refactor: use narrower/broader terms for creating extra notes

Author: brianrodri

lua/my/obsidian-depth-links.lua

@@ -0,0 +1,61 @@
+local H = {}
+local D = {}
+
+---@param scope "Narrower" | "Broader"
+function H.goto_new_scoped_link(scope)
+  local obsidian_api = require("obsidian.api")
+  local obsidian_note = require("obsidian.note")
+
+  local current_note = obsidian_api.current_note()
+  if not current_note then return end
+
+  local new_id = obsidian_api.input('New "' .. scope .. '" Note')
+  if vim.fn.empty(new_id) == 1 then return end
+
+  local new_note = obsidian_note.create({ id = new_id, should_write = false }):write({
+    template = Obsidian.opts.note.template, -- luacheck:ignore 113
+    update_content = function(lines)
+      return vim.list_extend(lines, {
+        "## " .. (scope == "Narrower" and "Broader" or "Narrower"),
+        "",
+        "- " .. current_note:format_link(),
+      })
+    end,
+  })
+
+  H.push_location_onto_tagstack(
+    new_note.id,
+    current_note:insert_text(
+      string.format("- " .. new_note:format_link()),
+      scope == "Narrower" and D.NARROWER_OPTS or D.BROADER_SECTION
+    )
+  )
+
+  vim.schedule(
+    function()
+      new_note:open({
+        line = 1 + (new_note.has_frontmatter and new_note.frontmatter_end_line or 1),
+        callback = vim.schedule_wrap(vim.cmd.checktime),
+      })
+    end
+  )
+end
+
+---@param tagname string
+---@param line_num integer
+function H.push_location_onto_tagstack(tagname, line_num)
+  if line_num == 0 then return end
+  local buf = vim.api.nvim_get_current_buf()
+  local col = 3
+  local off = 0
+  local new_item = { tagname = tagname, from = { buf, line_num, col, off } }
+  vim.fn.settagstack(vim.fn.win_getid(), { items = { new_item } }, "t")
+end
+
+D.NARROWER_OPTS = { placement = "bot", section = { level = 2, header = "Narrower" } }
+D.BROADER_SECTION = { placement = "top", section = { level = 2, header = "Broader" } }
+
+return {
+  goto_new_narrower_note = function() H.goto_new_scoped_link("Narrower") end,
+  goto_new_broader_note = function() H.goto_new_scoped_link("Broader") end,
+}

lua/my/obsidian-scope.lua

@@ -1,5 +1,5 @@
-local my_obsidian_depth_links = require("my.obsidian-depth-links")
 local my_obsidian_pinned_note = require("my.obsidian-pinned-note")
+local my_obsidian_scope = require("my.obsidian-scope")
 local my_vault = require("my.vault")
 
 ---@module "lazy"
@@ -39,8 +39,8 @@ return {
       { "<leader>vv", my_obsidian_pinned_note.open_pinned_note, desc = "Open Pinned Note", silent = true },
       { "<leader>va", my_obsidian_pinned_note.append_to_pinned_note, desc = "Append To Pinned Note", silent = true },
       { "<leader>vp", my_obsidian_pinned_note.pick_pinned_note, desc = "Pin/Unpin Note", silent = true },
-      { "<leader>vj", my_obsidian_depth_links.follow_new_child_link, desc = 'New "Down" Note', silent = true },
-      { "<leader>vk", my_obsidian_depth_links.follow_new_parent_link, desc = 'New "Up" Note', silent = true },
+      { "<leader>vj", my_obsidian_scope.goto_new_narrower_note, desc = "Create Narrower Note", silent = true },
+      { "<leader>vk", my_obsidian_scope.goto_new_broader_note, desc = "Create Broader Note", silent = true },
       { "<leader>vy", ":Obsidian extract_note<cr>", desc = "Extract to Note", silent = true, mode = { "n", "v" } },
       {
         "<leader>vr",