docs: revise commerce modules overview pages (#10738)

* revise API Key Module overview

* revise auth module

* support ref sidebar items

* remove examples

* revise cart module

* revise currency

* revise customer module

* revise fulfillment module

* revise inventory module

* revise order module

* revise payment

* revise pricing module

* revise product module

* revise promotion module

* revise region module

* revise sales channel module

* revise stock location module

* revise store module

* revise tax module

* revise user module

* lint content + fix snippets

www/packages/docs-ui/src/components/Breadcrumbs/index.tsx

@@ -4,7 +4,12 @@ import React, { useMemo } from "react"
 import clsx from "clsx"
 import Link from "next/link"
 import { SidebarItemLink } from "types"
-import { CurrentItemsState, useSidebar, useSiteConfig } from "../../providers"
+import {
+  CurrentItemsState,
+  isSidebarItemLink,
+  useSidebar,
+  useSiteConfig,
+} from "../../providers"
 import { Button } from "../Button"
 import { TriangleRightMini } from "@medusajs/icons"
 
@@ -29,22 +34,20 @@ export const Breadcrumbs = () => {
       tempBreadcrumbItems = getBreadcrumbsOfItem(item.previousSidebar)
     }
 
-    const parentPath =
-      item.parentItem?.type === "link"
-        ? getLinkPath(item.parentItem)
-        : (item.parentItem?.type === "category" &&
-              breadcrumbOptions?.showCategories) ||
-            item.parentItem?.type === "sub-category"
-          ? "#"
-          : undefined
-    const firstItemPath =
-      item.default[0].type === "link"
-        ? getLinkPath(item.default[0])
-        : (item.default[0].type === "category" &&
-              breadcrumbOptions?.showCategories) ||
-            item.default[0].type === "sub-category"
-          ? "#"
-          : undefined
+    const parentPath = isSidebarItemLink(item.parentItem)
+      ? getLinkPath(item.parentItem)
+      : (item.parentItem?.type === "category" &&
+            breadcrumbOptions?.showCategories) ||
+          item.parentItem?.type === "sub-category"
+        ? "#"
+        : undefined
+    const firstItemPath = isSidebarItemLink(item.default[0])
+      ? getLinkPath(item.default[0])
+      : (item.default[0].type === "category" &&
+            breadcrumbOptions?.showCategories) ||
+          item.default[0].type === "sub-category"
+        ? "#"
+        : undefined
 
     const breadcrumbPath = parentPath || firstItemPath || "/"
 
@@ -76,7 +79,7 @@ export const Breadcrumbs = () => {
           breadcrumbOptions?.showCategories)
       ) {
         tempBreadcrumbItems.set(
-          sidebarActiveItem.parentItem.type === "link"
+          isSidebarItemLink(sidebarActiveItem.parentItem)
             ? getLinkPath(sidebarActiveItem.parentItem) || "#"
             : "#",
           sidebarActiveItem.parentItem.chapterTitle ||