Merge branch 'rescript-lang:master' into functors

Author: jderochervlk

.github/ISSUE_TEMPLATE/config.yml

@@ -1,19 +1,19 @@
 blank_issues_enabled: false
 contact_links:
   - name: 🚀 rescript-compiler
-    url: https://github.com/rescript-lang/rescript-compiler/issues
-    about: Please report problems about the ReScript compiler and build system here.
+    url: https://github.com/rescript-lang/rescript/issues
+    about: Please report problems about the ReScript compiler, build system and tools here.
   - name: 💻 rescript-vscode
     url: https://github.com/rescript-lang/rescript-vscode/issues
-    about: VSCode language support, LSP, tools
+    about: VSCode language support, LSP
   - name: 📦 create-rescript-app
     url: https://github.com/rescript-lang/create-rescript-app/issues
     about: ReScript's project generator
   - name: ⚛️ rescript-react
     url: https://github.com/rescript-lang/rescript-react/issues
     about: ReScript bindings to React.js
   - name: 🌐 rescript-core
-    url: https://github.com/rescript-association/rescript-core/issues
+    url: https://github.com/rescript-lang/rescript-core/issues
     about: New ReScript standard library
   - name: 💬 ReScript Forum
     url: https://forum.rescript-lang.org/

.github/workflows/pull-request.yml

@@ -4,10 +4,11 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
         with:
-          node-version: 14.x
+          node-version: 20
+          cache: npm
       - run: npm ci
       - run: npx rescript
       - run: npm test

.node-version

@@ -0,0 +1 @@
+22.11.0

CONTRIBUTING.md

@@ -6,8 +6,8 @@ Please make sure to check out our [Code of Conduct](CODE_OF_CONDUCT.md) and make
 
 ## Ways to contribute
 
-- Writing docs for the manual (Check for issues that are marked with a [`manual`](https://github.com/rescript-association/rescript-lang.org/issues?q=is%3Aissue+is%3Aopen+label%3A"manual") and [`help wanted`](https://github.com/rescript-association/rescript-lang.org/issues?q=is%3Aissue+is%3Aopen+label%3A"help+wanted") tag)
-- Joining in discussions on our [issue tracker](https://github.com/rescript-association/rescript-lang.org/issues)
+- Writing docs for the manual (Check for issues that are marked with a [`manual`](https://github.com/rescript-lang/rescript-lang.org/issues?q=is%3Aissue+is%3Aopen+label%3A"manual") and [`help wanted`](https://github.com/rescript-lang/rescript-lang.org/issues?q=is%3Aissue+is%3Aopen+label%3A"help+wanted") tag)
+- Joining in discussions on our [issue tracker](https://github.com/rescript-lang/rescript-lang.org/issues)
 - Give feedback for improvements (incomplete / missing docs, bad wording,
   search user experience / design, etc.)
 - Advanced: Help building platform features (design system, automatic testing, markdown parsing, etc.)
@@ -16,15 +16,15 @@ Please make sure to check out our [Code of Conduct](CODE_OF_CONDUCT.md) and make
 
 ### Find an issue
 
-Before you start any work or submit any PRs, make sure to check our [issue tracker](https://github.com/rescript-association/rescript-lang.org/issues) for any issues or discussions on the topic.
+Before you start any work or submit any PRs, make sure to check our [issue tracker](https://github.com/rescript-lang/rescript-lang.org/issues) for any issues or discussions on the topic.
 
 If you can't find any relevant issues, feel free to create a new one to start a discussion. We usually assign issues to a responsible person to prevent confusion and duplicate work, so always double check if an issue is currently being worked on, or talk to the current assignee to take over the task.
 
 **Always make sure to get feedback from the core maintainers before starting any work**
 
 The project follows very specific goals and tries to deliver the highest value with the least amount of resources. Please help us focus on the tasks at hand and don't submit any code / bigger refactorings without any proper discussion on the issue tracker. Otherwise your PR might not be accepted!
 
-If you need inspiration on what to work on, you can check out issues tagged with [`good first issue`](https://github.com/rescript-association/rescript-lang.org/issues?q=is%3Aissue+is%3Aopen+label%3A"good+first+issue") or [`help wanted`](https://github.com/rescript-association/rescript-lang.org/issues?q=is%3Aissue+is%3Aopen+label%3A"help+wanted").
+If you need inspiration on what to work on, you can check out issues tagged with [`good first issue`](https://github.com/rescript-lang/rescript-lang.org/issues?q=is%3Aissue+is%3Aopen+label%3A"good+first+issue") or [`help wanted`](https://github.com/rescript-lang/rescript-lang.org/issues?q=is%3Aissue+is%3Aopen+label%3A"help+wanted").
 
 ### Discuss an issue
 
@@ -44,7 +44,7 @@ We value your voluntary work, and of course it's fine to step back from a ticket
 
 ### Communication Channels
 
-- [Issue Tracker](https://github.com/rescript-association/rescript-lang.org/issues)
+- [Issue Tracker](https://github.com/rescript-lang/rescript-lang.org/issues)
 - [ReScript Discourse (General / mostly unrelated discussions)](http://forum.rescript-lang.org)
 
 ## Working on the rescript-lang.org

README.md

@@ -6,7 +6,7 @@
 
 This is the official documentation platform for the [ReScript](https://rescript-lang.org) programming language.
 
-**Please report any technical issues with ReScript to the [compiler repository](https://github.com/rescript-lang/rescript-compiler).**
+**Please report any technical issues with ReScript to the [compiler repository](https://github.com/rescript-lang/rescript).**
 
 **In case you are missing some specific documentation:**
 
@@ -16,8 +16,8 @@ This is the official documentation platform for the [ReScript](https://rescript-
 
 ## System Requirements
 
-- `node@16.x` or higher (for ES6 module compat)
-- `npm@7` or higher (package-lock v2)
+- `node@20` or higher
+- `npm@10` or higher
 
 ## Setup
 
@@ -28,10 +28,7 @@ npm i
 # Initial build
 npx rescript
 
-# Only needed for initial clone (or content H2 changes)
-npm run update-index
-
-# Build the index data
+# Build the index data. Only needed for initial clone (or content H2 changes)
 npm run update-index
 
 # In a new tab

_blogposts/2020-09-25-release-8-3.mdx

@@ -17,7 +17,7 @@ It's focused on type safety, performance and JS interop. It used to be called Bu
 npm i [email protected]
 ```
 
-The changes are listed [here](https://github.com/rescript-lang/rescript-compiler/blob/master/Changes.md#83), this is a large release,  and we will go through some highlighted changes.
+The changes are listed [here](https://github.com/rescript-lang/rescript/blob/master/Changes.md#83), this is a large release,  and we will go through some highlighted changes.
 
 
 
@@ -122,7 +122,7 @@ Now user can pick up their js file extension support per module format:
 
 ## More flexible filename support
 
-To have better integration with other [JS infrastructures](https://github.com/rescript-lang/rescript-compiler/issues/4624),
+To have better integration with other [JS infrastructures](https://github.com/rescript-lang/rescript/issues/4624),
 for example, Next.js/React Native, we allow file names like `404.res`,
 `Button.Android.res` so that it can just be picked up by those tools
 

_blogposts/2020-11-17-editor-support-custom-operators-and-more.mdx

@@ -8,7 +8,7 @@ description: |
   Update on what we're doing around the end of 2020 and early next year.
 ---
 
-import Video from "src/components/Video"
+import Video from "src/components/Video";
 
 ## Upcoming Improvements
 
@@ -28,7 +28,7 @@ Hongbo continues to improve the compiler experience in monorepo-like setups. Exp
 
 ## Docs
 
-Patrick is [rearranging the React documentation](https://github.com/rescript-association/rescript-lang.org/pull/96), and continues to improve the main documentation site with Cheng Lou.
+Patrick is [rearranging the React documentation](https://github.com/rescript-lang/rescript-lang.org/pull/96), and continues to improve the main documentation site with Cheng Lou.
 
 ## Syntax
 

_blogposts/2020-12-07-release-8-4.mdx

@@ -19,7 +19,7 @@ It's focused on type safety, performance and JS interop. It used to be called Bu
 npm i [email protected]
 ```
 
-The changes are listed [here](https://github.com/rescript-lang/rescript-compiler/blob/master/Changes.md#841).
+The changes are listed [here](https://github.com/rescript-lang/rescript/blob/master/Changes.md#841).
 
 We will go through some highlighted changes.
 
@@ -33,11 +33,10 @@ In this release, we fix the integrity of `bsb -make-world` which allows user to
 The fix is well implemented that people who don't do such modifications will not pay for it.
 
 This is one of the highest desired feature request based on the
-[user feedback](https://github.com/rescript-lang/rescript-compiler/issues/4361#issuecomment-739538789), so we will expand a bit here why it is tricky
-to implement it without compromising performance.
+[user feedback](https://github.com/rescript-lang/rescript/issues/4361#issuecomment-739538789), so we will expand a bit here why it is tricky to implement it without compromising performance.
 
 In ReScript compilation scheme, dependencies as packages are treated as a black box,
-changes of dependencies should be *transitive*. The is due to that we have cross module
+changes of dependencies should be _transitive_. The is due to that we have cross module
 optimizations and the binary interface itself is a hash of its dependencies.
 So for a package dependency chain: A -> B -> C, if A changes and B does not change, C still needs get rebuilt.
 Because the intermediate output of B may still change due to the change of A.
@@ -68,6 +67,6 @@ of such stale outptu, such stale `List.cmi` file will break the integrity of the
 In this release, we introduced a more robust algorithm that will always remove stale output before the build so
 that such integrity is not broken.
 
-Last but not the least, we continue improving the readability, debuggability of the [generated output](https://github.com/rescript-lang/rescript-compiler/pull/4858) : )
+Last but not the least, we continue improving the readability, debuggability of the [generated output](https://github.com/rescript-lang/rescript/pull/4858) : )
 
 Happy Hacking! -- Hongbo Zhang

_blogposts/2021-02-09-release-9-0.mdx

@@ -22,13 +22,13 @@ npm install [email protected]
 
 You can also try our new release in the [Online Playground](/try).
 
-In this post we will highlight the most notable changes. The full changelog for this release can be found [here](https://github.com/rescript-lang/rescript-compiler/blob/master/Changes.md#90).
+In this post we will highlight the most notable changes. The full changelog for this release can be found [here](https://github.com/rescript-lang/rescript/blob/master/Changes.md#90).
 
 ## Compiler Improvements
 
 ### New External Stdlib Configuration
 
-This is a long-awaited [feature request](https://github.com/rescript-lang/rescript-compiler/pull/2171).
+This is a long-awaited [feature request](https://github.com/rescript-lang/rescript/pull/2171).
 
 Our compiler comes with a set of stdlib modules (such as `Belt`, `Pervasives`, etc.) for core functionality. Compiled ReScript code relies on the JS runtime version of these stdlib modules.
 
@@ -47,7 +47,7 @@ We made a small [demo repo](https://github.com/bobzhang/zero-cost-rescript) and
 
 ### Improved Code Generation for Pattern Matching
 
-We fine-tuned our pattern matching engine to optimize the JS output even more. Here is an example of a pretty substantial optimization, based on [this issue](https://github.com/rescript-lang/rescript-compiler/issues/4924):
+We fine-tuned our pattern matching engine to optimize the JS output even more. Here is an example of a pretty substantial optimization, based on [this issue](https://github.com/rescript-lang/rescript/issues/4924):
 
 ```res
 type test =
@@ -87,7 +87,7 @@ function test(x) {
 
 As you can see, the 9.0 compiler removes all the unnecessary `typeof` checks!
 
-This is possible because our optimizer will try to analyze several predicates and get rid of redundant ones. More diffs can be found [here](https://github.com/rescript-lang/rescript-compiler/pull/4927/files?file-filters%5B%5D=.js).
+This is possible because our optimizer will try to analyze several predicates and get rid of redundant ones. More diffs can be found [here](https://github.com/rescript-lang/rescript/pull/4927/files?file-filters%5B%5D=.js).
 
 Another important improvement is that we fixed the pattern match offset issue, which lead to the consequence that magic numbers will not be generated for complex pattern matches anymore.
 

_blogposts/2021-03-03-rescript-association-rebranding.mdx

@@ -25,7 +25,7 @@ Founded in 2018, the ReScript Association provides a legal and financial foundat
 - [rescript-lang.org](https://rescript-lang.org).
 - [Community forum](https://forum.rescript-lang.org) & server.
 - ReScript related domains and [analytics data](https://simpleanalytics.com/rescript-lang.org).
-- [genType’s](https://github.com/rescript-association/genType) release automation.
+- [genType’s](https://github.com/rescript-lang/genType) release automation.
 - Help maintaining editor related tools such as [rescript-vscode](https://github.com/rescript-lang/rescript-vscode), [vim-rescript](https://github.com/rescript-lang/vim-rescript) and the underlying [editor-support](https://github.com/rescript-lang/rescript-editor-support).
 - Design & logo assets (together with our designer) for all of ReScript.
 - Helping out on upcoming [ocaml.org](https://ocaml.org) work.
@@ -48,6 +48,7 @@ High quality, long-term Open Source work doesn’t come from some good words and
 If your company relies on the ReScript platform for building commercial products, please consider supporting our efforts by [sending a donation](https://rescript-association.org/donate). It’s the best way to future proof your product’s foundation. Alternatively, you can sponsor individual members like [ryyppy](https://github.com/sponsors/ryyppy/) on GitHub Sponsors.
 
 We want to take this opportunity to thank our previous and active sponsors:
+
 - [Tezos Foundation](https://tezos.foundation) (2020-21)
 - [Ahrefs](https://ahrefs.com) (2019)
 - [OCaml Software Foundation](https://ocaml-sf.org) (2018-19)

_blogposts/2021-05-07-release-9-1.mdx

@@ -10,7 +10,7 @@ description: |
 
 ## Exciting Improvements in ReScript 9.1
 
-Our recent few releases of ReScript contains [lots of improvements](https://github.com/rescript-lang/rescript-compiler/blob/3134392a364b70c9c172aa6c1dbaa1ac6580265d/Changes.md#91), among which are a few standout features we'd like to further promote. Hope you're as excited as we are about these! It goes without saying, our [updated editor plugin](https://forum.rescript-lang.org/t/ann-rescript-vscode-1-1-1-released/1542/3) works with the new releases.
+Our recent few releases of ReScript contains [lots of improvements](https://github.com/rescript-lang/rescript/blob/3134392a364b70c9c172aa6c1dbaa1ac6580265d/Changes.md#91), among which are a few standout features we'd like to further promote. Hope you're as excited as we are about these! It goes without saying, our [updated editor plugin](https://forum.rescript-lang.org/t/ann-rescript-vscode-1-1-1-released/1542/3) works with the new releases.
 
 ### New NPM Package
 
@@ -159,6 +159,6 @@ let helloUnicode = (x) =>{
 
 ## Conclusion
 
-Don't miss our various other improvements in [our changelog](https://github.com/rescript-lang/rescript-compiler/blob/3134392a364b70c9c172aa6c1dbaa1ac6580265d/Changes.md#91). As always we try to keep our changes performant, lean and robust. We hope you'll enjoy these.
+Don't miss our various other improvements in [our changelog](https://github.com/rescript-lang/rescript/blob/3134392a364b70c9c172aa6c1dbaa1ac6580265d/Changes.md#91). As always we try to keep our changes performant, lean and robust. We hope you'll enjoy these.
 
 See you next time!

_blogposts/2021-06-25-roadmap-2021-and-new-landing-page.mdx

@@ -21,7 +21,7 @@ It has almost been a year since we originally [launched our new ReScript brand](
 - Accessible object system (no need for `Js.t`)
 - The release of our new `rescript` npm package and cli to replace `bs-platform`
 - Making every part of ReScript fully community owned
-- etc. 
+- etc.
 
 Stay tuned, this is just the beginning!
 
@@ -30,6 +30,7 @@ Stay tuned, this is just the beginning!
 We had some thorough discussions about the future of the project and outlined the most important milestones for the next upcoming releases.
 
 **Here's the gist:**
+
 - Two release channels: `stable` and `experimental`
 - More predictable release dates and better migration steps
 - Better communication and discussion for breaking changes
@@ -41,15 +42,18 @@ The detailed roadmap with all our planned changes (and definition of our release
 
 After several iterations, we are happy to announce our new [landing page](/).
 
-<Image src="/static/img/landing_page_figma.png" withShadow={true} caption="Figma design draft for the new landing page"/>
+<Image
+  src="/static/img/landing_page_figma.png"
+  withShadow={true}
+  caption="Figma design draft for the new landing page"
+/>
 
 This is an incredible milestone for the documentation, and will act as a foundation for some cool new future improvements, such as:
 
 - Highlighted Case Studies from production users such as Beop or Rohea
 - An interactive playground widget for the headline code examples
 - New starter templates and guides
 
-
-Furthermore, in case you are a **production user of ReScript** and you want to see your company logo highlighted on the landing page, please [open an issue](https://github.com/rescript-association/rescript-lang.org/issues) and let us know!
+Furthermore, in case you are a **production user of ReScript** and you want to see your company logo highlighted on the landing page, please [open an issue](https://github.com/rescript-lang/rescript-lang.org/issues) and let us know!
 
 Happy hacking.

_blogposts/2022-08-25-release-10-0-0.mdx

@@ -14,7 +14,7 @@ ReScript version 10 is available! Version 10 is a culmination of over a year's w
 npm install rescript@10
 ```
 
-All changes are listed [here](https://github.com/rescript-lang/rescript-compiler/blob/10.0_release/CHANGELOG.md). Let's take a tour of a few of the features we're extra excited about.
+All changes are listed [here](https://github.com/rescript-lang/rescript/blob/10.0_release/CHANGELOG.md). Let's take a tour of a few of the features we're extra excited about.
 
 ## Faster builds with native M1 support
 Users with M1 chips should see a notable speedup, as the new ReScript version has full native support for M1.
@@ -27,9 +27,9 @@ let str = "Σ"
 
 You can also pattern match on Unicode characters:
 ```res
-switch someCharacter { 
-  | 'Σ' => "what a fine Unicode char" 
-  | _ => "Unicode is fun" 
+switch someCharacter {
+  | 'Σ' => "what a fine Unicode char"
+  | _ => "Unicode is fun"
 }
 ```
 
@@ -79,7 +79,7 @@ Version 10 brings the building blocks needed for a number of exciting new featur
 
 ## Upgrade guide
 
-Please see the detailed [changelog](https://github.com/rescript-lang/rescript-compiler/blob/10.0_release/CHANGELOG.md) for a list of breaking changes.
+Please see the detailed [changelog](https://github.com/rescript-lang/rescript/blob/10.0_release/CHANGELOG.md) for a list of breaking changes.
 Each breaking change lists suggestions on how to upgrade your project.
 This can be out of your control in case of dependencies. In that case, please raise issues with the maintainers of those libraries.