Added capability to applypatch -> replaceText to replace the header along with the content

package.json

@@ -24,6 +24,7 @@
   "scripts": {
     "build": "tsc",
     "test": "jest",
+    "prepare": "npm run build",
     "docs": "typedoc",
     "docs-serve": "http-server docs"
   },

src/cli.ts

@@ -53,6 +53,10 @@ program
     "Heading delimiter to use in place of '::'.",
     "::"
   )
+  .option(
+    "--replace-heading",
+    "Replace the heading as well as its content."
+  )
   .argument("<operation>", "Operation to perform ('replace', 'append', etc.)")
   .argument("<targetType>", "Target type ('heading', 'block', etc.)")
   .argument(
@@ -77,13 +81,34 @@ program
 
       const document = await fs.readFile(documentPath, "utf-8");
 
-      const instruction = {
-        operation,
-        targetType,
-        content,
-        target:
-          targetType !== "heading" ? target : target.split(options.delimiter),
-      } as PatchInstruction;
+      let instruction: PatchInstruction;
+
+      // Only create a ReplaceHeadingPatchInstruction when the operation and target are correct
+      if (operation === "replace" && targetType === "heading") {
+        instruction = {
+          operation,
+          targetType,
+          content,
+          target: target.split(options.delimiter),
+          replaceHeading: options.replaceHeading, 
+        };
+      } else {
+        // If the user tries to use the flag incorrectly, exit with an error.
+        if (options.replaceHeading) {
+          console.error(
+            "The --replace-heading flag is only valid for 'replace' operations on 'heading' targets."
+          );
+          process.exit(1);
+        }
+        // Create other instruction types as before
+        instruction = {
+          operation,
+          targetType,
+          content,
+          target:
+            targetType !== "heading" ? target : target.split(options.delimiter),
+        } as PatchInstruction;
+      }
 
       const patchedDocument = applyPatch(document, instruction);
       if (options.output === "-") {

src/patch.ts

@@ -20,6 +20,7 @@ import {
   isList,
   isString,
   isStringArrayArray,
+  isReplaceHeadingPatchInstruction
 } from "./typeGuards.js";
 
 export enum PatchFailureReason {
@@ -60,8 +61,15 @@ const replaceText = (
   instruction: PatchInstruction,
   target: DocumentMapMarkerContentPair
 ): string => {
+  let start = target.content.start;
+  if (
+    isReplaceHeadingPatchInstruction(instruction) &&
+    instruction.replaceHeading
+  ) {
+    start = target.marker.start;
+  }
   return [
-    document.slice(0, target.content.start),
+    document.slice(0, start),
     instruction.content,
     document.slice(target.content.end),
   ].join("");

src/typeGuards.ts

@@ -1,4 +1,5 @@
-import { AppendableFrontmatterType } from "./types";
+import { AppendableFrontmatterType,PatchInstruction,
+  ReplaceHeadingPatchInstruction, } from "./types";
 
 export function isStringArrayArray(obj: unknown): obj is string[][] {
   // Check if the object is an array
@@ -28,3 +29,11 @@ export function isDictionary(obj: unknown): obj is Record<string, unknown> {
 export function isList(obj: unknown): obj is Array<unknown> {
   return Array.isArray(obj);
 }
+
+export function isReplaceHeadingPatchInstruction(
+  instruction: PatchInstruction
+): instruction is ReplaceHeadingPatchInstruction {
+  return (
+    instruction.targetType === "heading" && instruction.operation === "replace"
+  );
+}

src/types.ts

@@ -121,6 +121,12 @@ export interface ReplaceHeadingPatchInstruction
     BaseHeadingPatchInstruction,
     StringContent {
   operation: "replace";
+  /**
+   * When replaceHeading is `true`, the heading will be replaced along with its content.
+   *
+   * By default, only the content under the heading is replaced.
+   */
+  replaceHeading?: boolean;
 }
 
 /**