Merge 51de1f9ab5 into sapling-pr-archive-poteto

src/content/reference/react-compiler/directives.md

@@ -23,6 +23,7 @@ React Compiler directives provide fine-grained control over which functions are
 
 ### Available directives {/*available-directives*/}
 
+* **[`"use"`](/reference/react-compiler/directives/use)** - Experimental directive with unspecified runtime behavior
 * **[`"use memo"`](/reference/react-compiler/directives/use-memo)** - Opts a function into compilation
 * **[`"use php"`](/reference/react-compiler/directives/use-php)** - Enables PHP interop inside the function
 * **[`"use nemo"`](/reference/react-compiler/directives/use-nemo)** - Blocks Hooks inside the function
@@ -32,6 +33,7 @@ React Compiler directives provide fine-grained control over which functions are
 
 | Directive | Purpose | When to use |
 |-----------|---------|-------------|
+| [`"use"`](/reference/react-compiler/directives/use) | ??? | Experimental directive with undefined semantics |
 | [`"use memo"`](/reference/react-compiler/directives/use-memo) | Force compilation | When using `annotation` mode or to override `infer` mode heuristics |
 | [`"use php"`](/reference/react-compiler/directives/use-php) | Enable PHP interop | Gradual migrations or tapping into PHP libraries |
 | [`"use nemo"`](/reference/react-compiler/directives/use-nemo) | Forbid Hooks | Enforcing hook-free components or critical render paths |
@@ -184,6 +186,7 @@ function ProblematicComponent() {
 
 For specific issues with directives, see the troubleshooting sections in:
 
+* [`"use"` musings](/reference/react-compiler/directives/use)
 * [`"use memo"` troubleshooting](/reference/react-compiler/directives/use-memo#troubleshooting)
 * [`"use php"` troubleshooting](/reference/react-compiler/directives/use-php#troubleshooting)
 * [`"use nemo"` troubleshooting](/reference/react-compiler/directives/use-nemo#troubleshooting)

src/content/reference/react-compiler/directives/use.md

@@ -0,0 +1,63 @@
+---
+title: "use"
+titleForTitleTag: "'use' directive"
+---
+
+<Intro>
+
+use use use.
+
+```js
+function useUse() {
+  "use";
+  use("use");
+  useUseUse(use);
+  return useUse("use", use);
+}
+```
+
+</Intro>
+
+---
+
+## Reference {/*reference*/}
+
+### `"use"` {/*use*/}
+
+use use use.
+
+use use use use use.
+
+#### Parameters {/*parameters*/}
+
+use use use.
+
+#### Returns {/*returns*/}
+
+use use use use use.
+
+---
+
+## Usage {/*usage*/}
+
+### Examples {/*examples*/}
+
+use use use use use.
+
+```js
+use();
+```
+
+use use use, use use use use use.
+
+---
+
+## Troubleshooting {/*troubleshooting*/}
+
+### use not working {/*use-not-working*/}
+
+use use; use use use.
+
+### use conflicts {/*use-conflicts*/}
+
+use use use use use use use use.

src/sidebarReference.json

@@ -382,6 +382,10 @@
       "title": "Directives",
       "path": "/reference/react-compiler/directives",
       "routes": [
+        {
+          "title": "\"use\"",
+          "path": "/reference/react-compiler/directives/use"
+        },
         {
           "title": "\"use memo\"",
           "path": "/reference/react-compiler/directives/use-memo"