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 method empty
An empty list of arguments in a method call. Insertion delimiter should be empty.
3. Argument list: Actual method multi line
A multi line list of arguments in a method call. Insertion delimiter should include new line.
4. Argument list: Actual method single line
A single line list of arguments in a method call
5. Argument list: Actual multi line
A multi line list of arguments in a function call. Insertion delimiter should include new line.
6. Argument list: Actual single line
A single line list of arguments in a function call
7. Argument list: Formal empty
An empty list of parameters in a function declaration. Insertion delimiter should be empty.
8. Argument list: Formal multi line
A multi line list of parameters in a function declaration. Insertion delimiter should include new line.
9. Argument list: Formal single line
A single line list of parameters in a function declaration
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 method (iteration)
Iteration scope for arguments in a method call: the argument list. The domain should be the entire method call.
3. Argument: Actual method multi line
A multi line argument in a method call. Insertion delimiter should include new line.
4. Argument: Actual method single line
A single line argument in a method call
5. Argument: Actual multi line
A multiline argument in a function call. Insertion delimiter should include new line.
6. Argument: Actual single line
A single line argument in a function call
7. Argument: Formal (iteration)
Iteration scope for formal parameters in a function declaration: the parameters list. The domain should be the entire function.
8. Argument: Formal multi line
A multi line parameter in a function declaration. Insertion delimiter should include new line.
9. Argument: Formal single line
A single line parameter in a function declaration
Branch
1. Branch: If
An if branch
2. Branch: If (iteration)
Iteration scope for if/elif/else branches: the if-else statement.
3. Branch: If elif else
An if-elif-else branch. The removal range for the if branch should include the trailing `else` keyword.
4. Branch: If else
An if-else branch
5. Branch: Switch case
A case/default branch in a switch statement
6. Branch: Switch case (iteration)
Iteration scope for switch branches: the switch statement body.
7. Branch: Ternary
A branch in a ternary expression
8. Branch: Ternary (iteration)
Iteration scope for ternary expression branches: the ternary expression.
Class
1. Class
A class in an object-oriented language
2. Class (iteration document)
Iteration scope for classes: the entire document including leading and trailing empty lines.
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
Comment
1. Comment: Block
A block comment
2. Comment: Line
A line comment
Condition
1. Condition: Do while
A condition in a do while loop
2. Condition: For
A condition in a for loop
3. Condition: If
A condition in an if statement
4. Condition: Switch case
A condition in a switch statement
5. Condition: Switch case (iteration)
Iteration scope for conditions in a switch statement: the switch statement body.
6. Condition: Ternary
A condition in a ternary expression
7. Condition: While
A condition in a while loop
Function call
1. Function call
A function call
Function callee
1. Function callee
The function being called in a function call
If statement
1. If statement
An if statement
Interior
1. Interior: Class
The body of a class
2. Interior: Do while
The body of a do-while loop
3. Interior: Enum
The body of an enum
4. Interior: For
The body of a for loop
5. Interior: Function
The body of a function declaration
6. Interior: If
The body of an if/elif/else branch
7. Interior: Switch
The body of a switch statement
8. Interior: Switch case
The body of a switch case branch
9. Interior: Ternary
The body of a ternary condition/branch
10. Interior: While
The body of a while loop
List
1. List
A list/array
Name
1. Name (iteration block)
Iteration scope for names: statement blocks (body of functions/if-statements/for-loops/etc).
2. Name (iteration class)
Iteration scope for names: class bodies.
3. Name (iteration document)
Iteration scope for names: the entire document including leading and trailing empty lines.
4. Name (iteration enum)
Iteration scope for names: enum bodies.
5. Name: Argument formal
Name of a parameter in a function declaration
6. Name: Argument formal (iteration)
Iteration scope for names of formal parameters in a function declaration: the parameters list. The domain should be the entire function.
7. Name: Assignment
Name (LHS) of an assignment
8. Name: Class
Name of a class
9. Name: Enum
Name of an enum
10. Name: Field class
Name (LHS) of a field in a class
11. Name: Field enum
Name (LHS) of a field in an enum
12. Name: Function
Name of a function
13. Name: Variable
Name (LHS) of a variable declaration
Named function
1. Named function
A named function declaration
2. Named function (iteration document)
Iteration scope for named functions: the entire document including leading and trailing empty lines.
Statement
1. Statement
A statement, eg assignment, for loop, etc
2. Statement (iteration block)
Iteration scope for statements: statement blocks (body of functions/if-statements/for-loops/etc).
3. Statement (iteration class)
Iteration scope for statements: class bodies.
4. Statement (iteration document)
Iteration scope for statements: the entire document including leading and trailing empty lines.
5. Statement: Class
A class declaration
6. Statement: Enum
An enum declaration
7. Statement: Field class
A field declaration in a class
String
1. String: Single line
A single-line string
Type
1. Type (iteration block)
Iteration scope for types: statement blocks (body of functions/if-statements/for-loops/etc).
2. Type (iteration class)
Iteration scope for types: class bodies.
3. Type (iteration document)
Iteration scope for types: the entire document including leading and trailing empty lines.
4. Type: Argument formal
Type of formal parameter in a function declaration
5. Type: Argument formal (iteration)
Iteration scope for types of formal parameters in a function declaration: the parameters list. The domain should be the entire function.
6. Type: Cast
A type cast
7. Type: Class
A class declaration
8. Type: Enum
An enum declaration
9. Type: Field class
Type of field in a class
10. Type: Return
Type of return value in a function declaration
11. Type: Variable
Type of variable in a variable declaration
Value
1. Value (iteration block)
Iteration scope for values: statement blocks (body of functions/if-statements/for-loops/etc).
2. Value (iteration class)
Iteration scope for values: class bodies.
3. Value (iteration document)
Iteration scope for values: the entire document including leading and trailing empty lines.
4. Value (iteration enum)
Iteration scope for values: enum bodies.
5. Value: Assignment
Value (RHS) of an assignment
6. Value: Field enum
Value (RHS) of a field in an enum
7. Value: Return
Return value of a function
8. Value: Switch
The value / subject of a switch statement
9. Value: Variable
Value (RHS) of a variable declaration
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