+
+### Highlight regular expression syntax
+
+By default syntax inside regex literals is highlighted using
+[regex](https://github.com/tree-sitter/tree-sitter-regex) grammar. To disable
+this feature use:
+
+```emacs-lisp
+(setopt clojure-ts-use-regex-parser nil)
+```
+
+Example of regex syntax highlighting:
+
+
+
+### Navigation and Evaluation
+
+To make forms inside of `(comment ...)` forms appear as top-level forms for evaluation and navigation, set
+
+``` emacs-lisp
+(setopt clojure-ts-toplevel-inside-comment-form t)
+```
+
+### Fill paragraph
+
+To change the maximal line length used by `M-x prog-fill-reindent-defun` (also
+bound to `M-q` by default) to reformat docstrings and comments it's possible to
+customize `clojure-ts-fill-paragraph` variable (by default set to the value of
+Emacs' `fill-paragraph` value).
+
+Every new line in the docstrings is indented by
+`clojure-ts-docstring-fill-prefix-width` number of spaces (set to 2 by default
+which matches the `clojure-mode` settings).
+
+### imenu
+
+`clojure-ts-mode` supports various types of definition that can be navigated
+using `imenu`, such as:
+
+- namespace
+- function
+- macro
+- var
+- interface (forms such as `defprotocol`, `definterface` and `defmulti`)
+- class (forms such as `deftype`, `defrecord` and `defstruct`)
+- keyword (for example, spec definitions)
+
+### Integration with `outline-minor-mode`
+
+`clojure-ts-mode` supports two integration variants with
+`outline-minor-mode`. The default variant uses special top-level comments (level
+1 heading starts with three semicolons, level 2 heading starts with four,
+etc.). The other variant treats def-like forms (the same forms produced by the
+`imenu` command) as outline headings. To use the second option, use the
+following customization:
+
+```emacs-lisp
+(setopt clojure-ts-outline-variant 'imenu)
+```
+
+## Refactoring support
+
+### Threading macros related features
+
+There are a bunch of commands for threading and unwinding threaded Clojure forms:
+
+- `clojure-ts-thread`: Thread another form into the surrounding thread. Both
+`->>`/`some->>` and `->`/`some->` variants are supported.
+- `clojure-ts-unwind`: Unwind a threaded expression. Supports both `->>`/`some->>`
+and `->`/`some->`.
+- `clojure-ts-thread-first-all`: Introduce the thread first macro (`->`) and
+rewrite the entire form. With a prefix argument do not thread the last form.
+- `clojure-ts-thread-last-all`: Introduce the thread last macro and rewrite the
+entire form. With a prefix argument do not thread the last form.
+- `clojure-ts-unwind-all`: Fully unwind a threaded expression removing the
+threading macro.
+
+#### Customize threading refactoring behavior
+
+By default `clojure-ts-thread-first-all` and `clojure-ts-thread-last-all` will
+thread all nested expressions. For example this expression:
+
+```clojure
+(->map (assoc {} :key "value") :lock)
+```
+
+After executing `clojure-ts-thread-last-all` will be converted to:
+
+```clojure
+(-> {}
+ (assoc :key "value")
+ (->map :lock))
+```
+
+This behavior can be changed by setting:
+
+```emacs-lisp
+(setopt clojure-ts-thread-all-but-last t)
+```
+
+Then the last expression will not be threaded and the result will be:
+
+```clojure
+(-> (assoc {} :key "value")
+ (->map :lock))
+```
+
+### Cycling things
+
+- `clojure-ts-cycle-keyword-string`: Convert the string at point to a keyword and
+vice versa.
+- `clojure-ts-cycle-privacy`: Cycle privacy of `def`s or `defn`s. Use metadata
+explicitly with setting `clojure-ts-use-metadata-for-defn-privacy` to `t` for
+`defn`s too.
+- `clojure-ts-cycle-conditional`: Change a surrounding conditional form to its
+ negated counterpart, or vice versa (supports `if`/`if-not` and
+ `when`/`when-not`). For `if`/`if-not` also transposes the else and then
+ branches, keeping the semantics the same as before.
+- `clojure-ts-cycle-not`: Add or remove a `not` form around the current form.
+
+### Convert collection
+
+Convert any given collection at point to list, quoted list, map, vector or
+set. The following commands are available:
+
+- `clojure-ts-convert-collection-to-list`
+- `clojure-ts-convert-collection-to-quoted-list`
+- `clojure-ts-convert-collection-to-map`
+- `clojure-ts-convert-collection-to-vector`
+- `clojure-ts-convert-collection-to-set`
+
+### Add arity to a function or macro
+
+`clojure-ts-add-arity`: Add a new arity to an existing single-arity or
+multi-arity function or macro. Function can be defined using `defn`, `fn` or
+`defmethod` form. This command also supports functions defined inside forms like
+`letfn`, `defprotol`, `reify`, `extend-protocol` or `proxy`.
+
+### Default keybindings
+
+| Keybinding | Command |
+|:----------------------------|:-----------------------------------------------|
+| `C-:` | `clojure-ts-cycle-keyword-string` |
+| `C-c SPC` | `clojure-ts-align` |
+| `C-c C-r t` / `C-c C-r C-t` | `clojure-ts-thread` |
+| `C-c C-r u` / `C-c C-r C-u` | `clojure-ts-unwind` |
+| `C-c C-r f` / `C-c C-r C-f` | `clojure-ts-thread-first-all` |
+| `C-c C-r l` / `C-c C-r C-l` | `clojure-ts-thread-last-all` |
+| `C-c C-r p` / `C-c C-r C-p` | `clojure-ts-cycle-privacy` |
+| `C-c C-r (` / `C-c C-r C-(` | `clojure-ts-convert-collection-to-list` |
+| `C-c C-r '` / `C-c C-r C-'` | `clojure-ts-convert-collection-to-quoted-list` |
+| `C-c C-r {` / `C-c C-r C-{` | `clojure-ts-convert-collection-to-map` |
+| `C-c C-r [` / `C-c C-r C-[` | `clojure-ts-convert-collection-to-vector` |
+| `C-c C-r #` / `C-c C-r C-#` | `clojure-ts-convert-collection-to-set` |
+| `C-c C-r c` / `C-c C-r C-c` | `clojure-ts-cycle-conditional` |
+| `C-c C-r o` / `C-c C-r C-o` | `clojure-ts-cycle-not` |
+| `C-c C-r a` / `C-c C-r C-a` | `clojure-ts-add-arity` |
+
+### Customize refactoring commands prefix
+
+By default prefix for all refactoring commands is `C-c C-r`. It can be changed
+by customizing `clojure-ts-refactor-map-prefix` variable.
+
+## Code completion
+
+`clojure-ts-mode` provides basic code completion functionality. Completion only
+works for the current source buffer and includes completion of top-level
+definitions and local bindings. This feature can be turned off by setting:
+
+```emacs-lisp
+(setopt clojure-ts-completion-enabled nil)
+```
+
+Here's the short video illustrating the feature with Emacs's built-in completion UI (it
+should also work well with more advanced packages like `company` and `corfu`):
+
+https://github.com/user-attachments/assets/7c37179f-5a5d-424f-9bd6-9c8525f6b2f7
+
+## Migrating to clojure-ts-mode
+
+If you are migrating to `clojure-ts-mode` note that `clojure-mode` is still
+required for CIDER and `clj-refactor` packages to work properly.
+
+After installing the package do the following:
+
+- Check the value of `clojure-mode-hook` and copy all relevant hooks to `clojure-ts-mode-hook`.
+
+``` emacs-lisp
+(add-hook 'clojure-ts-mode-hook #'cider-mode)
+(add-hook 'clojure-ts-mode-hook #'enable-paredit-mode)
+(add-hook 'clojure-ts-mode-hook #'rainbow-delimiters-mode)
+(add-hook 'clojure-ts-mode-hook #'clj-refactor-mode)
+```
+
+- Update `.dir-locals.el` in all of your Clojure projects to activate directory
+ local variables in `clojure-ts-mode`.
+
+``` emacs-lisp
+((clojure-mode
+ (cider-clojure-cli-aliases . ":test:repl"))
+ (clojure-ts-mode
+ (cider-clojure-cli-aliases . ":test:repl")))
+```
+
+## Caveats
+
+As the Tree-sitter Emacs APIs are new and keep evolving there are some
+differences in the behavior of `clojure-ts-mode` on different Emacs versions.
+Here are some notable examples:
+
+- On Emacs 29 the parent mode is `prog-mode`, but on Emacs 30+ it's both `prog-mode`
+and `clojure-mode` (this is very helpful when dealing with `derived-mode-p` checks)
+- Navigation by sexp/lists might work differently on Emacs versions lower
+ than 31. Starting with version 31, Emacs uses Tree-sitter 'things' settings, if
+ available, to rebind some commands.
+- If you set `clojure-ts-extra-def-forms`, `clojure-ts-mode` will highlight the
+ specified forms, including their docstrings, in a manner similar to Clojure's
+ `defn`. However, Markdown syntax will not be highlighted within these custom
+ docstrings.
+
+## Frequently Asked Questions
+
+### What `clojure-mode` features are currently missing?
+
+As of version 0.5.x, `clojure-ts-mode` provides almost all `clojure-mode` features.
+Currently only a few refactoring commands are missing.
+
+### Does `clojure-ts-mode` work with CIDER?
+
+Yes! Preliminary support for `clojure-ts-mode` was released in [CIDER
+1.14](https://github.com/clojure-emacs/cider/releases/tag/v1.14.0). Note that
+`clojure-mode` is still needed for some APIs that haven't yet been ported to
+`clojure-ts-mode`.
+
+For now, when you take care of the keybindings for the CIDER commands you use
+and ensure `cider-mode` is enabled for `clojure-ts-mode` buffers in your config,
+most functionality should already work:
+
+```emacs-lisp
+(add-hook 'clojure-ts-mode-hook #'cider-mode)
+```
+
+Check out [this article](https://metaredux.com/posts/2024/02/19/cider-preliminary-support-for-clojure-ts-mode.html) for more details.
+
+> [!NOTE]
+>
+> The dynamic indentation feature in CIDER requires clojure-ts-mode 0.3+.
+
+### Does `clojure-ts-mode` work with `inf-clojure`?
+
+Yes, it does. `inf-clojure` 3.3+ supports `clojure-ts-mode`.
+
+### Why does `clojure-ts-mode` require Emacs 30?
+
+You might be wondering why does `clojure-ts-mode` require Emacs 30 instead of
+Emacs 29, which introduced the built-in Tree-sitter support. The answer is
+simple - the initial Tree-sitter support in Emacs 29 had quite a few issues and
+we felt it's better to nudge most people interested in using it to Emacs 30,
+which fixed a lot of the problems.
+
+## Contributing
+
+We welcome contributions of any kind!
+
+If you're not familiar with Tree-sitter, a good place to start is our
+[design documentation](doc/design.md), which explains how Tree-sitter
+works in Emacs in broad strokes and covers some of the design
+decisions we've made a long the way.
+
+We're using [Eldev](https://github.com/emacs-eldev/eldev) as our build tool, so you'll
+have to install it. We also provide a simple [Makefile](Makefile) with targets invoking Eldev. You
+only need to know a couple of them:
+
+```shell
+make lint
+
+make test
```
-OR you can move the `libtree-sitter-clojure.so`/`libtree-sitter-clojure.dylib` to a directory named `tree-sitter`
-under your `user-emacs-directory` (typically `~/.emacs.d` on Unix systems).
+The process of releasing a new version of `clojure-ts-mode` is documented [here](doc/release-process).
## License
-Copyright © 2022-2023 Danny Freeman and [contributors][].
+Copyright © 2022-2025 Danny Freeman, Bozhidar Batsov and [contributors][].
Distributed under the GNU General Public License; type C-h C-c to view it.
diff --git a/clojure-mode-tests/clojure-mode-convert-collection-test.el b/clojure-mode-tests/clojure-mode-convert-collection-test.el
new file mode 100644
index 0000000..14e5291
--- /dev/null
+++ b/clojure-mode-tests/clojure-mode-convert-collection-test.el
@@ -0,0 +1,82 @@
+;;; clojure-mode-convert-collection-test.el --- Clojure Mode: convert collection type -*- lexical-binding: t; -*-
+
+;; Copyright (C) 2016-2021 Benedek Fazekas Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies: