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.
Argument list
1. Argument list: Actual empty
An empty list of arguments in a function call. Insertion delimiter should be empty.
2. Argument list: Actual multi line
A multi line list of arguments in a function call. Insertion delimiter should include new line.
3. Argument list: Actual single line
A single line list of arguments in a function call
Argument or parameter
1. Argument: Actual (iteration)
Iteration scope for arguments in a function call: the argument list. The domain should be the entire function call.
2. Argument: Actual single line
A single line argument in a function call
Collection item
1. Collection item: Unenclosed
An item in a comma-separated list without enclosing delimiters. This could be multi-variable declarations, import statements, etc.
2. Collection item: Unenclosed (iteration)
Iteration scope for items in a comma-separated list without enclosing delimiters
Collection key
1. Key: Map pair
Key (LHS) of a key-value pair of a map
2. Key: Map pair (iteration)
Iteration scope for keys of key-value pairs in a map: should be between the braces.
Comment
1. Comment: Block
A block comment
Function call
1. Function call
A function call
Function callee
1. Function callee
The function being called in a function call
Map
1. Map
A map/dictionary
Name
1. Name (iteration block)
Iteration scope for names: statement blocks (body of functions/if-statements/for-loops/etc).
2. Name (iteration document)
Iteration scope for names: the entire document including leading and trailing empty lines.
Selector
1. Selector
A selector in a css rule set
Statement
1. Statement
A statement, eg assignment, for loop, etc
2. Statement (iteration document)
Iteration scope for statements: the entire document including leading and trailing empty lines.
String
1. String: Single line
A single-line string
Unit
1. Unit
A unit in a css rule set
Value
1. Value: Map pair
Value (RHS) of a key-value pair in a map
2. Value: Map pair (iteration)
Iteration scope for values of key-value pairs in a map: should be between the braces.
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
Used to disqualify a token from being treated as a surrounding pair delimiter. This will usually be operators containing `>` or `<`, eg `<`, `<=`, `->`, etc