frostney / frostney/GocciaScript

Support do expressions

Open
#1,005 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

engine new feature spec compliance
Dominant language
Pascal
Stars
20
Forks
3
Avg merge
3d 4h
Merged PRs (30d)
45

Description

Summary

Implement the Stage 1 TC39 proposal: https://github.com/tc39/proposal-do-expressions

Parse and compile do expressions with proposal-correct completion values, lexical scope, precedence, and abrupt completion.

Why

This proposal fits GocciaScript's modern ECMAScript surface and the 0.13.0 proposal roadmap. It should extend the engine's existing architecture rather than arrive as a userland shim.

Current behavior

Blocks cannot currently produce a value in expression position.

Expected behavior

Parse and compile do expressions with proposal-correct completion values, lexical scope, precedence, and abrupt completion.

Scope notes

Target the bytecode-first architecture after #875, or preserve temporary parity if the tree walker remains. Cover empty/nested blocks, closures, and control-flow early errors. Previously-invalid additive syntax: no flag.

Related bytecode roadmap: #871 and #875. Update the relevant language/built-in documentation and Goccia proposal inventory. Use the proposal repository and its current specification at implementation time; add focused project tests and matching pinned Test262/proposal coverage without regressions.

Acceptance criteria

  • Parser/API surface, descriptors, evaluation order, errors, and observable protocol behavior match the current proposal.
  • Implementation uses the identified shared engine seam without a duplicate compatibility shim.
  • Focused positive, negative, abrupt-completion, and edge-case tests cover the proposal.
  • Relevant project suites, pinned Test262 cases, formatting, and documentation checks pass.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the TC39 do-expressions proposal and the bytecode-first architecture referenced after #875; review related bytecode roadmap issues #871 and #875 before locating the shared engine seam. Done means proposal-correct parsing and compilation, focused positive, negative, abrupt-completion, and edge-case coverage, matching pinned Test262 or proposal tests, and updated documentation without regressions.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
compilers, documentation, testing-qa
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.