rescript-lang / rescript-lang/experimental-rescript-webapi
Simplify package module/type structure
オープン
@jderochervlk がすでに取り組んでいます。
2026年4月18日 から。
- 主要言語
- ReScript
- スター
- 40
- フォーク
- 11
- 平均マージ
- 3日 12時間
- マージ済み PR(30日)
- 12
説明
Summary
Pre-alpha breaking cleanup to simplify the package structure and make the public surface more consistent.
This issue tracks the refactor to:
- rename root
*APItype-holder modules to*Types - keep the existing folder structure for concrete modules
- export the primary concrete type as
t - selectively re-export additional public helper types from the concrete module that uses them
- remove unrelated
openusage - remove trivial primitive aliases like
string,bool,unit, and low-value callback aliases where they do not add meaning - remove
windowandnavigatorfromGlobalwithout deletingGlobal - shift access toward owner modules such as
Window,Navigator,History,Storage,Performance, and similar modules - avoid introducing any new
includedirectives as part of the simplification
Out Of Scope
- contributor docs
- code-generation conventions
- deleting
Global - flattening the folder structure
Execution Order
- #239 must land first
- #238, #240, #241, and #243 can run in parallel after #239
- #242 is the final integration pass
Linked Issues
- #239 Shared groundwork for package simplification
- #238 Simplify DOM, event, and observer module surfaces
- #240 Simplify fetch, file, canvas, URL, and socket module surfaces
- #241 Move runtime capability access away from Global window and navigator
- #243 Simplify media and device module surfaces
- #242 Final integration for package simplification
Acceptance Criteria
- No root
src/*API.restype-holder files remain; they are replaced bysrc/*Types.res. - The existing folder structure remains in place.
- Each concrete module exports its main type as
t. - Concrete modules selectively re-export secondary public types only where justified.
- Unrelated
openusage is removed. - No new
includedirectives are introduced by this refactor. - Trivial primitive aliases are removed instead of being renamed or moved.
Global.windowandGlobal.navigatorare removed.- Source and tests stop depending on
Global.windowandGlobal.navigator. - The package passes
npm run buildandnpm testafter integration.
コントリビューションガイド
このリポジトリのコントリビューションガイドは索引されていません
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
評価
この issue はまだ評価されていません。