Update deprecation notice.

Author: lgarron

README.md

@@ -1,8 +1,47 @@
-⚠️ ⚠️ ⚠️
+# ⚠️ `@github/webauthn-json` is deprecated
 
-WebAuthn-json has been sunset. Now that [all major browsers support WebAuthn](https://developer.mozilla.org/en-US/docs/Web/API/Web_Authentication_API#browser_compatibility) we recommend invoking the native APIs
+As of March 2025, stable versions of all major browsers now support the following methods:
 
-⚠️ ⚠️ ⚠️
+- [`PublicKeyCredential.parseCreationOptionsFromJSON(…)`](https://developer.mozilla.org/en-US/docs/Web/API/PublicKeyCredential/parseCreationOptionsFromJSON_static)
+- [`PublicKeyCredential.parseRequestOptionsFromJSON(…)`](https://developer.mozilla.org/en-US/docs/Web/API/PublicKeyCredential/parseCreationOptionsFromJSON_static)
+
+By design, these are compatible with `@github/webauthn-json` encoding, so you can use them as a drop-in substitute. We strongly recommend doing so, since:
+
+- The browser-native JSON parsing functions are increasingly receiving fields and features (such as user-agent hints and the `prf` extension) that `@github/webauthn-json` will never receive.
+- Removing `@github/webauthn-json` from your codebase will remove code from your authentication pages, reducing load times for your users and reducing the chance you will need to debug issues.
+
+If you need to support older browsers in the short-term, consider loading this library only as a fallback:
+
+```js
+async function register() {
+  const parseCreationOptionsFromJSON =
+  PublicKeyCredential.parseCreationOptionsFromJSON ??
+    /* @type PublicKeyCredential.parseCreationOptionsFromJSON */
+    (await import("@github/webauthn-json/browser-ponyfill")).parseCreationOptionsFromJSON;
+
+  const publicKey = parseCreationOptionsFromJSON({ /* … */ });
+  return navigator.credentials.create({publicKey});
+}
+
+async function authenticate() {
+  const parseRequestOptionsFromJSON =
+    PublicKeyCredential.parseRequestOptionsFromJSON ??
+      /* @type PublicKeyCredential.parseRequestOptionsFromJSON */
+      (await import("@github/webauthn-json/browser-ponyfill")).parseRequestOptionsFromJSON;
+
+  const publicKey = parseRequestOptionsFromJSON({ /* … */ });
+  return navigator.credentials.get({publicKey});
+}
+```
+
+<br>
+<br>
+
+This project's old README contents are below:
+
+<br>
+
+--------
 
 # `@github/webauthn-json`