chore(build): auto-generate vimdoc (#82)

doc/img-clip.nvim.txt

@@ -112,67 +112,67 @@ below:
     {
       default = {
         -- file and directory options
-        dir_path = "assets", ---@type string
-        extension = "png", ---@type string
-        file_name = "%Y-%m-%d-%H-%M-%S", ---@type string
-        use_absolute_path = false, ---@type boolean
-        relative_to_current_file = false, ---@type boolean
+        dir_path = "assets", ---@type string | fun(): string
+        extension = "png", ---@type string | fun(): string
+        file_name = "%Y-%m-%d-%H-%M-%S", ---@type string | fun(): string
+        use_absolute_path = false, ---@type boolean | fun(): boolean
+        relative_to_current_file = false, ---@type boolean | fun(): boolean
 
         -- template options
-        template = "$FILE_PATH", ---@type string
-        url_encode_path = false, ---@type boolean
-        relative_template_path = true, ---@type boolean
-        use_cursor_in_template = true, ---@type boolean
-        insert_mode_after_paste = true, ---@type boolean
+        template = "$FILE_PATH", ---@type string | fun(context: table): string
+        url_encode_path = false, ---@type boolean | fun(): boolean
+        relative_template_path = true, ---@type boolean | fun(): boolean
+        use_cursor_in_template = true, ---@type boolean | fun(): boolean
+        insert_mode_after_paste = true, ---@type boolean | fun(): boolean
 
         -- prompt options
-        prompt_for_file_name = true, ---@type boolean
-        show_dir_path_in_prompt = false, ---@type boolean
+        prompt_for_file_name = true, ---@type boolean | fun(): boolean
+        show_dir_path_in_prompt = false, ---@type boolean | fun(): boolean
 
         -- base64 options
-        max_base64_size = 10, ---@type number
-        embed_image_as_base64 = false, ---@type boolean
+        max_base64_size = 10, ---@type number | fun(): number
+        embed_image_as_base64 = false, ---@type boolean | fun(): boolean
 
         -- image options
-        process_cmd = "", ---@type string
-        copy_images = false, ---@type boolean
-        download_images = true, ---@type boolean
+        process_cmd = "", ---@type string | fun(): string
+        copy_images = false, ---@type boolean | fun(): boolean
+        download_images = true, ---@type boolean | fun(): boolean
 
         -- drag and drop options
         drag_and_drop = {
-          enabled = true, ---@type boolean
-          insert_mode = false, ---@type boolean
+          enabled = true, ---@type boolean | fun(): boolean
+          insert_mode = false, ---@type boolean | fun(): boolean
         },
       },
 
       -- filetype specific options
       filetypes = {
         markdown = {
-          url_encode_path = true, ---@type boolean
-          template = "![$CURSOR]($FILE_PATH)", ---@type string
-          download_images = false, ---@type boolean
+          url_encode_path = true, ---@type boolean | fun(): boolean
+          template = "![$CURSOR]($FILE_PATH)", ---@type string | fun(context: table): string
+          download_images = false, ---@type boolean | fun(): boolean
         },
 
         vimwiki = {
-          url_encode_path = true, ---@type boolean
-          template = "![$CURSOR]($FILE_PATH)", ---@type string
-          download_images = false, ---@type boolean
+          url_encode_path = true, ---@type boolean | fun(): boolean
+          template = "![$CURSOR]($FILE_PATH)", ---@type string | fun(context: table): string
+          download_images = false, ---@type boolean | fun(): boolean
         },
 
         html = {
-          template = '<img src="$FILE_PATH" alt="$CURSOR">', ---@type string
+          template = '<img src="$FILE_PATH" alt="$CURSOR">', ---@type string | fun(context: table): string
         },
 
         tex = {
-          relative_template_path = false, ---@type boolean
+          relative_template_path = false, ---@type boolean | fun(): boolean
           template = [[
     \begin{figure}[h]
       \centering
       \includegraphics[width=0.8\textwidth]{$FILE_PATH}
       \caption{$CURSOR}
       \label{fig:$LABEL}
     \end{figure}
-        ]], ---@type string
+        ]], ---@type string | fun(context: table): string
         },
 
         typst = {
@@ -181,19 +181,19 @@ below:
       image("$FILE_PATH", width: 80%),
       caption: [$CURSOR],
     ) <fig-$LABEL>
-        ]], ---@type string
+        ]], ---@type string | fun(context: table): string
         },
 
         rst = {
           template = [[
     .. image:: $FILE_PATH
        :alt: $CURSOR
        :width: 80%
-        ]], ---@type string
+        ]], ---@type string | fun(context: table): string
         },
 
         asciidoc = {
-          template = 'image::$FILE_PATH[width=80%, alt="$CURSOR"]', ---@type string
+          template = 'image::$FILE_PATH[width=80%, alt="$CURSOR"]', ---@type string | fun(context: table): string
         },
 
         org = {
@@ -203,14 +203,14 @@ below:
     #+CAPTION: $CURSOR
     #+NAME: fig:$LABEL
     #+END_FIGURE
-        ]=], ---@type string
+        ]=], ---@type string | fun(context: table): string
         },
       },
 
       -- file, directory, and custom triggered options
-      files = {}, ---@type table
-      dirs = {}, ---@type table
-      custom = {}, ---@type table
+      files = {}, ---@type table | fun(): table
+      dirs = {}, ---@type table | fun(): table
+      custom = {}, ---@type table | fun(): table
     }
 <
 
@@ -428,7 +428,7 @@ The drag and drop feature enables users to drag images from the web browser or
 file explorer into the terminal to automatically embed them, in normal mode.
 Drag and drop can also be enabled in insert mode by setting the
 `drag_and_drop.insert_mode` option to `true`. For drag and drop to work
-properly, the following is required by the terminal emulator:
+properly, the terminal emulator must meet the following requirements:
 
 1. The terminal emulator must paste the file path or URL to the image when it is dropped into the terminal.
 2. The text must be inserted in bracketed paste mode <https://cirw.in/blog/bracketed-paste>, which allows Neovim to differentiate pasted text from typed-in text.