Files
ale/doc/ale-typescript.txt
w0rp 400857d758 Implement Lua ALE setup & overhaul documentation
1. Add ale.setup and ale.setup.buffer for pure Lua configuration.
2. Update many global settings to use Booleans instead of numbers to
   make types easiert to work with in Lua.
3. Radically reformat documentation and fix errors to make
   documentation more usable for Neovim users.
2025-03-27 12:40:11 +00:00

333 lines
13 KiB
Plaintext

===============================================================================
ALE TypeScript Integration *ale-typescript-options*
===============================================================================
biome *ale-typescript-biome*
*ale-options.biome_executable*
*g:ale_biome_executable*
*b:ale_biome_executable*
biome_executable
g:ale_biome_executable
Type: |String|
Default: `'biome'`
*ale-options.biome_options*
*g:ale_biome_options*
*b:ale_biome_options*
biome_options
g:ale_biome_options
Type: |String|
Default: `''`
This variable can be set to pass additional options to `biome check` when
applying fixes.
*ale-options.biome_use_global*
*g:ale_biome_use_global*
*b:ale_biome_use_global*
biome_use_global
g:ale_biome_use_global
Type: |Number|
Default: `get(g:, 'ale_use_global_executables', 0)`
See |ale-integrations-local-executables|
*ale-options.biome_fixer_apply_unsafe*
*g:ale_biome_fixer_apply_unsafe*
*b:ale_biome_fixer_apply_unsafe*
biome_fixer_apply_unsafe
g:ale_biome_fixer_apply_unsafe
Type: |Number|
Default: `0`
If set to `1`, biome will apply unsafe fixes along with safe fixes.
*ale-options.biome_lsp_project_root*
*g:ale_biome_lsp_project_root*
*b:ale_biome_lsp_project_root*
biome_lsp_project_root
g:ale_biome_lsp_project_root
Type: |String|
Default: `''`
If this variable is left unset, ALE will try to find the project root by
executing the following steps in the given order:
1. Find an ancestor directory containing a biome.json.
2. Find an ancestor directory containing a biome.jsonc.
3. Find an ancestor directory containing a package.json.
4. Find an ancestor directory containing a .git folder.
5. Use the directory of the current buffer (if the buffer was opened from
a file).
===============================================================================
cspell *ale-typescript-cspell*
See |ale-cspell-options|
===============================================================================
deno *ale-typescript-deno*
Starting from version 1.6.0, Deno comes with its own language server. Earlier
versions are not supported.
-------------------------------------------------------------------------------
Options
*ale-options.deno_executable*
*g:ale_deno_executable*
*b:ale_deno_executable*
deno_executable
g:ale_deno_executable
Type: |String|
Default: `'deno'`
*ale-options.deno_lsp_project_root*
*g:ale_deno_lsp_project_root*
*b:ale_deno_lsp_project_root*
deno_lsp_project_root
g:ale_deno_lsp_project_root
Type: |String|
Default: `''`
If this variable is left unset, ALE will try to find the project root by
executing the following steps in the given order:
1. Find an ancestor directory containing a tsconfig.json.
2. Find an ancestor directory containing a .git folder.
3. Use the directory of the current buffer (if the buffer was opened from
a file).
*ale-options.deno_unstable*
*g:ale_deno_unstable*
*b:ale_deno_unstable*
deno_unstable
g:ale_deno_unstable
Type: |Number|
Default: `0`
Enable or disable unstable Deno features and APIs.
*ale-options.deno_import_map*
*g:ale_deno_import_map*
*b:ale_deno_import_map*
deno_import_map
g:ale_deno_import_map
Type: |String|
Default: `'import_map.json'`
Specify the import map filename to load url maps in a deno project.
===============================================================================
dprint *ale-typescript-dprint*
See |ale-dprint-options| and https://dprint.dev/plugins/typescript
===============================================================================
eslint *ale-typescript-eslint*
Because of how TypeScript compiles code to JavaScript and how interrelated
the two languages are, the `eslint` linter for TypeScript uses the JavaScript
options for `eslint` too. See: |ale-javascript-eslint|.
===============================================================================
prettier *ale-typescript-prettier*
See |ale-javascript-prettier| for information about the available options.
===============================================================================
standard *ale-typescript-standard*
*ale-options.typescript_standard_executable*
*g:ale_typescript_standard_executable*
*b:ale_typescript_standard_executable*
typescript_standard_executable
g:ale_typescript_standard_executable
Type: |String|
Default: `'standard'`
See |ale-integrations-local-executables|
*ale-options.typescript_standard_options*
*g:ale_typescript_standard_options*
*b:ale_typescript_standard_options*
typescript_standard_options
g:ale_typescript_standard_options
Type: |String|
Default: `''`
This variable can be set to pass additional options to standard.
*ale-options.typescript_standard_use_global*
*g:ale_typescript_standard_use_global*
*b:ale_typescript_standard_use_global*
typescript_standard_use_global
g:ale_typescript_standard_use_global
Type: |Number|
Default: `get(g:, 'ale_use_global_executables', 0)`
See |ale-integrations-local-executables|
===============================================================================
tslint *ale-typescript-tslint*
This linter isn't recommended, because TSLint can't be used for checking for
problems while you type. You should probably use the tsserver plugin instead.
tsserver plugins are described here:
https://github.com/Microsoft/TypeScript/wiki/Writing-a-Language-Service-Plugin
Follow the instructions on the plugin website for installing it:
https://github.com/Microsoft/typescript-tslint-plugin
Then disable TSLint in your typescript ftplugin file. >
let b:ale_linters_ignore = ['tslint']
<
Or in Lua: >
require("ale").setup.buffer({linters_ignore={"tslint"}})
<
-------------------------------------------------------------------------------
Options
*ale-options.typescript_tslint_executable*
*g:ale_typescript_tslint_executable*
*b:ale_typescript_tslint_executable*
typescript_tslint_executable
g:ale_typescript_tslint_executable
Type: |String|
Default: `'tslint'`
See |ale-integrations-local-executables|
*ale-options.typescript_tslint_config_path*
*g:ale_typescript_tslint_config_path*
*b:ale_typescript_tslint_config_path*
typescript_tslint_config_path
g:ale_typescript_tslint_config_path
Type: |String|
Default: `''`
ALE will first discover the tslint.json path in an ancestor directory. If no
such path exists, this variable will be used instead.
*ale-options.typescript_tslint_ignore_empty_files*
*g:ale_typescript_tslint_ignore_empty_files*
*b:ale_typescript_tslint_ignore_empty_files*
typescript_tslint_ignore_empty_files
g:ale_typescript_tslint_ignore_empty_files
Type: |Number|
Default: `0`
When set to `1`, ALE will not report any problems for empty files with
TSLint. ALE will still execute TSLint for the files, but ignore any problems
reported. This stops ALE from complaining about newly created files,
and files where lines have been added and then removed.
*ale-options.typescript_tslint_rules_dir*
*g:ale_typescript_tslint_rules_dir*
*b:ale_typescript_tslint_rules_dir*
typescript_tslint_rules_dir
g:ale_typescript_tslint_rules_dir
Type: |String|
Default: `''`
If this variable is set, ALE will use it as the rules directory for tslint.
*ale-options.typescript_tslint_use_global*
*g:ale_typescript_tslint_use_global*
*b:ale_typescript_tslint_use_global*
typescript_tslint_use_global
g:ale_typescript_tslint_use_global
Type: |Number|
Default: `get(g:, 'ale_use_global_executables', 0)`
See |ale-integrations-local-executables|
===============================================================================
tsserver *ale-typescript-tsserver*
*ale-options.typescript_tsserver_executable*
*g:ale_typescript_tsserver_executable*
*b:ale_typescript_tsserver_executable*
typescript_tsserver_executable
g:ale_typescript_tsserver_executable
Type: |String|
Default: `'tsserver'`
ALE will first discover the tsserver path in an ancestor node_modules
directory. If no such path exists, this variable will be used instead.
If you wish to use only a globally installed version of tsserver, set
|g:ale_typescript_tsserver_use_global| to `1`.
*ale-options.typescript_tsserver_config_path*
*g:ale_typescript_tsserver_config_path*
*b:ale_typescript_tsserver_config_path*
typescript_tsserver_config_path
g:ale_typescript_tsserver_config_path
Type: |String|
Default: `''`
ALE will first discover the tsserver.json path in an ancestor directory. If
no such path exists, this variable will be used instead.
*ale-options.typescript_tsserver_use_global*
*g:ale_typescript_tsserver_use_global*
*b:ale_typescript_tsserver_use_global*
typescript_tsserver_use_global
g:ale_typescript_tsserver_use_global
Type: |Number|
Default: `get(g:, 'ale_use_global_executables', 0)`
This variable controls whether or not ALE will search for a local path for
tsserver first. If this variable is set to `1`, then ALE will always use the
global version of tsserver, in preference to locally installed versions of
tsserver in node_modules.
===============================================================================
xo *ale-typescript-xo*
*ale-options.typescript_xo_executable*
*g:ale_typescript_xo_executable*
*b:ale_typescript_xo_executable*
typescript_xo_executable
g:ale_typescript_xo_executable
Type: |String|
Default: `'xo'`
See |ale-integrations-local-executables|
*ale-options.typescript_xo_options*
*g:ale_typescript_xo_options*
*b:ale_typescript_xo_options*
typescript_xo_options
g:ale_typescript_xo_options
Type: |String|
Default: `''`
This variable can be set to pass additional options to xo.
*ale-options.typescript_xo_use_global*
*g:ale_typescript_xo_use_global*
*b:ale_typescript_xo_use_global*
typescript_xo_use_global
g:ale_typescript_xo_use_global
Type: |Number|
Default: `get(g:, 'ale_use_global_executables', 0)`
See |ale-integrations-local-executables|
===============================================================================
vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl: