Lazy state: Maybe remove $
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 21
- Forks
- 23
- Avg merge
- 1d 22h
- Merged PRs (30d)
- 17
Description
Lazy state is proving a bit hard for people (even people on the team) to understand
The story for new users is:
Use
$to access state
Cool, but then they open up a callback and it breaks. So now the rule is:
Use
$to access state, unless in a callback
Which I suppose isn't too bad, but does require a certain mindfulness.
Why don't we drop $ entirely and just treat state as a special entity in the compiler? All the rules we apply to $ now just apply to the special variable state. Which means: if we see state passed into an operation at the top level, we wrap it up in a lazy function.
Reasons for:
- This is so much easier for users. State Just Works all the time now
- We barely even need to document this stuff
Reasons against:
- I have a natural, philosophic aversion to special variables
- Inside a callback you still need to remember to declare the state parameter (I suppose we could automate this in the compiler?)
- We are hiding magic away but magic is still happening. Isn't that bad? One thing I've tried to do in v2 is remove magic, to make things more transparent (which doesn't necessarily mean simpler). Maybe users really do need to understand how lazy state works?
- Declaring state at the top of your code will cause problems, ie,
const state = {}. But that's true anyway, and why would you do that? We could even compiler warn against this
I'm warming to the idea that we go ahead and do this. I think we do still need to document something about what's happening, especially if users look at their compiled code. But it would be heavy advanced stuff.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the compiler’s current handling of $ at the top level and inside callbacks. Evaluate treating state as the special entity, including callback parameters and declarations such as const state = {}, then define the expected compiled behavior and any advanced documentation needed.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- typescript
- Domain
- compilers
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100