Hacktoberfest 2026：維護者為十月標記出來的 issue，仍然開放、適合新手。 瀏覽 Hacktoberfest issue

Review of OCaml-derived language features

未關閉
  • 哪裡不對？
#9,074 0 則留言 0 個 reaction 已指派 0 人 在 GitHub 檢視

維護者通常 1 天內回覆

還沒有人認領這個 Issue。

評估

難度
5/5
預估耗時
一週以上
新手友好度
35/100
Issue 類型
缺陷
描述清晰度
基本清楚
活躍度
活躍
技術堆疊
ocaml
領域
compilers

研究方向

Start by reading the feature review and its test checklist in this issue, then inspect the linked test work in #9076 and the individual bug reports #9068–#9073 and #9095. The review checked runtime behavior, diagnostics, formatting, editor tooling and interface generation; tests should cover the listed language features, with regression tests added for each fix.

由索引模型根據 Issue 內容生成。

描述

ReScript inherited a number of language features from OCaml that most code never touches: GADTs, existential types, locally abstract types, polymorphic annotations, functors, recursive and first-class modules, extensible variants, private types, constraint, variance annotations, destructive substitution, module type of and #...t patterns. Several of them had little or no test coverage. This issue tracks a review of these features and the bugs it found.

Method
  • Usage: counted each feature in 21 public ReScript repositories (about 550k lines, including rescript-lang.org, rescript-relay, sury, rescript-nodejs and the two large Juspay apps), in the stdlib and in our test suites.
  • Behaviour: wrote small programs for each feature and checked what they do at run time, their error messages, the formatter, and editor hover, completion and interface generation.
Findings

Run-time behaviour was correct throughout, including GADTs with @as, @tag and @unboxed, existentials packed with first-class modules, and higher-order and generative functors. Every bug was in diagnostics, the formatter or the editor tooling.

Usage outside our own test fixtures:

Feature Use
GADTs, locally abstract types rare (rescript-urql, a few bindings)
Polymorphic annotations ('a.) used in sury
constraint rescript-nodejs (Stream, Net)
open! rescript-lang.org, rescript-pages, rescript-nodejs
module type of include module type of in a .resi (rescript-urql)
#...t patterns rescript-lang.org playground
User-defined open types none; only type exn +=
module rec, with type := / with module := none
Functors, first-class modules, private types, coercion common

None of these is a removal candidate. module rec and with type := / with module := have no uses in the corpus, but the corpus is mostly libraries and misses private application code. module rec is the only way to write mutually recursive modules. with type := / with module := amounts to a few branches in the type checker and parser, so removing it would save little. The remaining features are either used or depend on machinery that stays anyway (for example, exn is itself an open type).

Tests
  • Tests for GADTs, existentials, polymorphic fields, constraint, private and indexed extensible types, destructive substitution and typed first-class modules (#9076); each fix PR adds its own regression tests
Bugs
  • #9065
  • #9066
  • #9067
  • #9068
  • #9069
  • #9070
  • #9071
  • #9072
  • #9073
  • #9063 (reported separately)
  • #9095 (found while reviewing #9077)
Known limitations of the fixes
  • #9084: across files, Find References and rename don't connect a use of an applied functor's member (StrSet.add) to its declaration in the functor's file; within a file they do.
  • #9085: an extension declared inside a module whose signature hides it is still offered by completion.
  • #9083: a functor whose result is a module type identifier ((O: Ord): Set => …) hovers without its parameters.
Not bugs, noted
  • Refutation cases (| C => .) can't be written. This came up in #6987 together with empty variants; that issue was closed as stale without a decision.
  • exception X followed by a line starting with ( parses as exception X(...), the same newline sensitivity as f\n(a).
主要語言
OCaml
星號
7.5k
分支
484
平均合併
20 小時 19 分鐘
30 天內合併 PR
242

環境準備

在 Codespaces 中開啟

在瀏覽器裡用你自己的 GitHub 帳號啟動這個專案的開發容器。

從這裡開始

  1. 先讀完整個 Issue，再讀專案的貢獻指南。
  2. 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
  3. Fork 儲存庫，在一個分支上完成修改。
  4. 送出 Pull Request，並在描述裡引用這個 Issue 編號。

rescript-lang/rescript 的其他 Issue

查看 rescript-lang/rescript 的全部 Issue

相似的 Issue

更多 Compilers Issue

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。