Merge branch 'master' into rescript-assoication-stuff

Author: fhammerschmidt

.gitattributes

@@ -1,2 +1,4 @@
 *.res linguist-language=ReScript
 *.resi linguist-language=ReScript
+
+/public/playground-bundles/**  binary linguist-vendored

.gitignore

@@ -7,6 +7,7 @@ public/blog/feed.xml
 
 node_modules/
 .next/
+out/
 index_data/*.json
 
 # Generated via test examples script
@@ -26,9 +27,13 @@ lib/
 .vercel
 
 src/**/*.mjs
-scripts/**/*.mjs
+scripts/gendocs.mjs
+scripts/generate_*.mjs
 
 # Generated via generate-llms script
 public/llms/manual/**/llm*.txt
 public/llms/react/**/llm*.txt
 pages/docs/**/**/llms.mdx
+
+public/playground-bundles/
+public/_redirects

.nowignore

@@ -1,8 +1,5 @@
-[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-v1.4%20adopted-ff69b4.svg)](CODE_OF_CONDUCT.md)
-
-<a href="https://simpleanalytics.com/rescript-lang.org?utm_source=rescript-lang.org&utm_content=badge" referrerpolicy="origin" target="_blank"><img src="https://simpleanalyticsbadge.com/rescript-lang.org?counter=true" loading="lazy" referrerpolicy="no-referrer" crossorigin="anonymous" /></a>
-
 # rescript-lang.org
+[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-v1.4%20adopted-ff69b4.svg)](CODE_OF_CONDUCT.md)
 
 This is the official documentation platform for the [ReScript](https://rescript-lang.org) programming language.
 

README.md

@@ -2,9 +2,30 @@
   "Overview": [
     "introduction",
     "installation",
-    "migrate-to-v11",
     "editor-plugins",
-    "try"
+    "llms"
+  ],
+  "Guides": [
+    "converting-from-js",
+    "editor-code-analysis",
+    "project-structure"
+  ],
+  "JavaScript Interop": [
+    "interop-cheatsheet",
+    "embed-raw-javascript",
+    "shared-data-types",
+    "external",
+    "bind-to-js-object",
+    "bind-to-js-function",
+    "import-from-export-to-js",
+    "bind-to-global-js-values",
+    "json",
+    "inlining-constants",
+    "use-illegal-identifier-names",
+    "generate-converters-accessors",
+    "browser-support-polyfills",
+    "libraries",
+    "typescript-integration"
   ],
   "Language Features": [
     "overview",
@@ -14,6 +35,7 @@
     "tuple",
     "record",
     "object",
+    "dict",
     "variant",
     "polymorphic-variant",
     "null-undefined-option",
@@ -35,27 +57,6 @@
     "reserved-keywords",
     "equality-comparison"
   ],
-  "Advanced Features": [
-    "extensible-variant",
-    "scoped-polymorphic-types"
-  ],
-  "JavaScript Interop": [
-    "interop-cheatsheet",
-    "embed-raw-javascript",
-    "shared-data-types",
-    "external",
-    "bind-to-js-object",
-    "bind-to-js-function",
-    "import-from-export-to-js",
-    "bind-to-global-js-values",
-    "json",
-    "inlining-constants",
-    "use-illegal-identifier-names",
-    "generate-converters-accessors",
-    "browser-support-polyfills",
-    "libraries",
-    "typescript-integration"
-  ],
   "Build System": [
     "build-overview",
     "build-configuration",
@@ -66,14 +67,8 @@
     "build-performance",
     "warning-numbers"
   ],
-  "Guides": [
-    "converting-from-js",
-    "editor-code-analysis"
-  ],
-  "Extra": [
-    "newcomer-examples",
-    "project-structure",
-    "faq",
-    "llms"
+  "Advanced Features": [
+    "extensible-variant",
+    "scoped-polymorphic-types"
   ]
 }

data/sidebar_manual_v1200.json

@@ -82,6 +82,28 @@ let somethingElse = null;
 
 Read more about the [`@as` decorator and variants](variant.md#valid-as-payloads).
 
+## Adding fixed argument values to external functions
+You can leverage the `@as` decorator to add fixed values for external function arguments. You then do not need to supply a value for that argument.
+
+<CodeTab labels={["ReScript", "JS Output"]}>
+
+```res
+@module("fs")
+external readFileSyncUtf8: (string, @as(json`{encoding: "utf8"}`) _) => string = "readFileSync"
+
+let contents = readFileSyncUtf8("./someFile.txt")
+```
+
+```js
+import * as Fs from "fs";
+
+let contents = Fs.readFileSync("./someFile.txt", {encoding: "utf8"});
+```
+
+</CodeTab>
+
+Read more about [fixed arguments in functions](bind-to-js-function.md#fixed-arguments).
+
 ### References
 
 * [Bind Using ReScript Record](/docs/manual/latest/bind-to-js-object#bind-using-rescript-record)

misc_docs/syntax/decorator_as.mdx

@@ -6,6 +6,8 @@ summary: "This is the `regular expression` extension point."
 category: "extensionpoints"
 ---
 
+> Deprecated in favor of native regular expression syntax in v12+
+
 `%re` is used to create JavaScript regular expressions.
 
 <CodeTab labels={["ReScript", "JS Output"]}>

misc_docs/syntax/extension_regular_expression.mdx

@@ -0,0 +1,51 @@
+---
+id: "dict"
+keywords: ["dict"]
+name: "dict"
+summary: "This is the `dict{}` syntax"
+category: "languageconstructs"
+---
+
+> Available in v12+
+
+The `dict{}` syntax is used to represent [dictionaries](dict.md). It's used both when creating dicts, and when pattern matching on dicts.
+
+### Example
+
+<CodeTab labels={["ReScript", "JS Output"]}>
+
+```res
+// Create a dict
+let d = dict{"A": 5, "B": 6, "C": 7}
+
+// Pattern match on the full dict
+let b = switch d {
+| dict{"B": b} => Some(b)
+| _ => None
+}
+
+// Destructure the dict
+let dict{"C": ?c} = d
+```
+
+```js
+let d = {
+  A: 5,
+  B: 6,
+  C: 7
+};
+
+let b = d.B;
+
+let b$1 = b !== undefined ? b : undefined;
+
+let c = d.C;
+```
+
+</CodeTab>
+
+### References
+
+* [Dictionaries](/docs/manual/latest/dict)
+
+

misc_docs/syntax/language_dict.mdx

@@ -0,0 +1,45 @@
+---
+id: "for"
+keywords: ["for", "loop"]
+name: "for loop"
+summary: "This is the `for` loop."
+category: "languageconstructs"
+---
+
+ReScript supports `for` loops. 
+
+For loops can iterate from a starting value up to (and including) the ending value via the `to` keyword, or in the opposite direction via the `downto` keyword.
+
+### Example
+
+<CodeTab labels={["ReScript", "JS Output"]}>
+
+```res
+// Using `to`
+for x in 1 to 3 {
+  Console.log(x)
+}
+
+// Using `downto`
+for y in 3 downto 1 {
+  Console.log(y)
+}
+```
+
+```js
+for(var x = 1; x <= 3; ++x){
+  console.log(x);
+}
+
+for(var y = 3; y >= 1; --y){
+  console.log(y);
+}
+```
+
+</CodeTab>
+
+
+### References
+
+* [For Loops](control-flow.md#for-loops)
+

misc_docs/syntax/language_for.mdx

@@ -0,0 +1,31 @@
+---
+id: "regular-expression-syntax"
+keywords: ["regular", "expression", "regex"]
+name: "/re/"
+summary: "This is the `regular expression` syntax."
+category: "languageconstructs"
+---
+
+> Available in v12+
+
+You write regular expressions in ReScript just like you do in JavaScript.
+
+<CodeTab labels={["ReScript", "JS Output"]}>
+
+```res
+let regex = /^hello/
+let result = regex->RegExp.test("hello world")
+```
+
+```js
+let regex = /^hello/;
+
+let result = regex.test("hello world");
+```
+
+</CodeTab>
+
+### References
+
+* [Regular Expressions](/docs/manual/latest/primitive-types#regular-expression)
+* [RegExp API](/docs/manual/latest/api/core/regexp)

misc_docs/syntax/language_regular_expression.mdx

@@ -0,0 +1,50 @@
+---
+id: "while"
+keywords: ["while", "loop"]
+name: "while loop"
+summary: "This is the `while` loop."
+category: "languageconstructs"
+---
+
+ReScript supports `while` loops. While loops execute its body code block while its condition is true. 
+
+ReScript does not have the `break` keyword, but you can easily break out of a while loop by using a mutable binding.
+
+### Example
+
+<CodeTab labels={["ReScript", "JS Output"]}>
+
+```res
+let break = ref(false)
+
+while !break.contents {
+  if Math.random() > 0.3 {
+    break := true
+  } else {
+    Console.log("Still running")
+  }
+}
+
+```
+
+```js
+let $$break = {
+  contents: false
+};
+
+while (!$$break.contents) {
+  if (Math.random() > 0.3) {
+    $$break.contents = true;
+  } else {
+    console.log("Still running");
+  }
+};
+```
+
+</CodeTab>
+
+
+### References
+
+* [While Loops](control-flow.md#while-loops)
+