docs: add bridge submodules

Author: gregfromstl

apps/portal/src/app/references/components/TDoc/utils/getSidebarLinkgroups.ts

@@ -167,6 +167,11 @@ export function getSidebarLinkGroups(doc: TransformedDoc, path: string) {
       return tag === "@modules";
     });
 
+    const bridge = docs.filter((d) => {
+      const [tag] = getCustomTag(d) || [];
+      return tag === "@bridge";
+    });
+
     // sort extensions into their own groups
     if (extensions.length) {
       const extensionGroups = extensions.reduce(
@@ -247,9 +252,68 @@ export function getSidebarLinkGroups(doc: TransformedDoc, path: string) {
       }
     }
 
+    if (bridge.length) {
+      const bridgeGroups = bridge.reduce(
+        (acc, d) => {
+          const [, moduleName] = getCustomTag(d) || [];
+          if (moduleName) {
+            if (!acc[moduleName]) {
+              acc[moduleName] = [];
+            }
+            acc[moduleName]?.push(d);
+          }
+          return acc;
+        },
+        {} as Record<string, SomeDoc[]>,
+      );
+      const bridgeLinkGroups: {
+        name: string;
+        href: string;
+        links?: { name: string; href?: string }[];
+      }[] = Object.entries(bridgeGroups)
+        .filter(([namespaceName]) => namespaceName.toLowerCase() !== "common")
+        .map(([namespaceName, docs]) => {
+          const links = docs.map((d) => ({
+            name: d.name,
+            href: getLink(`${path}/${namespaceName.toLowerCase()}/${d.name}`),
+          }));
+          return {
+            name: namespaceName,
+            href: "",
+            links,
+          };
+        });
+
+      // Add the top-level functions
+      for (const [_, docs] of Object.entries(bridgeGroups).filter(
+        ([namespaceName]) => namespaceName.toLowerCase() === "common",
+      )) {
+        for (const doc of docs) {
+          bridgeLinkGroups.push({
+            name: doc.name,
+            href: getLink(`${path}/${doc.name}`),
+          });
+        }
+      }
+
+      if (!linkGroups.find((group) => group.name === name)) {
+        linkGroups.push({
+          name: name,
+          href: getLink(`${path}/${key}`),
+          links: [{ name: "Universal Bridge", links: bridgeLinkGroups }],
+          isCollapsible: false,
+        });
+      } else {
+        linkGroups
+          .find((group) => group.name === name)
+          ?.links.push({ name: "Universal Bridge", links: bridgeLinkGroups });
+      }
+      console.log(linkGroups);
+    }
+
     const nonExtensions = docs.filter((d) => {
       const [tag] = getCustomTag(d) || [];
-      return tag !== "@extension" && tag !== "@modules";
+      return tag !== "@extension" && tag !== "@modules" && tag !== "@bridge";
     });
 
     // sort into groups

packages/thirdweb/src/bridge/Buy.ts

@@ -55,7 +55,7 @@ import type { PreparedQuote, Quote } from "./types/Quote.js";
  * @returns A promise that resolves to a non-finalized quote for the requested buy.
  *
  * @throws Will throw an error if there is an issue fetching the quote.
- * @bridge
+ * @bridge Buy
  * @beta
  */
 export async function quote(options: quote.Options): Promise<quote.Result> {
@@ -188,7 +188,7 @@ export declare namespace quote {
  * @returns A promise that resolves to a non-finalized quote for the requested buy.
  *
  * @throws Will throw an error if there is an issue fetching the quote.
- * @bridge
+ * @bridge Buy
  * @beta
  */
 export async function prepare(

packages/thirdweb/src/bridge/Sell.ts

@@ -55,7 +55,7 @@ import type { PreparedQuote, Quote } from "./types/Quote.js";
  * @returns A promise that resolves to a non-finalized quote for the requested sell.
  *
  * @throws Will throw an error if there is an issue fetching the quote.
- * @bridge
+ * @bridge Sell
  * @beta
  */
 export async function quote(options: quote.Options): Promise<quote.Result> {
@@ -188,7 +188,7 @@ export declare namespace quote {
  * @returns A promise that resolves to a non-finalized quote for the requested buy.
  *
  * @throws Will throw an error if there is an issue fetching the quote.
- * @bridge
+ * @bridge Sell
  * @beta
  */
 export async function prepare(

packages/thirdweb/src/bridge/Status.ts

@@ -7,7 +7,7 @@ import type { Status } from "./types/Status.js";
 /**
  * Retrieves a Universal Bridge quote for the provided sell intent. The quote will specify the expected `destinationAmount` that will be received in exchange for the specified `originAmount`, which is specified with the `sellAmountWei` option.
  *
-+ * The returned status will include both the origin and destination transactions and any finalized amounts for the route.
+ * The returned status will include both the origin and destination transactions and any finalized amounts for the route.
  *
  * @example
  * ```typescript