refactor: common reference should not use uid

Author: JounQin

src/runtime/components/OpenAPIPath.tsx

@@ -298,6 +298,7 @@ export const OpenAPIPath = ({
             key={ref}
             schema={ref}
             openapiPath={openapiPath}
+            isCommonRef={false}
             collectRefs={false}
           />
         )

src/runtime/components/OpenAPIRef.tsx

@@ -20,6 +20,17 @@ export interface OpenAPIRefProps {
    * The specific path to the OpenAPI schema, otherwise the first matched will be used.
    */
   openapiPath?: string
+  /**
+   * Whether is a common reference, no `uid` will be generated.
+   *
+   * @default true
+   */
+  isCommonRef?: boolean
+  /**
+   * Whether to collect references from the schema.
+   *
+   * @default true
+   */
   collectRefs?: boolean
 }
 
@@ -150,6 +161,7 @@ const getRefsForSchema = (
 export const OpenAPIRef = ({
   schema,
   openapiPath: openapiPath_,
+  isCommonRef = true,
   collectRefs = true,
 }: OpenAPIRefProps) => {
   const { page } = usePageData()
@@ -158,7 +170,9 @@ export const OpenAPIRef = ({
 
   const innerUid = useId()
 
-  if (!uid) {
+  if (isCommonRef) {
+    uid = '' // common references do not need a unique ID
+  } else if (!uid) {
     uid = innerUid
   }
 
@@ -207,6 +221,7 @@ export const OpenAPIRef = ({
           key={schema}
           schema={schema}
           openapiPath={openapiPath}
+          isCommonRef={isCommonRef}
           collectRefs={false}
         />
       ))}

src/runtime/components/_RefLink.tsx

@@ -14,7 +14,12 @@ export const RefLink = ({ $ref }: RefLinkProps) => {
     return null
   }
 
-  const ref = $ref.replace('/components/schemas/', '').slice(1)
-  const refName = modelName(ref)
-  return <X.a href={COMMON_REFS[ref] || `#${uid}-${ref}`}>{refName}</X.a>
+  const ref = $ref.replace('/components/schemas/', '')
+  const plainRef = ref.slice(1)
+  const refName = modelName(plainRef)
+  return (
+    <X.a href={COMMON_REFS[plainRef] || (uid ? `#${uid}-${plainRef}` : ref)}>
+      {refName}
+    </X.a>
+  )
 }