feat: implement fix operation utils

Author: ygj6

src/operationUtils.ts

@@ -0,0 +1,130 @@
+import type { Node } from 'vue-eslint-parser/ast/nodes'
+import type { Token } from 'vue-eslint-parser/ast/tokens'
+// import * as fixutils from "./fixUtils";
+export type Operation = {
+  range: number[]
+  text: string
+}
+// TODO: for simplicity of implementation, we've skipped all `{ ...expr }` cases
+
+/**
+ * Creates a fix command that inserts text at the specified index in the source text.
+ * @param {int} index The 0-based index at which to insert the new text.
+ * @param {string} text The text to insert.
+ * @returns {Object} The fix command.
+ * @private
+ */
+export function insertTextAt(index: number, text: string): Operation {
+  return {
+    range: [index, index],
+    text,
+  }
+}
+
+/**
+ * Creates a fix command that inserts text after the given node or token.
+ * The fix is not applied until applyFixes() is called.
+ * @param {Node|Token} nodeOrToken The node or token to insert after.
+ * @param {string} text The text to insert.
+ * @returns {Object} The fix command.
+ */
+export function insertTextAfter(
+  nodeOrToken: Node | Token,
+  text: string
+): Operation {
+  return insertTextAfterRange(nodeOrToken.range, text)
+}
+
+/**
+ * Creates a fix command that inserts text after the specified range in the source text.
+ * The fix is not applied until applyFixes() is called.
+ * @param {int[]} range The range to replace, first item is start of range, second
+ *      is end of range.
+ * @param {string} text The text to insert.
+ * @returns {Object} The fix command.
+ */
+export function insertTextAfterRange(range: number[], text: string): Operation {
+  return insertTextAt(range[1], text)
+}
+
+/**
+ * Creates a fix command that inserts text before the given node or token.
+ * The fix is not applied until applyFixes() is called.
+ * @param {Node|Token} nodeOrToken The node or token to insert before.
+ * @param {string} text The text to insert.
+ * @returns {Object} The fix command.
+ */
+export function insertTextBefore(
+  nodeOrToken: Node | Token,
+  text: string
+): Operation {
+  return insertTextBeforeRange(nodeOrToken.range, text)
+}
+
+/**
+ * Creates a fix command that inserts text before the specified range in the source text.
+ * The fix is not applied until applyFixes() is called.
+ * @param {int[]} range The range to replace, first item is start of range, second
+ *      is end of range.
+ * @param {string} text The text to insert.
+ * @returns {Object} The fix command.
+ */
+export function insertTextBeforeRange(
+  range: number[],
+  text: string
+): Operation {
+  return insertTextAt(range[0], text)
+}
+
+/**
+ * Creates a fix command that replaces text at the node or token.
+ * The fix is not applied until applyFixes() is called.
+ * @param {Node|Token} nodeOrToken The node or token to remove.
+ * @param {string} text The text to insert.
+ * @returns {Object} The fix command.
+ */
+export function replaceText(
+  nodeOrToken: Node | Token,
+  text: string
+): Operation {
+  return replaceTextRange(nodeOrToken.range, text)
+}
+
+/**
+ * Creates a fix command that replaces text at the specified range in the source text.
+ * The fix is not applied until applyFixes() is called.
+ * @param {int[]} range The range to replace, first item is start of range, second
+ *      is end of range.
+ * @param {string} text The text to insert.
+ * @returns {Object} The fix command.
+ */
+export function replaceTextRange(range: number[], text: string): Operation {
+  return {
+    range,
+    text,
+  }
+}
+
+/**
+ * Creates a fix command that removes the node or token from the source.
+ * The fix is not applied until applyFixes() is called.
+ * @param {Node|Token} nodeOrToken The node or token to remove.
+ * @returns {Object} The fix command.
+ */
+export function remove(nodeOrToken: Node | Token): Operation {
+  return removeRange(nodeOrToken.range)
+}
+
+/**
+ * Creates a fix command that removes the specified range of text from the source.
+ * The fix is not applied until applyFixes() is called.
+ * @param {int[]} range The range to remove, first item is start of range, second
+ *      is end of range.
+ * @returns {Object} The fix command.
+ */
+export function removeRange(range: number[]): Operation {
+  return {
+    range,
+    text: '',
+  }
+}