📝 Add docstrings to admin-ui-2449 (#2466)

Docstrings generation was requested by @moabu.

* #2452 (comment)

The following files were modified:

* `admin-ui/plugins/auth-server/components/Configuration/Keys/Jwks/JwkListPage.tsx`
* `admin-ui/plugins/auth-server/components/Configuration/Keys/KeysPage.tsx`
* `admin-ui/plugins/auth-server/components/Configuration/Keys/hooks/useJwkActions.ts`

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

Author: coderabbitai[bot]

admin-ui/plugins/auth-server/components/Configuration/Keys/Jwks/JwkListPage.tsx

@@ -10,6 +10,11 @@ const generateStableKey = (kid: string | undefined, index: number): string => {
   return kid || `jwk-${index}`
 }
 
+/**
+ * Render the JSON Web Key Set (JWKS) section, handling loading, error, and empty states.
+ *
+ * @returns The component's React element containing the JWKS section: a loading wrapper while fetching, an error alert if loading fails, the list of JWK items when present, or an informational alert when no keys are found.
+ */
 function JwkListPage(): React.ReactElement {
   const { t } = useTranslation()
   const { jwks, isLoading, error } = useJwkApi()
@@ -58,4 +63,4 @@ function JwkListPage(): React.ReactElement {
 
 JwkListPage.displayName = 'JwkListPage'
 
-export default JwkListPage
+export default JwkListPage

admin-ui/plugins/auth-server/components/Configuration/Keys/KeysPage.tsx

@@ -6,6 +6,11 @@ import { useTranslation } from 'react-i18next'
 import SetTitle from 'Utils/SetTitle'
 import applicationStyle from 'Routes/Apps/Gluu/styles/applicationstyle'
 
+/**
+ * Render the public keys configuration page, set the page title, and display the JWK list inside a tab.
+ *
+ * @returns A React element containing a Card with a tabbed JWK list and the page title set to the localized "public keys" title.
+ */
 function KeysPage(): React.ReactElement {
   const { t } = useTranslation()
   SetTitle(t('titles.public_keys'))
@@ -27,4 +32,4 @@ function KeysPage(): React.ReactElement {
 
 KeysPage.displayName = 'KeysPage'
 
-export default KeysPage
+export default KeysPage

admin-ui/plugins/auth-server/components/Configuration/Keys/hooks/useJwkActions.ts

@@ -2,6 +2,11 @@ import { useCallback } from 'react'
 import { useNavigate } from 'react-router-dom'
 import { ROUTES } from '../constants'
 
+/**
+ * Provides actions related to JWK configuration, including navigation to the keys list.
+ *
+ * @returns An object with `navigateToKeysList` — a function that navigates to the keys list route.
+ */
 export function useJwkActions() {
   const navigate = useNavigate()
 
@@ -12,4 +17,4 @@ export function useJwkActions() {
   return {
     navigateToKeysList,
   }
-}
+}