@types/react 16.9.48 → 16.9.49

react/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for React (http://facebook.github.io/reac
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/react.
 
 ### Additional Details
- * Last updated: Wed, 26 Aug 2020 19:36:31 GMT
+ * Last updated: Mon, 31 Aug 2020 16:41:48 GMT
  * Dependencies: [@types/csstype](https://npmjs.com/package/@types/csstype), [@types/prop-types](https://npmjs.com/package/@types/prop-types)
  * Global values: `React`
 

react/experimental.d.ts

@@ -163,4 +163,26 @@ declare module '.' {
      * @see https://reactjs.org/docs/concurrent-mode-reference.html#usetransition
      */
     export function unstable_useTransition(config?: SuspenseConfig | null): [TransitionStartFunction, boolean];
+
+    /**
+     * @private
+     */
+    const opaqueIdentifierBranding: unique symbol;
+    /**
+     * WARNING: Don't use this as a `string`.
+     *
+     * This is an opaque type that is not supposed to type-check structurally.
+     * It is only valid if returned from React methods and passed to React e.g. `<button aria-labelledby={opaqueIdentifier} />`
+     */
+    // We can't create a type that would be rejected for string concatenation or `.toString()` calls.
+    // So in order to not have to add `string | OpaqueIdentifier` to every react-dom host prop we intersect it with `string`.
+    type OpaqueIdentifier = string & {
+        readonly [opaqueIdentifierBranding]: unknown;
+        // While this would cause `const stringified: string = opaqueIdentifier.toString()` to not type-check it also adds completions while typing.
+        // It would also still allow string concatenation.
+        // Unsure which is better. Not type-checking or not suggesting.
+        // toString(): void;
+    };
+
+    export function unstable_useOpaqueIdentifier(): OpaqueIdentifier;
 }

react/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/react",
-    "version": "16.9.48",
+    "version": "16.9.49",
     "description": "TypeScript definitions for React",
     "license": "MIT",
     "contributors": [
@@ -144,6 +144,6 @@
         "@types/prop-types": "*",
         "csstype": "^3.0.2"
     },
-    "typesPublisherContentHash": "f892a8f3578a4196f9b44230278818d9e2ca4f025267759ec2b03f8e91133279",
+    "typesPublisherContentHash": "b034149a5cda0dd4cd3ee0abc4fec00bfcaf5a2d7d57ac0b8097f45735912dd3",
     "typeScriptVersion": "3.1"
 }