Dart

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

Content rangeRemoval rangeBlended rangesRender whitespace

Anonymous function

1. Anonymous function

An anonymous function, eg a lambda function, an arrow function, etc.

Argument list

1. Argument list: Actual constructor empty

An empty list of arguments in a constructor call. Insertion delimiter should be empty.

2. Argument list: Actual constructor multi line

A multi-line list of arguments in a constructor call. Insertion delimiter should include a newline.

3. Argument list: Actual constructor single line

A single-line list of arguments in a constructor call

4. Argument list: Actual empty

An empty list of arguments in a function call. Insertion delimiter should be empty.

5. Argument list: Actual enum empty

An empty list of arguments in an enum constructor call. Insertion delimiter should be empty.

6. Argument list: Actual enum multi line

A multi-line list of arguments in an enum constructor call. Insertion delimiter should include a newline.

7. Argument list: Actual enum single line

A single-line list of arguments in an enum constructor call

8. Argument list: Actual method empty

An empty list of arguments in a method call. Insertion delimiter should be empty.

9. Argument list: Actual method multi line

A multi-line list of arguments in a method call. Insertion delimiter should include a newline.

10. Argument list: Actual method single line

A single-line list of arguments in a method call

11. Argument list: Actual multi line

A multi-line list of arguments in a function call. Insertion delimiter should include a newline.

12. Argument list: Actual single line

A single-line list of arguments in a function call

13. Argument list: Formal constructor empty

An empty list of parameters in a constructor declaration. Insertion delimiter should be empty.

14. Argument list: Formal constructor multi line

A multi-line list of parameters in a constructor declaration. Insertion delimiter should include a newline.

15. Argument list: Formal constructor single line

A single-line list of parameters in a constructor declaration

16. Argument list: Formal empty

An empty list of parameters in a function declaration. Insertion delimiter should be empty.

17. Argument list: Formal lambda empty

An empty list of parameters in an anonymous function. Insertion delimiter should be empty.

18. Argument list: Formal lambda multi line

A multi-line list of parameters in an anonymous function. Insertion delimiter should include a newline.

19. Argument list: Formal lambda single line

A single-line list of parameters in an anonymous function

20. Argument list: Formal method empty

An empty list of parameters in a method declaration. Insertion delimiter should be empty.

21. Argument list: Formal method multi line

A multi-line list of parameters in a method declaration. Insertion delimiter should include a newline.

22. Argument list: Formal method single line

A single-line list of parameters in a method declaration

23. Argument list: Formal multi line

A multi-line list of parameters in a function declaration. Insertion delimiter should include a newline.

24. Argument list: Formal single line

A single-line list of parameters in a function declaration

Argument or parameter

1. Argument: Actual constructor multi line

A multi-line argument in a constructor call. Insertion delimiter should include a newline.

2. Argument: Actual constructor single line

A single-line argument in a constructor call

3. Argument: Actual enum multi line

A multi-line argument in an enum constructor call. Insertion delimiter should include a newline.

4. Argument: Actual enum single line

A single-line argument in an enum constructor call

5. Argument: Actual method multi line

A multi-line argument in a method call. Insertion delimiter should include a newline.

6. Argument: Actual method single line

A single-line argument in a method call

7. Argument: Actual multi line

A multi-line argument in a function call. Insertion delimiter should include a newline.

8. Argument: Actual single line

A single-line argument in a function call

9. Argument: Formal catch

A parameter in a catch clause

10. Argument: Formal constructor multi line

A multi-line parameter in a constructor declaration. Insertion delimiter should include a newline.

11. Argument: Formal constructor single line

A single-line parameter in a constructor declaration

12. Argument: Formal lambda multi line

A multi-line parameter in an anonymous function. Insertion delimiter should include a newline.

13. Argument: Formal lambda single line

A single-line parameter in an anonymous function

14. Argument: Formal method multi line

A multi-line parameter in a method declaration. Insertion delimiter should include a newline.

15. Argument: Formal method single line

A single-line parameter in a method declaration

16. Argument: Formal multi line

A multi-line parameter in a function declaration. Insertion delimiter should include a newline.

17. Argument: Formal single line

A single-line parameter in a function declaration

18. Argument: Actual (iteration)

Iteration scope for arguments in a function call: the argument list. The domain should be the entire function call.

19. Argument: Actual constructor (iteration)

Iteration scope for arguments in a constructor call: the argument list. The domain should be the entire constructor call..

20. Argument: Actual enum (iteration)

Iteration scope for arguments in an enum constructor call: the argument list. The domain should be the entire enum constructor call..

21. Argument: Actual method (iteration)

Iteration scope for arguments in a method call: the argument list. The domain should be the entire method call.

22. Argument: Formal (iteration)

Iteration scope for parameters in a function declaration: the parameter list. The domain should be the entire function.

23. Argument: Formal constructor (iteration)

Iteration scope for parameters in a constructor declaration: the parameter list. The domain should be the entire constructor.

24. Argument: Formal lambda (iteration)

Iteration scope for parameters in an anonymous function: the parameter list. The domain should be the entire anonymous function.

25. Argument: Formal method (iteration)

Iteration scope for parameters in a method declaration: the parameter list. The domain should be the entire method.

Branch

1. Branch: If

An if branch

2. Branch: If elif else

An if-elif-else branch. The removal range for the if branch should include the trailing else keyword.

3. Branch: If else

An if-else branch

4. Branch: Switch case

A case/default branch in a switch statement

5. Branch: Ternary

A branch in a ternary expression

6. Branch: Try

A try/catch/finally branch

7. Branch: If (iteration)

Iteration scope for if/elif/else branches: the if/elif/else statement.

8. Branch: Switch case (iteration)

Iteration scope for case/default branches in a switch statement: the switch statement body.

9. Branch: Ternary (iteration)

Iteration scope for ternary expression branches: the ternary expression.

10. Branch: Try (iteration)

Iteration scope for try/catch/finally branches: the try/catch/finally statement.

Class

1. Class

A class/struct declaration

2. Class (iteration document)

Iteration scope for classes: the entire document including leading and trailing empty lines.

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 a newline.

2. Collection item: Unenclosed single line

An item in a comma-separated single-line list without enclosing delimiters. This could be multi-variable declarations, import statements, etc.

3. 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 in 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

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: Ternary

A condition in a ternary expression

6. Condition: While

A condition in a while loop

7. Condition: Switch case (iteration)

Iteration scope for conditions in a switch statement: the switch statement body.

Function call

1. Function call

A function call

2. Function call: Chain

A chain of function calls, eg foo().bar()

3. Function call: Constructor

A constructor call

4. Function call: Enum

An enum constructor call

5. Function call: Generic

A function call with generic type arguments

6. Function call: Method

A method call

Function callee

1. Function callee

The function being called in a function call

2. Function callee: Chain

The function being called in a chain of function calls, including parent objects.

3. Function callee: Constructor

The class being constructed in a class instantiation, including the new keyword.

4. Function callee: Enum

The enum constructor being called

5. Function callee: Generic

The function being called in a function call with generic type arguments

6. Function callee: Method

The function being called in a method call, including parent objects.

If statement

1. If statement

An if statement

List

1. List

A list/array

Map

1. Map

A map/dictionary

Name

1. Name: Argument actual

Name of a (keyword) argument in a function call

2. Name: Argument catch

Name of a parameter in a catch clause

3. Name: Argument formal

Name of a parameter in a function declaration

4. Name: Argument formal constructor

Name of a parameter in a constructor declaration

5. Name: Argument formal lambda

Name of a parameter in an anonymous function

6. Name: Argument formal method

Name of a parameter in a method declaration

7. Name: Assignment

Name (LHS) of an assignment statement

8. Name: Assignment compound

Name (LHS) of a compound assignment statement, eg +=/-=

9. Name: Class

Name of a class/struct declaration

10. Name: Constant

Name (LHS) of a constant declaration

11. Name: Constructor

Name of a constructor declaration

12. Name: Enum

Name of an enum declaration

13. Name: Field class

Name (LHS) of a field declaration in a class/struct

14. Name: Field enum

Name (LHS) of a field declaration in an enum

15. Name: Foreach

Iteration variable name in a for-each loop

16. Name: Function

Name of a function declaration

17. Name: Method

Name of a method declaration

18. Name: Type alias

Name (LHS) of a type alias declaration

19. Name: Variable initialized

Name (LHS) of an initialized variable declaration

20. Name: Variable uninitialized

Name (LHS) of an uninitialized variable declaration

21. Name (iteration block)

Iteration scope for names: statement blocks (body of functions/if-statements/for-loops/etc).

22. Name (iteration class)

Iteration scope for names: class bodies.

23. Name (iteration document)

Iteration scope for names: the entire document including leading and trailing empty lines.

24. Name (iteration enum)

Iteration scope for names: enum bodies.

25. Name: Argument actual (iteration)

Iteration scope for names of (keyword) arguments in a function call: the argument list.

26. Name: Argument formal (iteration)

Iteration scope for names of parameters in a function declaration: the parameter list.

27. Name: Argument formal constructor (iteration)

Iteration scope for names of parameters in a constructor declaration: the parameter list.

28. Name: Argument formal lambda (iteration)

Iteration scope for names of parameters in an anonymous function: the parameter list.

29. Name: Argument formal method (iteration)

Iteration scope for names of parameters in a method declaration: the parameter list.

Named function

1. Named function

A named function declaration

2. Named function: Constructor

A constructor declaration

3. Named function: Method

A method declaration

4. Named function (iteration class)

Iteration scope for named functions: class bodies.

5. Named function (iteration document)

Iteration scope for named functions: the entire document including leading and trailing empty lines.

Statement

1. Statement: Assignment

An assignment statement

2. Statement: Assignment compound

A compound assignment statement, eg +=/-=

3. Statement: Break

A break statement

4. Statement: Class

A class/struct declaration

5. Statement: Constant

A constant declaration

6. Statement: Constructor

A constructor declaration

7. Statement: Continue

A continue statement

8. Statement: Do while

A do-while loop

9. Statement: Enum

An enum declaration

10. Statement: Field class

A field declaration in a class/struct

11. Statement: For

A for loop

12. Statement: Foreach

A for-each loop

13. Statement: Function

A named function declaration

14. Statement: Function call

A function call statement

15. Statement: If

An if/elif/else statement

16. Statement: Import

An import statement

17. Statement: Method

A method declaration

18. Statement: Return

A return statement

19. Statement: Switch

A switch statement

20. Statement: Throw

A throw statement

21. Statement: Try

A try/catch/finally statement

22. Statement: Type alias

A type alias declaration

23. Statement: Update

An update statement, eg ++/--

24. Statement: Variable initialized

An initialized variable declaration

25. Statement: Variable uninitialized

An uninitialized variable declaration

26. Statement: While

A while loop

27. Statement: Yield

A yield statement

28. Statement (iteration block)

Iteration scope for statements: statement blocks (body of functions/if-statements/for-loops/etc).

29. Statement (iteration class)

Iteration scope for statements: class bodies.

30. Statement (iteration document)

Iteration scope for statements: the entire document including leading and trailing empty lines.

Type

1. Type: Alias

A type alias declaration

2. Type: Argument catch

Type of a parameter in a catch clause

3. Type: Argument formal

Type of a parameter in a function declaration

4. Type: Argument formal constructor

Type of a parameter in a constructor declaration

5. Type: Argument formal lambda

Type of a parameter in an anonymous function

6. Type: Argument formal method

Type of a parameter in a method declaration

7. Type: Cast

A type cast

8. Type: Class

A class/struct declaration

9. Type: Constant

Type of a constant declaration

10. Type: Enum

An enum declaration

11. Type: Field class

Type of a field declaration in a class/struct

12. Type: Foreach

Type of a variable in a for-each loop

13. Type: Return

Type of a return value in a function declaration

14. Type: Return method

Type of a return value in a method declaration

15. Type: Type argument

Type argument to a generic / parametrized type

16. Type: Variable initialized

Type of an initialized variable declaration

17. Type: Variable uninitialized

Type of an uninitialized variable declaration

18. Type (iteration block)

Iteration scope for types: statement blocks (body of functions/if-statements/for-loops/etc).

19. Type (iteration class)

Iteration scope for types: class bodies.

20. Type (iteration document)

Iteration scope for types: the entire document including leading and trailing empty lines.

21. Type: Argument formal (iteration)

Iteration scope for types of parameters in a function declaration: the parameter list.

22. Type: Argument formal constructor (iteration)

Iteration scope for types of parameters in a constructor declaration: the parameter list.

23. Type: Argument formal lambda (iteration)

Iteration scope for types of parameters in an anonymous function: the parameter list.

24. Type: Argument formal method (iteration)

Iteration scope for types of parameters in a method declaration: the parameter list.

25. Type: Type argument (iteration)

Iteration scope for type arguments to a generic / parametrized type: the type argument list.

Value

1. Value: Argument actual

Value of a (keyword) argument in a function call

2. Value: Argument formal

Default value of a parameter in a function declaration

3. Value: Argument formal constructor

Default value of a parameter in a constructor declaration

4. Value: Argument formal lambda

Default value of a parameter in an anonymous function

5. Value: Argument formal method

Default value of a parameter in a method declaration

6. Value: Assignment

Value (RHS) of an assignment statement

7. Value: Assignment compound

Value (RHS) of a compound assignment statement, eg +=/-=

8. Value: Constant

Value (RHS) of a constant declaration

9. Value: Field class

Value (RHS) of a field declaration in a class/struct

10. Value: Foreach

Iterable in a for-each loop

11. Value: Map pair

Value (RHS) of a key-value pair in a map

12. Value: Return

Return value of a function

13. Value: Return lambda

Implicit return value of an anonymous function

14. Value: Switch

Value / subject of a switch statement

15. Value: Throw

Value of a throw statement

16. Value: Type alias

Type expression (RHS) of a type alias declaration

17. Value: Variable

Value (RHS) of a variable declaration

18. Value: Yield

Value of a yield statement

19. Value (iteration block)

Iteration scope for values: statement blocks (body of functions/if-statements/for-loops/etc).

20. Value (iteration class)

Iteration scope for values: class bodies.

21. Value (iteration document)

Iteration scope for values: the entire document including leading and trailing empty lines.

22. Value: Argument actual (iteration)

Iteration scope for values of (keyword) arguments in a function call: the argument list.

23. Value: Argument formal (iteration)

Iteration scope for default values of parameters in a function declaration: the parameter list.

24. Value: Argument formal constructor (iteration)

Iteration scope for default values of parameters in a constructor declaration: the parameter list.

25. Value: Argument formal lambda (iteration)

Iteration scope for default values of parameters in an anonymous function: the parameter list.

26. Value: Argument formal method (iteration)

Iteration scope for default values of parameters in a method declaration: the parameter list.

27. 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

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: Class

The body of a class/struct declaration

2. Interior: Constructor

The body of a constructor declaration

3. Interior: Do while

The body of a do-while loop

4. Interior: Enum

The body of an enum declaration

5. Interior: For

The body of a for loop

6. Interior: Foreach

The body of a for-each loop

7. Interior: Function

The body of a function declaration

8. Interior: If

The body of an if/elif/else branch

9. Interior: Lambda

The block body of an anonymous function

10. Interior: Method

The body of a method declaration

11. Interior: Switch

The body of a switch statement

12. Interior: Switch case

The body of a case/default branch in a switch statement

13. Interior: Try

The body of a try/catch/finally branch

14. Interior: While

The body of a while loop

String

1. String: Multi line

A multi-line string

2. String: Single line

A single-line string

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: String multi line

Internally used text fragment consisting of a multi-line string

4. Text fragment: String single line

Internally used text fragment consisting of a single-line string