refactor: rename marks config to bookmarks and simplify persistence API

- Rename opts.marks to opts.bookmarks for better clarity
- Simplify persist option to boolean | string (true uses default path)
- Implement lazy node resolution for loaded bookmarks
- Update documentation with new bookmarks configuration
- Improve bulk operations to use public list() method consistently

Author: xiantang

doc/nvim-tree-lua.txt

@@ -640,6 +640,9 @@ Following is the default configuration. See |nvim-tree-opts| for details. >lua
           default_yes = false,
         },
       },
+      bookmarks = {
+        persist = false,
+      },
       experimental = {
       },
       log = {
@@ -3200,6 +3203,7 @@ highlight group is not, hard linking as follows: >
 |nvim-tree.actions.remove_file.close_window|
 |nvim-tree.actions.use_system_clipboard|
 |nvim-tree.auto_reload_on_write|
+|nvim-tree.bookmarks.persist|
 |nvim-tree.diagnostics.debounce_delay|
 |nvim-tree.diagnostics.diagnostic_opts|
 |nvim-tree.diagnostics.enable|

lua/nvim-tree/marks/init.lua

@@ -127,7 +127,6 @@ function Marks:get(node)
   if not node or not node.absolute_path then
     return nil
   end
-  
   local mark = self.marks[node.absolute_path]
   if mark == true then
     -- Lazy resolve: try to find node in explorer tree
@@ -139,7 +138,6 @@ function Marks:get(node)
     end
     return nil
   end
-  
   return mark
 end
 
@@ -162,7 +160,6 @@ function Marks:list()
       -- Already a node object
       node = mark
     end
-    
     if node then
       table.insert(list, node)
     end
@@ -359,7 +356,6 @@ function Marks:navigate_select()
     else
       node = mark
     end
-    
     if node and not node:is(DirectoryNode) and not utils.get_win_buf_from_path(node.absolute_path) then
       open_file.fn("edit", node.absolute_path)
     elseif node then