From 0de9750a8a0dd65d72c1ce0c0b1c51ab24b1dfbb Mon Sep 17 00:00:00 2001
From: Sarah Soutoul <sarah@clerk.dev>
Date: Wed, 5 Nov 2025 11:06:24 -0600
Subject: [PATCH 1/8] Fix types for hooks

---
 .typedoc/custom-plugin.mjs | 24 ++++++++++++++++++++----
 1 file changed, 20 insertions(+), 4 deletions(-)

diff --git a/.typedoc/custom-plugin.mjs b/.typedoc/custom-plugin.mjs
index 842e464f3e9..641735c59b0 100644
--- a/.typedoc/custom-plugin.mjs
+++ b/.typedoc/custom-plugin.mjs
@@ -98,8 +98,8 @@ function getRelativeLinkReplacements() {
 function getCatchAllReplacements() {
   return [
     {
-      pattern: /\(setActiveParams\)/g,
-      replace: '([setActiveParams](/docs/reference/javascript/types/set-active-params))',
+      pattern: /(?<!\[)SetActiveParams(?!\]\()/g,
+      replace: '[SetActiveParams](/docs/reference/javascript/types/set-active-params)',
     },
     {
       pattern: /`LoadedClerk`/g,
@@ -110,8 +110,24 @@ function getCatchAllReplacements() {
       replace: '([CreateOrganizationParams](#create-organization-params))',
     },
     {
-      pattern: /\| `SignInResource` \|/,
-      replace: '| [SignInResource](/docs/reference/javascript/sign-in) |',
+      pattern: /`SignInResource`/g,
+      replace: '[`SignInResource`](/docs/reference/javascript/sign-up)',
+    },
+    {
+      pattern: /`SignUpResource`/g,
+      replace: '[`SignUpResource`](/docs/reference/javascript/sign-up)',
+    },
+    {
+      pattern: /`UserResource`/g,
+      replace: '[`UserResource`](/docs/reference/javascript/user)',
+    },
+    {
+      pattern: /<code>SessionResource(\[\])<\/code>/g,
+      replace: '[`SessionResource`](/docs/reference/javascript/session) [ ]',
+    },
+    {
+      pattern: /`SignedInSessionResource`/g,
+      replace: '[`SignedInSessionResource`](/docs/reference/javascript/session)',
     },
     {
       pattern: /`OrganizationPrivateMetadata`/g,

From 8bc65ab5f5e7c41ec26f59a4efd6d738b9be6f43 Mon Sep 17 00:00:00 2001
From: Sarah Soutoul <sarah@clerk.dev>
Date: Wed, 5 Nov 2025 11:29:34 -0600
Subject: [PATCH 2/8] Remove code

---
 .typedoc/custom-plugin.mjs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.typedoc/custom-plugin.mjs b/.typedoc/custom-plugin.mjs
index 641735c59b0..d313d9500ea 100644
--- a/.typedoc/custom-plugin.mjs
+++ b/.typedoc/custom-plugin.mjs
@@ -122,8 +122,8 @@ function getCatchAllReplacements() {
       replace: '[`UserResource`](/docs/reference/javascript/user)',
     },
     {
-      pattern: /<code>SessionResource(\[\])<\/code>/g,
-      replace: '[`SessionResource`](/docs/reference/javascript/session) [ ]',
+      pattern: /SessionResource(\[\])/g,
+      replace: '[`SessionResource`](/docs/reference/javascript/session) []',
     },
     {
       pattern: /`SignedInSessionResource`/g,

From 6e6ca25ba3d26f5799430ad1961a5de5102091dc Mon Sep 17 00:00:00 2001
From: Sarah Soutoul <sarah@clerk.dev>
Date: Wed, 5 Nov 2025 12:29:34 -0600
Subject: [PATCH 3/8] More fixes

---
 .typedoc/custom-plugin.mjs | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/.typedoc/custom-plugin.mjs b/.typedoc/custom-plugin.mjs
index d313d9500ea..4a03be7f9fa 100644
--- a/.typedoc/custom-plugin.mjs
+++ b/.typedoc/custom-plugin.mjs
@@ -98,7 +98,7 @@ function getRelativeLinkReplacements() {
 function getCatchAllReplacements() {
   return [
     {
-      pattern: /(?<!\[)SetActiveParams(?!\]\()/g,
+      pattern: /(?<![`[\]])\bSetActiveParams\b(?![\]\(])/g,
       replace: '[SetActiveParams](/docs/reference/javascript/types/set-active-params)',
     },
     {
@@ -110,23 +110,23 @@ function getCatchAllReplacements() {
       replace: '([CreateOrganizationParams](#create-organization-params))',
     },
     {
-      pattern: /`SignInResource`/g,
-      replace: '[`SignInResource`](/docs/reference/javascript/sign-up)',
+      pattern: /(?<![\[\w`])`?SignInResource`?(?![\]\w`])/g,
+      replace: '[`SignInResource`](/docs/reference/javascript/sign-in)',
     },
     {
-      pattern: /`SignUpResource`/g,
+      pattern: /(?<![\[\w`])`?SignUpResource`?(?![\]\w`])/g,
       replace: '[`SignUpResource`](/docs/reference/javascript/sign-up)',
     },
     {
-      pattern: /`UserResource`/g,
+      pattern: /(?<![\[\w`])`?UserResource`?(?![\]\w`])/g,
       replace: '[`UserResource`](/docs/reference/javascript/user)',
     },
     {
-      pattern: /SessionResource(\[\])/g,
-      replace: '[`SessionResource`](/docs/reference/javascript/session) []',
+      pattern: /(?<![`[\]])\bSessionResource(\[\])?\b(?![\]\)`])/g,
+      replace: '[`SessionResource`](/docs/reference/javascript/session)$1',
     },
     {
-      pattern: /`SignedInSessionResource`/g,
+      pattern: /(?<![\[\w`])`?SignedInSessionResource`?(?![\]\w`])/g,
       replace: '[`SignedInSessionResource`](/docs/reference/javascript/session)',
     },
     {

From a0676d5c1cbca9545b136d52b3b254c960c0deec Mon Sep 17 00:00:00 2001
From: Alexis Aguilar <98043211+alexisintech@users.noreply.github.com>
Date: Wed, 5 Nov 2025 15:47:07 -0500
Subject: [PATCH 4/8] updates

---
 .typedoc/custom-plugin.mjs | 47 ++++++++++++++++++++++++++++----------
 1 file changed, 35 insertions(+), 12 deletions(-)

diff --git a/.typedoc/custom-plugin.mjs b/.typedoc/custom-plugin.mjs
index 4a03be7f9fa..635b4c5747e 100644
--- a/.typedoc/custom-plugin.mjs
+++ b/.typedoc/custom-plugin.mjs
@@ -98,37 +98,56 @@ function getRelativeLinkReplacements() {
 function getCatchAllReplacements() {
   return [
     {
-      pattern: /(?<![`[\]])\bSetActiveParams\b(?![\]\(])/g,
-      replace: '[SetActiveParams](/docs/reference/javascript/types/set-active-params)',
+      pattern: /(?<![\[\w`])`Appearance`\\<`Theme`\\>/g,
+      replace: '[`Appearance<Theme>`](/docs/guides/customizing-clerk/appearance-prop/overview)',
     },
     {
-      pattern: /`LoadedClerk`/g,
-      replace: '[Clerk](/docs/reference/javascript/clerk)',
+      pattern: /(?<![\[\w`])`?BillingMoneyAmount`?(?![\]\w`])/g,
+      replace: '[`BillingMoneyAmount`](/docs/reference/javascript/types/billing-money-amount)',
     },
     {
       pattern: /\(CreateOrganizationParams\)/g,
       replace: '([CreateOrganizationParams](#create-organization-params))',
     },
     {
-      pattern: /(?<![\[\w`])`?SignInResource`?(?![\]\w`])/g,
-      replace: '[`SignInResource`](/docs/reference/javascript/sign-in)',
-    },
-    {
-      pattern: /(?<![\[\w`])`?SignUpResource`?(?![\]\w`])/g,
-      replace: '[`SignUpResource`](/docs/reference/javascript/sign-up)',
+      pattern: /`LoadedClerk`/g,
+      replace: '[Clerk](/docs/reference/javascript/clerk)',
     },
     {
-      pattern: /(?<![\[\w`])`?UserResource`?(?![\]\w`])/g,
-      replace: '[`UserResource`](/docs/reference/javascript/user)',
+      pattern: /(?<![\[\w`])`?LocalizationResource`?(?![\]\w`])/g,
+      replace: '[`LocalizationResource`](/docs/reference/javascript/types/localization-resource)',
     },
     {
+      // SessionResource appears in plain text, with an array next to it, with backticks, etc.
+      // e.g. `SessionResource[]`
       pattern: /(?<![`[\]])\bSessionResource(\[\])?\b(?![\]\)`])/g,
       replace: '[`SessionResource`](/docs/reference/javascript/session)$1',
     },
+    {
+      pattern: /(?<![\[\w`])`?SessionStatusClaim`?(?![\]\w`])/g,
+      replace: '[`SessionStatusClaim`](/docs/reference/javascript/types/session-status)',
+    },
+
+    {
+      pattern: /(?<![`[\]])\bSetActiveParams\b(?![\]\(])/g,
+      replace: '[SetActiveParams](/docs/reference/javascript/types/set-active-params)',
+    },
+    {
+      pattern: /(?<![\[\w`])`?SignInResource`?(?![\]\w`])/g,
+      replace: '[`SignInResource`](/docs/reference/javascript/sign-in)',
+    },
     {
       pattern: /(?<![\[\w`])`?SignedInSessionResource`?(?![\]\w`])/g,
       replace: '[`SignedInSessionResource`](/docs/reference/javascript/session)',
     },
+    {
+      pattern: /(?<![\[\w`])`?SignUpResource`?(?![\]\w`])/g,
+      replace: '[`SignUpResource`](/docs/reference/javascript/sign-up)',
+    },
+    {
+      pattern: /(?<![\[\w`])`?OrganizationResource`?(?![\]\w`])/g,
+      replace: '[`OrganizationResource`](/docs/reference/javascript/organization)',
+    },
     {
       pattern: /`OrganizationPrivateMetadata`/g,
       replace:
@@ -158,6 +177,10 @@ function getCatchAllReplacements() {
       replace:
         '[`OrganizationMembershipPublicMetadata`](/docs/reference/javascript/types/metadata#organization-membership-public-metadata)',
     },
+    {
+      pattern: /(?<![\[\w`])`?UserResource`?(?![\]\w`])/g,
+      replace: '[`UserResource`](/docs/reference/javascript/user)',
+    },
     {
       /**
        * By default, `@deprecated` is output with `**Deprecated**`. We want to add a full stop to it.

From ad2e0d92cad51defec36ae362af82ef91a6739f1 Mon Sep 17 00:00:00 2001
From: Alexis Aguilar <98043211+alexisintech@users.noreply.github.com>
Date: Wed, 5 Nov 2025 15:51:24 -0500
Subject: [PATCH 5/8] add changeset

---
 .changeset/ripe-parks-find.md | 2 ++
 1 file changed, 2 insertions(+)
 create mode 100644 .changeset/ripe-parks-find.md

diff --git a/.changeset/ripe-parks-find.md b/.changeset/ripe-parks-find.md
new file mode 100644
index 00000000000..a845151cc84
--- /dev/null
+++ b/.changeset/ripe-parks-find.md
@@ -0,0 +1,2 @@
+---
+---

From d40b5f513d10c7ec17b4c9d4d1914005fe42d85a Mon Sep 17 00:00:00 2001
From: Sarah Soutoul <sarah@clerk.dev>
Date: Wed, 5 Nov 2025 15:11:52 -0600
Subject: [PATCH 6/8] Fix localization link

---
 .typedoc/custom-plugin.mjs | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/.typedoc/custom-plugin.mjs b/.typedoc/custom-plugin.mjs
index 635b4c5747e..b61bba008c7 100644
--- a/.typedoc/custom-plugin.mjs
+++ b/.typedoc/custom-plugin.mjs
@@ -30,16 +30,16 @@ const LINK_REPLACEMENTS = [
   ['clerk-paginated-response', '/docs/reference/javascript/types/clerk-paginated-response'],
   ['paginated-resources', '#paginated-resources'],
   ['create-organization-params', '#create-organization-params'],
-  ['session-resource', '/docs/reference/javascript/session'],
-  ['signed-in-session-resource', '/docs/reference/javascript/session'],
-  ['sign-in-resource', '/docs/reference/javascript/sign-in'],
-  ['sign-up-resource', '/docs/reference/javascript/sign-up'],
-  ['user-resource', '/docs/reference/javascript/user'],
+  // ['session-resource', '/docs/reference/javascript/session'],
+  // ['signed-in-session-resource', '/docs/reference/javascript/session'],
+  // ['sign-in-resource', '/docs/reference/javascript/sign-in'],
+  // ['sign-up-resource', '/docs/reference/javascript/sign-up'],
+  // ['user-resource', '/docs/reference/javascript/user'],
   ['session-status-claim', '/docs/reference/javascript/types/session-status'],
   ['user-organization-invitation-resource', '/docs/reference/javascript/types/user-organization-invitation'],
   ['organization-membership-resource', '/docs/reference/javascript/types/organization-membership'],
   ['organization-suggestion-resource', '/docs/reference/javascript/types/organization-suggestion'],
-  ['organization-resource', '/docs/reference/javascript/organization'],
+  // ['organization-resource', '/docs/reference/javascript/organization'],
   ['organization-domain-resource', '/docs/reference/javascript/types/organization-domain'],
   ['organization-invitation-resource', '/docs/reference/javascript/types/organization-invitation'],
   ['organization-membership-request-resource', '/docs/reference/javascript/types/organization-membership-request'],
@@ -115,7 +115,7 @@ function getCatchAllReplacements() {
     },
     {
       pattern: /(?<![\[\w`])`?LocalizationResource`?(?![\]\w`])/g,
-      replace: '[`LocalizationResource`](/docs/reference/javascript/types/localization-resource)',
+      replace: '[`LocalizationResource`](/docs/guides/customizing-clerk/localization)',
     },
     {
       // SessionResource appears in plain text, with an array next to it, with backticks, etc.

From aec728a20eaead61aeca1f955373a7aace94715f Mon Sep 17 00:00:00 2001
From: Sarah Soutoul <sarah@clerk.dev>
Date: Wed, 5 Nov 2025 15:12:58 -0600
Subject: [PATCH 7/8] Remove uncommented code

---
 .typedoc/custom-plugin.mjs | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/.typedoc/custom-plugin.mjs b/.typedoc/custom-plugin.mjs
index b61bba008c7..0cc1133415f 100644
--- a/.typedoc/custom-plugin.mjs
+++ b/.typedoc/custom-plugin.mjs
@@ -30,16 +30,16 @@ const LINK_REPLACEMENTS = [
   ['clerk-paginated-response', '/docs/reference/javascript/types/clerk-paginated-response'],
   ['paginated-resources', '#paginated-resources'],
   ['create-organization-params', '#create-organization-params'],
-  // ['session-resource', '/docs/reference/javascript/session'],
-  // ['signed-in-session-resource', '/docs/reference/javascript/session'],
-  // ['sign-in-resource', '/docs/reference/javascript/sign-in'],
-  // ['sign-up-resource', '/docs/reference/javascript/sign-up'],
-  // ['user-resource', '/docs/reference/javascript/user'],
+  ['session-resource', '/docs/reference/javascript/session'],
+  ['signed-in-session-resource', '/docs/reference/javascript/session'],
+  ['sign-in-resource', '/docs/reference/javascript/sign-in'],
+  ['sign-up-resource', '/docs/reference/javascript/sign-up'],
+  ['user-resource', '/docs/reference/javascript/user'],
   ['session-status-claim', '/docs/reference/javascript/types/session-status'],
   ['user-organization-invitation-resource', '/docs/reference/javascript/types/user-organization-invitation'],
   ['organization-membership-resource', '/docs/reference/javascript/types/organization-membership'],
   ['organization-suggestion-resource', '/docs/reference/javascript/types/organization-suggestion'],
-  // ['organization-resource', '/docs/reference/javascript/organization'],
+  ['organization-resource', '/docs/reference/javascript/organization'],
   ['organization-domain-resource', '/docs/reference/javascript/types/organization-domain'],
   ['organization-invitation-resource', '/docs/reference/javascript/types/organization-invitation'],
   ['organization-membership-request-resource', '/docs/reference/javascript/types/organization-membership-request'],

From 89586085200277e6a54de4584c0640d1bd7dcea4 Mon Sep 17 00:00:00 2001
From: Sarah Soutoul <sarah@clerk.dev>
Date: Wed, 5 Nov 2025 18:02:06 -0600
Subject: [PATCH 8/8] Remove space

---
 .typedoc/custom-plugin.mjs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.typedoc/custom-plugin.mjs b/.typedoc/custom-plugin.mjs
index 0cc1133415f..8133662ac73 100644
--- a/.typedoc/custom-plugin.mjs
+++ b/.typedoc/custom-plugin.mjs
@@ -127,7 +127,6 @@ function getCatchAllReplacements() {
       pattern: /(?<![\[\w`])`?SessionStatusClaim`?(?![\]\w`])/g,
       replace: '[`SessionStatusClaim`](/docs/reference/javascript/types/session-status)',
     },
-
     {
       pattern: /(?<![`[\]])\bSetActiveParams\b(?![\]\(])/g,
       replace: '[SetActiveParams](/docs/reference/javascript/types/set-active-params)',