Function renameNote

apps/desktop/src/main/vault.ts:3107–3154

(
  root: string,
  rel: string,
  nextTitle: string
)

}

export async function renameNote(
  root: string,
  rel: string,
  nextTitle: string
): Promise<NoteMeta> {
  const abs = resolveSafe(root, rel)
  const folder = folderOf(root, abs)
  if (!folder) throw new Error(`Note not in a known folder: ${rel}`)
  const dir = path.dirname(abs)
  const trimmed = sanitizeNoteTitle(nextTitle)
  // Preserve the file's type on rename — a `.excalidraw` drawing must stay a
  // drawing, not get turned into a `.md` note (which would render its JSON).
  const ext = isExcalidrawPath(abs) ? '.excalidraw' : '.md'
  const target = path.join(dir, `${trimmed}${ext}`)
  const willRename = target !== abs
  // Snapshot the vault before the rename so inbound [[wikilinks]] still
  // resolve to this note under its current name; we rewrite them afterwards.
  const notesBefore = willRename ? await listNotes(root) : []
  if (willRename) {
    // Check for conflicts, but allow case-only renames on case-insensitive FS
    try {
      await fs.access(target)
      const [srcStat, dstStat] = await Promise.all([fs.stat(abs), fs.stat(target)])
      if (srcStat.ino !== dstStat.ino) {
        throw new Error(`A note named "${trimmed}" already exists in ${folder}`)
      }
    } catch (e) {
      if ((e as NodeJS.ErrnoException).code !== 'ENOENT') throw e
    }
    // Two-step rename for case-only changes on case-insensitive filesystems
    if (abs.toLowerCase() === target.toLowerCase() && abs !== target) {
      const tmp = abs + '_rename_tmp_' + Date.now()
      await fs.rename(abs, tmp)
      await fs.rename(tmp, target)
    } else {
      await fs.rename(abs, target)
    }
  }
  const meta = await readMeta(root, target, folder)
  await moveNoteComments(root, rel, meta.path)
  invalidateNoteMetaCache(root, rel)
  invalidateNoteMetaCache(root, meta.path)
  invalidateVaultTextSearchCache(root)
  if (willRename) {
    await updateInboundWikilinks(root, notesBefore, rel, meta.title)
  }
  return meta
}

/**
 * Rewrite every `[[wikilink]]` across the vault that pointed to a note's old