Add `cursorless_create_destination` action to talon api

[pokey]

This came up during a pairing session. I wanted to do something like:

transform <user.cursorless_target>:
    old = user.cursorless_get_text(cursorless_target, 1)
    new = some_transformation(old)
    destination = user.cursorless_create_destination(cursorless_target)
    user.cursorless_insert(destination, new)

Notice I can't use our existing user.cursorless_insert out of the box because it expects a destination, so we need a way to make a destination from a target

Checklist

• [-] I have added tests
• [x] I have updated the docs and cheatsheet
• [x] I have not broken the cheatsheet

[pokey]

This still needs tests and docs, but I wanted to get your thoughts first @AndreasArvidsson

[AndreasArvidsson]

I wanted the same.

Couldn't insert just accept a destination or target instead? Is it really simpler with another action?

[pokey]

Oh that's an interesting idea. Slightly mixed feelings as it might cause people to conflate target and destination, but could be simpler. I don't have a strong feeling. Maybe let's discuss tomorrow?

[AndreasArvidsson]

Yup

[pokey]

update from meet-up:

• Add cursorless_create_destination(target: ListTarget | RangeTarget | PrimitiveTarget, insertion_mode: "before"|"after"|"to" = "to") -> CursorlessDestination
• This will go into a file just for our public api; for now just include this but in the future move other functions there
• In the future, if it becomes annoying boilerplate, just automatically do conversion in cursorless_insert

[pokey]

ok @AndreasArvidsson this one is good to go

[pokey]

wait one sec i'll add release notes

[pokey]

ok good to go

[jaresty]

This rings a bell for me too. Great idea!

[pokey]

ok @AndreasArvidsson feedback addressed