@cueloop/schema 0.1.0-alpha.5 → 0.1.0-alpha.50

package/src/working-copy.ts

@@ -0,0 +1,61 @@
+/**
+ * Working-copy block surgery: the only module that slices raw source text by
+ * Block line ranges. Cut removes a block's lines; restore re-inserts a base
+ * block's chunk and reports when the working copy round-trips back to the
+ * submitted revision (pristine). Callers never touch lineStart/lineEnd.
+ */
+
+import { parseBlocks, type Block } from "./markdown";
+
+/** Chunk of the base source a block occupies (for restore and display). */
+export function sourceChunk(base: string, block: Block): string {
+  const lines = base.split("\n");
+  return lines.slice(block.lineStart, block.lineEnd + 1).join("\n");
+}
+
+/** Remove a work block's lines from the working source (Cut). */
+export function cutBlock(working: string, block: Block): string {
+  const lines = working.split("\n");
+  const before = lines.slice(0, block.lineStart);
+  const after = lines.slice(block.lineEnd + 1);
+  while (before.length && before[before.length - 1]!.trim() === "") before.pop();
+  return [...before, ...after].join("\n");
+}
+
+/** The line a restored block re-enters at: the next surviving block's start. */
+export function restoreLine(next: Block | undefined, workingLineCount: number): number {
+  return next ? next.lineStart : workingLineCount;
+}
+
+/**
+ * Block-structure signature: kind + text of every block, insensitive to
+ * blank-line layout between blocks. NUL separates blocks so no block text
+ * can fake a boundary.
+ */
+function signature(text: string): string {
+  return parseBlocks(text)
+    .map((block) => block.kind + " " + block.text)
+    .join("\0");
+}
+
+/**
+ * Re-insert a cut base block into the working source before `beforeLine`.
+ * Returns undefined when the block structure round-trips to the base content
+ * (restore may differ in blank-line placement only) - the working copy is
+ * back to pristine and should be dropped.
+ */
+export function restoreBlock(
+  base: string,
+  working: string,
+  block: Block,
+  beforeLine: number,
+): string | undefined {
+  const lines = working.split("\n");
+  const before = lines.slice(0, beforeLine);
+  const after = lines.slice(beforeLine);
+  const insertedLines = sourceChunk(base, block).split("\n");
+  if (before.length && before[before.length - 1]!.trim() !== "") insertedLines.unshift("");
+  if (after.length && after[0]!.trim() !== "") insertedLines.push("");
+  const restored = [...before, ...insertedLines, ...after].join("\n");
+  return signature(restored) === signature(base) ? undefined : restored;
+}