vim-prose 0.1.0

package/dist/extensions/vim/types.d.ts

@@ -0,0 +1,55 @@
+import type { Node as ProseMirrorNode } from 'prosemirror-model';
+export type Mode = 'normal' | 'insert' | 'visual' | 'visual-line';
+export interface Register {
+    text: string;
+    linewise: boolean;
+    content: ProseMirrorNode[] | null;
+}
+export interface RepeatableAction {
+    type: 'command' | 'operator-linewise' | 'operator-motion' | 'operator-textobject' | 'insert-command';
+    key: string;
+    count: number;
+    operator?: 'd' | 'y' | 'c';
+    motion?: string;
+    findChar?: string;
+    findMotion?: 'f' | 'F' | 't' | 'T';
+    textObject?: {
+        type: 'i' | 'a';
+        object: string;
+    };
+    insertedText?: string;
+}
+export interface VimState {
+    mode: Mode;
+    count: number | null;
+    operator: 'd' | 'y' | 'c' | null;
+    findPending: boolean;
+    findMotion: 'f' | 'F' | 't' | 'T' | null;
+    ggPending: boolean;
+    visualAnchor: number | null;
+    visualHead: number | null;
+    register: Register;
+    goalColumn: number | null;
+    marks: Record<string, number>;
+    markPending: boolean;
+    gotoMarkPending: boolean;
+    searchTerm: string;
+    searchWholeWord: boolean;
+    searchActive: boolean;
+    searchQuery: string;
+    searchHighlightsVisible: boolean;
+    lastAction: RepeatableAction | null;
+    insertTextBuffer: string;
+    isTrackingInsert: boolean;
+    shiftRightPending: boolean;
+    shiftLeftPending: boolean;
+    zzPending: boolean;
+    statusMessage: string;
+}
+export interface VimEditorCommands {
+    undo(): boolean;
+    redo(): boolean;
+    indent?(): boolean;
+    outdent?(): boolean;
+}
+export declare function defaultVimState(): VimState;

package/dist/extensions/vim/types.js

@@ -0,0 +1,29 @@
+export function defaultVimState() {
+    return {
+        mode: 'normal',
+        count: null,
+        operator: null,
+        findPending: false,
+        findMotion: null,
+        ggPending: false,
+        visualAnchor: null,
+        visualHead: null,
+        register: { text: '', linewise: false, content: null },
+        goalColumn: null,
+        marks: {},
+        markPending: false,
+        gotoMarkPending: false,
+        searchTerm: '',
+        searchWholeWord: false,
+        searchActive: false,
+        searchQuery: '',
+        searchHighlightsVisible: false,
+        lastAction: null,
+        insertTextBuffer: '',
+        isTrackingInsert: false,
+        shiftRightPending: false,
+        shiftLeftPending: false,
+        zzPending: false,
+        statusMessage: '',
+    };
+}

package/dist/extensions/vim/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/extensions/vim/types.ts"],"names":[],"mappings":"AAmBA,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,IAAI;QACX,aAAa,EAAE,IAAI;QACnB,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,KAAK;QAClB,UAAU,EAAE,IAAI;QAChB,SAAS,EAAE,KAAK;QAChB,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE;KACxC,CAAA;AACH,CAAC"}

package/dist/extensions/vim/utils.d.ts

@@ -0,0 +1,76 @@
+import { EditorState } from 'prosemirror-state';
+/**
+ * Get the start position of the current paragraph/line (inside the text node).
+ */
+export declare function lineStart(state: EditorState): number;
+/**
+ * Get the end position of the current paragraph/line (inside the text node).
+ */
+export declare function lineEnd(state: EditorState): number;
+/**
+ * Get line start/end for an arbitrary position.
+ */
+export declare function lineStartAt(state: EditorState, pos: number): number;
+export declare function lineEndAt(state: EditorState, pos: number): number;
+/**
+ * Get the text content of the current line/paragraph.
+ */
+export declare function lineText(state: EditorState): string;
+/**
+ * Get the cursor offset within its current paragraph.
+ */
+export declare function cursorOffsetInLine(state: EditorState): number;
+/**
+ * Check if a character is a word character (\w).
+ */
+export declare function isWordChar(ch: string): boolean;
+/**
+ * Check if a character is whitespace.
+ */
+export declare function isWhitespace(ch: string): boolean;
+/**
+ * Get the first non-blank character position on the current line.
+ */
+export declare function firstNonBlank(state: EditorState): number;
+/**
+ * Clamp a position within the document.
+ */
+export declare function clampPos(state: EditorState, pos: number): number;
+/**
+ * Get character at a given document position (returns empty string if out of bounds).
+ */
+export declare function charAt(state: EditorState, pos: number): string;
+/**
+ * Find the paragraph node boundaries that contain the given position.
+ * Returns [nodeStart, nodeEnd] where nodeStart is the position before the node
+ * and nodeEnd is the position after the node (including the node itself).
+ */
+export declare function paragraphBounds(state: EditorState, pos: number): {
+    from: number;
+    to: number;
+};
+/**
+ * Get the word under cursor at the given position.
+ */
+export declare function wordUnderCursor(state: EditorState, pos: number): string | null;
+/**
+ * Find all positions of a search term in the document.
+ */
+export declare function findAllMatches(state: EditorState, term: string, wholeWord?: boolean): number[];
+/**
+ * Find the next match position after fromPos, wrapping around.
+ */
+export declare function findNextMatch(state: EditorState, term: string, fromPos: number, wholeWord?: boolean): number | null;
+/**
+ * Find the previous match position before fromPos, wrapping around.
+ */
+export declare function findPrevMatch(state: EditorState, term: string, fromPos: number, wholeWord?: boolean): number | null;
+/**
+ * Find the "line-level" node boundaries for linewise operations (dd, yy, V, etc.).
+ * For text inside a list item with a single child, returns the list item bounds.
+ * Otherwise returns the textblock bounds (same as paragraphBounds).
+ */
+export declare function lineBounds(state: EditorState, pos: number): {
+    from: number;
+    to: number;
+};

package/dist/extensions/vim/utils.js

@@ -0,0 +1,224 @@
+/**
+ * Get the start position of the current paragraph/line (inside the text node).
+ */
+export function lineStart(state) {
+    const { $head } = state.selection;
+    return $head.start($head.depth);
+}
+/**
+ * Get the end position of the current paragraph/line (inside the text node).
+ */
+export function lineEnd(state) {
+    const { $head } = state.selection;
+    return $head.end($head.depth);
+}
+/**
+ * Get line start/end for an arbitrary position.
+ */
+export function lineStartAt(state, pos) {
+    const $pos = state.doc.resolve(pos);
+    if ($pos.depth === 0)
+        return pos;
+    return $pos.start($pos.depth);
+}
+export function lineEndAt(state, pos) {
+    const $pos = state.doc.resolve(pos);
+    if ($pos.depth === 0)
+        return pos;
+    return $pos.end($pos.depth);
+}
+/**
+ * Get the text content of the current line/paragraph.
+ */
+export function lineText(state) {
+    const start = lineStart(state);
+    const end = lineEnd(state);
+    return state.doc.textBetween(start, end, '\n', '\n');
+}
+/**
+ * Get the cursor offset within its current paragraph.
+ */
+export function cursorOffsetInLine(state) {
+    const { $head } = state.selection;
+    return $head.pos - $head.start($head.depth);
+}
+/**
+ * Check if a character is a word character (\w).
+ */
+export function isWordChar(ch) {
+    return /\w/.test(ch);
+}
+/**
+ * Check if a character is whitespace.
+ */
+export function isWhitespace(ch) {
+    return /\s/.test(ch);
+}
+/**
+ * Get the first non-blank character position on the current line.
+ */
+export function firstNonBlank(state) {
+    const start = lineStart(state);
+    const text = lineText(state);
+    for (let i = 0; i < text.length; i++) {
+        if (!/\s/.test(text[i])) {
+            return start + i;
+        }
+    }
+    return start;
+}
+/**
+ * Clamp a position within the document.
+ */
+export function clampPos(state, pos) {
+    return Math.max(0, Math.min(pos, state.doc.content.size));
+}
+/**
+ * Get character at a given document position (returns empty string if out of bounds).
+ */
+export function charAt(state, pos) {
+    if (pos < 0 || pos >= state.doc.content.size)
+        return '';
+    try {
+        return state.doc.textBetween(pos, pos + 1, '\n', '\n');
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Find the paragraph node boundaries that contain the given position.
+ * Returns [nodeStart, nodeEnd] where nodeStart is the position before the node
+ * and nodeEnd is the position after the node (including the node itself).
+ */
+export function paragraphBounds(state, pos) {
+    let $pos = state.doc.resolve(pos);
+    if ($pos.depth === 0) {
+        // At document root (between nodes), resolve into nearest textblock
+        if (pos < state.doc.content.size) {
+            $pos = state.doc.resolve(pos + 1);
+        }
+        else if (pos > 0) {
+            $pos = state.doc.resolve(pos - 1);
+        }
+        else {
+            return { from: 0, to: state.doc.content.size };
+        }
+    }
+    const depth = $pos.depth;
+    const start = $pos.before(depth);
+    const end = $pos.after(depth);
+    return { from: start, to: end };
+}
+/**
+ * Get the word under cursor at the given position.
+ */
+export function wordUnderCursor(state, pos) {
+    const $pos = state.doc.resolve(pos);
+    if ($pos.depth === 0)
+        return null;
+    const lineS = $pos.start($pos.depth);
+    const lineE = $pos.end($pos.depth);
+    const ch = charAt(state, pos);
+    if (!ch || !isWordChar(ch))
+        return null;
+    let from = pos;
+    let to = pos;
+    while (from > lineS && isWordChar(charAt(state, from - 1)))
+        from--;
+    while (to < lineE && isWordChar(charAt(state, to)))
+        to++;
+    if (from === to)
+        return null;
+    return state.doc.textBetween(from, to);
+}
+/**
+ * Find all positions of a search term in the document.
+ */
+export function findAllMatches(state, term, wholeWord = false) {
+    if (!term)
+        return [];
+    const positions = [];
+    state.doc.descendants((node, pos) => {
+        if (node.isText && node.text) {
+            let idx = 0;
+            while (true) {
+                const found = node.text.indexOf(term, idx);
+                if (found === -1)
+                    break;
+                if (wholeWord) {
+                    const before = found > 0 ? node.text[found - 1] : '';
+                    const after = found + term.length < node.text.length
+                        ? node.text[found + term.length]
+                        : '';
+                    if ((before && isWordChar(before)) || (after && isWordChar(after))) {
+                        idx = found + 1;
+                        continue;
+                    }
+                }
+                positions.push(pos + found);
+                idx = found + 1;
+            }
+        }
+    });
+    return positions.sort((a, b) => a - b);
+}
+/**
+ * Find the next match position after fromPos, wrapping around.
+ */
+export function findNextMatch(state, term, fromPos, wholeWord = false) {
+    const matches = findAllMatches(state, term, wholeWord);
+    if (matches.length === 0)
+        return null;
+    for (const pos of matches) {
+        if (pos > fromPos)
+            return pos;
+    }
+    return matches[0]; // wrap around
+}
+/**
+ * Find the previous match position before fromPos, wrapping around.
+ */
+export function findPrevMatch(state, term, fromPos, wholeWord = false) {
+    const matches = findAllMatches(state, term, wholeWord);
+    if (matches.length === 0)
+        return null;
+    for (let i = matches.length - 1; i >= 0; i--) {
+        if (matches[i] < fromPos)
+            return matches[i];
+    }
+    return matches[matches.length - 1]; // wrap around
+}
+/**
+ * Find the "line-level" node boundaries for linewise operations (dd, yy, V, etc.).
+ * For text inside a list item with a single child, returns the list item bounds.
+ * Otherwise returns the textblock bounds (same as paragraphBounds).
+ */
+export function lineBounds(state, pos) {
+    let $pos = state.doc.resolve(pos);
+    if ($pos.depth === 0) {
+        if (pos < state.doc.content.size) {
+            $pos = state.doc.resolve(pos + 1);
+        }
+        else if (pos > 0) {
+            $pos = state.doc.resolve(pos - 1);
+        }
+        else {
+            return { from: 0, to: state.doc.content.size };
+        }
+    }
+    let depth = $pos.depth;
+    // Walk up through ancestors looking for a list item
+    for (let d = $pos.depth - 1; d >= 1; d--) {
+        const node = $pos.node(d);
+        const name = node.type.name;
+        if (name === 'listItem' || name === 'list_item') {
+            // Use list item bounds if it has only one child (the common case)
+            if (node.childCount === 1) {
+                depth = d;
+            }
+            break;
+        }
+    }
+    return { from: $pos.before(depth), to: $pos.after(depth) };
+}

package/dist/extensions/vim/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/extensions/vim/utils.ts"],"names":[],"mappings":"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"}

package/dist/extensions/vim/vim-mode.css

@@ -0,0 +1,81 @@
+/* Vim mode visual indicators */
+
+/* Hide native caret in non-insert modes */
+.vim-mode-normal,
+.vim-mode-visual,
+.vim-mode-visual-line {
+  caret-color: transparent;
+}
+
+/* Show native caret in insert mode */
+.vim-mode-insert {
+  caret-color: auto;
+}
+
+/* Block cursor (character under cursor in normal/visual modes) */
+.vim-block-cursor {
+  background: rgba(55, 53, 47, 0.8);
+  color: #ffffff;
+  border-radius: 1px;
+}
+
+/* Block cursor at end of line (widget) */
+.vim-block-cursor-eol {
+  background: rgba(55, 53, 47, 0.8);
+  border-radius: 1px;
+}
+
+/* Visual selection highlight */
+.vim-visual-selection {
+  background: rgba(59, 130, 246, 0.3);
+}
+
+/* Suppress native selection in visual modes (we use decorations instead) */
+.vim-mode-visual ::selection,
+.vim-mode-visual-line ::selection {
+  background: transparent;
+}
+
+/* Search bar */
+.vim-search-bar {
+  display: flex;
+  align-items: center;
+  padding: 4px 8px;
+  background: #f8f8f8;
+  border-top: 1px solid #e0e0e0;
+  font-family: 'SF Mono', 'Fira Code', 'Fira Mono', 'Roboto Mono', monospace;
+  font-size: 14px;
+  min-height: 28px;
+}
+
+.vim-search-prefix {
+  color: #666;
+  margin-right: 2px;
+}
+
+.vim-search-input {
+  color: #333;
+  white-space: pre;
+}
+
+.vim-search-cursor {
+  color: #333;
+  animation: vim-cursor-blink 1s step-end infinite;
+}
+
+@keyframes vim-cursor-blink {
+  50% {
+    opacity: 0;
+  }
+}
+
+/* Search match highlights */
+.vim-search-match {
+  background: rgba(255, 200, 0, 0.4);
+  border-radius: 1px;
+}
+
+.vim-search-match-current {
+  background: rgba(255, 140, 0, 0.5);
+  border-radius: 1px;
+}

package/dist/extensions/vim/visual.d.ts

@@ -0,0 +1,15 @@
+import { EditorState, Transaction } from 'prosemirror-state';
+import { VimState } from './types';
+/**
+ * Update the visual selection based on anchor and new head position.
+ */
+export declare function updateVisualSelection(state: EditorState, tr: Transaction, vimState: VimState, newHead: number): Transaction;
+/**
+ * Get the effective selection range for visual mode operations (y, d, c, x).
+ * Returns the from/to positions and whether it's a linewise operation.
+ */
+export declare function getVisualRange(state: EditorState, vimState: VimState): {
+    from: number;
+    to: number;
+    linewise: boolean;
+} | null;

package/dist/extensions/vim/visual.js

@@ -0,0 +1,58 @@
+import { TextSelection } from 'prosemirror-state';
+import { lineBounds } from './utils';
+/**
+ * Update the visual selection based on anchor and new head position.
+ */
+export function updateVisualSelection(state, tr, vimState, newHead) {
+    if (vimState.visualAnchor === null)
+        return tr;
+    const anchor = vimState.visualAnchor;
+    const head = newHead;
+    if (vimState.mode === 'visual') {
+        // Characterwise visual: select from anchor to head
+        // In vim, visual selection is inclusive. We extend head by 1 when head >= anchor
+        let selFrom, selTo;
+        if (head >= anchor) {
+            selFrom = anchor;
+            selTo = Math.min(head + 1, state.doc.content.size);
+        }
+        else {
+            selFrom = head;
+            selTo = Math.min(anchor + 1, state.doc.content.size);
+        }
+        try {
+            tr.setSelection(TextSelection.create(tr.doc, selFrom, selTo));
+        }
+        catch {
+            // leave as-is
+        }
+    }
+    else if (vimState.mode === 'visual-line') {
+        // Linewise visual: select full lines from anchor to head
+        const anchorBounds = lineBounds(state, anchor);
+        const headBounds = lineBounds(state, newHead);
+        const from = Math.min(anchorBounds.from, headBounds.from);
+        const to = Math.max(anchorBounds.to, headBounds.to);
+        try {
+            tr.setSelection(TextSelection.create(tr.doc, from, to));
+        }
+        catch {
+            // leave as-is
+        }
+    }
+    tr.scrollIntoView();
+    return tr;
+}
+/**
+ * Get the effective selection range for visual mode operations (y, d, c, x).
+ * Returns the from/to positions and whether it's a linewise operation.
+ */
+export function getVisualRange(state, vimState) {
+    if (vimState.visualAnchor === null)
+        return null;
+    const { from, to } = state.selection;
+    if (vimState.mode === 'visual-line') {
+        return { from, to, linewise: true };
+    }
+    return { from, to, linewise: false };
+}

package/dist/extensions/vim/visual.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual.js","sourceRoot":"","sources":["../../../src/extensions/vim/visual.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAE1E,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAE7C;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,EAAe,EACf,KAAkB,EAClB,EAAY,EACZ,OAAe;IAEf,IAAI,EAAE,CAAC,YAAY,KAAK,IAAI;QAAE,OAAO,EAAE,CAAA;IAEvC,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAA;IAC9B,6DAA6D;IAC7D,8FAA8F;IAC9F,mDAAmD;IACnD,IAAI,IAAY,CAAA;IAChB,IAAI,EAAU,CAAA;IACd,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;QACtB,IAAI,GAAG,MAAM,CAAA;QACb,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACpD,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,OAAO,CAAA;QACd,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACnD,CAAC;IAED,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,CAAA;IACxD,OAAO,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,CAAA;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,EAAe,EACf,KAAkB,EAClB,EAAY,EACZ,OAAe;IAEf,IAAI,EAAE,CAAC,YAAY,KAAK,IAAI;QAAE,OAAO,EAAE,CAAA;IAEvC,MAAM,aAAa,GAAG,WAAW,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,CAAA;IACzD,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IAE/C,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,WAAW,CAAC,CAAA;IACzD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,WAAW,CAAC,CAAA;IAEvD,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,EAAE,YAAY,CAAC,CAAA;IAC7C,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;IAEzC,IAAI,CAAC,SAAS,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAA;IAErC,wEAAwE;IACxE,kEAAkE;IAClE,oEAAoE;IACpE,gEAAgE;IAChE,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAA;IAC5B,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAA;IAEtB,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,CAAA;IACxD,OAAO,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,CAAA;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAkB;IAC/C,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,SAAS,CAAA;IACpC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAA;AACrB,CAAC"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "vim-prose",
+  "author": "KJ Shanks",
+  "version": "0.1.0",
+  "description": "Vim keybinding extension for Tiptap v3 / ProseMirror",
+  "type": "module",
+  "main": "dist/extensions/vim/index.js",
+  "types": "dist/extensions/vim/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/extensions/vim/index.js",
+      "types": "./dist/extensions/vim/index.d.ts"
+    },
+    "./tiptap": {
+      "import": "./dist/extensions/vim/tiptap.js",
+      "types": "./dist/extensions/vim/tiptap.d.ts"
+    },
+    "./style.css": "./dist/extensions/vim/vim-mode.css"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && cp src/extensions/vim/vim-mode.css dist/extensions/vim/vim-mode.css",
+    "typecheck": "tsc --noEmit",
+    "dev": "vite demo",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "@tiptap/core": ">=3",
+    "prosemirror-model": ">=1",
+    "prosemirror-state": ">=1",
+    "prosemirror-view": ">=1"
+  },
+  "peerDependenciesMeta": {
+    "@tiptap/core": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@tiptap/core": "^3.20.3",
+    "@tiptap/pm": "^3.20.3",
+    "@tiptap/starter-kit": "^3.20.4",
+    "prosemirror-model": "^1.25.4",
+    "prosemirror-state": "^1.4.4",
+    "prosemirror-transform": "^1.11.0",
+    "prosemirror-view": "^1.41.6",
+    "typescript": "^5.9.3",
+    "vite": "^8.0.0"
+  },
+  "keywords": [
+    "vim",
+    "tiptap",
+    "prosemirror",
+    "editor",
+    "keybindings",
+    "modal"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Kyle-Shanks/vim-prose"
+  }
+}