Below are visualizations of all our scope tests for this language. These were created primarily for testing purposes rather than as documentation. There are quite a few, and they may feel a bit overwhelming from a documentation standpoint.
Scopes
Argument or parameter
1. Argument: Actual multi line
A multiline argument in a function call. Insertion delimiter should include new line.
2. Argument: Actual single line
A single line argument in a function call
3. Argument: Actual (iteration)
Iteration scope for arguments in a function call: the argument list. The domain should be the entire function call.
Collection item
1. Collection item: Unenclosed multi line
An item in a comma-separated multi line list without enclosing delimiters. This could be multi-variable declarations, import statements, etc. Insertion delimiter should include new line.
2. Collection item: Unenclosed (iteration)
Iteration scope for items in a comma-separated list without enclosing delimiters
Comment
1. Comment: Block
A block comment
2. Comment: Line
A line comment
Environment
1. Environment
An environment, eg in LaTeX
Function call
1. Function call
A function call
Function callee
1. Function callee
The function being called in a function call
List
1. List
A list/array
Section
1. Section
A document section
2. Section (iteration document)
Iteration scope for sections: the entire document including leading and trailing empty lines.
Xml both tags
1. Tags
Both tags in a xml element
Xml element
1. Element
A xml/html element. Also used for LaTeX environments
Xml end tag
1. End tag
The end tag of a xml element
Xml start tag
1. Start tag
The start tag of a xml element
Internal scopes
The following are internal scopes. They are not intended for user interaction or spoken use. These scopes exist solely for internal Cursorless functionality.
Disqualify delimiter
1. Disqualify delimiter
Internally used to disqualify a token from being treated as a surrounding pair delimiter. This will usually be operators containing `>` or `<`, eg `<`, `<=`, `->`, etc.
Interior
1. Interior: Element
The interior/children of a XML element
Text fragment
1. Text fragment: Comment block
Internally used text fragment consisting of a block comment
2. Text fragment: Comment line
Internally used text fragment consisting of a line comment
3. Text fragment: Element
Internally used text fragment consisting of a xml element interior