store TipTap JSON as in-memory format, convert to markdown only at disk boundary

Author: ComputelessComputer

src/components/journal/EditableNote.tsx

@@ -14,7 +14,7 @@ import StarterKit from "@tiptap/starter-kit";
 import { forwardRef, useEffect, useImperativeHandle, useRef, } from "react";
 import { useDebounceCallback, } from "usehooks-ts";
 import "../editor/Editor.css";
-import { json2md, md2json, } from "../../lib/markdown";
+import { parseJsonContent, } from "../../lib/markdown";
 import { resolveAssetUrl, saveImage, } from "../../services/images";
 import { saveDailyNote, } from "../../services/storage";
 import type { DailyNote, } from "../../types/note";
@@ -44,8 +44,8 @@ const EditableNote = forwardRef<EditableNoteHandle, EditableNoteProps>(
     const onSaveRef = useRef(onSave,);
     onSaveRef.current = onSave;
 
-    const saveDebounced = useDebounceCallback((markdown: string,) => {
-      const updated = { ...noteRef.current, content: markdown, };
+    const saveDebounced = useDebounceCallback((jsonStr: string,) => {
+      const updated = { ...noteRef.current, content: jsonStr, };
       if (onSaveRef.current) {
         onSaveRef.current(updated,);
       } else {
@@ -127,7 +127,7 @@ const EditableNote = forwardRef<EditableNoteHandle, EditableNoteProps>(
           },
         },),
       ],
-      content: md2json(note.content,),
+      content: parseJsonContent(note.content,),
       editable: true,
       immediatelyRender: false,
       editorProps: {
@@ -163,7 +163,7 @@ const EditableNote = forwardRef<EditableNoteHandle, EditableNoteProps>(
         },
       },
       onUpdate: ({ editor, },) => {
-        saveDebounced(json2md(editor.getJSON(),),);
+        saveDebounced(JSON.stringify(editor.getJSON(),),);
       },
     },);
 
@@ -182,7 +182,7 @@ const EditableNote = forwardRef<EditableNoteHandle, EditableNoteProps>(
 
     useEffect(() => {
       if (!editor || editor.isDestroyed) return;
-      const incoming = md2json(note.content,);
+      const incoming = parseJsonContent(note.content,);
       if (!editor.isFocused) {
         editor.commands.setContent(incoming, { emitUpdate: false, },);
       }

src/lib/markdown.ts

@@ -106,3 +106,13 @@ export function json2md(json: JSONContent,): string {
     return "";
   }
 }
+
+export function parseJsonContent(raw: string | undefined | null,): JSONContent {
+  if (typeof raw !== "string" || !raw.trim()) return EMPTY_DOC;
+  try {
+    const parsed = JSON.parse(raw,);
+    return isValidContent(parsed,) ? parsed : EMPTY_DOC;
+  } catch {
+    return EMPTY_DOC;
+  }
+}

src/services/storage.ts

@@ -1,4 +1,5 @@
 import { exists, mkdir, readTextFile, writeTextFile, } from "@tauri-apps/plugin-fs";
+import { EMPTY_DOC, json2md, md2json, parseJsonContent, } from "../lib/markdown";
 import { DailyNote, getDaysAgo, } from "../types/note";
 import { resolveMarkdownImages, unresolveMarkdownImages, } from "./images";
 import { getNoteDir, getNotePath, } from "./paths";
@@ -31,7 +32,8 @@ export async function saveDailyNote(note: DailyNote,): Promise<void> {
   const noteDir = await getNoteDir(note.date,);
   await ensureDir(noteDir,);
   const filepath = await getNotePath(note.date,);
-  let body = unresolveMarkdownImages(note.content,);
+  const json = parseJsonContent(note.content,);
+  let body = unresolveMarkdownImages(json2md(json,),);
   if (!body.endsWith("\n",)) body += "\n";
   await writeTextFile(filepath, buildFrontmatter(note.city, body,),);
 }
@@ -46,14 +48,15 @@ export async function loadDailyNote(date: string,): Promise<DailyNote | null> {
 
   const raw = await readTextFile(filepath,);
   const { city, body, } = parseFrontmatter(raw,);
-  const content = await resolveMarkdownImages(body.replace(/&nbsp;/g, "",),);
+  const resolved = await resolveMarkdownImages(body.replace(/&nbsp;/g, "",),);
+  const content = JSON.stringify(md2json(resolved,),);
   return { date, content, city, };
 }
 
 export async function createEmptyDailyNote(date: string,): Promise<DailyNote> {
   const note: DailyNote = {
     date,
-    content: "",
+    content: JSON.stringify(EMPTY_DOC,),
   };
 
   await saveDailyNote(note,);

src/services/tasks.ts

@@ -1,3 +1,4 @@
+import { json2md, md2json, parseJsonContent, } from "../lib/markdown";
 import { getDaysAgo, getToday, } from "../types/note";
 import type { DailyNote, } from "../types/note";
 import { loadDailyNote, saveDailyNote, } from "./storage";
@@ -141,29 +142,27 @@ function prependTasks(content: string, tasks: TaskLine[],): string {
  */
 export async function rolloverTasks(days: number = 30,): Promise<boolean> {
   const today = getToday();
-  // Map from task text → TaskLine (preserves indent, deduplicates by text)
   const taskMap = new Map<string, TaskLine>();
   const modifiedNotes: DailyNote[] = [];
 
-  // Scan past notes
   for (let i = 1; i <= days; i++) {
     const date = getDaysAgo(i,);
     const note = await loadDailyNote(date,);
     if (!note || !note.content.trim()) continue;
+    const markdown = json2md(parseJsonContent(note.content,),);
+    if (!markdown.trim()) continue;
 
-    // 1. Extract unchecked tasks → move to today (preserving nesting)
-    const { tasks, cleaned, } = extractUncheckedTasks(note.content,);
+    const { tasks, cleaned, } = extractUncheckedTasks(markdown,);
     if (tasks.length > 0) {
       tasks.forEach((t,) => {
         if (!taskMap.has(t.text,)) {
           taskMap.set(t.text, t,);
         }
       },);
-      modifiedNotes.push({ ...note, content: cleaned, },);
+      modifiedNotes.push({ ...note, content: JSON.stringify(md2json(cleaned,),), },);
     }
 
-    // 2. Find checked recurring tasks that are due again
-    const checkedRecurring = extractCheckedRecurringTasks(note.content,);
+    const checkedRecurring = extractCheckedRecurringTasks(markdown,);
     for (const taskText of checkedRecurring) {
       const recurrence = parseRecurrence(taskText,)!;
       const nextDue = addDaysToDate(date, recurrence.intervalDays,);
@@ -175,19 +174,15 @@ export async function rolloverTasks(days: number = 30,): Promise<boolean> {
 
   if (taskMap.size === 0) return false;
 
-  // Save cleaned past notes (unchecked tasks removed)
   await Promise.all(modifiedNotes.map((note,) => saveDailyNote(note,)),);
-
-  // Deduplicate against tasks already in today's note
   const todayNote = await loadDailyNote(today,);
-  const todayContent = todayNote?.content ?? "";
-  const existingTasks = extractAllTaskTexts(todayContent,);
+  const todayMarkdown = todayNote ? json2md(parseJsonContent(todayNote.content,),) : "";
+  const existingTasks = extractAllTaskTexts(todayMarkdown,);
   const newTasks = [...taskMap.values(),].filter((t,) => !existingTasks.has(t.text,));
-
   if (newTasks.length === 0) return false;
 
-  const updated = prependTasks(todayContent, newTasks,);
-  await saveDailyNote({ date: today, content: updated, },);
-
+  const updated = prependTasks(todayMarkdown, newTasks,);
+  const updatedJson = JSON.stringify(md2json(updated,),);
+  await saveDailyNote({ date: today, content: updatedJson, city: todayNote?.city, },);
   return true;
 }

src/types/note.ts

@@ -1,6 +1,6 @@
 export interface DailyNote {
   date: string; // ISO date string (YYYY-MM-DD)
-  content: string; // markdown
+  content: string; // TipTap JSON string (in-memory), markdown on disk
   city?: string | null;
 }