KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #developer-tools #cli #codex #claude-code #react #dsh-plugin #mcp #open-source #dsh #deepseek-harness

cfmleditor

★ 33 Open GitHub ↗

An extension for Visual Studio Code to assist in development with CFML.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# CFML Editor

[![cfml](https://img.shields.io/badge/cfml-ide-blue.svg?logo=slack&labelColor=555555)](http://cfml-slack.net/)

[!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/garetheddies)

An extension for the development of CFML.

## Acknowledgements

- [`vscode-cfml`](https://github.com/vadim-sibiryanskiy-yumasoft/vscode-cfml) fork of the vscode-cfml project used as the base for this fork
- [`vscode-cfml`](https://github.com/KamasamaK/vscode-cfml) original vscode-cfml project
- [`vscode-coldfusion`](https://github.com/ilich/vscode-coldfusion/) on which the syntax highlighting is based, which was based on the next extension
- [`sublimetext-cfml`](https://github.com/jcberquist/sublimetext-cfml) as inspiration for some of the features. Some "parsing" logic (including regexes) was also used.
- [`cfdocs`](https://github.com/foundeo/cfdocs/) as the default documentation and sample images in this README
- [`lucee-docs`](https://github.com/lucee/lucee-docs) as an alternative source of documentation
- [`vscode-php-docblocker`](https://github.com/neild3r/vscode-php-docblocker) as the basis for docblock completion

## Features

1. **Syntax Highlighting**  
Using the default theme `Dark+`
![Syntax Highlighting](https://raw.githubusercontent.com/cfmleditor/cfmleditor/master/images/cfdocs_leaderboard.png)

1. **Signature Help**  
Automatically triggers within signature of a function or can be manually triggered. This currently does not work for member functions. It is sometimes unable to work within a string.  
Win/Linux: `Ctrl`+`Shift`+`Space`; Mac: `Cmd`+`Shift`+`Space`
![Signature Help](https://raw.githubusercontent.com/cfmleditor/cfmleditor/master/images/cfdocs_leaderboard_signature.png)

1. **Hover Documentation**  
Displays documentation for certain entities. Currently applicable to CFML global functions, CFML global tags/attributes, user-defined functions, HTML tags, and CSS properties. Does not always consider context, so for example it may also incorrectly trigger on SQL or JavaScript functions with the same name.  
Win/Linux: `Ctrl`+`K` `Ctrl`+`I`; Mac: `Cmd`+`K` `Cmd`+`I`
![Hover Documentation](https://raw.githubusercontent.com/cfmleditor/cfmleditor/master/images/cfdocs_leaderboard_hover.png)

1. **Document Symbols**  
Search CFML symbols within a document. Also used for outline and breadcrumbs.  
Win/Linux: `Ctrl`+`Shift`+`O`; Mac: `Cmd`+`Shift`+`O`
![Document Symbols](https://raw.githubusercontent.com/cfmleditor/cfmleditor/master/images/cfdocs_leaderboard_document-symbols.png)

1. **Workspace Symbols**  
Search symbols within the workspace. Limited to components and their function declarations.  
Win/Linux: `Ctrl`+`T`; Mac: `Cmd`+`T`
![Workspace Symbols](https://raw.githubusercontent.com/cfmleditor/cfmleditor/master/images/cfdocs_workspace-symbols.png)

1. **Completion Suggestions**  
Suggestions for global functions, global tags and attributes, enumerated values, user functions, keywords, scopes, component properties, variables, component dot-paths, docblocks, HTML tags and attributes, and CSS properties. Does not always consider context, so it may trigger inappropriately.  
Win/Linux: `Ctrl`+`Space`; Mac: `Cmd`+`Space`
![Completion Suggestions](https://raw.githubusercontent.com/cfmleditor/cfmleditor/master/images/cfdocs_leaderboard_completion.png)

1. **Definition**
Provides a link to the definition of a symbol. Currently only for object creation, function usage, function return types, argument types, property types, component extends, function arguments, function local variables, template variables, and application variables.  
_Go to Definition:_ Win/Linux: `F12`/`Ctrl`+click; Mac: `F12`  
_Peek Definition:_ Win/Linux: `Alt`+`F12` (`Ctrl`+hover provides a smaller, alternate peek); Mac: `Opt`+`F12`  
_Open Definition to the Side:_ Win/Linux: `Ctrl`+`K` `F12`  
![Peek Definition](https://raw.githubusercontent.com/cfmleditor/cfmleditor/master/images/cfdocs_definition-peek.png)

1. **Type Definition**
Provides a link to the definition of the type for a symbol. This only applies to user-defined types within the same workspace.  
_No default shortcuts_

## Settings

The following are configurable Settings (Win/Linux: `Ctrl`+`Comma`; Mac: `Cmd`+`Comma`).

### CFML

This extension contributes these settings to Visual Studio Code:

- `cfml.globalDefinitions.source`: The source of the global definitions. Currently only supports CFDocs. [_Default_: `cfdocs`]
- `cfml.cfDocs.source`: Indicates the source location type to be used for CFDocs.  
**Values**
  - `remote`: Retrieve resources remotely from GitHub. [_Default_]
  - `local`: Retrieve resources locally using `cfml.cfDocs.localPath`.
- `cfml.cfDocs.localPath`: [_Optional_] Physical path to the data/language directory of CFDocs.
- `cfml.hover.enable`: Whether hover is enabled for CFML entities. [_Default_: `true`]
- `cfml.hover.html.enable`: Whether hover is enabled for HTML entities. [_Default_: `true`]
- `cfml.hover.css.enable`: Whether hover is enabled for CSS entities. [_Default_: `true`]
- `cfml.signature.enable`: Whether signature help is enabled. [_Default_: `true`]
- `cfml.suggest.enable`: Whether completion help is enabled. [_Default_: `true`]
- `cfml.suggest.snippets.enable`: Whether included [snippets](./snippets/snippets.json) are part of completion help. [_Default_: `true`]
- `cfml.suggest.snippets.exclude`: [_Optional_] Set of snippet keys you would like excluded from suggestions.
- `cfml.suggest.globalFunctions.enable`: Whether global functions are part of completion help. [_Default_: `true`]
- `cfml.suggest.globalFunctions.firstLetterCase`: What case should be used for the first letter of global function suggestions. [_Default_: `unchanged`]
- `cfml.suggest.globalTags.enable`: Whether global tags are part of completion help. [_Default_: `true`]
- `cfml.suggest.globalTags.attributes.quoteType`: Which quote type to use when completing CFML attribute suggestion. [_Default_: `double`]
- `cfml.suggest.globalTags.attributes.defaultValue`: Whether to populate the default value for an attribute if it has one. [_Default_: `false`]
- `cfml.suggest.globalTags.includeAttributes.setType`: What set of attributes to include when global tag suggestion is selected. [_Default_: `none`]
- `cfml.suggest.globalTags.includeAttributes.custom`: A custom set of attributes to include for given tags when suggestion is selected. Tags set here override the set type.  
  **Example**
    ```json
    "cfml.suggest.globalTags.includeAttributes.custom": {
        "cfquery": [
            {
                "name": "name"
            },
            {
                "name": "datasource",
                "value": "dsn"
            }
        ]
    }
    ```
- `cfml.suggest.htmlTags.enable`: Whether HTML tags are part of completion help. [_Default_: `true`]
- `cfml.suggest.htmlTags.attributes.quoteType`: Which quote type to use when completing HTML attribute suggestion. [_Default_: `double`]
- `cfml.suggest.css.enable`: Whether CSS properties and values are part of completion help. [_Default_: `true`]
- `cfml.suggest.scopes.case`: Whether the completed scopes should be uppercase or lowercase. [_Default_: `lowercase`]
- `cfml.definition.enable`: Whether providing definitions is enabled. [_Default_: `true`]
- `cfml.definition.userFunctions.search.enable`: Whether to search for matching functions throughout the workspace when a reliable match cannot be determined. Peek Definition will provide a list of all matches. [_Default_: `false`]
- `cfml.indexComponents.enable`: Whether to index the components in workspace on startup. This is done on each startup and duration depends on number and complexity of components as well as hardware specifications. Editor may be unresponsive during this period. It is currently required for most features involving components to work properly. [_Default_: `true`]
- `cfml.autoCloseTags.enable`: Whether to enable auto-closing tags for CFML. [_Default_: `true`]
- `cfml.autoCloseTags.configurationTarget`: Auto-configuration target for auto-closing tags. [_Default_: `Global`]
- `cfml.docBlock.gap`: Whether there should be a gap between the hint and other tags in a docblock. [_Default_: `true`]
- `cfml.docBlock.extra`: Extra tags you would like to include in every docblock  
  **Example**
    ```json
    "cfml.docBlock.extra": [
        {
            "name": "output",
            "default": "false",
            "types": [
                "component",
                "function"
            ]
        }
    ]
    ```
- `cfml.engine.name`: Name of the CFML engine against which to filter.
- `cfml.engine.version`: Version of the CFML engine against which to filter. SemVer format is preferred.
- `cfml.mappings`: Represents CFML mappings from logicalPath to directoryPath.  
  **Examples**
    ```json
    "cfml.mappings": [
      {
        "logicalPath": "/model",
        "directoryPath": "C:\\myprojects\\projectname\\app\\model"
      }
    ]
    ```
    ```json
    "cfml.mappings": [
      {
        "logicalPath": "/model",
        "directoryPath": "/app/model",
        "isPhysicalDirectoryPath": false
      }
    ]
    ```

### Other

#### Emmet

You can enable Emmet within CFML files by using the following setting:

```json
"emmet.includeLanguages": {
  "cfml": "html"
}
```

## Commands

Used in [Command Palette](https://code.visualstudio.com/docs/getstarted/userinterface#_command-palette). Can also be bound to [Keyboard Shortcuts](https://code.visualstudio.com/docs/getstarted/keybindings).

- Refresh cache for global definitions
- Refresh cache for workspace definitions
- Toggle CFML line comment (Default: `Ctrl`+`/`)
- Toggle CFML block comment (Default: `Shift`+`Alt`+`A`)
- Open Application file for currently active document
- Go to Matching Tag
- Open CFDocs page
- Open CFML engine docs page
- Fold all functions in active editor

## Known Issues/Limitations

1. Initial indexing can be a lengthy process depending on how many components you have and your hardware specifications. During this time, some features will be unavailable and the editor may be sluggish.
2. There is partial embedded language support. You will get some HTML and CSS features, but no JS or SQL assistance within CFML files. You will still get syntax highlighting and you can use user snippets and Emmet to supplement somewhat.
3. An extension of the issue above is that as implemented there is only one language defined for CFML. This can cause a number of issues where functionality or settings are based on language ID. For example, with Emmet enabled, you will get the Emmet functionality throughout all CFML files and contexts.
4. Removing, moving, or renaming folders does not update the workspace definitions or symbols and will cause discrepancies with those resources. To rectify this, you may use the command to refresh workspace definitions at any time.
5. Completion suggestions are not always properly contextual.
6. The "parsing" is mostly done with regular expressions without considering context in most cases, which can result in occasional issues. One way this manifests is that you may get non-CFML being parsed as CFML. This can also result in strings and comments being parsed as if they were part of code. To simplify the expressions, semicolons are often expected as terminators in CFScript even though they are optional in some engines.
7. Type inference is extremely primitive and only based on variable initialization.
8. Using `<cfoutput>` within embedded languages (CSS and JavaScript) reverts the syntax tokenization to the base language which results in incorrect highlighting.

## Future Plans

If there is no ticket for it in the [Github issues](https://github.com/cfmleditor/cfmleditor/issues) its likely not on our radar. Submit a ticket if you want to discuss something for future development.

## Recommended Extensions

VS Code and this extension lack features and functionality that I find useful for development. Below are some supplemental extensions that I believe will improve the development experience for most.

- [cfmleditor-lint](https://marketplace.visualstudio.com/items?itemName=CFMLEditor.cfmleditor-lint) - Integrates CFLint into VS Code as diagnostics/problems.
- [highlight-matching-tag](https://marketplace.visualstudio.com/items?itemName=vincaslt.highlight-matching-tag) - This will highlight the relevant tags based on your configuration with a configurable style. There are also some useful commands.
- [Path Autocomplete](https://marketplace.visualstudio.com/items?itemName=ionutvmi.path-autocomplete) - Provides suggestions when entering file paths

## Release Notes

See [CHANGELOG.md](/CHANGELOG.md)

## Contributing

See [CONTRIBUTING.md](/CONTRIBUTING.md)

## Support

For questions or help, join the `#ide` channel in the [CFML Slack workspace](http://cfml-slack.net/ ) to talk with people about this or other editor tools. To file a bug or feature request, open a [GitHub issue](https://github.com/cfmleditor/cfmleditor/issues).

## Performance Tweaks

Performance may depend on lots of different factors and in a perfect world performance wouldn't be a problem, some of the following performance tweaks might reduce the feature set of CFMLEditor, but improve the general experience. Try these things one at a time to see if they provide an improvement for you.

You may have to restart your editor to see the benefits of these performance tweaks.

### Provide the most bang for buck

Thse provide best improvements for the least amount of feature loss, recommend starting with these.

- Disable Signature Help by unticking `Cfml > Signature: Enable` in the settings
- Setting a positive `Cfml > Definition > Lookahead: Max Length` value ( start with `1000` )
  - This can reduce the overhead when looking around based on the current cursor position. ( `-1` is the default, where the lookahead is unlimited )
- Setting a positive `Cfml > Definition > Lookbehind: Max Length` value ( start with `1000` )
  - This can reduce the overhead when looking around based on the current cursor position. ( `-1` is the default, where the lookbehind is unlimited )

### Good performance improvements but at a cost

These can provide good performance benefits but reduce the feature set significantly

- Disable `Cfml > Definition > User Functions > Search: Enable`
- Disable `Cfml > Index Components: Enable`
- Disable `Cfml › Definition: Enable`

### Experimental performance improvements

These are not recommended, so only try if everything else hasn't worked, these could make things worse.

- Disable `Cfml › Suggest: Replace Comments`

cfmleditor

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README