anilink-api-wrapper 2.0.0 → 2.1.0

package/dist/AniLink.d.ts

@@ -1,8 +1,16 @@
 /**
- * Stable error codes returned by the AniLink transport boundary.
+ * {@link AniLinkErrorCodes} is the stable code map returned by the AniLink transport boundary.
  *
- * These codes let consumers classify failures without depending on Axios
- * implementation details or matching human-readable messages.
+ * These codes let consumers classify failures without depending on Axios implementation details or matching human-readable messages. Use {@link AniLinkErrorCode} to type the code and {@link AniLinkError} to branch on it.
+ *
+ * @see {@link AniLinkErrorCode}
+ * @example
+ * ```ts
+ * import { AniLinkErrorCodes } from "./base/AniLinkError";
+ * if (error.code === AniLinkErrorCodes.AUTH) {
+ *   console.error("Missing token");
+ * }
+ * ```
  */
 declare const AniLinkErrorCodes: {
     readonly API: "API_ERROR";
@@ -15,11 +23,24 @@ declare const AniLinkErrorCodes: {
     readonly VALIDATION: "VALIDATION_ERROR";
     readonly UNKNOWN: "UNKNOWN_ERROR";
 };
-/** A machine-readable AniLink transport error code. */
+/**
+ * Union of stable error codes exposed by the AniLink transport boundary.
+ *
+ * @see {@link AniLinkErrorCodes}
+ */
 type AniLinkErrorCode = (typeof AniLinkErrorCodes)[keyof typeof AniLinkErrorCodes];
-/** A base error with a stable AniLink error code. */
+/**
+ * Base error for failures normalized by AniLink.
+ *
+ * Consumers can branch on {@link AniLinkError.code} without depending on the
+ * underlying Axios error or a provider's human-readable message.
+ *
+ * @see {@link AniLinkErrorCodes}
+ */
 declare class AniLinkError extends Error {
+    /** Stable code used to classify the failure. */
     code: AniLinkErrorCode;
+    /** Original Axios or transport error when raw diagnostics were enabled. */
     readonly rawAxiosError?: unknown;
     /**
      * Creates a sanitized AniLink error.
@@ -36,6 +57,8 @@ declare class AniLinkError extends Error {
  * Populated from the `x-ratelimit-*` header family (AniList) or the
  * `X-RateLimit-*` / `Retry-After` family used by REST providers such as
  * MyAnimeList, whenever the upstream includes the required headers.
+ *
+ * @see {@link AniLinkApiError.rateLimit}
  */
 interface RateLimitInfo {
     /** The maximum number of requests allowed in the current window. */
@@ -54,7 +77,9 @@ interface RateLimitInfo {
  * through it directly.
  */
 declare class AniLinkApiError extends AniLinkError {
+    /** HTTP status returned by the upstream API. For GraphQL failures this is the upstream GraphQL error status when available, and the HTTP envelope status (`200`) otherwise. */
     readonly status: number;
+    /** Response body returned by the upstream API, preserved verbatim. */
     readonly data: unknown;
     /**
      * Rate-limit accounting parsed from the `x-ratelimit-limit`,
@@ -85,6 +110,8 @@ declare class AniLinkApiError extends AniLinkError {
  * includes them. Any additional upstream fields are preserved verbatim via the
  * index signature so consumers never need to string-match messages to
  * classify a failure.
+ *
+ * @see {@link AniLinkGraphQLError.graphqlErrors}
  */
 interface GraphQLUpstreamError {
     /** The human-readable error message returned by AniList. */
@@ -98,7 +125,18 @@ interface GraphQLUpstreamError {
     /** Any additional upstream fields, preserved verbatim. */
     [key: string]: unknown;
 }
-/** A GraphQL-level failure returned inside an HTTP 200 envelope. */
+/**
+ * GraphQL-level failure returned inside an HTTP 200 envelope.
+ *
+ * The inherited {@link AniLinkApiError.status} reflects the upstream GraphQL
+ * error status when an entry in {@link AniLinkGraphQLError.graphqlErrors}
+ * carries one (for example `404` or `429`), and the HTTP `200` envelope status
+ * otherwise. This makes `status` a meaningful classification field for
+ * GraphQL failures and lets status-based branching and retry policies treat a
+ * GraphQL-level `429`/`5xx` like its HTTP-level counterpart.
+ *
+ * @see {@link GraphQLUpstreamError}
+ */
 declare class AniLinkGraphQLError extends AniLinkApiError {
     /**
      * The upstream GraphQL `errors` array carried by the envelope, preserved
@@ -124,7 +162,11 @@ declare class AniLinkGraphQLError extends AniLinkApiError {
      */
     constructor(errors: ReadonlyArray<GraphQLUpstreamError>, data?: unknown, rawAxiosError?: unknown);
 }
-/** A failure caused by a missing authentication token. */
+/**
+ * Failure caused by a missing authentication token on a protected operation.
+ *
+ * @see {@link AniLinkErrorCodes.AUTH}
+ */
 declare class AniLinkAuthError extends AniLinkError {
     /**
      * Creates an authentication error for a token-required operation.
@@ -133,9 +175,13 @@ declare class AniLinkAuthError extends AniLinkError {
      */
     constructor(operation?: string);
 }
-/** A failure caused by operation variables that fail validation. */
+/**
+ * Failure caused by operation variables that fail validation.
+ *
+ * @see {@link AniLinkErrorCodes.VALIDATION}
+ */
 declare class AniLinkValidationError extends AniLinkError {
-    /** The individual validation problems, one per line. */
+    /** Individual validation problems, one per entry. */
     readonly details: readonly string[];
     /**
      * Creates a validation error for invalid operation variables.
@@ -152,15 +198,37 @@ declare class AniLinkValidationError extends AniLinkError {
  * consumers a stable type to branch on without inspecting status codes. It
  * carries no additional fields beyond {@link AniLinkApiError}; its value is
  * the named type itself.
+ *
+ * @see {@link AniLinkApiError}
  */
 declare class AniLinkRestError extends AniLinkApiError {
+    /**
+     * Creates a REST error carrying the upstream HTTP status and body.
+     *
+     * @param status - The HTTP status returned by the upstream REST API.
+     * @param data - The response body returned by the upstream REST API.
+     * @param rawAxiosError - The original Axios error when raw diagnostics are enabled.
+     * @param options - Additional error metadata such as rate-limit headers.
+     */
+    constructor(status: number, data: unknown, rawAxiosError?: unknown, options?: {
+        rateLimit?: RateLimitInfo;
+    });
 }
-/** Additional metadata attached to a transport failure. */
+/**
+ * Additional metadata attached to a transport failure.
+ *
+ * @see {@link AniLinkNetworkError.timeoutMs}
+ */
 interface AniLinkNetworkErrorOptions {
     /** The effective per-attempt timeout in milliseconds, when a timeout was configured and enforced. */
     timeoutMs?: number;
 }
-/** A network, timeout, cancellation, or circuit-breaker failure. */
+/**
+ * Network, timeout, cancellation, or circuit-breaker failure.
+ *
+ * @see {@link AniLinkErrorCodes.NETWORK}
+ * @see {@link AniLinkErrorCodes.TIMEOUT}
+ */
 declare class AniLinkNetworkError extends AniLinkError {
     /**
      * The effective timeout duration in milliseconds when this failure was a
@@ -180,6 +248,24 @@ declare class AniLinkNetworkError extends AniLinkError {
     constructor(code: typeof AniLinkErrorCodes.NETWORK | typeof AniLinkErrorCodes.TIMEOUT | typeof AniLinkErrorCodes.ABORTED | typeof AniLinkErrorCodes.CIRCUIT, message: string, rawAxiosError?: unknown, options?: AniLinkNetworkErrorOptions);
 }
 
+/**
+ * Per-window cap on retries across requests sharing the same transport
+ * settings object.
+ *
+ * The per-request `maxRetries` bounds retries for one call, but a workload
+ * issuing thousands of requests during a sustained upstream outage would
+ * still multiply API call volume by up to `maxRetries + 1` indefinitely.
+ * This budget bounds the *total* retry spend per rolling window; when it is
+ * exhausted, failures surface without retries until the window elapses.
+ *
+ * @see {@link RequestOptions.retryBudget}
+ */
+interface RetryBudget {
+    /** The maximum number of retries allowed across the window. */
+    maxRetriesPerWindow: number;
+    /** The rolling window length in milliseconds. */
+    windowMs: number;
+}
 /**
  * Retry policy for transient transport failures.
  *
@@ -187,6 +273,8 @@ declare class AniLinkNetworkError extends AniLinkError {
  * each wait is a random value between `0` and the computed exponential cap so
  * concurrent clients do not synchronize their retries (thundering herd).
  * Server-dictated `Retry-After` delays are never jittered.
+ *
+ * @see {@link RequestOptions.retry}
  */
 interface RetryPolicy {
     /** The maximum number of retries after the initial attempt. */
@@ -208,9 +296,32 @@ interface RetryPolicy {
  * GraphQL providers use `POST` only; REST providers additionally use `GET`,
  * `PUT`, and `DELETE`. The union is shared so hooks and error contexts stay
  * provider-agnostic.
+ *
+ * @see {@link sendRequest}
  */
 type HttpMethod = "GET" | "POST" | "PUT" | "DELETE";
-/** Context passed to the request lifecycle hooks for a single attempt. */
+/**
+ * Authentication material a provider can apply to an HTTP request.
+ *
+ * @see {@link RequestAuthInput}
+ */
+interface RequestAuth {
+    /** A bearer token, when the provider uses bearer authentication. */
+    readonly token?: string;
+    /** Explicit headers for schemes such as Basic auth or provider API keys. */
+    readonly headers?: Readonly<Record<string, string>>;
+}
+/**
+ * Legacy string tokens and structured provider authentication accepted by transport.
+ *
+ * @see {@link RequestAuth}
+ */
+type RequestAuthInput = string | RequestAuth;
+/**
+ * Context passed to the request lifecycle hooks for a single failed attempt.
+ *
+ * @see {@link OnErrorHandler}
+ */
 interface RequestErrorContext {
     /** The URL the request was sent to. */
     url: string;
@@ -218,16 +329,25 @@ interface RequestErrorContext {
     method: HttpMethod;
     /** The 1-based attempt that failed. */
     attempt: number;
-    /** The stable code of the normalized failure. */
+    /** The stable code of the normalized failure; see {@link AniLinkErrorCode}. */
     code: AniLinkErrorCode;
     /** The HTTP status when the failure came from an API response. */
     status?: number;
     /** The delay before the next retry, when the failure will be retried. */
     nextDelayMs?: number;
 }
-/** A callback invoked when an attempt fails, before each retry wait and once more when retries are exhausted. */
+/**
+ * Callback invoked when an attempt fails, before each retry wait and once more when retries are exhausted.
+ *
+ * @see {@link RequestOptions.onError}
+ * @see {@link RequestOptions.onRetry}
+ */
 type OnErrorHandler = (error: AniLinkError, context: RequestErrorContext) => void;
-/** Context passed to the `onRequestStart` hook just before an attempt is sent. */
+/**
+ * Context passed to the `onRequestStart` hook just before an attempt is sent.
+ *
+ * @see {@link OnRequestStartHandler}
+ */
 interface RequestContext {
     /** The URL the request is being sent to. */
     url: string;
@@ -239,12 +359,16 @@ interface RequestContext {
 /**
  * A callback invoked immediately before each request attempt is sent. Use it
  * to count request volume or correlate logs with outgoing attempts.
+ *
+ * @see {@link RequestOptions.onRequestStart}
  */
 type OnRequestStartHandler = (context: RequestContext) => void;
 /**
  * A callback invoked after each attempt completes, whether it succeeded or
  * failed. The elapsed wall-clock time of the attempt is reported as
  * `durationMs`, making this the natural point for latency metrics.
+ *
+ * @see {@link RequestOptions.onResponse}
  */
 type OnResponseHandler = (context: RequestContext & {
     durationMs: number;
@@ -252,11 +376,13 @@ type OnResponseHandler = (context: RequestContext & {
 /**
  * Transport settings shared by the AniLink request operations.
  *
- * Pass these as the second argument of the `AniLink` constructor; they apply
+ * Pass these as the second argument of the {@link AniLink} constructor; they apply
  * per instance and never leak across clients.
+ *
+ * @see {@link sendRequest}
  */
 interface RequestOptions {
-    /** Milliseconds before a request is aborted. `0` disables the Axios timeout. Defaults to 30 seconds; timeout errors carry the effective duration as `timeoutMs`. */
+    /** Milliseconds before a request is aborted. `0` disables the Axios timeout. Defaults to {@link DEFAULT_REQUEST_TIMEOUT}; timeout errors carry the effective duration as {@link AniLinkNetworkError.timeoutMs}. */
     timeout?: number;
     /** Signal used to cancel in-flight requests. */
     signal?: AbortSignal;
@@ -278,7 +404,9 @@ interface RequestOptions {
      * Opt into proactive request pacing driven by the `x-ratelimit-*` headers
      * of every successful response: when the reported remaining quota drops
      * below `rateLimitFloor` (default 1), the next attempt waits until the
-     * window resets instead of discovering the limit via a `429`. Off by default.
+     * window resets instead of discovering the limit via a `429`. On by
+     * default; pass `false` to disable it and discover the limit reactively
+     * (each `429` then costs a wasted request plus a retry wait).
      */
     paceWithRateLimit?: boolean;
     /**
@@ -298,7 +426,30 @@ interface RequestOptions {
         threshold: number;
         cooldownMs: number;
     };
-    /** Invoked when an attempt fails, and once more when retries are exhausted. */
+    /**
+     * Optional per-window cap on total retry attempts, complementing the
+     * per-request `maxRetries` and the opt-in `circuitBreaker`: the retry
+     * policy bounds one request's retries, the breaker handles sustained
+     * outages after consecutive failures, and this budget bounds the total
+     * retry spend across many requests in a rolling window (which handles
+     * chronic intermittent failures even when the breaker never trips).
+     * When the budget for the current window is exhausted, failures surface
+     * without retries until the window elapses. Off by default.
+     */
+    retryBudget?: RetryBudget;
+    /**
+     * Upper bound on concurrent keep-alive sockets for this request.
+     * Defaults to {@link MAX_SOCKETS} (20). Supplying this or
+     * `maxFreeSockets` constructs dedicated per-request agents instead of
+     * reusing the shared module-level pool, isolating this caller's socket
+     * pressure from other {@link AniLink} instances and providers.
+     */
+    maxSockets?: number;
+    /**
+     * Upper bound on retained idle keep-alive sockets for this request.
+     * Defaults to {@link MAX_FREE_SOCKETS} (5); see {@link RequestOptions.maxSockets}.
+     */
+    maxFreeSockets?: number;
     onError?: OnErrorHandler;
     /** Invoked before each retry wait with the scheduled delay in `nextDelayMs`. Falls back to per-attempt `onError` calls when unset. */
     onRetry?: OnErrorHandler;
@@ -309,16 +460,21 @@ interface RequestOptions {
 }
 
 /**
- * The `custom` member of the `AniListApi` type.
+ * The `custom` member group of the `AniListApi` type.
+ *
+ * @see https://docs.anilist.co/reference/query
  */
-
 type AniListCustom = {
     /**
-     * Custom query or mutation.
-     * @param query - The query for the request.
-     * @param variables - The variables for the request. This parameter is optional.
-     * @returns {Promise<any>} A promise that resolves to the response from the request.
-     *
+     * {@link AniListCustom.custom} runs an arbitrary GraphQL query or mutation against AniList, returning the
+     * raw response. Use it as an escape hatch when no typed operation fits: the `query`
+     * string is sent verbatim and the `variables` argument is forwarded as-is.
+     * @param query - The GraphQL query or mutation string to send verbatim.
+     * @param variables - The variables to forward with the request. Optional.
+     * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+     * @returns {Promise<T>} A promise that resolves to the raw response, typed as `T` (defaults to `unknown`).
+     * @throws {AniLinkError} When the request fails. When AniList returns partial success (some fields resolve while others fail inside an HTTP 200 envelope), the thrown `AniLinkGraphQLError` exposes the resolved portion via its `partialData` field, so the fields that did resolve remain recoverable from the error.
+     * @see https://docs.anilist.co/reference/query
      * @example
      * ```typescript
      * const viewer = await aniLink.anilist.custom('query {Viewer {id}}');
@@ -796,9 +952,13 @@ interface MediaTagCollectionResponse {
 }
 
 /**
- * `MediaTagCollectionVariables` is an interface representing the variables for the `MediaTagCollectionQuery`.
- * It includes optional parameters for querying media tag collection data.
- * @see https://docs.anilist.co/reference/query
+ * {@link MediaTagCollectionVariables} contains variables for the {@link MediaTagCollectionQuery} operation.
+ *
+ * See {@link MediaTagCollectionQuery} and {@link MediaTagCollectionResponse} for the operation and response shape.
+ *
+ * Values are validated with `MediaTagCollectionMappings` before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/mediatag
  */
 interface MediaTagCollectionVariables {
     /**
@@ -925,94 +1085,98 @@ interface SiteStatisticsResponse {
 }
 
 /**
- * `MediaSort` is a type that represents the sorting options for the `Media` query.
+ * {@link MediaSort} is a type that represents the sorting options for the `Media` query.
  * It can be one of the following: 'ID', 'ID_DESC', 'TITLE_ROMAJI', 'TITLE_ROMAJI_DESC', 'TITLE_ENGLISH', 'TITLE_ENGLISH_DESC', 'TITLE_NATIVE', 'TITLE_NATIVE_DESC', 'TYPE', 'TYPE_DESC', 'FORMAT', 'FORMAT_DESC', 'START_DATE', 'START_DATE_DESC', 'END_DATE', 'END_DATE_DESC', 'SCORE', 'SCORE_DESC', 'POPULARITY', 'POPULARITY_DESC', 'TRENDING', 'TRENDING_DESC', 'EPISODES', 'EPISODES_DESC', 'DURATION', 'DURATION_DESC', 'STATUS', 'STATUS_DESC', 'CHAPTERS', 'CHAPTERS_DESC', 'VOLUMES', 'VOLUMES_DESC', 'UPDATED_AT', 'UPDATED_AT_DESC', 'SEARCH_MATCH', 'FAVOURITES', 'FAVOURITES_DESC'
  * @see https://docs.anilist.co/reference/enum/mediasort
  */
 type MediaSort = "ID" | "ID_DESC" | "TITLE_ROMAJI" | "TITLE_ROMAJI_DESC" | "TITLE_ENGLISH" | "TITLE_ENGLISH_DESC" | "TITLE_NATIVE" | "TITLE_NATIVE_DESC" | "TYPE" | "TYPE_DESC" | "FORMAT" | "FORMAT_DESC" | "START_DATE" | "START_DATE_DESC" | "END_DATE" | "END_DATE_DESC" | "SCORE" | "SCORE_DESC" | "POPULARITY" | "POPULARITY_DESC" | "TRENDING" | "TRENDING_DESC" | "EPISODES" | "EPISODES_DESC" | "DURATION" | "DURATION_DESC" | "STATUS" | "STATUS_DESC" | "CHAPTERS" | "CHAPTERS_DESC" | "VOLUMES" | "VOLUMES_DESC" | "UPDATED_AT" | "UPDATED_AT_DESC" | "SEARCH_MATCH" | "FAVOURITES" | "FAVOURITES_DESC";
 /**
- * `MediaListSort` is a type that represents the sorting options for the `MediaList` query.
+ * {@link MediaListSort} is a type that represents the sorting options for the `MediaList` query.
  * It can be one of the following: 'MEDIA_ID', 'MEDIA_ID_DESC', 'SCORE', 'SCORE_DESC', 'STATUS', 'STATUS_DESC', 'PROGRESS', 'PROGRESS_DESC', 'PROGRESS_VOLUMES', 'PROGRESS_VOLUMES_DESC', 'REPEAT', 'REPEAT_DESC', 'PRIORITY', 'PRIORITY_DESC', 'STARTED_ON', 'STARTED_ON_DESC', 'FINISHED_ON', 'FINISHED_ON_DESC', 'ADDED_TIME', 'ADDED_TIME_DESC', 'UPDATED_TIME', 'UPDATED_TIME_DESC', 'MEDIA_TITLE_ROMAJI', 'MEDIA_TITLE_ROMAJI_DESC', 'MEDIA_TITLE_ENGLISH', 'MEDIA_TITLE_ENGLISH_DESC', 'MEDIA_TITLE_NATIVE', 'MEDIA_TITLE_NATIVE_DESC', 'MEDIA_POPULARITY', 'MEDIA_POPULARITY_DESC'
  * @see https://docs.anilist.co/reference/enum/medialistsort
  */
 type MediaListSort = "MEDIA_ID" | "MEDIA_ID_DESC" | "SCORE" | "SCORE_DESC" | "STATUS" | "STATUS_DESC" | "PROGRESS" | "PROGRESS_DESC" | "PROGRESS_VOLUMES" | "PROGRESS_VOLUMES_DESC" | "REPEAT" | "REPEAT_DESC" | "PRIORITY" | "PRIORITY_DESC" | "STARTED_ON" | "STARTED_ON_DESC" | "FINISHED_ON" | "FINISHED_ON_DESC" | "ADDED_TIME" | "ADDED_TIME_DESC" | "UPDATED_TIME" | "UPDATED_TIME_DESC" | "MEDIA_TITLE_ROMAJI" | "MEDIA_TITLE_ROMAJI_DESC" | "MEDIA_TITLE_ENGLISH" | "MEDIA_TITLE_ENGLISH_DESC" | "MEDIA_TITLE_NATIVE" | "MEDIA_TITLE_NATIVE_DESC" | "MEDIA_POPULARITY" | "MEDIA_POPULARITY_DESC";
 /**
- * `MediaTrendSort` is a type that represents the sorting options for the `MediaTrend` query.
+ * {@link MediaTrendSort} is a type that represents the sorting options for the `MediaTrend` query.
  * It can be one of the following: 'ID', 'ID_DESC', 'MEDIA_ID', 'MEDIA_ID_DESC', 'DATE', 'DATE_DESC', 'SCORE', 'SCORE_DESC', 'POPULARITY', 'POPULARITY_DESC', 'TRENDING', 'TRENDING_DESC', 'EPISODE', 'EPISODE_DESC'.
  * @see https://docs.anilist.co/reference/enum/mediatrendsort
  */
 type MediaTrendSort = "ID" | "ID_DESC" | "MEDIA_ID" | "MEDIA_ID_DESC" | "DATE" | "DATE_DESC" | "SCORE" | "SCORE_DESC" | "POPULARITY" | "POPULARITY_DESC" | "TRENDING" | "TRENDING_DESC" | "EPISODE" | "EPISODE_DESC";
 /**
- * `UserSort` is a type that represents the sorting options for the `User` query.
+ * {@link UserSort} is a type that represents the sorting options for the `User` query.
  * It can be one of the following: 'ID', 'ID_DESC', 'USERNAME', 'USERNAME_DESC', 'WATCHED_TIME', 'WATCHED_TIME_DESC', 'CHAPTERS_READ', 'CHAPTERS_READ_DESC', 'SEARCH_MATCH'.
  * @see https://docs.anilist.co/reference/enum/usersort
  */
 type UserSort = "ID" | "ID_DESC" | "USERNAME" | "USERNAME_DESC" | "WATCHED_TIME" | "WATCHED_TIME_DESC" | "CHAPTERS_READ" | "CHAPTERS_READ_DESC" | "SEARCH_MATCH";
 /**
- * `UserStatisticSort` is a type that represents the sorting options for the `UserStatistic` query.
+ * {@link UserStatisticSort} is a type that represents the sorting options for the `UserStatistic` query.
  * It can be one of the following: 'ID', 'ID_DESC', 'COUNT', 'COUNT_DESC', 'PROGRESS', 'PROGRESS_DESC', 'MEAN_SCORE', 'MEAN_SCORE_DESC'.
  * @see https://docs.anilist.co/reference/enum/userstatisticssort
  */
 type UserStatisticSort = "ID" | "ID_DESC" | "COUNT" | "COUNT_DESC" | "PROGRESS" | "PROGRESS_DESC" | "MEAN_SCORE" | "MEAN_SCORE_DESC";
 /**
- * `ActivitySort` is a type that represents the sorting options for the `Activity` query.
+ * {@link ActivitySort} is a type that represents the sorting options for the `Activity` query.
  * It can be one of the following: 'ID', 'ID_DESC', 'PINNED'.
  * @see https://docs.anilist.co/reference/enum/activitysort
  */
 type ActivitySort = "ID" | "ID_DESC" | "PINNED";
 /**
- * `AiringSort` is a type that represents the sorting options for the `MediaTrend` query.
+ * {@link AiringSort} is a type that represents the sorting options for the `MediaTrend` query.
  * It can be one of the following: 'ID', 'ID_DESC', 'MEDIA_ID', 'MEDIA_ID_DESC', 'TIME', 'TIME_DESC', 'EPISODE', 'EPISODE_DESC'.
  * @see https://docs.anilist.co/reference/enum/airingsort
  */
 type AiringSort = "ID" | "ID_DESC" | "MEDIA_ID" | "MEDIA_ID_DESC" | "TIME" | "TIME_DESC" | "EPISODE" | "EPISODE_DESC";
 /**
- * `CharacterSort` is a type that represents the sorting options for the `Character` query.
+ * {@link CharacterSort} is a type that represents the sorting options for the `Character` query.
  * It can be one of the following: 'ID', 'ID_DESC', 'ROLE', 'ROLE_DESC', 'SEARCH_MATCH', 'FAVOURITES', 'FAVOURITES_DESC', 'RELEVANCE'.
  * @see https://docs.anilist.co/reference/enum/charactersort
  */
 type CharacterSort = "ID" | "ID_DESC" | "ROLE" | "ROLE_DESC" | "SEARCH_MATCH" | "FAVOURITES" | "FAVOURITES_DESC" | "RELEVANCE";
 /**
- * `RecommendationSort` is a type that represents the sorting options for the `Recommendation` query.
+ * {@link RecommendationSort} is a type that represents the sorting options for the `Recommendation` query.
  * It can be one of the following: 'ID', 'ID_DESC', 'RATING', 'RATING_DESC'.
  * @see https://docs.anilist.co/reference/enum/recommendationsort
  */
 type RecommendationSort = "ID" | "ID_DESC" | "RATING" | "RATING_DESC";
 /**
- * `ReviewSort` is a type that represents the sorting options for the `Review` query.
+ * {@link ReviewSort} is a type that represents the sorting options for the `Review` query.
  * It can be one of the following: 'ID', 'ID_DESC', 'MEDIA_ID', 'MEDIA_ID_DESC', 'SCORE', 'SCORE_DESC', 'RATING', 'RATING_DESC', 'CREATED_AT', 'CREATED_AT_DESC', 'UPDATED_AT', 'UPDATED_AT_DESC'.
  * @see https://docs.anilist.co/reference/enum/reviewsort
  */
 type ReviewSort = "ID" | "ID_DESC" | "MEDIA_ID" | "MEDIA_ID_DESC" | "SCORE" | "SCORE_DESC" | "RATING" | "RATING_DESC" | "CREATED_AT" | "CREATED_AT_DESC" | "UPDATED_AT" | "UPDATED_AT_DESC";
 /**
- * `SiteTrendSort` is a type that represents the sorting options for the `SiteTrend` query.
+ * {@link SiteTrendSort} is a type that represents the sorting options for the `SiteTrend` query.
  * It can be one of the following: 'DATE', 'DATE_DESC', 'COUNT', 'COUNT_DESC', 'CHANGE', 'CHANGE_DESC'.
  * @see https://docs.anilist.co/reference/enum/sitetrendsort
  */
 type SiteTrendSort = "DATE" | "DATE_DESC" | "COUNT" | "COUNT_DESC" | "CHANGE" | "CHANGE_DESC";
 /**
- * `StaffSort` is a type that represents the sorting options for the `Staff` query.
+ * {@link StaffSort} is a type that represents the sorting options for the `Staff` query.
  * It can be one of the following: 'ID', 'ID_DESC', 'ROLE', 'ROLE_DESC', 'SEARCH_MATCH', 'FAVOURITES', 'FAVOURITES_DESC', 'RELEVANCE'.
  * @see https://docs.anilist.co/reference/enum/staffsort
  */
 type StaffSort = "ID" | "ID_DESC" | "ROLE" | "ROLE_DESC" | "SEARCH_MATCH" | "FAVOURITES" | "FAVOURITES_DESC" | "RELEVANCE";
 /**
- * `StudioSort` is a type that represents the sorting options for the `Studio` query.
+ * {@link StudioSort} is a type that represents the sorting options for the `Studio` query.
  * It can be one of the following: 'ID', 'ID_DESC', 'NAME', 'NAME_DESC', 'SEARCH_MATCH', 'FAVOURITES', 'FAVOURITES_DESC'.
  * @see https://docs.anilist.co/reference/enum/studiosort
  */
 type StudioSort = "ID" | "ID_DESC" | "NAME" | "NAME_DESC" | "SEARCH_MATCH" | "FAVOURITES" | "FAVOURITES_DESC";
 /**
- * `ThreadSort` is a type that represents the sorting options for the `Thread` query.
+ * {@link ThreadSort} is a type that represents the sorting options for the `Thread` query.
  * It can be one of the following: 'ID', 'ID_DESC', 'TITLE', 'TITLE_DESC', 'CREATED_AT', 'CREATED_AT_DESC', 'UPDATED_AT', 'UPDATED_AT_DESC', 'REPLIED_AT', 'REPLIED_AT_DESC', 'REPLY_COUNT', 'REPLY_COUNT_DESC', 'VIEW_COUNT', 'VIEW_COUNT_DESC', 'IS_STICKY', 'SEARCH_MATCH'.
  * @see https://docs.anilist.co/reference/enum/threadsort
  */
 type ThreadSort = "ID" | "ID_DESC" | "TITLE" | "TITLE_DESC" | "CREATED_AT" | "CREATED_AT_DESC" | "UPDATED_AT" | "UPDATED_AT_DESC" | "REPLIED_AT" | "REPLIED_AT_DESC" | "REPLY_COUNT" | "REPLY_COUNT_DESC" | "VIEW_COUNT" | "VIEW_COUNT_DESC" | "IS_STICKY" | "SEARCH_MATCH";
 
 /**
- * `SiteStatisticsVariables` is an interface representing the variables for the `SiteStatisticsQuery`.
- * It includes optional parameters for querying site statistics data.
- * @see https://docs.anilist.co/reference/query
+ * {@link SiteStatisticsVariables} contains variables for the {@link SiteStatisticsQuery} operation.
+ *
+ * See {@link SiteStatisticsQuery} and {@link SiteStatisticsResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/sitestatistics
  */
 interface SiteStatisticsVariables {
     /**
@@ -1157,27 +1321,31 @@ interface ExternalLinkSourceCollectionResponse {
 }
 
 /**
- * `MediaType` is a type that represents the type of media.
+ * {@link MediaType} is a type that represents the type of media.
  * It can be one of the following: 'ANIME', 'MANGA'.
  * @see https://docs.anilist.co/reference/enum/mediatype
  */
 type MediaType = "ANIME" | "MANGA";
 /**
- * `NotificationType` is a type that represents the type of notification.
+ * {@link NotificationType} is a type that represents the type of notification.
  * It can be one of the following: 'ACTIVITY_MESSAGE', 'ACTIVITY_REPLY', 'FOLLOWING', 'ACTIVITY_MENTION', 'THREAD_COMMENT_MENTION', 'THREAD_SUBSCRIBED', 'THREAD_COMMENT_REPLY', 'AIRING', 'ACTIVITY_LIKE', 'ACTIVITY_REPLY_LIKE', 'THREAD_LIKE', 'THREAD_COMMENT_LIKE', 'ACTIVITY_REPLY_SUBSCRIBED', 'RELATED_MEDIA_ADDITION', 'MEDIA_DATA_CHANGE', 'MEDIA_MERGE', 'MEDIA_DELETION'.
  * @see https://docs.anilist.co/reference/enum/notificationtype
  */
 type NotificationType = "ACTIVITY_MESSAGE" | "ACTIVITY_REPLY" | "FOLLOWING" | "ACTIVITY_MENTION" | "THREAD_COMMENT_MENTION" | "THREAD_SUBSCRIBED" | "THREAD_COMMENT_REPLY" | "AIRING" | "ACTIVITY_LIKE" | "ACTIVITY_REPLY_LIKE" | "THREAD_LIKE" | "THREAD_COMMENT_LIKE" | "ACTIVITY_REPLY_SUBSCRIBED" | "RELATED_MEDIA_ADDITION" | "MEDIA_DATA_CHANGE" | "MEDIA_MERGE" | "MEDIA_DELETION";
 /**
- * `LikeableType` is a type that represents the type of likeable item.
+ * {@link LikeableType} is a type that represents the type of likeable item.
  * It can be one of the following: 'THREAD', 'THREAD_COMMENT', 'ACTIVITY', 'ACTIVITY_REPLY'.
  * @see https://docs.anilist.co/reference/enum/likeabletype
  */
 type LikeableType = "THREAD" | "THREAD_COMMENT" | "ACTIVITY" | "ACTIVITY_REPLY";
 
 /**
- * `ExternalLinkSourceCollectionVariables` is an interface representing the variables for the `ExternalLinkSourceCollectionQuery`.
- * It includes optional id, type, and mediaType.
+ * {@link ExternalLinkSourceCollectionVariables} contains variables for the {@link ExternalLinkSourceCollectionQuery} operation.
+ *
+ * See {@link ExternalLinkSourceCollectionQuery} and {@link ExternalLinkSourceCollectionResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
  * @see https://docs.anilist.co/reference/query
  */
 interface ExternalLinkSourceCollectionVariables {
@@ -1196,16 +1364,20 @@ interface ExternalLinkSourceCollectionVariables {
 }
 
 /**
- * `ActivityType` is a type that represents the type of activity.
+ * {@link ActivityType} is a type that represents the type of activity.
  * It can be one of the following: 'TEXT', 'ANIME_LIST', 'MANGA_LIST', 'MESSAGE', 'MEDIA_LIST'.
  * @see https://docs.anilist.co/reference/enum/activitytype
  */
 type ActivityType = "TEXT" | "ANIME_LIST" | "MANGA_LIST" | "MESSAGE" | "MEDIA_LIST";
 
 /**
- * `ActivityVariables` is an interface representing the variables for the `ActivityQuery`.
- * It includes optional id, userId, messengerId, mediaId, type, isFollowing, hasReplies, hasRepliesOrTypeText, createdAt, id_not, id_in, id_not_in, userId_not, userId_in, userId_not_in, messengerId_not, messengerId_in, messengerId_not_in, mediaId_not, mediaId_in, mediaId_not_in, type_not, type_in, type_not_in, createdAt_greater, sort, and asHtml.
- * @see https://docs.anilist.co/reference/query
+ * {@link ActivityVariables} contains variables for the {@link ActivityQuery} operation.
+ *
+ * See {@link ActivityQuery} and {@link Activity} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/union/activityunion
  */
 interface ActivityVariables {
     /**
@@ -1319,9 +1491,13 @@ interface ActivityVariables {
 }
 
 /**
- * `ActivityReplyVariables` is an interface representing the variables for the `ActivityReplyQuery`.
- * At least one of `id` or `activityId` is required by the AniList API; `asHtml` is optional.
- * @see https://docs.anilist.co/reference/query
+ * {@link ActivityReplyVariables} contains variables for the {@link ActivityReplyQuery} operation.
+ *
+ * See {@link ActivityReplyQuery} and {@link ActivityReply} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/activityreply
  */
 interface ActivityReplyVariables {
     /**
@@ -1398,9 +1574,13 @@ interface ActivityRepliesPageResponse {
 }
 
 /**
- * `ActivityRepliesVariables` is an interface representing the variables for the `ActivityRepliesQuery`.
- * Every parameter is optional: without filters AniList returns the latest activity replies.
- * @see https://docs.anilist.co/reference/query
+ * {@link ActivityRepliesVariables} contains variables for the {@link ActivityRepliesQuery} operation.
+ *
+ * See {@link ActivityRepliesQuery} and {@link ActivityRepliesPageResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/activityreply
  */
 interface ActivityRepliesVariables {
     /**
@@ -1450,9 +1630,13 @@ interface ActivitiesPageResponse {
 }
 
 /**
- * `ActivitiesVariables` is an interface representing the variables for the `ActivitiesQuery`.
- * It includes optional page, per page, id, user id, messenger id, media id, type, is following, has replies, has replies or type text, created at, id not, id in, id not in, user id not, user id in, user id not in, messenger id not, messenger id in, messenger id not in, media id not, media id in, media id not in, type not, type in, type not in, created at greater, sort, and as html.
- * @see https://docs.anilist.co/reference/query
+ * {@link ActivitiesVariables} contains variables for the {@link ActivitiesQuery} operation.
+ *
+ * See {@link ActivitiesQuery} and {@link ActivitiesPageResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/union/activityunion
  */
 interface ActivitiesVariables {
     /**
@@ -2188,9 +2372,13 @@ interface AiringScheduleResponse {
 }
 
 /**
- * `AiringScheduleVariables` is an interface representing the variables for the `AiringScheduleQuery`.
- * It includes optional id, mediaId, episode, airingAt, notYetAired, id_not, id_in, id_not_in, mediaId_not, mediaId_in, mediaId_not_in, episode_not, episode_in, episode_not_in, episode_greater, episode_lesser, airingAt_greater, airingAt_lesser, sort, and asHtml.
- * @see https://docs.anilist.co/reference/query
+ * {@link AiringScheduleVariables} contains variables for the {@link AiringScheduleQuery} operation.
+ *
+ * See {@link AiringScheduleQuery} and {@link AiringScheduleResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/airingschedule
  */
 interface AiringScheduleVariables {
     /**
@@ -2300,9 +2488,13 @@ interface AiringSchedulesPageResponse {
 }
 
 /**
- * `AiringSchedulesVariables` is an interface representing the variables for the `AiringSchedulesQuery`.
- * It includes optional page, per page, id, media id, episode, airing at, not yet aired, id not, id in, id not in, media id not, media id in, media id not in, episode not, episode in, episode not in, episode greater, episode lesser, airing at greater, airing at lesser, sort, and as html.
- * @see https://docs.anilist.co/reference/query
+ * {@link AiringSchedulesVariables} contains variables for the {@link AiringSchedulesQuery} operation.
+ *
+ * See {@link AiringSchedulesQuery} and {@link AiringSchedulesPageResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/airingschedule
  */
 interface AiringSchedulesVariables {
     /**
@@ -2581,9 +2773,13 @@ interface CharacterResponse {
 }
 
 /**
- * `CharacterVariables` is an interface representing the variables for the `CharacterQuery`.
- * It includes optional id, isBirthday, search, id_not, id_in, id_not_in, sort, asHtml, mediaSort, mediaOnList, mediaPage, and mediaPerPage.
- * @see https://docs.anilist.co/reference/query
+ * {@link CharacterVariables} contains variables for the {@link CharacterQuery} operation.
+ *
+ * See {@link CharacterQuery} and {@link CharacterResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/character
  */
 interface CharacterVariables {
     /**
@@ -2661,9 +2857,13 @@ interface CharactersPageResponse {
 }
 
 /**
- * `CharactersVariables` is an interface representing the variables for the `CharactersQuery`.
- * It includes optional page, per page, id, is birthday, search, id not, id in, id not in, sort, as html, media sort, media on list, media page, and media per page.
- * @see https://docs.anilist.co/reference/query
+ * {@link CharactersVariables} contains variables for the {@link CharactersQuery} operation.
+ *
+ * See {@link CharactersQuery} and {@link CharactersPageResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/character
  */
 interface CharactersVariables {
     /**
@@ -2725,34 +2925,34 @@ interface CharactersVariables {
 }
 
 /**
- * `MediaFormat` is a type that represents the format of a media.
+ * {@link MediaFormat} is a type that represents the format of a media.
  * It can be one of the following: 'TV', 'TV_SHORT', 'MOVIE', 'SPECIAL', 'OVA', 'ONA', 'MUSIC', 'MANGA', 'NOVEL', 'ONE_SHOT'.
  * @see https://docs.anilist.co/reference/enum/mediaformat
  */
 type MediaFormat = "TV" | "TV_SHORT" | "MOVIE" | "SPECIAL" | "OVA" | "ONA" | "MUSIC" | "MANGA" | "NOVEL" | "ONE_SHOT";
 /**
- * `ScoreFormat` is a type representing the scoring format for a media list.
+ * {@link ScoreFormat} is a type representing the scoring format for a media list.
  * It can be one of the following: 'POINT_100', 'POINT_10_DECIMAL', 'POINT_10', 'POINT_5', 'POINT_3'.
  * @see https://docs.anilist.co/reference/enum/scoreformat
  */
 type ScoreFormat = "POINT_100" | "POINT_10_DECIMAL" | "POINT_10" | "POINT_5" | "POINT_3";
 
 /**
- * `UserStaffNameLanguage` is a type representing the language of a user's staff name.
+ * {@link UserStaffNameLanguage} is a type representing the language of a user's staff name.
  * It can be one of the following: 'ROMAJI', 'ENGLISH', 'NATIVE', 'ROMAJI_STYLISED', 'ENGLISH_STYLISED', 'NATIVE_STYLISED'.
  * @see https://docs.anilist.co/reference/enum/userstaffnamelanguage
  */
 type UserStaffNameLanguage = "ROMAJI" | "ENGLISH" | "NATIVE" | "ROMAJI_STYLISED" | "ENGLISH_STYLISED" | "NATIVE_STYLISED";
 
 /**
- * `UserTitleLanguage` is a type representing the language of a user's title.
+ * {@link UserTitleLanguage} is a type representing the language of a user's title.
  * It can be one of the following: 'ROMAJI', 'ENGLISH', 'NATIVE', 'ROMAJI_STYLISED', 'ENGLISH_STYLISED', 'NATIVE_STYLISED'.
  * @see https://docs.anilist.co/reference/enum/usertitlelanguage
  */
 type UserTitleLanguage = "ROMAJI" | "ENGLISH" | "NATIVE" | "ROMAJI_STYLISED" | "ENGLISH_STYLISED" | "NATIVE_STYLISED";
 
 /**
- * `Staff` is an interface representing a staff member.
+ * {@link Staff} is an interface representing a staff member.
  * It includes the id and name each having their own properties.
  * @see https://docs.anilist.co/reference/object/staff
  */
@@ -2762,13 +2962,13 @@ interface Staff {
      */
     id: number;
     /**
-     * `name` is an instance of `Name` representing the name of the staff member.
+     * `name` is an instance of {@link Name} representing the name of the staff member.
      */
     name: Name;
 }
 
 /**
- * `Studio` is an interface representing a studio.
+ * {@link Studio} is an interface representing a studio.
  * It includes the id and name each having their own properties.
  * @see https://docs.anilist.co/reference/object/studio
  */
@@ -2784,7 +2984,7 @@ interface Studio {
 }
 
 /**
- * `Stat` is an interface representing the statistics of a media.
+ * {@link Stat} is an interface representing the statistics of a media.
  * It includes the count, mean score, minutes watched, chapters read, media ids, format, status, score, length, release year, start year, genre, tag, country, voice actor, character ids, staff, and studio each having their own properties.
  * @see https://docs.anilist.co/reference/object/userstatistictypes
  */
@@ -2838,7 +3038,7 @@ interface Stat {
      */
     genre?: string;
     /**
-     * `tag` is an instance of `Tag` representing the tag of the media.
+     * `tag` is an instance of {@link Tag} representing the tag of the media.
      */
     tag?: Tag;
     /**
@@ -2846,7 +3046,7 @@ interface Stat {
      */
     country?: string;
     /**
-     * `voiceActor` is an instance of `Staff` representing the voice actor of the media.
+     * `voiceActor` is an instance of {@link Staff} representing the voice actor of the media.
      */
     voiceActor?: Staff;
     /**
@@ -2854,11 +3054,11 @@ interface Stat {
      */
     characterIds?: number[];
     /**
-     * `staff` is an instance of `Staff` representing the staff of the media.
+     * `staff` is an instance of {@link Staff} representing the staff of the media.
      */
     staff?: Staff;
     /**
-     * `studio` is an instance of `Studio` representing the studio of the media.
+     * `studio` is an instance of {@link Studio} representing the studio of the media.
      */
     studio?: Studio;
 }
@@ -3007,7 +3207,7 @@ interface ActivityHistory {
 }
 
 /**
- * `Favoured` is an interface representing a favoured entity.
+ * {@link Favoured} is an interface representing a favoured entity.
  * It includes the genre, amount, meanScore, timeWatched, tag, staff, studio, year, and format each having their own properties.
  * @see https://docs.anilist.co/reference/object/favourites
  */
@@ -3029,15 +3229,15 @@ interface Favoured {
      */
     timeWatched: number;
     /**
-     * `tag` is an object of type `Tag` representing the tag of the favoured entity.
+     * `tag` is an object of type {@link Tag} representing the tag of the favoured entity.
      */
     tag?: Tag;
     /**
-     * `staff` is an object of type `Staff` representing the staff of the favoured entity.
+     * `staff` is an object of type {@link Staff} representing the staff of the favoured entity.
      */
     staff?: Staff;
     /**
-     * `studio` is an object of type `Studio` representing the studio of the favoured entity.
+     * `studio` is an object of type {@link Studio} representing the studio of the favoured entity.
      */
     studio?: Studio;
     /**
@@ -3555,9 +3755,13 @@ interface UserResponse {
 }
 
 /**
- * `FollowerVariables` is an interface representing the variables for the `FollowerQuery`.
- * It includes optional userId, sort, asHtml, animeStatLimit, mangaStatLimit, animeStatSort, and mangaStatSort.
- * @see https://docs.anilist.co/reference/query
+ * {@link FollowerVariables} contains variables for the {@link FollowerQuery} operation.
+ *
+ * See {@link FollowerQuery} and {@link UserResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/user
  */
 interface FollowerVariables {
     /**
@@ -3615,9 +3819,13 @@ interface FollowersPageResponse {
 }
 
 /**
- * `FollowersVariables` is an interface representing the variables for the `FollowersQuery`.
- * It includes optional page, per page, user id, sort, anime stat limit, manga stat limit, anime stat sort, and manga stat sort.
- * @see https://docs.anilist.co/reference/query
+ * {@link FollowersVariables} contains variables for the {@link FollowersQuery} operation.
+ *
+ * See {@link FollowersQuery} and {@link FollowersPageResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/user
  */
 interface FollowersVariables {
     /**
@@ -3659,9 +3867,13 @@ interface FollowersVariables {
 }
 
 /**
- * `FollowingVariables` is an interface representing the variables for the `FollowingQuery`.
- * It includes optional userId, sort, asHtml, animeStatLimit, mangaStatLimit, animeStatSort, and mangaStatSort.
- * @see https://docs.anilist.co/reference/query
+ * {@link FollowingVariables} contains variables for the {@link FollowingQuery} operation.
+ *
+ * See {@link FollowingQuery} and {@link UserResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/user
  */
 interface FollowingVariables {
     /**
@@ -3719,9 +3931,13 @@ interface FollowingsPageResponse {
 }
 
 /**
- * `FollowingsVariables` is an interface representing the variables for the `FollowingsQuery`.
- * It includes optional page, per page, user id, sort, anime stat limit, manga stat limit, anime stat sort, and manga stat sort.
- * @see https://docs.anilist.co/reference/query
+ * {@link FollowingsVariables} contains variables for the {@link FollowingsQuery} operation.
+ *
+ * See {@link FollowingsQuery} and {@link FollowingsPageResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/user
  */
 interface FollowingsVariables {
     /**
@@ -3787,9 +4003,13 @@ interface LikesPageResponse {
 }
 
 /**
- * `LikesVariables` is an interface representing the variables for the `LikesQuery`.
- * The AniList API requires both `likeableId` and `type`; `page` and `perPage` are optional.
- * @see https://docs.anilist.co/reference/query
+ * {@link LikesVariables} contains variables for the {@link LikesQuery} operation.
+ *
+ * See {@link LikesQuery} and {@link LikesPageResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/union/likeableunion
  */
 interface LikesVariables {
     /**
@@ -3811,9 +4031,11 @@ interface LikesVariables {
 }
 
 /**
- * `MarkdownVariables` is an interface representing the variables for the `MarkdownQuery`.
- * It includes an optional markdown string.
- * @see https://docs.anilist.co/reference/query
+ * {@link MarkdownVariables} contains variables for the {@link MarkdownQuery} operation.
+ *
+ * See {@link MarkdownQuery}; it returns the converted HTML string.
+ *
+ * @see https://docs.anilist.co/reference/object/parsedmarkdown
  */
 interface MarkdownVariables {
     /**
@@ -3945,20 +4167,20 @@ interface MediaListCollectionResponse {
 }
 
 /**
- * `MediaStatus` is a type that represents the status of a media.
+ * {@link MediaStatus} is a type that represents the status of a media.
  * It can be one of the following: 'FINISHED', 'RELEASING', 'NOT_YET_RELEASED', 'CANCELLED', 'HIATUS'.
  * @see https://docs.anilist.co/reference/enum/mediastatus
  */
 type MediaStatus = "FINISHED" | "RELEASING" | "NOT_YET_RELEASED" | "CANCELLED" | "HIATUS";
 /**
- * `MediaListStatus` is a type that represents the status of a media list.
+ * {@link MediaListStatus} is a type that represents the status of a media list.
  * It can be one of the following: 'CURRENT', 'PLANNING', 'COMPLETED', 'DROPPED', 'PAUSED', 'REPEATING'.
  * @see https://docs.anilist.co/reference/enum/medialiststatus
  */
 type MediaListStatus = "CURRENT" | "PLANNING" | "COMPLETED" | "DROPPED" | "PAUSED" | "REPEATING";
 
 /**
- * `FuzzyDateInput` is a type representing a fuzzy date input.
+ * {@link FuzzyDateInput} is a type representing a fuzzy date input.
  * It includes the year, month, and day each having their own optional properties.
  * @see https://docs.anilist.co/reference/input/fuzzydateinput
  */
@@ -3978,9 +4200,13 @@ type FuzzyDateInput = {
 };
 
 /**
- * `MediaListCollectionVariables` is an interface representing the variables for the `MediaListCollectionQuery`.
- * The AniList API requires a `type` plus a `userId` or a `userName`; every other parameter is optional.
- * @see https://docs.anilist.co/reference/query
+ * {@link MediaListCollectionVariables} contains variables for the {@link MediaListCollectionQuery} operation.
+ *
+ * See {@link MediaListCollectionQuery} and {@link MediaListCollectionResponse} for the operation and response shape.
+ *
+ * Values are validated with `MediaListCollectionMappings` before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/medialistcollection
  */
 interface MediaListCollectionVariables {
     /**
@@ -4176,9 +4402,13 @@ interface MediaListResponse {
 }
 
 /**
- * `MediaListVariables` is an interface representing the variables for the `MediaListQuery`.
- * It includes optional parameters for querying media list data.
- * @see https://docs.anilist.co/reference/query
+ * {@link MediaListVariables} contains variables for the {@link MediaListQuery} operation.
+ *
+ * See {@link MediaListQuery} and {@link MediaListResponse} for the operation and response shape.
+ *
+ * Values are validated with `MediaListMappings` before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/medialist
  */
 interface MediaListVariables {
     /**
@@ -4320,9 +4550,13 @@ interface MediaListsPageResponse {
 }
 
 /**
- * `MediaListsVariables` is an interface representing the variables for the `MediaListsQuery`.
- * It includes optional page, per page, id, user id, user name, type, status, media id, is following, notes, started at, completed at, compare with auth list, user id in, status in, status not in, status not, media id in, media id not in, notes like, started at greater, started at lesser, started at like, completed at greater, completed at lesser, completed at like, sort, score format, as array, and as html.
- * @see https://docs.anilist.co/reference/query
+ * {@link MediaListsVariables} contains variables for the {@link MediaListsQuery} operation.
+ *
+ * See {@link MediaListsQuery} and {@link MediaListsPageResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/medialist
  */
 interface MediaListsVariables {
     /**
@@ -4448,14 +4682,14 @@ interface MediaListsVariables {
 }
 
 /**
- * `MediaSeason` is a type that represents the season of a media.
+ * {@link MediaSeason} is a type that represents the season of a media.
  * It can be one of the following: 'WINTER', 'SPRING', 'SUMMER', 'FALL'.
  * @see https://docs.anilist.co/reference/enum/mediaseason
  */
 type MediaSeason = "WINTER" | "SPRING" | "SUMMER" | "FALL";
 
 /**
- * `MediaSource` is a type that represents the source of a media.
+ * {@link MediaSource} is a type that represents the source of a media.
  * It can be one of the following: 'ORIGINAL', 'MANGA', 'LIGHT_NOVEL', 'VISUAL_NOVEL', 'VIDEO_GAME', 'OTHER', 'NOVEL', 'DOUJINSHI', 'ANIME', 'WEB_NOVEL', 'LIVE_ACTION', 'GAME', 'BOOK', 'MUSIC', 'MULTIMEDIA_PROJECT', 'PICTURE_BOOK'.
  * @see https://docs.anilist.co/reference/enum/mediasource
  */
@@ -5084,9 +5318,13 @@ interface MediaResponse {
 }
 
 /**
- * `MediaVariables` is an interface representing the variables for the `MediaQuery`.
- * It includes optional parameters for querying media data.
- * @see https://docs.anilist.co/reference/query
+ * {@link MediaVariables} contains variables for the {@link MediaQuery} operation.
+ *
+ * See {@link MediaQuery} and {@link MediaResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/media
  */
 interface MediaVariables {
     /**
@@ -5424,9 +5662,13 @@ interface MediaTrendResponse {
 }
 
 /**
- * `MediaTrendVariables` is an interface representing the variables for the `MediaTrendQuery`.
- * It includes optional parameters for querying media trend data.
- * @see https://docs.anilist.co/reference/query
+ * {@link MediaTrendVariables} contains variables for the {@link MediaTrendQuery} operation.
+ *
+ * See {@link MediaTrendQuery} and {@link MediaTrendResponse} for the operation and response shape.
+ *
+ * Values are validated with `MediaTrendMappings` before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/mediatrend
  */
 interface MediaTrendVariables {
     /**
@@ -5560,9 +5802,13 @@ interface MediaTrendsPageResponse {
 }
 
 /**
- * `MediaTrendsVariables` is an interface representing the variables for the `MediaTrendsQuery`.
- * It includes optional page, per page, media id, date, trending, average score, popularity, episode, releasing, media id not, media id in, media id not in, date greater, date lesser, trending greater, trending lesser, trending not, average score greater, average score lesser, average score not, popularity greater, popularity lesser, popularity not, episode greater, episode lesser, episode not, sort, and as html.
- * @see https://docs.anilist.co/reference/query
+ * {@link MediaTrendsVariables} contains variables for the {@link MediaTrendsQuery} operation.
+ *
+ * See {@link MediaTrendsQuery} and {@link MediaTrendsPageResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/mediatrend
  */
 interface MediaTrendsVariables {
     /**
@@ -5704,9 +5950,13 @@ interface MediasPageResponse {
 }
 
 /**
- * `MediasVariables` is an interface representing the variables for the `MediasQuery`.
- * It includes optional page, per page, id, idMal, startDate, endDate, season, seasonYear, type, format, status, episodes, duration, chapters, volumes, isAdult, genre, tag, minimumTagRank, tagCategory, onList, licensedBy, licensedById, averageScore, popularity, source, countryOfOrigin, isLicensed, search, id_not, id_in, id_not_in, idMal_not, idMal_in, idMal_not_in, startDate_greater, startDate_lesser, startDate_like, endDate_greater, endDate_lesser, endDate_like, format_in, format_not, format_not_in, status_in, status_not, status_not_in, episodes_greater, episodes_lesser, duration_greater, duration_lesser, chapters_greater, chapters_lesser, volumes_greater, volumes_lesser, genre_in, genre_not_in, tag_in, tag_not_in, tagCategory_in, tagCategory_not_in, licensedBy_in, licensedById_in, averageScore_not, averageScore_greater, averageScore_lesser, popularity_not, popularity_greater, popularity_lesser, source_in, sort, and asHtml.
- * @see https://docs.anilist.co/reference/query
+ * {@link MediasVariables} contains variables for the {@link MediasQuery} operation.
+ *
+ * See {@link MediasQuery} and {@link MediasPageResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/media
  */
 interface MediasVariables {
     /**
@@ -6557,9 +6807,13 @@ interface MediaDeletionNotification {
 type NotificationResponse = AiringNotification | FollowingNotification | ActivityMessageNotification | ActivityNotification | ThreadNotification | ThreadLikeNotification | RelatedMediaAdditionNotification | MediaDataChangeNotification | MediaMergeNotification | MediaDeletionNotification;
 
 /**
- * `NotificationVariables` is an interface representing the variables for the `NotificationQuery`.
- * It includes optional parameters for querying notification data.
- * @see https://docs.anilist.co/reference/query
+ * {@link NotificationVariables} contains variables for the {@link NotificationQuery} operation.
+ *
+ * See {@link NotificationQuery} and {@link NotificationResponse} for the operation and response shape.
+ *
+ * Values are validated with `NotificationMappings` before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/union/notificationunion
  */
 interface NotificationVariables {
     /**
@@ -6605,9 +6859,13 @@ interface NotificationsPageResponse {
 }
 
 /**
- * `NotificationsVariables` is an interface representing the variables for the `NotificationsQuery`.
- * It includes optional page, per page, type, reset notification count, type in, and as html.
- * @see https://docs.anilist.co/reference/query
+ * {@link NotificationsVariables} contains variables for the {@link NotificationsQuery} operation.
+ *
+ * See {@link NotificationsQuery} and {@link NotificationsPageResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/union/notificationunion
  */
 interface NotificationsVariables {
     /**
@@ -6677,9 +6935,13 @@ interface RecommendationResponse {
 }
 
 /**
- * `RecommendationVariables` is an interface representing the variables for the `RecommendationQuery`.
- * It includes optional parameters for querying recommendation data.
- * @see https://docs.anilist.co/reference/query
+ * {@link RecommendationVariables} contains variables for the {@link RecommendationQuery} operation.
+ *
+ * See {@link RecommendationQuery} and {@link RecommendationResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/recommendation
  */
 interface RecommendationVariables {
     /**
@@ -6749,9 +7011,13 @@ interface RecommendationsPageResponse {
 }
 
 /**
- * `RecommendationsVariables` is an interface representing the variables for the `RecommendationsQuery`.
- * It includes optional page, per page, id, media id, media recommendation id, user id, rating, on list, rating greater, rating lesser, sort, and as html.
- * @see https://docs.anilist.co/reference/query
+ * {@link RecommendationsVariables} contains variables for the {@link RecommendationsQuery} operation.
+ *
+ * See {@link RecommendationsQuery} and {@link RecommendationsPageResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/recommendation
  */
 interface RecommendationsVariables {
     /**
@@ -6881,9 +7147,13 @@ interface ReviewResponse {
 }
 
 /**
- * `ReviewVariables` is an interface representing the variables for the `ReviewQuery`.
- * It includes optional parameters for querying review data.
- * @see https://docs.anilist.co/reference/query
+ * {@link ReviewVariables} contains variables for the {@link ReviewQuery} operation.
+ *
+ * See {@link ReviewQuery} and {@link ReviewResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/review
  */
 interface ReviewVariables {
     /**
@@ -6937,9 +7207,13 @@ interface ReviewsPageResponse {
 }
 
 /**
- * `ReviewsVariables` is an interface representing the variables for the `ReviewsQuery`.
- * It includes optional page, per page, id, media id, user id, media type, sort, and as html.
- * @see https://docs.anilist.co/reference/query
+ * {@link ReviewsVariables} contains variables for the {@link ReviewsQuery} operation.
+ *
+ * See {@link ReviewsQuery} and {@link ReviewsPageResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/review
  */
 interface ReviewsVariables {
     /**
@@ -7191,9 +7465,13 @@ interface StaffResponse {
 }
 
 /**
- * `StaffVariables` is an interface representing the variables for the `StaffQuery`.
- * It includes optional parameters for querying staff data.
- * @see https://docs.anilist.co/reference/query
+ * {@link StaffVariables} contains variables for the {@link StaffQuery} operation.
+ *
+ * See {@link StaffQuery} and {@link StaffResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/staff
  */
 interface StaffVariables {
     /**
@@ -7303,9 +7581,13 @@ interface StaffsPageResponse {
 }
 
 /**
- * `StaffsVariables` is an interface representing the variables for the `StaffsQuery`.
- * It includes optional page, per page, id, is birthday, search, id not, id in, id not in, sort, as html, staff media sort, staff media type, staff media on list, staff media page, staff media per page, characters sort, characters page, characters per page, character media sort, character media on list, character media page, and character media per page.
- * @see https://docs.anilist.co/reference/query
+ * {@link StaffsVariables} contains variables for the {@link StaffsQuery} operation.
+ *
+ * See {@link StaffsQuery} and {@link StaffsPageResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/staff
  */
 interface StaffsVariables {
     /**
@@ -7578,9 +7860,13 @@ interface StudioResponse {
 }
 
 /**
- * `StudioVariables` is an interface representing the variables for the `StudioQuery`.
- * It includes optional parameters for querying studio data.
- * @see https://docs.anilist.co/reference/query
+ * {@link StudioVariables} contains variables for the {@link StudioQuery} operation.
+ *
+ * See {@link StudioQuery} and {@link StudioResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/studio
  */
 interface StudioVariables {
     /**
@@ -7706,9 +7992,13 @@ interface StudiosPageResponse {
 }
 
 /**
- * `StudiosVariables` is an interface representing the variables for the `StudiosQuery`.
- * It includes optional page, per page, id, search, id not, id in, id not in, sort, as html, media sort, media is main, media on list, media page, media per page, staff media sort, staff media type, staff media on list, staff media page, staff media per page, characters sort, characters page, characters per page, character media sort, character media on list, character media page, and character media per page.
- * @see https://docs.anilist.co/reference/query
+ * {@link StudiosVariables} contains variables for the {@link StudiosQuery} operation.
+ *
+ * See {@link StudiosQuery} and {@link StudiosPageResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/studio
  */
 interface StudiosVariables {
     /**
@@ -8003,9 +8293,13 @@ interface ThreadCommentResponse {
 }
 
 /**
- * `ThreadCommentVariables` is an interface representing the variables for the `ThreadCommentQuery`.
- * It includes optional parameters for querying thread comment data.
- * @see https://docs.anilist.co/reference/query
+ * {@link ThreadCommentVariables} contains variables for the {@link ThreadCommentQuery} operation.
+ *
+ * See {@link ThreadCommentQuery} and {@link ThreadCommentResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/threadcomment
  */
 interface ThreadCommentVariables {
     /**
@@ -8055,9 +8349,13 @@ interface ThreadCommentsPageResponse {
 }
 
 /**
- * `ThreadCommentsVariables` is an interface representing the variables for the `ThreadCommentsQuery`.
- * The AniList API requires a `threadId` or a `userId`; the remaining parameters are optional.
- * @see https://docs.anilist.co/reference/query
+ * {@link ThreadCommentsVariables} contains variables for the {@link ThreadCommentsQuery} operation.
+ *
+ * See {@link ThreadCommentsQuery} and {@link ThreadCommentsPageResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/threadcomment
  */
 interface ThreadCommentsVariables {
     /**
@@ -8091,9 +8389,13 @@ interface ThreadCommentsVariables {
 }
 
 /**
- * `ThreadVariables` is an interface representing the variables for the `ThreadQuery`.
- * It includes optional parameters for querying thread data.
- * @see https://docs.anilist.co/reference/query
+ * {@link ThreadVariables} contains variables for the {@link ThreadQuery} operation.
+ *
+ * See {@link ThreadQuery} and {@link ThreadResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/thread
  */
 interface ThreadVariables {
     /**
@@ -8163,10 +8465,14 @@ interface ThreadsPageResponse {
 }
 
 /**
- * `ThreadsVariables` is an interface representing the variables for the `ThreadsQuery`.
- * It includes optional page, per page, id, user id, reply user id, subscribed, category id, media category id, search, id in, sort, and as html.
- * @see https://docs.anilist.co/reference/query
- */
+ * {@link ThreadsVariables} contains variables for the {@link ThreadsQuery} operation.
+ *
+ * See {@link ThreadsQuery} and {@link ThreadsPageResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/thread
+ */
 interface ThreadsVariables {
     /**
      * `page` is a number representing the page number.
@@ -8219,9 +8525,13 @@ interface ThreadsVariables {
 }
 
 /**
- * `UserVariables` is an interface representing the variables for the `UserQuery`.
- * It includes optional parameters for querying user data.
- * @see https://docs.anilist.co/reference/query
+ * {@link UserVariables} contains variables for the {@link UserQuery} operation.
+ *
+ * See {@link UserQuery} and {@link UserResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/user
  */
 interface UserVariables {
     /**
@@ -8291,9 +8601,13 @@ interface UsersPageResponse {
 }
 
 /**
- * `UsersVariables` is an interface representing the variables for the `UsersQuery`.
- * It includes optional page, per page, id, name, is moderator, search, sort, as html, anime stat limit, manga stat limit, anime stat sort, and manga stat sort.
- * @see https://docs.anilist.co/reference/query
+ * {@link UsersVariables} contains variables for the {@link UsersQuery} operation.
+ *
+ * See {@link UsersQuery} and {@link UsersPageResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/user
  */
 interface UsersVariables {
     /**
@@ -8350,97 +8664,104 @@ interface UsersVariables {
  * The `query` member (query + page operations) of the `AniListApi` type.
  */
 
+/**
+ * Typed AniList query operations exposed by `AniListApi`.
+ *
+ * @see https://docs.anilist.co/reference/query
+ */
 type AniListQueries = {
     /**
-     * Query methods for fetching data from the Anilist API.
+     * Query methods for fetching data from the AniList API.
      * @public
      * @type {Object}
-     * @property {Function} user - Fetches user data from the Anilist API.
-     * @property {Function} media - Fetches media data from the Anilist API.
-     * @property {Function} mediaTrend - Fetches media trend data from the Anilist API.
-     * @property {Function} airingSchedule - Fetches airing schedule data from the Anilist API.
-     * @property {Function} character - Fetches character data from the Anilist API.
-     * @property {Function} staff - Fetches staff data from the Anilist API.
-     * @property {Function} mediaList - Fetches media list data from the Anilist API.
-     * @property {Function} mediaListCollection - Fetches media list collection data from the Anilist API.
-     * @property {Function} like - Fetches users who liked a model from the Anilist API.
-     * @property {Function} genreCollection - Fetches genre collection data from the Anilist API.
-     * @property {Function} mediaTagCollection - Fetches media tag collection data from the Anilist API.
-     * @property {Function} viewer - Fetches viewer data from the Anilist API.
-     * @property {Function} notification - Fetches notification data from the Anilist API.
-     * @property {Function} studio - Fetches studio data from the Anilist API.
-     * @property {Function} review - Fetches review data from the Anilist API.
-     * @property {Function} activity - Fetches activity data from the Anilist API.
-     * @property {Function} activityReply - Fetches activity reply data from the Anilist API.
-     * @property {Function} following - Fetches following data from the Anilist API.
-     * @property {Function} follower - Fetches follower data from the Anilist API.
-     * @property {Function} thread - Fetches thread data from the Anilist API.
-     * @property {Function} threadComment - Fetches thread comment data from the Anilist API.
-     * @property {Function} recommendation - Fetches recommendation data from the Anilist API.
-     * @property {Function} markdown - Fetches markdown data from the Anilist API.
-     * @property {Function} aniChartUser - Fetches aniChart user data from the Anilist API.
-     * @property {Function} siteStatistics - Fetches site statistics data from the Anilist API.
-     * @property {Function} externalLinkSourceCollection - Fetches external link source collection data from the Anilist API.
-     * @property {Object} page - Fetches pages of data from the Anilist API.
+     * @property {Function} user - Fetches user data from the AniList API.
+     * @property {Function} media - Fetches media data from the AniList API.
+     * @property {Function} mediaTrend - Fetches media trend data from the AniList API.
+     * @property {Function} airingSchedule - Fetches airing schedule data from the AniList API.
+     * @property {Function} character - Fetches character data from the AniList API.
+     * @property {Function} staff - Fetches staff data from the AniList API.
+     * @property {Function} mediaList - Fetches media list data from the AniList API.
+     * @property {Function} mediaListCollection - Fetches media list collection data from the AniList API.
+     * @property {Function} like - Fetches users who liked a model from the AniList API.
+     * @property {Function} genreCollection - Fetches genre collection data from the AniList API.
+     * @property {Function} mediaTagCollection - Fetches media tag collection data from the AniList API.
+     * @property {Function} viewer - Fetches viewer data from the AniList API.
+     * @property {Function} notification - Fetches notification data from the AniList API.
+     * @property {Function} studio - Fetches studio data from the AniList API.
+     * @property {Function} review - Fetches review data from the AniList API.
+     * @property {Function} activity - Fetches activity data from the AniList API.
+     * @property {Function} activityReply - Fetches activity reply data from the AniList API.
+     * @property {Function} following - Fetches following data from the AniList API.
+     * @property {Function} follower - Fetches follower data from the AniList API.
+     * @property {Function} thread - Fetches thread data from the AniList API.
+     * @property {Function} threadComment - Fetches thread comment data from the AniList API.
+     * @property {Function} recommendation - Fetches recommendation data from the AniList API.
+     * @property {Function} markdown - Fetches markdown data from the AniList API.
+     * @property {Function} aniChartUser - Fetches AniChart user data from the AniList API.
+     * @property {Function} siteStatistics - Fetches site statistics data from the AniList API.
+     * @property {Function} externalLinkSourceCollection - Fetches external link source collection data from the AniList API.
+     * @property {Object} page - Fetches pages of data from the AniList API.
+     * @see https://docs.anilist.co/reference/query
      */
     query: {
         /**
-         * Fetches user data from the Anilist API.
-         * @param {UserVariables} variables - The variables for the query.
-         * @returns {Promise<UserResponse>} A promise that resolves to the user's data.
+         * `UserQuery` fetches a single user by `id` or `userName`. Returns a {@link UserResponse}.
+         * @param {UserVariables} variables - The {@link UserVariables} for the query.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<UserResponse>} A promise that resolves to the user's {@link UserResponse} data.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.query.user({id: 542244, asHtml: true});
          * ```
          * @see https://docs.anilist.co/reference/object/user
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         user: (variables: UserVariables, options?: RequestOptions) => Promise<UserResponse>;
         /**
-         * Fetches media data from the Anilist API.
-         * @param {MediaVariables} variables - The variables for the query.
-         * @returns {Promise<MediaResponse>} A promise that resolves to the media data.
+         * `MediaQuery` fetches the media data for a single anime or manga by `id` or `idMal`. Returns a {@link MediaResponse}.
+         * @param {MediaVariables} variables - The {@link MediaVariables} for the query.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<MediaResponse>} A promise that resolves to the {@link MediaResponse} data.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.query.media({id: 1, type: 'ANIME'});
          * ```
          * @see https://docs.anilist.co/reference/object/media
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         media: (variables: MediaVariables, options?: RequestOptions) => Promise<MediaResponse>;
         /**
-         * Fetches media trend data from the Anilist API.
-         * @param {MediaTrendVariables} variables - The variables for the query.
-         * @returns {Promise<MediaTrendResponse>} A promise that resolves to the media trend data.
+         * `MediaTrendQuery` fetches the trend entry for a single airing media. Returns a {@link MediaTrendResponse}.
+         * @param {MediaTrendVariables} variables - The {@link MediaTrendVariables} for the query.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<MediaTrendResponse>} A promise that resolves to the {@link MediaTrendResponse} data.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.query.mediaTrend({mediaId: 1, type: 'ANIME'});
          * ```
          * @see https://docs.anilist.co/reference/object/mediatrend
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         mediaTrend: (variables: MediaTrendVariables, options?: RequestOptions) => Promise<MediaTrendResponse>;
         /**
-         * Fetches airing schedule data from the Anilist API.
-         * @param {AiringScheduleVariables} variables - The variables for the query.
-         * @returns {Promise<AiringScheduleResponse>} A promise that resolves to the airing schedule data.
+         * `AiringScheduleQuery` fetches a single airing schedule entry by `id` or `mediaId`. Returns an {@link AiringScheduleResponse}.
+         * @param {AiringScheduleVariables} variables - The {@link AiringScheduleVariables} for the query.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<AiringScheduleResponse>} A promise that resolves to the {@link AiringScheduleResponse} data.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.query.airingSchedule({mediaId: 130590});
          * ```
-         * Must be quering an airing anime. Returns error if not.
+         * Must be querying an airing anime. Returns error if not.
          * @see https://docs.anilist.co/reference/object/airingschedule
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         airingSchedule: (variables: AiringScheduleVariables, options?: RequestOptions) => Promise<AiringScheduleResponse>;
         /**
-         * Fetches character data from the Anilist API.
-         * @param {CharacterVariables} variables - The variables for the query.
-         * @returns {Promise<CharacterResponse>} A promise that resolves to the character data.
+         * `CharacterQuery` fetches a single character by `id`. Returns a {@link CharacterResponse}.
+         * @param {CharacterVariables} variables - The {@link CharacterVariables} for the query.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<CharacterResponse>} A promise that resolves to the {@link CharacterResponse} data.
          *
          * @example
          * ```typescript
@@ -8455,13 +8776,13 @@ type AniListQueries = {
          * });
          * ```
          * @see https://docs.anilist.co/reference/object/character
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         character: (variables: CharacterVariables, options?: RequestOptions) => Promise<CharacterResponse>;
         /**
-         * Fetches staff data from the Anilist API.
-         * @param {StaffVariables} variables - The variables for the query.
-         * @returns {Promise<StaffResponse>} A promise that resolves to the staff data.
+         * `StaffQuery` fetches a single staff member by `id`. Returns a {@link StaffResponse}.
+         * @param {StaffVariables} variables - The {@link StaffVariables} for the query.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<StaffResponse>} A promise that resolves to the {@link StaffResponse} data.
          *
          * @example
          * ```typescript
@@ -8483,26 +8804,26 @@ type AniListQueries = {
          * });
          * ```
          * @see https://docs.anilist.co/reference/object/staff
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         staff: (variables: StaffVariables, options?: RequestOptions) => Promise<StaffResponse>;
         /**
-         * Fetches media list data from the Anilist API.
-         * @param {MediaListVariables} variables - The variables for the query.
-         * @returns {Promise<MediaListResponse>} A promise that resolves to the media list data.
+         * `MediaListQuery` fetches a single media list entry by `id`, or by `userName`/`userId` plus `mediaId`. Returns a {@link MediaListResponse}.
+         * @param {MediaListVariables} variables - The {@link MediaListVariables} for the query.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<MediaListResponse>} A promise that resolves to the {@link MediaListResponse} data.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.query.mediaList({userId: 542244});
          * ```
          * @see https://docs.anilist.co/reference/object/medialist
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         mediaList: (variables: MediaListVariables, options?: RequestOptions) => Promise<MediaListResponse>;
         /**
-         * Fetches media list collection data from the Anilist API.
-         * @param {MediaListCollectionVariables} variables - The variables for the query.
-         * @returns {Promise<MediaListCollectionResponse>} A promise that resolves to the media list collection data.
+         * `MediaListCollectionQuery` fetches a user's full list collection, chunked via `chunk`/`perChunk`. Returns a {@link MediaListCollectionResponse}; flatten it with `AniListHelpers.flattenMediaListCollection`.
+         * @param {MediaListCollectionVariables} variables - The {@link MediaListCollectionVariables} for the query.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<MediaListCollectionResponse>} A promise that resolves to the {@link MediaListCollectionResponse} data.
          *
          * @example
          * ```typescript
@@ -8515,37 +8836,38 @@ type AniListQueries = {
          * });
          * ```
          * @see https://docs.anilist.co/reference/object/medialistcollection
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         mediaListCollection: (variables: MediaListCollectionVariables, options?: RequestOptions) => Promise<MediaListCollectionResponse>;
         /**
-         * Fetches genre collection data from the Anilist API.
-         * @returns {Promise<String>} A promise that resolves to the genre collection data.
+         * `GenreCollectionQuery` returns the list of all genres recognized by AniList. No variables are required.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<string>} A promise that resolves to the genre collection data.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.query.genreCollection()
          * ```
          * @see https://docs.anilist.co/reference/query
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         genreCollection: (options?: RequestOptions) => Promise<string>;
         /**
-         * Fetches media tag collection data from the Anilist API.
-         * @returns {Promise<MediaTagCollectionResponse>} A promise that resolves to the media tag collection data.
+         * `MediaTagCollectionQuery` returns all media tags recognized by AniList, optionally filtered by `variables`. Returns a {@link MediaTagCollectionResponse}.
+         * @param {MediaTagCollectionVariables} variables - Optional {@link MediaTagCollectionVariables} filters for the query.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<MediaTagCollectionResponse>} A promise that resolves to the {@link MediaTagCollectionResponse} data.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.query.mediaTagCollection()
          * ```
          * @see https://docs.anilist.co/reference/object/mediatag
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         mediaTagCollection: (variables?: MediaTagCollectionVariables, options?: RequestOptions) => Promise<MediaTagCollectionResponse>;
         /**
-         * Fetches viewer data from the Anilist API.
-         * @param {UserVariables} variables - The variables for the query.
-         * @returns {Promise<UserResponse>} A promise that resolves to the viewer data.
+         * `ViewerQuery` fetches the currently authenticated user. Returns a {@link UserResponse}.
+         * @param {UserVariables} variables - The {@link UserVariables} for the query.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<UserResponse>} A promise that resolves to the {@link UserResponse} data.
          *
          * @example
          * ```typescript
@@ -8553,13 +8875,13 @@ type AniListQueries = {
          * ```
          * Must be authenticated.
          * @see https://docs.anilist.co/reference/object/user
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         viewer: (variables: UserVariables, options?: RequestOptions) => Promise<UserResponse>;
         /**
-         * Fetches notification data from the Anilist API.
-         * @param {NotificationVariables} variables - The variables for the query.
-         * @returns {Promise<NotificationResponse>} A promise that resolves to the notification data.
+         * `NotificationQuery` fetches a single notification by `id`. Returns a {@link NotificationResponse}. Must be authenticated.
+         * @param {NotificationVariables} variables - The {@link NotificationVariables} for the query.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<NotificationResponse>} A promise that resolves to the {@link NotificationResponse} data.
          *
          * @example
          * ```typescript
@@ -8567,129 +8889,129 @@ type AniListQueries = {
          * ```
          * Must be authenticated.
          * @see https://docs.anilist.co/reference/union/notificationunion
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         notification: (variables: NotificationVariables, options?: RequestOptions) => Promise<NotificationResponse>;
         /**
-         * Fetches studio data from the Anilist API.
-         * @param {StudioVariables} variables - The variables for the query.
-         * @returns {Promise<StudioResponse>} A promise that resolves to the studio data.
+         * `StudioQuery` fetches a single studio by `id`. Returns a {@link StudioResponse}.
+         * @param {StudioVariables} variables - The {@link StudioVariables} for the query.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<StudioResponse>} A promise that resolves to the {@link StudioResponse} data.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.query.studio({id: 561, asHtml: true});
          * ```
          * @see https://docs.anilist.co/reference/object/studio
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         studio: (variables: StudioVariables, options?: RequestOptions) => Promise<StudioResponse>;
         /**
-         * Fetches review data from the Anilist API.
-         * @param {ReviewVariables} variables - The variables for the query.
-         * @returns {Promise<ReviewResponse>} A promise that resolves to the review data.
+         * `ReviewQuery` fetches a single review by `id`. Returns a {@link ReviewResponse}.
+         * @param {ReviewVariables} variables - The {@link ReviewVariables} for the query.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<ReviewResponse>} A promise that resolves to the {@link ReviewResponse} data.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.query.review({id: 8008, asHtml: true});
          * ```
          * @see https://docs.anilist.co/reference/object/review
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         review: (variables: ReviewVariables, options?: RequestOptions) => Promise<ReviewResponse>;
         /**
-         * Fetches activity data from the Anilist API.
-         * @param {ActivityVariables} variables - The variables for the query.
-         * @returns {Promise<Activity>} A promise that resolves to the activity data.
+         * `ActivityQuery` fetches a single activity by `id`. Returns an {@link Activity} (a union of text, message, and list activities).
+         * @param {ActivityVariables} variables - The {@link ActivityVariables} for the query.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<Activity>} A promise that resolves to the {@link Activity} data.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.query.activity({id: 723235883, asHtml: true});
          * ```
          * @see https://docs.anilist.co/reference/union/activityunion
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         activity: (variables: ActivityVariables, options?: RequestOptions) => Promise<Activity>;
         /**
-         * Fetches activity reply data from the Anilist API.
-         * @param {ActivityReplyVariables} variables - The variables for the query.
-         * @returns {Promise<ActivityReply>} A promise that resolves to the activity reply data.
+         * `ActivityReplyQuery` fetches a single activity reply by `id`. Returns an {@link ActivityReply}.
+         * @param {ActivityReplyVariables} variables - The {@link ActivityReplyVariables} for the query.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<ActivityReply>} A promise that resolves to the {@link ActivityReply} data.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.query.activityReply({id: 12191046, asHtml: true});
          * ```
          * @see https://docs.anilist.co/reference/object/activityreply
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         activityReply: (variables: ActivityReplyVariables, options?: RequestOptions) => Promise<ActivityReply>;
         /**
-         * Fetches following data from the Anilist API.
-         * @param {FollowingVariables} variables - The variables for the query.
-         * @returns {Promise<UserResponse>} A promise that resolves to the following data.
+         * `FollowingQuery` fetches a single user that the given `userId` follows. Returns a {@link UserResponse}.
+         * @param {FollowingVariables} variables - The {@link FollowingVariables} for the query.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<UserResponse>} A promise that resolves to the {@link UserResponse} data.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.query.following({userId: 542244});
          * ```
          * @see https://docs.anilist.co/reference/object/user
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         following: (variables: FollowingVariables, options?: RequestOptions) => Promise<UserResponse>;
         /**
-         * Fetches follower data from the Anilist API.
-         * @param {FollowerVariables} variables - The variables for the query.
-         * @returns {Promise<UserResponse>} A promise that resolves to the follower data.
+         * `FollowerQuery` fetches a single follower of the given `userId`. Returns a {@link UserResponse}.
+         * @param {FollowerVariables} variables - The {@link FollowerVariables} for the query.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<UserResponse>} A promise that resolves to the {@link UserResponse} data.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.query.follower({userId: 542244});
          * ```
          * @see https://docs.anilist.co/reference/object/user
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         follower: (variables: FollowerVariables, options?: RequestOptions) => Promise<UserResponse>;
         /**
-         * Fetches thread data from the Anilist API.
-         * @param {ThreadVariables} variables - The variables for the query.
-         * @returns {Promise<ThreadResponse>} A promise that resolves to the thread data.
+         * `ThreadQuery` fetches a single forum thread by `id`. Returns a {@link ThreadResponse}.
+         * @param {ThreadVariables} variables - The {@link ThreadVariables} for the query.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<ThreadResponse>} A promise that resolves to the {@link ThreadResponse} data.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.query.thread({id: 71881, asHtml: true});
          * ```
          * @see https://docs.anilist.co/reference/object/thread
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         thread: (variables: ThreadVariables, options?: RequestOptions) => Promise<ThreadResponse>;
         /**
-         * Fetches thread comment data from the Anilist API.
-         * @param {ThreadCommentVariables} variables - The variables for the query.
-         * @returns {Promise<ThreadCommentResponse>} A promise that resolves to the thread comment data.
+         * `ThreadCommentQuery` fetches a single thread comment by `id`. Returns a {@link ThreadCommentResponse}.
+         * @param {ThreadCommentVariables} variables - The {@link ThreadCommentVariables} for the query.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<ThreadCommentResponse>} A promise that resolves to the {@link ThreadCommentResponse} data.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.query.threadComment({id: 2555166, asHtml: true});
          * ```
          * @see https://docs.anilist.co/reference/object/threadcomment
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         threadComment: (variables: ThreadCommentVariables, options?: RequestOptions) => Promise<ThreadCommentResponse>;
         /**
-         * Fetches recommendation data from the Anilist API.
-         * @param {RecommendationVariables} variables - The variables for the query.
-         * @returns {Promise<RecommendationResponse>} A promise that resolves to the recommendation data.
+         * `RecommendationQuery` fetches a single recommendation by `id` or `mediaId`. Returns a {@link RecommendationResponse}.
+         * @param {RecommendationVariables} variables - The {@link RecommendationVariables} for the query.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<RecommendationResponse>} A promise that resolves to the {@link RecommendationResponse} data.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.query.recommendation({mediaId: 156822, asHtml: true});
          * ```
          * @see https://docs.anilist.co/reference/object/recommendation
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         recommendation: (variables: RecommendationVariables, options?: RequestOptions) => Promise<RecommendationResponse>;
         /**
-         * Fetches markdown data from the Anilist API.
-         * @param {MarkdownVariables} variables - The variables for the query.
+         * `MarkdownQuery` parses AniList markdown into HTML. Returns the rendered HTML string.
+         * @param {MarkdownVariables} variables - The {@link MarkdownVariables} for the query.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
          * @returns {Promise<string>} A promise that resolves to the markdown data.
          *
          * @example
@@ -8697,12 +9019,12 @@ type AniListQueries = {
          * await aniLink.anilist.query.markdown({markdown: 'Hello, world!'});
          * ```
          * @see https://docs.anilist.co/reference/object/parsedmarkdown
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         markdown: (variables: MarkdownVariables, options?: RequestOptions) => Promise<string>;
         /**
-         * Fetches aniChart user data from the Anilist API.
-         * @returns {Promise<AniChartUserResponse>} A promise that resolves to the aniChart user data.
+         * `AniChartUserQuery` fetches the AniChart settings for the authenticated user. Returns an {@link AniChartUserResponse}. Must be authenticated.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<AniChartUserResponse>} A promise that resolves to the {@link AniChartUserResponse} data.
          *
          * @example
          * ```typescript
@@ -8710,291 +9032,295 @@ type AniListQueries = {
          * ```
          * Must be authenticated.
          * @see https://docs.anilist.co/reference/object/anichartuser
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         aniChartUser: (options?: RequestOptions) => Promise<AniChartUserResponse>;
         /**
-         * Fetches site statistics data from the Anilist API.
-         * @returns {Promise<SiteStatisticsResponse>} A promise that resolves to the site statistics data.
+         * `SiteStatisticsQuery` fetches aggregate AniList site statistics, optionally filtered by `variables`. Returns a {@link SiteStatisticsResponse}.
+         * @param {SiteStatisticsVariables} variables - Optional {@link SiteStatisticsVariables} filters for the query.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<SiteStatisticsResponse>} A promise that resolves to the {@link SiteStatisticsResponse} data.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.query.siteStatistics();
          * ```
          * @see https://docs.anilist.co/reference/object/sitestatistics
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         siteStatistics: (variables?: SiteStatisticsVariables, options?: RequestOptions) => Promise<SiteStatisticsResponse>;
         /**
-         * Fetches external link source collection data from the Anilist API.
-         * @returns {Promise<ExternalLinkSourceCollectionResponse>} A promise that resolves to the external link source collection data.
+         * `ExternalLinkSourceCollectionQuery` returns the available external link sources, optionally filtered by `variables`. Returns an {@link ExternalLinkSourceCollectionResponse}.
+         * @param {ExternalLinkSourceCollectionVariables} variables - Optional {@link ExternalLinkSourceCollectionVariables} filters for the query.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<ExternalLinkSourceCollectionResponse>} A promise that resolves to the {@link ExternalLinkSourceCollectionResponse} data.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.query.externalLinkSourceCollection();
          * ```
          * @see https://docs.anilist.co/reference/query
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         externalLinkSourceCollection: (variables?: ExternalLinkSourceCollectionVariables, options?: RequestOptions) => Promise<ExternalLinkSourceCollectionResponse>;
         /**
-         * Fetches pages of data from the Anilist API.
-         * All page queries have the same structure as original queries with the addition of `page` and `perPage` variables.
+         * {@link AniListQueries} groups the paginated query operations. All page queries mirror the single-object queries above
+         * with the addition of `page` and `perPage` variables, and return a `*PageResponse` carrying the items
+         * plus `PageInfo` pagination metadata. Drive them with `paginate` or
+         * `paginatePages` to walk all pages automatically.
          *
          * @public
          * @type {Object}
-         * @property {Function} users - Fetches users data from the Anilist API.
-         * @property {Function} medias - Fetches medias data from the Anilist API.
-         * @property {Function} characters - Fetches characters data from the Anilist API.
-         * @property {Function} staffs - Fetches staffs data from the Anilist API.
-         * @property {Function} studios - Fetches studios data from the Anilist API.
-         * @property {Function} mediaLists - Fetches media lists data from the Anilist API.
-         * @property {Function} airingSchedules - Fetches airing schedules data from the Anilist API.
-         * @property {Function} mediaTrends - Fetches media trends data from the Anilist API.
-         * @property {Function} notifications - Fetches notifications data from the Anilist API.
-         * @property {Function} followers - Fetches followers data from the Anilist API.
-         * @property {Function} following - Fetches following data from the Anilist API.
-         * @property {Function} activities - Fetches activities data from the Anilist API.
-         * @property {Function} activityReplies - Fetches activity replies data from the Anilist API.
-         * @property {Function} threads - Fetches threads data from the Anilist API.
-         * @property {Function} threadComments - Fetches thread comments data from the Anilist API.
-         * @property {Function} reviews - Fetches reviews data from the Anilist API.
-         * @property {Function} recommendations - Fetches recommendations data from the Anilist API.
-         * @property {Function} likes - Fetches likes data from the Anilist API.
+         * @property {Function} users - Fetches users data from the AniList API.
+         * @property {Function} medias - Fetches medias data from the AniList API.
+         * @property {Function} characters - Fetches characters data from the AniList API.
+         * @property {Function} staffs - Fetches staffs data from the AniList API.
+         * @property {Function} studios - Fetches studios data from the AniList API.
+         * @property {Function} mediaLists - Fetches media lists data from the AniList API.
+         * @property {Function} airingSchedules - Fetches airing schedules data from the AniList API.
+         * @property {Function} mediaTrends - Fetches media trends data from the AniList API.
+         * @property {Function} notifications - Fetches notifications data from the AniList API.
+         * @property {Function} followers - Fetches followers data from the AniList API.
+         * @property {Function} following - Fetches following data from the AniList API.
+         * @property {Function} activities - Fetches activities data from the AniList API.
+         * @property {Function} activityReplies - Fetches activity replies data from the AniList API.
+         * @property {Function} threads - Fetches threads data from the AniList API.
+         * @property {Function} threadComments - Fetches thread comments data from the AniList API.
+         * @property {Function} reviews - Fetches reviews data from the AniList API.
+         * @property {Function} recommendations - Fetches recommendations data from the AniList API.
+         * @property {Function} likes - Fetches likes data from the AniList API.
          */
         page: {
             /**
-             * Fetches users data from the Anilist API.
-             * @param {UsersVariables} variables - The variables for the query.
-             * @returns {Promise<UsersPageResponse>} A promise that resolves to the users data and pagination metadata.
+             * `UsersQuery` fetches a page of users. Returns a {@link UsersPageResponse} with the items and `PageInfo`.
+             * @param {UsersVariables} variables - The {@link UsersVariables} for the query.
+             * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+             * @returns {Promise<UsersPageResponse>} A promise that resolves to the {@link UsersPageResponse} data and pagination metadata.
              *
              * @example
              * ```typescript
              * await aniLink.anilist.query.page.users({page: 1, perPage: 10});
              * ```
              * @see https://docs.anilist.co/reference/object/user
-             * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
              */
             users: (variables: UsersVariables, options?: RequestOptions) => Promise<UsersPageResponse>;
             /**
-             * Fetches medias data from the Anilist API.
-             * @param {MediasVariables} variables - The variables for the query.
-             * @returns {Promise<MediasPageResponse>} A promise that resolves to the medias data and pagination metadata.
+             * `MediasQuery` fetches a page of anime/manga. Returns a {@link MediasPageResponse} with the items and `PageInfo`.
+             * @param {MediasVariables} variables - The {@link MediasVariables} for the query.
+             * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+             * @returns {Promise<MediasPageResponse>} A promise that resolves to the {@link MediasPageResponse} data and pagination metadata.
              *
              * @example
              * ```typescript
              * await aniLink.anilist.query.page.medias({page: 1, perPage: 10, type: 'ANIME'});
              * ```
              * @see https://docs.anilist.co/reference/object/media
-             * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
              */
             medias: (variables: MediasVariables, options?: RequestOptions) => Promise<MediasPageResponse>;
             /**
-             * Fetches characters data from the Anilist API.
-             * @param {CharactersVariables} variables - The variables for the query.
-             * @returns {Promise<CharactersPageResponse>} A promise that resolves to the characters data and pagination metadata.
+             * `CharactersQuery` fetches a page of characters. Returns a {@link CharactersPageResponse} with the items and `PageInfo`.
+             * @param {CharactersVariables} variables - The {@link CharactersVariables} for the query.
+             * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+             * @returns {Promise<CharactersPageResponse>} A promise that resolves to the {@link CharactersPageResponse} data and pagination metadata.
              *
              * @example
              * ```typescript
              * await aniLink.anilist.query.page.characters({page: 1, perPage: 10});
              * ```
              * @see https://docs.anilist.co/reference/object/character
-             * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
              */
             characters: (variables: CharactersVariables, options?: RequestOptions) => Promise<CharactersPageResponse>;
             /**
-             * Fetches staffs data from the Anilist API.
-             * @param {StaffsVariables} variables - The variables for the query.
-             * @returns {Promise<StaffsPageResponse>} A promise that resolves to the staffs data and pagination metadata.
+             * `StaffsQuery` fetches a page of staff members. Returns a {@link StaffsPageResponse} with the items and `PageInfo`.
+             * @param {StaffsVariables} variables - The {@link StaffsVariables} for the query.
+             * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+             * @returns {Promise<StaffsPageResponse>} A promise that resolves to the {@link StaffsPageResponse} data and pagination metadata.
              *
              * @example
              * ```typescript
              * await aniLink.anilist.query.page.staffs({page: 1, perPage: 10});
              * ```
              * @see https://docs.anilist.co/reference/object/staff
-             * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
              */
             staffs: (variables: StaffsVariables, options?: RequestOptions) => Promise<StaffsPageResponse>;
             /**
-             * Fetches studios data from the Anilist API.
-             * @param {StudiosVariables} variables - The variables for the query.
-             * @returns {Promise<StudiosPageResponse>} A promise that resolves to the studios data and pagination metadata.
+             * `StudiosQuery` fetches a page of studios. Returns a {@link StudiosPageResponse} with the items and `PageInfo`.
+             * @param {StudiosVariables} variables - The {@link StudiosVariables} for the query.
+             * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+             * @returns {Promise<StudiosPageResponse>} A promise that resolves to the {@link StudiosPageResponse} data and pagination metadata.
              *
              * @example
              * ```typescript
              * await aniLink.anilist.query.page.studios({page: 1, perPage: 10});
              * ```
              * @see https://docs.anilist.co/reference/object/studio
-             * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
              */
             studios: (variables: StudiosVariables, options?: RequestOptions) => Promise<StudiosPageResponse>;
             /**
-             * Fetches media lists data from the Anilist API.
-             * @param {MediaListsVariables} variables - The variables for the query.
-             * @returns {Promise<MediaListsPageResponse>} A promise that resolves to the media lists data and pagination metadata.
+             * `MediaListsQuery` fetches a page of media list entries. Returns a {@link MediaListsPageResponse} with the items and `PageInfo`.
+             * @param {MediaListsVariables} variables - The {@link MediaListsVariables} for the query.
+             * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+             * @returns {Promise<MediaListsPageResponse>} A promise that resolves to the {@link MediaListsPageResponse} data and pagination metadata.
              *
              * @example
              * ```typescript
              * await aniLink.anilist.query.page.mediaLists({page: 1, perPage: 10, userId: 542244});
              * ```
              * @see https://docs.anilist.co/reference/object/medialist
-             * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
              */
             mediaLists: (variables: MediaListsVariables, options?: RequestOptions) => Promise<MediaListsPageResponse>;
             /**
-             * Fetches airing schedules data from the Anilist API.
-             * @param {AiringSchedulesVariables} variables - The variables for the query.
-             * @returns {Promise<AiringSchedulesPageResponse>} A promise that resolves to the airing schedules data and pagination metadata.
+             * `AiringSchedulesQuery` fetches a page of airing schedule entries. Returns an {@link AiringSchedulesPageResponse} with the items and `PageInfo`.
+             * @param {AiringSchedulesVariables} variables - The {@link AiringSchedulesVariables} for the query.
+             * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+             * @returns {Promise<AiringSchedulesPageResponse>} A promise that resolves to the {@link AiringSchedulesPageResponse} data and pagination metadata.
              *
              * @example
              * ```typescript
              * await aniLink.anilist.query.page.airingSchedules({page: 1, perPage: 10});
              * ```
              * @see https://docs.anilist.co/reference/object/airingschedule
-             * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
              */
             airingSchedules: (variables: AiringSchedulesVariables, options?: RequestOptions) => Promise<AiringSchedulesPageResponse>;
             /**
-             * Fetches media trends data from the Anilist API.
-             * @param {MediaTrendsVariables} variables - The variables for the query.
-             * @returns {Promise<MediaTrendsPageResponse>} A promise that resolves to the media trends data and pagination metadata.
+             * `MediaTrendsQuery` fetches a page of media trend entries. Returns a {@link MediaTrendsPageResponse} with the items and `PageInfo`.
+             * @param {MediaTrendsVariables} variables - The {@link MediaTrendsVariables} for the query.
+             * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+             * @returns {Promise<MediaTrendsPageResponse>} A promise that resolves to the {@link MediaTrendsPageResponse} data and pagination metadata.
              *
              * @example
              * ```typescript
              * await aniLink.anilist.query.page.mediaTrends({page: 1, perPage: 10, type: 'ANIME'});
              * ```
-             * Must be quering an airing anime. Returns error if not.
+             * Must be querying an airing anime. Returns error if not.
              * @see https://docs.anilist.co/reference/object/mediatrend
-             * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
              */
             mediaTrends: (variables: MediaTrendsVariables, options?: RequestOptions) => Promise<MediaTrendsPageResponse>;
             /**
-             * Fetches notifications data from the Anilist API.
-             * @param {NotificationsVariables} variables - The variables for the query.
-             * @returns {Promise<NotificationsPageResponse>} A promise that resolves to the notifications data and pagination metadata.\
+             * `NotificationsQuery` fetches a page of the authenticated user's notifications. Returns a {@link NotificationsPageResponse} with the items and `PageInfo`. Must be authenticated.
+             * @param {NotificationsVariables} variables - The {@link NotificationsVariables} for the query.
+             * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+             * @returns {Promise<NotificationsPageResponse>} A promise that resolves to the {@link NotificationsPageResponse} data and pagination metadata.
              *
              * @example
              * ```typescript
              * await aniLink.anilist.query.page.notifications({page: 1, perPage: 10});
              * ```
              * @see https://docs.anilist.co/reference/union/notificationunion
-             * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
              */
             notifications: (variables: NotificationsVariables, options?: RequestOptions) => Promise<NotificationsPageResponse>;
             /**
-             * Fetches followers data from the Anilist API.
-             * @param {FollowersVariables} variables - The variables for the query.
-             * @returns {Promise<FollowersPageResponse>} A promise that resolves to the followers data and pagination metadata.
+             * `FollowersQuery` fetches a page of a user's followers. Returns a {@link FollowersPageResponse} with the items and `PageInfo`.
+             * @param {FollowersVariables} variables - The {@link FollowersVariables} for the query.
+             * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+             * @returns {Promise<FollowersPageResponse>} A promise that resolves to the {@link FollowersPageResponse} data and pagination metadata.
              *
              * @example
              * ```typescript
              * await aniLink.anilist.query.page.followers({page: 1, perPage: 10, userId: 542244});
              * ```
              * @see https://docs.anilist.co/reference/object/user
-             * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
              */
             followers: (variables: FollowersVariables, options?: RequestOptions) => Promise<FollowersPageResponse>;
             /**
-             * Fetches following data from the Anilist API.
-             * @param {FollowingsVariables} variables - The variables for the query.
-             * @returns {Promise<FollowingsPageResponse>} A promise that resolves to the following data and pagination metadata.
+             * `FollowingsQuery` fetches a page of users that the given `userId` follows. Returns a {@link FollowingsPageResponse} with the items and `PageInfo`.
+             * @param {FollowingsVariables} variables - The {@link FollowingsVariables} for the query.
+             * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+             * @returns {Promise<FollowingsPageResponse>} A promise that resolves to the {@link FollowingsPageResponse} data and pagination metadata.
              *
              * @example
              * ```typescript
              * await aniLink.anilist.query.page.following({page: 1, perPage: 10, userId: 542244});
              * ```
              * @see https://docs.anilist.co/reference/object/user
-             * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
              */
             following: (variables: FollowingsVariables, options?: RequestOptions) => Promise<FollowingsPageResponse>;
             /**
-             * Fetches activities data from the Anilist API.
-             * @param {ActivitiesVariables} variables - The variables for the query.
-             * @returns {Promise<ActivitiesPageResponse>} A promise that resolves to the activities data and pagination metadata.
+             * `ActivitiesQuery` fetches a page of activities. Returns an {@link ActivitiesPageResponse} with the items and `PageInfo`.
+             * @param {ActivitiesVariables} variables - The {@link ActivitiesVariables} for the query.
+             * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+             * @returns {Promise<ActivitiesPageResponse>} A promise that resolves to the {@link ActivitiesPageResponse} data and pagination metadata.
              *
              * @example
              * ```typescript
              * await aniLink.anilist.query.page.activities({page: 1, perPage: 10, userId: 542244});
              * ```
              * @see https://docs.anilist.co/reference/union/activityunion
-             * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
              */
             activities: (variables: ActivitiesVariables, options?: RequestOptions) => Promise<ActivitiesPageResponse>;
             /**
-             * Fetches activity replies data from the Anilist API.
-             * @param {ActivityRepliesVariables} variables - The variables for the query.
-             * @returns {Promise<ActivityRepliesPageResponse>} A promise that resolves to the activity replies data and pagination metadata.
+             * `ActivityRepliesQuery` fetches a page of replies for an activity. Returns an {@link ActivityRepliesPageResponse} with the items and `PageInfo`.
+             * @param {ActivityRepliesVariables} variables - The {@link ActivityRepliesVariables} for the query.
+             * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+             * @returns {Promise<ActivityRepliesPageResponse>} A promise that resolves to the {@link ActivityRepliesPageResponse} data and pagination metadata.
              *
              * @example
              * ```typescript
              * await aniLink.anilist.query.page.activityReplies({page: 1, perPage: 10, activityId: 723235883});
              * ```
              * @see https://docs.anilist.co/reference/object/activityreply
-             * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
              */
             activityReplies: (variables: ActivityRepliesVariables, options?: RequestOptions) => Promise<ActivityRepliesPageResponse>;
             /**
-             * Fetches threads data from the Anilist API.
-             * @param {ThreadsVariables} variables - The variables for the query.
-             * @returns {Promise<ThreadsPageResponse>} A promise that resolves to the threads data and pagination metadata.
+             * `ThreadsQuery` fetches a page of forum threads. Returns a {@link ThreadsPageResponse} with the items and `PageInfo`.
+             * @param {ThreadsVariables} variables - The {@link ThreadsVariables} for the query.
+             * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+             * @returns {Promise<ThreadsPageResponse>} A promise that resolves to the {@link ThreadsPageResponse} data and pagination metadata.
              *
              * @example
              * ```typescript
              * await aniLink.anilist.query.page.threads({page: 1, perPage: 10});
              * ```
              * @see https://docs.anilist.co/reference/object/thread
-             * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
              */
             threads: (variables: ThreadsVariables, options?: RequestOptions) => Promise<ThreadsPageResponse>;
             /**
-             * Fetches thread comments data from the Anilist API.
-             * @param {ThreadCommentsVariables} variables - The variables for the query.
-             * @returns {Promise<ThreadCommentsPageResponse>} A promise that resolves to the thread comments data and pagination metadata.
+             * `ThreadCommentsQuery` fetches a page of comments for a thread. Returns a {@link ThreadCommentsPageResponse} with the items and `PageInfo`.
+             * @param {ThreadCommentsVariables} variables - The {@link ThreadCommentsVariables} for the query.
+             * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+             * @returns {Promise<ThreadCommentsPageResponse>} A promise that resolves to the {@link ThreadCommentsPageResponse} data and pagination metadata.
              *
              * @example
              * ```typescript
              * await aniLink.anilist.query.page.threadComments({page: 1, perPage: 10, threadId: 71881});
              * ```
              * @see https://docs.anilist.co/reference/object/threadcomment
-             * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
              */
             threadComments: (variables: ThreadCommentsVariables, options?: RequestOptions) => Promise<ThreadCommentsPageResponse>;
             /**
-             * Fetches reviews data from the Anilist API.
-             * @param {ReviewsVariables} variables - The variables for the query.
-             * @returns {Promise<ReviewsPageResponse>} A promise that resolves to the reviews data and pagination metadata.
+             * `ReviewsQuery` fetches a page of reviews. Returns a {@link ReviewsPageResponse} with the items and `PageInfo`.
+             * @param {ReviewsVariables} variables - The {@link ReviewsVariables} for the query.
+             * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+             * @returns {Promise<ReviewsPageResponse>} A promise that resolves to the {@link ReviewsPageResponse} data and pagination metadata.
              *
              * @example
              * ```typescript
              * await aniLink.anilist.query.page.reviews({page: 1, perPage: 10, mediaId: 1});
              * ```
              * @see https://docs.anilist.co/reference/object/review
-             * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
              */
             reviews: (variables: ReviewsVariables, options?: RequestOptions) => Promise<ReviewsPageResponse>;
             /**
-             * Fetches recommendations data from the Anilist API.
-             * @param {RecommendationsVariables} variables - The variables for the query.
-             * @returns {Promise<RecommendationsPageResponse>} A promise that resolves to the recommendations data and pagination metadata.
+             * `RecommendationsQuery` fetches a page of recommendations. Returns a {@link RecommendationsPageResponse} with the items and `PageInfo`.
+             * @param {RecommendationsVariables} variables - The {@link RecommendationsVariables} for the query.
+             * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+             * @returns {Promise<RecommendationsPageResponse>} A promise that resolves to the {@link RecommendationsPageResponse} data and pagination metadata.
              *
              * @example
              * ```typescript
              * await aniLink.anilist.query.page.recommendations({page: 1, perPage: 10, mediaId: 1});
              * ```
              * @see https://docs.anilist.co/reference/object/recommendation
-             * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
              */
             recommendations: (variables: RecommendationsVariables, options?: RequestOptions) => Promise<RecommendationsPageResponse>;
             /**
-             * Fetches likes data from the Anilist API.
-             * @param {LikesVariables} variables - The variables for the query.
-             * @returns {Promise<LikesPageResponse>} A promise that resolves to the likes data and pagination metadata.
+             * `LikesQuery` fetches a page of users who liked a likeable entity. Returns a {@link LikesPageResponse} with the items and `PageInfo`.
+             * @param {LikesVariables} variables - The {@link LikesVariables} for the query.
+             * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+             * @returns {Promise<LikesPageResponse>} A promise that resolves to the {@link LikesPageResponse} data and pagination metadata.
              *
              * @example
              * ```typescript
              * await aniLink.anilist.query.page.likes({page: 1, perPage: 10, likeAbleId: 1});
+             * ```
              * @see https://docs.anilist.co/reference/union/likeableunion
-             * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
              */
             likes: (variables: LikesVariables, options?: RequestOptions) => Promise<LikesPageResponse>;
         };
@@ -9039,9 +9365,13 @@ type ThreadComment = ThreadCommentResponse;
 type Likeable = Activity | ActivityReply | Thread | ThreadComment;
 
 /**
- * `SaveMediaListEntryVariables` is an interface representing the variables for the `SaveMediaListEntryMutation`.
- * It includes optional id, media id, status, score, raw score, progress, progress volumes, repeat, priority, private status, notes, hidden from status lists status, custom lists, advanced scores, started at date, and completed at date.
- * @see https://docs.anilist.co/reference/mutation
+ * {@link SaveMediaListEntryVariables} contains variables for the {@link SaveMediaListEntryMutation} operation.
+ *
+ * See the {@link SaveMediaListEntryMutation} operation and {@link MediaListResponse} for the response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/medialist
  */
 interface SaveMediaListEntryVariables {
     /**
@@ -9053,7 +9383,7 @@ interface SaveMediaListEntryVariables {
      */
     mediaId: number;
     /**
-     * `status` is a `MediaListStatus` representing the status of the media list entry.
+     * `status` is a {@link MediaListStatus} representing the status of the media list entry.
      */
     status?: MediaListStatus;
     /**
@@ -9101,23 +9431,25 @@ interface SaveMediaListEntryVariables {
      */
     advancedScores?: number[];
     /**
-     * `startedAt` is a `FuzzyDateInput` representing when the media list entry started.
+     * `startedAt` is a {@link FuzzyDateInput} representing when the media list entry started.
      */
     startedAt?: FuzzyDateInput;
     /**
-     * `completedAt` is a `FuzzyDateInput` representing when the media list entry was completed.
+     * `completedAt` is a {@link FuzzyDateInput} representing when the media list entry was completed.
      */
     completedAt?: FuzzyDateInput;
 }
 
 /**
- * `UpdateMediaListEntriesVariables` is an interface representing the variables for the `UpdateMediaListEntriesMutation`.
- * It includes optional status, score, raw score, progress, progress volumes, repeat, priority, private status, notes, hidden from status lists status, advanced scores, started at date, completed at date, and a required array of ids.
- * @see https://docs.anilist.co/reference/mutation
+ * {@link UpdateMediaListEntriesVariables} contains variables for the {@link UpdateMediaListEntriesMutation} operation.
+ *
+ * See {@link UpdateMediaListEntriesMutation} and {@link MediaListResponse} for the operation and response shape.
+ *
+ * @see https://docs.anilist.co/reference/object/medialist
  */
 interface UpdateMediaListEntriesVariables {
     /**
-     * `status` is a `MediaListStatus` representing the status of the media list entries.
+     * `status` is a {@link MediaListStatus} representing the status of the media list entries.
      */
     status?: MediaListStatus;
     /**
@@ -9175,7 +9507,7 @@ interface UpdateMediaListEntriesVariables {
 }
 
 /**
- * `NotificationOptions` is a type representing the notification options for a user.
+ * {@link NotificationOptions} is a type representing the notification options for a user.
  * It includes a `type` field which is a string representing the type of notification,
  * and an `enabled` field which is a boolean indicating whether the notification is enabled or not.
  * @see https://docs.anilist.co/reference/object/notificationoption
@@ -9192,7 +9524,7 @@ type NotificationOptions = {
 };
 
 /**
- * `MediaListOptions` is a type representing the media list options for a user.
+ * {@link MediaListOptions} is a type representing the media list options for a user.
  * It includes fields for section order, split completed section by format, custom lists, advanced scoring,
  * advanced scoring enabled, and theme.
  * @see https://docs.anilist.co/reference/object/medialistoptions
@@ -9225,7 +9557,7 @@ type MediaListOptions = {
 };
 
 /**
- * `DisabledListActivity` is a type representing the disabled list activity options for a user.
+ * {@link DisabledListActivity} is a type representing the disabled list activity options for a user.
  * It includes a `disabled` field which is a boolean indicating whether the activity is disabled or not,
  * and a `type` field which is a string representing the type of the activity.
  * @see https://docs.anilist.co/reference/object/medialisttypeoptions
@@ -9242,9 +9574,13 @@ type DisabledListActivity = {
 };
 
 /**
- * `UpdateUserVariables` is an interface representing the variables for the `UpdateUserMutation`.
- * It includes optional fields for updating user details.
- * @see https://docs.anilist.co/reference/mutation
+ * {@link UpdateUserVariables} contains variables for the {@link UpdateUserMutation} operation.
+ *
+ * See {@link UpdateUserMutation} and {@link UpdateUserResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/user
  */
 interface UpdateUserVariables {
     /**
@@ -9252,7 +9588,7 @@ interface UpdateUserVariables {
      */
     about?: string;
     /**
-     * `titleLanguage` is a `UserTitleLanguage` representing the updated title language preference of the user.
+     * `titleLanguage` is a {@link UserTitleLanguage} representing the updated title language preference of the user.
      */
     titleLanguage?: UserTitleLanguage;
     /**
@@ -9264,7 +9600,7 @@ interface UpdateUserVariables {
      */
     airingNotifications?: boolean;
     /**
-     * `scoreFormat` is a `ScoreFormat` representing the updated score format preference of the user.
+     * `scoreFormat` is a {@link ScoreFormat} representing the updated score format preference of the user.
      */
     scoreFormat?: ScoreFormat;
     /**
@@ -9280,7 +9616,7 @@ interface UpdateUserVariables {
      */
     donatorBadge?: string;
     /**
-     * `notificationOptions` is an array of `NotificationOptions` representing the updated notification options of the user.
+     * `notificationOptions` is an array of {@link NotificationOptions} representing the updated notification options of the user.
      */
     notificationOptions?: NotificationOptions[];
     /**
@@ -9292,15 +9628,15 @@ interface UpdateUserVariables {
      */
     activityMergeTime?: number;
     /**
-     * `animeListOptions` is a `MediaListOptions` representing the updated anime list options of the user.
+     * `animeListOptions` is a {@link MediaListOptions} representing the updated anime list options of the user.
      */
     animeListOptions?: MediaListOptions;
     /**
-     * `mangaListOptions` is a `MediaListOptions` representing the updated manga list options of the user.
+     * `mangaListOptions` is a {@link MediaListOptions} representing the updated manga list options of the user.
      */
     mangaListOptions?: MediaListOptions;
     /**
-     * `staffNameLanguage` is a `UserStaffNameLanguage` representing the updated staff name language preference of the user.
+     * `staffNameLanguage` is a {@link UserStaffNameLanguage} representing the updated staff name language preference of the user.
      */
     staffNameLanguage?: UserStaffNameLanguage;
     /**
@@ -9308,12 +9644,12 @@ interface UpdateUserVariables {
      */
     restrictMessagesToFollowing?: boolean;
     /**
-     * `disabledListActivity` is an array of `DisabledListActivity` representing the updated disabled list activity preferences of the user.
+     * `disabledListActivity` is an array of {@link DisabledListActivity} representing the updated disabled list activity preferences of the user.
      */
     disabledListActivity?: DisabledListActivity[];
 }
 /**
- * `UpdateUserResponse` is an interface representing the response from an update user mutation.
+ * {@link UpdateUserResponse} describes the user returned by {@link UpdateUserMutation}.
  * It includes the id, name, about, avatar, banner image, is following, is follower, is blocked, bans, options, media list options, unread notification count, site url, donator tier, donator badge, moderator roles, created at, and updated at.
  * @see https://docs.anilist.co/reference/object/user
  */
@@ -9518,9 +9854,13 @@ interface DeleteMediaListEntryResponse {
 }
 
 /**
- * `DeleteMediaListEntryMutation` is an interface representing the variables to delete a media list entry.
- * It includes the `id` of the media list entry to delete.
- * @see https://docs.anilist.co/reference/mutation
+ * {@link DeleteMediaListEntryVariables} contains variables for the {@link DeleteMediaListEntryMutation} operation.
+ *
+ * See the {@link DeleteMediaListEntryMutation} operation and {@link DeleteMediaListEntryResponse} for the response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/deleted
  */
 interface DeleteMediaListEntryVariables {
     /**
@@ -9530,10 +9870,10 @@ interface DeleteMediaListEntryVariables {
 }
 
 /**
- * `DeleteResult` is the response shape returned by the AniList delete mutations.
+ * {@link DeleteResult} is the response shape returned by the AniList delete mutations.
  * `deleted` is `true` when the target was deleted by this call and `false` when it was
  * already absent, which makes these mutations safe to retry after a partial failure.
- * @see https://docs.anilist.co/reference/mutation
+ * @see https://docs.anilist.co/reference/object/deleted
  */
 type DeleteResult = {
     /**
@@ -9543,9 +9883,13 @@ type DeleteResult = {
 };
 
 /**
- * `DeleteCustomListMutation` is an interface representing the variables to delete a custom list.
- * It includes the `customList` and `type` variables of the custom list to delete.
- * @see https://docs.anilist.co/reference/mutation
+ * {@link DeleteCustomListVariables} contains variables for the {@link DeleteCustomListMutation} operation.
+ *
+ * See the {@link DeleteCustomListMutation} operation and {@link DeleteResult} for the response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/deleted
  */
 interface DeleteCustomListVariables {
     /**
@@ -9559,9 +9903,13 @@ interface DeleteCustomListVariables {
 }
 
 /**
- * `SaveTextActivityMutation` is an interface representing the variables to save a text activity.
- * It includes the activity id, text, locked status, and HTML output flag.
- * @see https://docs.anilist.co/reference/mutation
+ * {@link SaveTextActivityVariables} contains variables for the {@link SaveTextActivityMutation} operation.
+ *
+ * See the {@link SaveTextActivityMutation} operation and {@link Activity} for the response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/union/activityunion
  */
 interface SaveTextActivityVariables {
     /**
@@ -9583,9 +9931,13 @@ interface SaveTextActivityVariables {
 }
 
 /**
- * `SaveMessageActivityMutation` is an interface representing the variables to save a message activity.
- * It includes the activity id, message, recipient id, private, locked, asMod, and asHtml.
- * @see https://docs.anilist.co/reference/mutation
+ * {@link SaveMessageActivityVariables} contains variables for the {@link SaveMessageActivityMutation} operation.
+ *
+ * See the {@link SaveMessageActivityMutation} operation and {@link Activity} for the response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/union/activityunion
  */
 interface SaveMessageActivityVariables {
     /**
@@ -9619,9 +9971,13 @@ interface SaveMessageActivityVariables {
 }
 
 /**
- * `SaveListActivityMutation` is an interface representing the variables to save a list activity.
- * It includes the `customList` and `type` variables of the list activity to save.
- * @see https://docs.anilist.co/reference/mutation
+ * {@link SaveListActivityVariables} contains variables for the {@link SaveListActivityMutation} operation.
+ *
+ * See the {@link SaveListActivityMutation} operation and {@link Activity} for the response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/union/activityunion
  */
 interface SaveListActivityVariables {
     /**
@@ -9639,9 +9995,12 @@ interface SaveListActivityVariables {
 }
 
 /**
- * `DeleteActivityMutation` is an interface representing the variables to delete an activity.
- * It includes the activity id.
- * @see https://docs.anilist.co/reference/mutation
+ * {@link DeleteActivityVariables} contains variables for the {@link DeleteActivityMutation} operation.
+ *
+ * Holds the `id` of the activity to delete. Use with the {@link DeleteActivityMutation} operation to obtain {@link DeleteResult}.
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/deleted
  */
 interface DeleteActivityVariables {
     /**
@@ -9651,9 +10010,13 @@ interface DeleteActivityVariables {
 }
 
 /**
- * `ToggleActivitySubscriptionMutation` is an interface representing the variables to pin an activity.
- * It includes activityId and subscribe.
- * @see https://docs.anilist.co/reference/mutation
+ * {@link ToggleActivitySubscriptionVariables} contains variables for the {@link ToggleActivitySubscriptionMutation} operation.
+ *
+ * See the {@link ToggleActivitySubscriptionMutation} operation and {@link Activity} for the response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/union/activityunion
  */
 interface ToggleActivitySubscriptionVariables {
     /**
@@ -9671,9 +10034,13 @@ interface ToggleActivitySubscriptionVariables {
 }
 
 /**
- * `ToggleActivityPinMutation` is an interface representing the variables to pin an activity.
- * It includes id and pinned.
- * @see https://docs.anilist.co/reference/mutation
+ * {@link ToggleActivityPinVariables} contains variables for the {@link ToggleActivityPinMutation} operation.
+ *
+ * See the {@link ToggleActivityPinMutation} operation and {@link Activity} for the response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/union/activityunion
  */
 interface ToggleActivityPinVariables {
     /**
@@ -9691,9 +10058,13 @@ interface ToggleActivityPinVariables {
 }
 
 /**
- * `SaveActivityReplyMutation` is an interface representing the variables to save an activity reply.
- * It includes the id of the activity, the activity id, the text of the activity reply, the locked status of the activity reply, and the status of the activity reply.
- * @see https://docs.anilist.co/reference/mutation
+ * {@link SaveActivityReplyVariables} contains variables for the {@link SaveActivityReplyMutation} operation.
+ *
+ * See the {@link SaveActivityReplyMutation} operation and {@link ActivityReply} for the response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/activityreply
  */
 interface SaveActivityReplyVariables {
     /**
@@ -9719,9 +10090,13 @@ interface SaveActivityReplyVariables {
 }
 
 /**
- * `DeleteActivityReplyMutation` is an interface representing the variables to delete an activity reply.
- * It includes the activity reply id.
- * @see https://docs.anilist.co/reference/mutation
+ * {@link DeleteActivityReplyVariables} contains variables for the {@link DeleteActivityReplyMutation} operation.
+ *
+ * See the {@link DeleteActivityReplyMutation} operation and {@link DeleteResult} for the response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/deleted
  */
 interface DeleteActivityReplyVariables {
     /**
@@ -9731,9 +10106,13 @@ interface DeleteActivityReplyVariables {
 }
 
 /**
- * `ToggleLikeMutation` is an interface representing the variables to toggle a like.
- * It includes the id of the likeable object and the type of the likeable object.
- * @see https://docs.anilist.co/reference/mutation
+ * {@link ToggleLikeVariables} contains variables for the {@link ToggleLikeMutation} operation.
+ *
+ * See {@link ToggleLikeMutation} and {@link BasicUser} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/user
  */
 interface ToggleLikeVariables {
     /**
@@ -9747,9 +10126,13 @@ interface ToggleLikeVariables {
 }
 
 /**
- * `ToggleFollowVariables` is an interface representing the variables to toggle a follow.
- * It includes a number representing the id of the user to follow.
- * @see https://docs.anilist.co/reference/mutation
+ * {@link ToggleFollowVariables} contains variables for the {@link ToggleFollowMutation} operation.
+ *
+ * See the {@link ToggleFollowMutation} operation and {@link UserResponse} for the response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/user
  */
 interface ToggleFollowVariables {
     /**
@@ -10062,9 +10445,13 @@ interface Favourites {
 }
 
 /**
- * `ToggleFavouriteVariables` is an interface that contains the variables that are required to toggle a favourite.
- * It includes the id of what to toggle as a favourite.
- * @see https://docs.anilist.co/reference/mutation
+ * {@link ToggleFavouriteVariables} contains variables for the {@link ToggleFavouriteMutation} operation.
+ *
+ * See the {@link ToggleFavouriteMutation} operation and {@link Favourites} for the response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/favourites
  */
 interface ToggleFavouriteVariables {
     /**
@@ -10090,8 +10477,13 @@ interface ToggleFavouriteVariables {
 }
 
 /**
- * `UpdateFavouriteOrderVariables` is an interface that contains the variables that are required to update the order of the favourite anime/manga.
- * @see https://docs.anilist.co/reference/mutation
+ * {@link UpdateFavouriteOrderVariables} contains variables for the {@link UpdateFavouriteOrderMutation} operation.
+ *
+ * See {@link UpdateFavouriteOrderMutation} and {@link Favourites} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/favourites
  */
 interface UpdateFavouriteOrderVariables {
     /**
@@ -10137,9 +10529,13 @@ interface UpdateFavouriteOrderVariables {
 }
 
 /**
- * `SaveReviewVariables` is an interface that contains the variables that are required to save a review.
- * It includes the review ID, media ID, body, summary, score, and private status.
- * @see https://docs.anilist.co/reference/mutation
+ * {@link SaveReviewVariables} contains variables for the {@link SaveReviewMutation} operation.
+ *
+ * See the {@link SaveReviewMutation} operation and {@link ReviewResponse} for the response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/review
  */
 interface SaveReviewVariables {
     /**
@@ -10173,16 +10569,20 @@ interface SaveReviewVariables {
 }
 
 /**
- * `ReviewRating` is a type representing the rating of a review.
+ * {@link ReviewRating} is a type representing the rating of a review.
  * It can be one of the following: 'NO_VOTE', 'UP_VOTE', 'DOWN_VOTE'.
  * @see https://docs.anilist.co/reference/enum/reviewrating
  */
 type ReviewRating = "NO_VOTE" | "UP_VOTE" | "DOWN_VOTE";
 
 /**
- * `RateReviewVariables` is an interface representing the variables for the `RateReviewMutation`.
- * It includes the review id and rating to apply to the review.
- * @see https://docs.anilist.co/reference/mutation
+ * {@link RateReviewVariables} contains variables for the {@link RateReviewMutation} operation.
+ *
+ * See the {@link RateReviewMutation} operation and {@link ReviewResponse} for the response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/review
  */
 interface RateReviewVariables {
     /**
@@ -10190,15 +10590,19 @@ interface RateReviewVariables {
      */
     reviewId: number;
     /**
-     * `rating` is a `ReviewRating` representing the vote to apply to the review.
+     * `rating` is a {@link ReviewRating} representing the vote to apply to the review.
      */
     rating: ReviewRating;
 }
 
 /**
- * `DeleteReviewVariables` is an interface that contains the variables that are required for the `DeleteReview` mutation.
- * It includes the review ID.
- * @see https://docs.anilist.co/reference/mutation
+ * {@link DeleteReviewVariables} contains variables for the {@link DeleteReviewMutation} operation.
+ *
+ * See the {@link DeleteReviewMutation} operation and {@link DeleteResult} for the response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/deleted
  */
 interface DeleteReviewVariables {
     /**
@@ -10208,16 +10612,20 @@ interface DeleteReviewVariables {
 }
 
 /**
- * `RecommendationRating` is a type representing the rating of a recommendation.
+ * {@link RecommendationRating} is a type representing the rating of a recommendation.
  * It can be one of the following: 'NO_RATING', 'RATE_UP', 'RATE_DOWN'.
  * @see https://docs.anilist.co/reference/enum/recommendationrating
  */
 type RecommendationRating = "NO_RATING" | "RATE_UP" | "RATE_DOWN";
 
 /**
- * `SaveRecommendationVariables` is an interface that contains the variables that are required to save a recommendation.
- * It includes the media ID, media recommendation ID, and rating.
- * @see https://docs.anilist.co/reference/mutation
+ * {@link SaveRecommendationVariables} contains variables for the {@link SaveRecommendationMutation} operation.
+ *
+ * See the {@link SaveRecommendationMutation} operation and {@link RecommendationResponse} for the response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/recommendation
  */
 interface SaveRecommendationVariables {
     /**
@@ -10239,9 +10647,13 @@ interface SaveRecommendationVariables {
 }
 
 /**
- * `SaveThreadVariables` is an interface that contains the variables that are passed to the `SaveThread` mutation.
- * It includes the ID, title, body, categories, mediaCategories, sticky, locked, and asHtml variables.
- * @see https://docs.anilist.co/reference/mutation
+ * {@link SaveThreadVariables} contains variables for the {@link SaveThreadMutation} operation.
+ *
+ * See the {@link SaveThreadMutation} operation and {@link ThreadResponse} for the response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/thread
  */
 interface SaveThreadVariables {
     /**
@@ -10279,9 +10691,13 @@ interface SaveThreadVariables {
 }
 
 /**
- * `DeleteThreadVariables` is an interface representing the variables to delete a thread.
- * It includes the thread id.
- * @see https://docs.anilist.co/reference/mutation
+ * {@link DeleteThreadVariables} contains variables for the {@link DeleteThreadMutation} operation.
+ *
+ * See the {@link DeleteThreadMutation} operation and {@link DeleteResult} for the response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/deleted
  */
 interface DeleteThreadVariables {
     /**
@@ -10291,9 +10707,13 @@ interface DeleteThreadVariables {
 }
 
 /**
- * `ToggleThreadSubscriptionVariables` is an interface representing the variables to subscribe to a thread.
- * It includes threadId and subscribe.
- * @see https://docs.anilist.co/reference/mutation
+ * {@link ToggleThreadSubscriptionVariables} contains variables for the {@link ToggleThreadSubscriptionMutation} operation.
+ *
+ * See {@link ToggleThreadSubscriptionMutation} and {@link ThreadResponse} for the operation and response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/thread
  */
 interface ToggleThreadSubscriptionVariables {
     /**
@@ -10311,9 +10731,13 @@ interface ToggleThreadSubscriptionVariables {
 }
 
 /**
- * `SaveThreadCommentVariables` is an interface that contains the variables that are passed to the `SaveThreadComment` mutation.
- * It contains the ID of the thread, the ID of the parent comment, the comment to be saved, and a boolean to determine if the response is in HTML format.
- * @see https://docs.anilist.co/reference/mutation
+ * {@link SaveThreadCommentVariables} contains variables for the {@link SaveThreadCommentMutation} operation.
+ *
+ * See the {@link SaveThreadCommentMutation} operation and {@link ThreadCommentResponse} for the response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/threadcomment
  */
 interface SaveThreadCommentVariables {
     /**
@@ -10343,9 +10767,13 @@ interface SaveThreadCommentVariables {
 }
 
 /**
- * `DeleteThreadCommentVariables` is an interface representing the variables to delete a thread comment.
- * It includes the id of the thread comment.
- * @see https://docs.anilist.co/reference/mutation
+ * {@link DeleteThreadCommentVariables} contains variables for the {@link DeleteThreadCommentMutation} operation.
+ *
+ * See the {@link DeleteThreadCommentMutation} operation and {@link DeleteResult} for the response shape.
+ *
+ * Values are validated before dispatch.
+ *
+ * @see https://docs.anilist.co/reference/object/deleted
  */
 interface DeleteThreadCommentVariables {
     /**
@@ -10355,8 +10783,11 @@ interface DeleteThreadCommentVariables {
 }
 
 /**
- * `UpdateAniChartSettingsVariables` is an interface that contains the variables that are required to update the AniChart settings.
- * @see https://docs.anilist.co/reference/mutation
+ * {@link UpdateAniChartSettingsVariables} contains variables for the {@link UpdateAniChartSettingsMutation} operation.
+ *
+ * See {@link UpdateAniChartSettingsMutation} for the operation. The mutation returns the updated AniChart settings string.
+ *
+ * @see https://docs.anilist.co/reference/object/anichartuser
  */
 interface UpdateAniChartSettingsVariables {
     /**
@@ -10378,8 +10809,11 @@ interface UpdateAniChartSettingsVariables {
 }
 
 /**
- * `UpdateAniChartHighlightsVariables` is an interface that contains the variables that are required to update the AniChart highlights.
- * @see https://docs.anilist.co/reference/mutation
+ * {@link UpdateAniChartHighlightsVariables} contains variables for the {@link UpdateAniChartHighlightsMutation} operation.
+ *
+ * See {@link UpdateAniChartHighlightsMutation} for the operation. The mutation returns the updated AniChart highlights string.
+ *
+ * @see https://docs.anilist.co/reference/object/anichartuser
  */
 interface UpdateAniChartHighlightsVariables {
     /**
@@ -10401,48 +10835,55 @@ interface UpdateAniChartHighlightsVariables {
  * The `mutation` member of the `AniListApi` type.
  */
 
+/**
+ * Typed AniList mutation operations exposed by `AniListApi`.
+ *
+ * @see https://docs.anilist.co/reference/mutation
+ */
 type AniListMutations = {
     /**
-     * Mutation methods for updating data on the Anilist API.
+     * Mutation methods for updating data on the AniList API.
      * @public
      * @type {Object}
-     * @property {Function} updateUser - Updates a user on the Anilist API.
-     * @property {Function} saveMediaListEntry - Saves a media list entry on the Anilist API.
-     * @property {Function} updateMediaListEntries - Updates media list entries on the Anilist API.
-     * @property {Function} deleteMediaListEntry - Deletes a media list entry on the Anilist API.
-     * @property {Function} deleteCustomList - Deletes a custom list on the Anilist API.
-     * @property {Function} saveTextActivity - Saves a text activity on the Anilist API.
-     * @property {Function} saveMessageActivity - Saves a message activity on the Anilist API.
-     * @property {Function} saveListActivity - Saves a list activity on the Anilist API.
-     * @property {Function} deleteActivity - Deletes an activity on the Anilist API.
-     * @property {Function} toggleActivityPin - Toggles an activity's pin status on the Anilist API.
-     * @property {Function} toggleActivitySubscription - Toggles an activity's subscription status on the Anilist API.
-     * @property {Function} saveActivityReply - Saves an activity reply on the Anilist API.
-     * @property {Function} deleteActivityReply - Deletes an activity reply on the Anilist API.
-     * @property {Function} toggleLike - Toggles a like on the Anilist API.
-     * @property {Function} toggleLikeV2 - Toggles a like on the Anilist API.
-     * @property {Function} toggleFollow - Toggles a follow on the Anilist API.
-     * @property {Function} toggleFavourite - Toggles a favorite on the Anilist API.
-     * @property {Function} updateFavouriteOrder - Updates a favorite order on the Anilist API.
-     * @property {Function} saveReview - Saves a review on the Anilist API.
-     * @property {Function} rateReview - Rates a review on the Anilist API.
-     * @property {Function} deleteReview - Deletes a review on the Anilist API.
-     * @property {Function} saveRecommendation - Saves a recommendation on the Anilist API.
-     * @property {Function} saveThread - Saves a thread on the Anilist API.
-     * @property {Function} deleteThread - Deletes a thread on the Anilist API.
-     * @property {Function} toggleThreadSubscription - Toggles a thread's subscription status on the Anilist API.
-     * @property {Function} saveThreadComment - Saves a thread comment on the Anilist API.
-     * @property {Function} deleteThreadComment - Deletes a thread comment on the Anilist API.
-     * @property {Function} updateAniChartSettings - Updates aniChart settings on the Anilist API.
-     * @property {Function} updateAniChartHighlights - Updates aniChart highlights on the Anilist API.
+     * @property {Function} updateUser - Updates a user on the AniList API.
+     * @property {Function} saveMediaListEntry - Saves a media list entry on the AniList API.
+     * @property {Function} updateMediaListEntries - Updates media list entries on the AniList API.
+     * @property {Function} deleteMediaListEntry - Deletes a media list entry on the AniList API.
+     * @property {Function} deleteCustomList - Deletes a custom list on the AniList API.
+     * @property {Function} saveTextActivity - Saves a text activity on the AniList API.
+     * @property {Function} saveMessageActivity - Saves a message activity on the AniList API.
+     * @property {Function} saveListActivity - Saves a list activity on the AniList API.
+     * @property {Function} deleteActivity - Deletes an activity on the AniList API.
+     * @property {Function} toggleActivityPin - Toggles an activity's pin status on the AniList API.
+     * @property {Function} toggleActivitySubscription - Toggles an activity's subscription status on the AniList API.
+     * @property {Function} saveActivityReply - Saves an activity reply on the AniList API.
+     * @property {Function} deleteActivityReply - Deletes an activity reply on the AniList API.
+     * @property {Function} toggleLike - Toggles a like on the AniList API.
+     * @property {Function} toggleLikeV2 - Toggles a like on the AniList API.
+     * @property {Function} toggleFollow - Toggles a follow on the AniList API.
+     * @property {Function} toggleFavourite - Toggles a favourite on the AniList API.
+     * @property {Function} updateFavouriteOrder - Updates a favourite order on the AniList API.
+     * @property {Function} saveReview - Saves a review on the AniList API.
+     * @property {Function} rateReview - Rates a review on the AniList API.
+     * @property {Function} deleteReview - Deletes a review on the AniList API.
+     * @property {Function} saveRecommendation - Saves a recommendation on the AniList API.
+     * @property {Function} saveThread - Saves a thread on the AniList API.
+     * @property {Function} deleteThread - Deletes a thread on the AniList API.
+     * @property {Function} toggleThreadSubscription - Toggles a thread's subscription status on the AniList API.
+     * @property {Function} saveThreadComment - Saves a thread comment on the AniList API.
+     * @property {Function} deleteThreadComment - Deletes a thread comment on the AniList API.
+     * @property {Function} updateAniChartSettings - Updates AniChart settings on the AniList API.
+     * @property {Function} updateAniChartHighlights - Updates AniChart highlights on the AniList API.
      *
      * Must be authenticated for all mutations.
      */
     mutation: {
         /**
-         * Updates a user on the Anilist API.
-         * @param {UpdateUserVariables} variables - The variables for the mutation.
-         * @returns {Promise<UpdateUserResponse>} A promise that resolves when the mutation is complete.
+         * `UpdateUserMutation` updates a user on the AniList API.
+         * @param {UpdateUserVariables} variables - The {@link UpdateUserVariables} for the mutation.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<UpdateUserResponse>} A promise that resolves to the {@link UpdateUserResponse} data.
+         * @throws If the client is unauthenticated, variables fail validation, or the request fails.
          *
          * @example
          * ```typescript
@@ -10466,26 +10907,28 @@ type AniListMutations = {
          * });
          * ```
          * @see https://docs.anilist.co/reference/object/user
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         updateUser: (variables: UpdateUserVariables, options?: RequestOptions) => Promise<UpdateUserResponse>;
         /**
-         * Saves a media list entry on the Anilist API.
-         * @param {SaveMediaListEntryVariables} variables - The variables for the mutation.
-         * @returns {Promise<MediaListResponse>} A promise that resolves when the mutation is complete.
+         * `SaveMediaListEntryMutation` saves a media list entry on the AniList API.
+         * @param {SaveMediaListEntryVariables} variables - The {@link SaveMediaListEntryVariables} for the mutation.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<MediaListResponse>} A promise that resolves to the {@link MediaListResponse} data.
+         * @throws If the client is unauthenticated, variables fail validation, or the request fails.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.mutation.saveMediaListEntry({mediaId: 1, status: 'COMPLETED'});
          * ```
          * @see https://docs.anilist.co/reference/object/medialist
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         saveMediaListEntry: (variables: SaveMediaListEntryVariables, options?: RequestOptions) => Promise<MediaListResponse>;
         /**
-         * Updates media list entries on the Anilist API.
-         * @param {UpdateMediaListEntriesVariables} variables - The variables for the mutation.
-         * @returns {Promise<MediaListResponse[]>} A promise that resolves when the mutation is complete.
+         * `UpdateMediaListEntriesMutation` updates media list entries on the AniList API.
+         * @param {UpdateMediaListEntriesVariables} variables - The {@link UpdateMediaListEntriesVariables} for the mutation.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<MediaListResponse[]>} A promise that resolves to the {@link MediaListResponse} entries.
+         * @throws If the client is unauthenticated, variables fail validation, or the request fails.
          *
          * @example
          * ```typescript
@@ -10497,13 +10940,14 @@ type AniListMutations = {
          * });
          * ```
          * @see https://docs.anilist.co/reference/object/medialist
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         updateMediaListEntries: (variables: UpdateMediaListEntriesVariables, options?: RequestOptions) => Promise<MediaListResponse[]>;
         /**
-         * Deletes a media list entry on the Anilist API.
-         * @param {DeleteMediaListEntryVariables} variables - The variables for the mutation.
-         * @returns {Promise<DeleteMediaListEntryResponse>} A promise that resolves when the mutation is complete.
+         * `DeleteMediaListEntryMutation` deletes a media list entry on the AniList API.
+         * @param {DeleteMediaListEntryVariables} variables - The {@link DeleteMediaListEntryVariables} for the mutation.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<DeleteMediaListEntryResponse>} A promise that resolves to the {@link DeleteMediaListEntryResponse} result.
+         * @throws If the client is unauthenticated, variables fail validation, or the request fails.
          *
          * @example
          * You cannot delete a media list entry without first fetching the entry's id. The entry's id is not the same as the mediaId. It is specific to each user and media.
@@ -10511,344 +10955,409 @@ type AniListMutations = {
          * await aniLink.anilist.mutation.deleteMediaListEntry({id: 1});
          * ```
          * @see https://docs.anilist.co/reference/object/deleted
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         deleteMediaListEntry: (variables: DeleteMediaListEntryVariables, options?: RequestOptions) => Promise<DeleteMediaListEntryResponse>;
         /**
-         * Deletes a custom list on the Anilist API. There is no mutation specifically for creating a custom list. You can create a custom list through the `updateUser` mutation under the `animeListOptions` or `mangaListOptions` variables.
-         * @param {DeleteCustomListVariables} variables - The variables for the mutation.
-         * @returns {Promise<DeleteResult>} A promise that resolves to `{ deleted }`, where `deleted` is `true` when the  custom list was deleted by this call and `false` when it was already absent.
+         * `DeleteCustomListMutation` deletes a custom list on the AniList API. There is no mutation specifically for creating a custom list; create one through `UpdateUserMutation` under the `animeListOptions` or `mangaListOptions` variables.
+         * @param {DeleteCustomListVariables} variables - The {@link DeleteCustomListVariables} for the mutation.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<DeleteResult>} A promise that resolves to `{ deleted }`, where `deleted` is `true` when the custom list was deleted by this call and `false` when it was already absent.
+         * @throws If the client is unauthenticated, variables fail validation, or the request fails.
          *
          * @example
          * ```typescript
-         * await aniLink.anilist.mutation.deleteCustomLists({customList: 'test'});
+         * await aniLink.anilist.mutation.deleteCustomList({customList: 'test', type: 'ANIME'});
          * ```
          * @see https://docs.anilist.co/reference/object/deleted
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         deleteCustomList: (variables: DeleteCustomListVariables, options?: RequestOptions) => Promise<DeleteResult>;
         /**
-         * Saves a text activity on the Anilist API. If no `id` is provided, a new activity will be created. If an `id` is provided, the activity with that `id` will be updated.
-         * @param {SaveTextActivityVariables} variables - The variables for the mutation.
-         * @returns {Promise<Activity>} A promise that resolves when the mutation is complete.
+         * `SaveTextActivityMutation` saves a text activity on the AniList API.
+         * @param {SaveTextActivityVariables} variables - The {@link SaveTextActivityVariables} for the mutation.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<Activity>} A promise that resolves to the saved {@link Activity}.
+         * @throws If the client is unauthenticated, variables fail validation, or the request fails.
          *
          * @example
          * ```typescript
-         * await aniLink.anilist.mutation.saveTextActivity({text: 'Hello, world!'});
+         * await aniLink.anilist.mutation.saveTextActivity({id: 1, text: 'Hello, world!'});
          * ```
          * @see https://docs.anilist.co/reference/union/activityunion
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         saveTextActivity: (variables: SaveTextActivityVariables, options?: RequestOptions) => Promise<Activity>;
         /**
-         * Saves a message activity on the Anilist API. If no `id` is provided, a new activity will be created. If an `id` is provided, the activity with that `id` will be updated.
-         * @param {SaveMessageActivityVariables} variables - The variables for the mutation.
-         * @returns {Promise<Activity>} A promise that resolves when the mutation is complete.
+         * `SaveMessageActivityMutation` saves a message activity on the AniList API.
+         * @param {SaveMessageActivityVariables} variables - The {@link SaveMessageActivityVariables} for the mutation.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<Activity>} A promise that resolves to the saved {@link Activity}.
+         * @throws If the client is unauthenticated, variables fail validation, or the request fails.
          *
          * @example
          * ```typescript
-         * await aniLink.anilist.mutation.saveMessageActivity({text: 'Hello, world!'});
+         * await aniLink.anilist.mutation.saveMessageActivity({id: 1, message: 'Hello, world!'});
          * ```
          * @see https://docs.anilist.co/reference/union/activityunion
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         saveMessageActivity: (variables: SaveMessageActivityVariables, options?: RequestOptions) => Promise<Activity>;
         /**
-         * Saves a list activity on the Anilist API.
+         * `SaveListActivityMutation` saves a list activity on the AniList API.
          * Mod Only
-         * @param {SaveListActivityVariables} variables - The variables for the mutation.
-         * @returns {Promise<Activity>} A promise that resolves when the mutation is complete.
+         * @param {SaveListActivityVariables} variables - The {@link SaveListActivityVariables} for the mutation.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<Activity>} A promise that resolves to the saved {@link Activity}.
+         * @throws If the client is unauthenticated, variables fail validation, or the request fails.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.mutation.saveListActivity({id: 1});
          * ```
          * @see https://docs.anilist.co/reference/union/activityunion
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         saveListActivity: (variables: SaveListActivityVariables, options?: RequestOptions) => Promise<Activity>;
         /**
-         * Deletes an activity on the Anilist API.
+         * `DeleteActivityMutation` deletes an activity on the AniList API.
          * Mod Only
-         * @param {DeleteActivityVariables} variables - The variables for the mutation.
-         * @returns {Promise<DeleteResult>} A promise that resolves to `{ deleted }`, where `deleted` is `true` when the          activity was deleted by this call and `false` when it was already absent.
+         * @param {DeleteActivityVariables} variables - The {@link DeleteActivityVariables} for the mutation.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<DeleteResult>} A promise that resolves to `{ deleted }`, where `deleted` is `true` when the activity was deleted by this call and `false` when it was already absent.
+         * @throws If the client is unauthenticated, variables fail validation, or the request fails.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.mutation.deleteActivity({id: 1});
          * ```
          * @see https://docs.anilist.co/reference/object/deleted
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         deleteActivity: (variables: DeleteActivityVariables, options?: RequestOptions) => Promise<DeleteResult>;
         /**
-         * Toggles the pin status of an activity on the Anilist API.
+         * `ToggleActivityPinMutation` toggles the pin status of an activity on the AniList API.
          *
-         * @param {ToggleActivityPinVariables} variables - The variables for the mutation.
-         * @returns {Promise<Activity>} A promise that resolves when the mutation is complete.
+         * @param {ToggleActivityPinVariables} variables - The {@link ToggleActivityPinVariables} for the mutation.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<Activity>} A promise that resolves to the updated {@link Activity}.
+         * @throws If the client is unauthenticated, variables fail validation, or the request fails.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.mutation.toggleActivityPin({id: 1, pinned: true});
          * ```
          * @see https://docs.anilist.co/reference/union/activityunion
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         toggleActivityPin: (variables: ToggleActivityPinVariables, options?: RequestOptions) => Promise<Activity>;
         /**
-         * Toggles the subscription status of an activity on the Anilist API.
+         * `ToggleActivitySubscriptionMutation` toggles the subscription status of an activity on the AniList API.
          *
-         * @param {ToggleActivitySubscriptionVariables} variables - The variables for the mutation.
-         * @returns {Promise<Activity>} A promise that resolves when the mutation is complete.
+         * @param {ToggleActivitySubscriptionVariables} variables - The {@link ToggleActivitySubscriptionVariables} for the mutation.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<Activity>} A promise that resolves to the updated {@link Activity}.
+         * @throws If the client is unauthenticated, variables fail validation, or the request fails.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.mutation.toggleActivitySubscription({activityId: 1, subscribe: true});
          * ```
          * @see https://docs.anilist.co/reference/union/activityunion
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         toggleActivitySubscription: (variables: ToggleActivitySubscriptionVariables, options?: RequestOptions) => Promise<Activity>;
         /**
-         * Saves an activity reply on the Anilist API. If no `id` is provided, a new activity reply will be created. If an `id` is provided, the activity reply with that `id` will be updated.
-         * @param {SaveActivityReplyVariables} variables - The variables for the mutation.
-         * @returns {Promise<ActivityReply>} A promise that resolves when the mutation is complete.
+         * `SaveActivityReplyMutation` saves an activity reply on the AniList API.
+         * @param {SaveActivityReplyVariables} variables - The {@link SaveActivityReplyVariables} for the mutation.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<ActivityReply>} A promise that resolves to the saved {@link ActivityReply}.
+         * @throws If the client is unauthenticated, variables fail validation, or the request fails.
          *
          * @example
          * ```typescript
-         * await aniLink.anilist.mutation.saveActivityReply({activityId: 1, text: 'Hello, world!'});
+         * await aniLink.anilist.mutation.saveActivityReply({id: 1, activityId: 2, text: 'Hello, world!'});
          * ```
          * @see https://docs.anilist.co/reference/object/activityreply
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         saveActivityReply: (variables: SaveActivityReplyVariables, options?: RequestOptions) => Promise<ActivityReply>;
         /**
-         * Deletes an activity reply on the Anilist API.
-         * @param {DeleteActivityReplyVariables} variables - The variables for the mutation.
+         * `DeleteActivityReplyMutation` deletes an activity reply on the AniList API.
+         * @param {DeleteActivityReplyVariables} variables - The {@link DeleteActivityReplyVariables} for the mutation.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
          * @returns {Promise<DeleteResult>} A promise that resolves to `{ deleted }`, where `deleted` is `true` when the reply was deleted by this call and `false` when it was already absent.
+         * @throws If the client is unauthenticated, variables fail validation, or the request fails.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.mutation.deleteActivityReply({id: 1});
          * ```
          * @see https://docs.anilist.co/reference/object/deleted
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         deleteActivityReply: (variables: DeleteActivityReplyVariables, options?: RequestOptions) => Promise<DeleteResult>;
         /**
-         * Toggles a like on the Anilist API.
-         * @param {ToggleLikeVariables} variables - The variables for the mutation.
-         * @returns {Promise<BasicUser>} A promise that resolves to the user who performed the like toggle.
+         * `ToggleLikeMutation` toggles a like on the AniList API.
+         * @param {ToggleLikeVariables} variables - The {@link ToggleLikeVariables} for the mutation.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<BasicUser>} A promise that resolves to the {@link BasicUser} who performed the like toggle.
+         * @throws If the client is unauthenticated, variables fail validation, or the request fails.
+         * @deprecated Use `toggleLikeV2` instead, which returns the richer {@link Likeable} union (activity, activity reply, thread, or thread comment) instead of a bare user.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.mutation.toggleLike({id: 1, type: 'ACTIVITY'});
          * ```
          * @see https://docs.anilist.co/reference/object/user
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         toggleLike: (variables: ToggleLikeVariables, options?: RequestOptions) => Promise<BasicUser>;
         /**
-         * Toggles a like on the Anilist API.
+         * `ToggleLikeV2Mutation` toggles a like on the AniList API.
          * Returns a different response than the `toggleLike` mutation.
-         * @param {ToggleLikeVariables} variables - The variables for the mutation.
-         * @returns {Promise<Likeable>} A promise that resolves to the liked entity: an activity,
+         * @param {ToggleLikeVariables} variables - The {@link ToggleLikeVariables} for the mutation.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<Likeable>} A promise that resolves to the liked {@link Likeable} entity: an activity,
          * activity reply, thread, or thread comment depending on the likeable type.
+         * @throws If the client is unauthenticated, variables fail validation, or the request fails.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.mutation.toggleLikeV2({id: 1, type: 'ACTIVITY'});
          * ```
          * @see https://docs.anilist.co/reference/union/likeableunion
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         toggleLikeV2: (variables: ToggleLikeVariables, options?: RequestOptions) => Promise<Likeable>;
         /**
-         * Toggles a follow on the Anilist API.
-         * @param {ToggleFollowVariables} variables - The variables for the mutation.
-         * @returns {Promise<UserResponse>} A promise that resolves when the mutation is complete.
+         * `ToggleFollowMutation` toggles a follow on the AniList API.
+         * @param {ToggleFollowVariables} variables - The {@link ToggleFollowVariables} for the mutation.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<UserResponse>} A promise that resolves to the updated {@link UserResponse}.
+         * @throws If the client is unauthenticated, variables fail validation, or the request fails.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.mutation.toggleFollow({userId: 542244});
          * ```
          * @see https://docs.anilist.co/reference/object/user
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         toggleFollow: (variables: ToggleFollowVariables, options?: RequestOptions) => Promise<UserResponse>;
         /**
-         * Toggles a favorite on the Anilist API.
-         * @param {ToggleFavouriteVariables} variables - The variables for the mutation.
-         * @returns {Promise<Favourites>} A promise that resolves when the mutation is complete.
+         * `ToggleFavouriteMutation` toggles a favourite on the AniList API.
+         * @param {ToggleFavouriteVariables} variables - The {@link ToggleFavouriteVariables} for the mutation.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<Favourites>} A promise that resolves to the updated {@link Favourites}.
+         * @throws If the client is unauthenticated, variables fail validation, or the request fails.
          *
          * @example
          * ```typescript
-         * await aniLink.anilist.mutation.toggleFavorite({studioId: 561});
+         * await aniLink.anilist.mutation.toggleFavourite({studioId: 561});
          * ```
          * @see https://docs.anilist.co/reference/object/favourites
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         toggleFavourite: (variables: ToggleFavouriteVariables, options?: RequestOptions) => Promise<Favourites>;
         /**
-         * Updates the order of favourites on the Anilist API.
-         * @param {UpdateFavouriteOrderVariables} variables - The variables for the mutation.
-         * @returns {Promise<Favourites>} A promise that resolves when the mutation is complete.
+         * `UpdateFavouriteOrderMutation` updates the order of favourites on the AniList API.
+         * @param {UpdateFavouriteOrderVariables} variables - The {@link UpdateFavouriteOrderVariables} for the mutation.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<Favourites>} A promise that resolves to the updated {@link Favourites}.
+         * @throws If the client is unauthenticated, variables fail validation, or the request fails.
          *
          * @example
          * ```typescript
-         * await aniLink.anilist.mutation.updateFavouriteOrder({ids: [1, 2, 3]});
+         * await aniLink.anilist.mutation.updateFavouriteOrder({
+         *   animeIds: [1],
+         *   mangaIds: [],
+         *   characterIds: [],
+         *   staffIds: [],
+         *   studioIds: [],
+         *   animeOrder: [1],
+         *   mangaOrder: [],
+         *   characterOrder: [],
+         *   staffOrder: [],
+         *   studioOrder: [],
+         * });
          * ```
          * @see https://docs.anilist.co/reference/object/favourites
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         updateFavouriteOrder: (variables: UpdateFavouriteOrderVariables, options?: RequestOptions) => Promise<Favourites>;
         /**
-         * Saves a review on the Anilist API. If no `id` is provided, a new review will be created. If an `id` is provided, the review with that `id` will be updated.
-         * @param {SaveReviewVariables} variables - The variables for the mutation.
-         * @returns {Promise<ReviewResponse>} A promise that resolves when the mutation is complete.
+         * `SaveReviewMutation` saves a review on the AniList API.
+         * @param {SaveReviewVariables} variables - The {@link SaveReviewVariables} for the mutation.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<ReviewResponse>} A promise that resolves to the saved {@link ReviewResponse}.
+         * @throws If the client is unauthenticated, variables fail validation, or the request fails.
          *
          * @example
          * ```typescript
-         * await aniLink.anilist.mutation.saveReview({mediaId: 1, body: 'testing', summary: 'testing', score: 8, private: true});
+         * await aniLink.anilist.mutation.saveReview({id: 1, mediaId: 1, body: 'testing', summary: 'testing', score: 8, private: true});
          * ```
          * @see https://docs.anilist.co/reference/object/review
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         saveReview: (variables: SaveReviewVariables, options?: RequestOptions) => Promise<ReviewResponse>;
         /**
-         * Rates a review on the Anilist API.
-         * @param {RateReviewVariables} variables - The variables for the mutation.
-         * @returns {Promise<ReviewResponse>} A promise that resolves to the rated review.
+         * `RateReviewMutation` rates a review on the AniList API.
+         * @param {RateReviewVariables} variables - The {@link RateReviewVariables} for the mutation.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<ReviewResponse>} A promise that resolves to the rated {@link ReviewResponse}.
+         * @throws If the client is unauthenticated, variables fail validation, or the request fails.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.mutation.rateReview({reviewId: 8008, rating: 'UP_VOTE'});
          * ```
          * @see https://docs.anilist.co/reference/object/review
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         rateReview: (variables: RateReviewVariables, options?: RequestOptions) => Promise<ReviewResponse>;
         /**
-         * Deletes a review on the Anilist API.
-         * @param {DeleteReviewVariables} variables - The variables for the mutation.
+         * `DeleteReviewMutation` deletes a review on the AniList API.
+         * @param {DeleteReviewVariables} variables - The {@link DeleteReviewVariables} for the mutation.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
          * @returns {Promise<DeleteResult>} A promise that resolves to `{ deleted }`, where `deleted` is `true` when the review was deleted by this call and `false` when it was already absent.
+         * @throws If the client is unauthenticated, variables fail validation, or the request fails.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.mutation.deleteReview({id: 1});
          * ```
          * @see https://docs.anilist.co/reference/object/deleted
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         deleteReview: (variables: DeleteReviewVariables, options?: RequestOptions) => Promise<DeleteResult>;
         /**
-         * Saves a recommendation on the Anilist API.
-         * @param {SaveRecommendationVariables} variables - The variables for the mutation.
-         * @returns {Promise<RecommendationResponse>} A promise that resolves when the mutation is complete.
+         * `SaveRecommendationMutation` saves a recommendation on the AniList API.
+         * @param {SaveRecommendationVariables} variables - The {@link SaveRecommendationVariables} for the mutation.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<RecommendationResponse>} A promise that resolves to the saved {@link RecommendationResponse}.
+         * @throws If the client is unauthenticated, variables fail validation, or the request fails.
          *
          * @example
          * ```typescript
-         * await aniLink.anilist.mutation.saveRecommendation({mediaId: 1, mediaRecommendationId: 2, rating: 8});
+         * await aniLink.anilist.mutation.saveRecommendation({mediaId: 1, mediaRecommendationId: 2, rating: 'RATE_UP'});
          * ```
          * @see https://docs.anilist.co/reference/object/recommendation
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         saveRecommendation: (variables: SaveRecommendationVariables, options?: RequestOptions) => Promise<RecommendationResponse>;
         /**
-         * Saves a thread on the Anilist API. If no `id` is provided, a new thread will be created. If an `id` is provided, the thread with that `id` will be updated.
-         * @param {SaveThreadVariables} variables - The variables for the mutation.
-         * @returns {Promise<ThreadResponse>} A promise that resolves when the mutation is complete.
+         * `SaveThreadMutation` saves a thread on the AniList API.
+         * @param {SaveThreadVariables} variables - The {@link SaveThreadVariables} for the mutation.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<ThreadResponse>} A promise that resolves to the saved {@link ThreadResponse}.
+         * @throws If the client is unauthenticated, variables fail validation, or the request fails.
          *
          * @example
          * ```typescript
-         * await aniLink.anilist.mutation.saveThread({title: 'Hello, world!', body: 'Hello, world!'});
+         * await aniLink.anilist.mutation.saveThread({
+         *   id: 1,
+         *   title: 'Hello, world!',
+         *   body: 'Hello, world!',
+         *   categories: [],
+         *   mediaCategories: [],
+         *   sticky: false,
+         *   locked: false,
+         *   asHtml: true,
+         * });
          * ```
          * @see https://docs.anilist.co/reference/object/thread
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         saveThread: (variables: SaveThreadVariables, options?: RequestOptions) => Promise<ThreadResponse>;
         /**
-         * Deletes a thread on the Anilist API.
-         * @param {DeleteThreadVariables} variables - The variables for the mutation.
+         * `DeleteThreadMutation` deletes a thread on the AniList API.
+         * @param {DeleteThreadVariables} variables - The {@link DeleteThreadVariables} for the mutation.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
          * @returns {Promise<DeleteResult>} A promise that resolves to `{ deleted }`, where `deleted` is `true` when the thread was deleted by this call and `false` when it was already absent.
+         * @throws If the client is unauthenticated, variables fail validation, or the request fails.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.mutation.deleteThread({id: 1});
          * ```
          * @see https://docs.anilist.co/reference/object/deleted
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         deleteThread: (variables: DeleteThreadVariables, options?: RequestOptions) => Promise<DeleteResult>;
         /**
-         * Toggles a thread subscription on the Anilist API.
-         * @param {ToggleThreadSubscriptionVariables} variables - The variables for the mutation.
-         * @returns {Promise<ThreadResponse>} A promise that resolves when the mutation is complete.
+         * `ToggleThreadSubscriptionMutation` toggles a thread subscription on the AniList API.
+         * @param {ToggleThreadSubscriptionVariables} variables - The {@link ToggleThreadSubscriptionVariables} for the mutation.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<ThreadResponse>} A promise that resolves to the updated {@link ThreadResponse}.
+         * @throws If the client is unauthenticated, variables fail validation, or the request fails.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.mutation.toggleThreadSubscription({threadId: 1, subscribe: true});
          * ```
          * @see https://docs.anilist.co/reference/object/thread
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         toggleThreadSubscription: (variables: ToggleThreadSubscriptionVariables, options?: RequestOptions) => Promise<ThreadResponse>;
         /**
-         * Saves a thread comment on the Anilist API. If no `id` is provided, a new thread comment will be created. If an `id` is provided, the thread comment with that `id` will be updated.
-         * @param {SaveThreadCommentVariables} variables - The variables for the mutation.
-         * @returns {Promise<ThreadCommentResponse>} A promise that resolves when the mutation is complete.
+         * `SaveThreadCommentMutation` saves a thread comment on the AniList API.
+         * @param {SaveThreadCommentVariables} variables - The {@link SaveThreadCommentVariables} for the mutation.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
+         * @returns {Promise<ThreadCommentResponse>} A promise that resolves to the saved {@link ThreadCommentResponse}.
+         * @throws If the client is unauthenticated, variables fail validation, or the request fails.
          *
          * @example
          * ```typescript
-         * await aniLink.anilist.mutation.saveThreadComment({threadId: 1, comment: 'Hello, world!'});
+         * await aniLink.anilist.mutation.saveThreadComment({
+         *   id: 1,
+         *   threadId: 1,
+         *   parentCommentId: 0,
+         *   comment: 'Hello, world!',
+         *   locked: false,
+         *   asHtml: true,
+         * });
          * ```
          * @see https://docs.anilist.co/reference/object/threadcomment
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         saveThreadComment: (variables: SaveThreadCommentVariables, options?: RequestOptions) => Promise<ThreadCommentResponse>;
         /**
-         * Deletes a thread comment on the Anilist API.
-         * @param {DeleteThreadCommentVariables} variables - The variables for the mutation.
+         * `DeleteThreadCommentMutation` deletes a thread comment on the AniList API.
+         * @param {DeleteThreadCommentVariables} variables - The {@link DeleteThreadCommentVariables} for the mutation.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
          * @returns {Promise<DeleteResult>} A promise that resolves to `{ deleted }`, where `deleted` is `true` when the comment was deleted by this call and `false` when it was already absent.
+         * @throws If the client is unauthenticated, variables fail validation, or the request fails.
          *
          * @example
          * ```typescript
          * await aniLink.anilist.mutation.deleteThreadComment({id: 1});
          * ```
          * @see https://docs.anilist.co/reference/object/deleted
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         deleteThreadComment: (variables: DeleteThreadCommentVariables, options?: RequestOptions) => Promise<DeleteResult>;
         /**
-         * Updates the AniChart settings for a user on the Anilist API.
-         * @param {UpdateAniChartSettingsVariables} variables - The variables for the mutation.
+         * `UpdateAniChartSettingsMutation` updates the AniChart settings for a user on the AniList API.
+         * @param {UpdateAniChartSettingsVariables} variables - The {@link UpdateAniChartSettingsVariables} for the mutation.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
          * @returns {Promise<string>} A promise that resolves to the updated AniChart settings string.
+         * @throws If the client is unauthenticated, variables fail validation, or the request fails.
          *
          * @example
          * ```typescript
-         * await aniLink.anilist.mutation.updateAniChartSettings({titleLanguage: 'romaji', theme: 'dark'});
+         * await aniLink.anilist.mutation.updateAniChartSettings({
+         *   titleLanguage: 'romaji',
+         *   outgoingLinkProvider: 'ANILIST',
+         *   theme: 'dark',
+         *   sort: 'POPULARITY',
+         * });
          * ```
          * @see https://docs.anilist.co/reference/object/anichartuser
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         updateAniChartSettings: (variables: UpdateAniChartSettingsVariables, options?: RequestOptions) => Promise<string>;
         /**
-         * Updates the AniChart highlights for a user on the Anilist API.
-         * @param {UpdateAniChartHighlightsVariables} variables - The variables for the mutation.
+         * `UpdateAniChartHighlightsMutation` updates the AniChart highlights for a user on the AniList API.
+         * @param {UpdateAniChartHighlightsVariables} variables - The {@link UpdateAniChartHighlightsVariables} for the mutation.
+         * @param options - Optional per-request transport settings ({@link RequestOptions}) merged over the instance-level ones for this call only.
          * @returns {Promise<string>} A promise that resolves to the updated AniChart highlights string.
+         * @throws If the client is unauthenticated, variables fail validation, or the request fails.
          *
          * @example
          * ```typescript
-         * await aniLink.anilist.mutation.updateAniChartHighlights({highlights: [{mediaId: 1, highlight: 'test'}]});
+         * await aniLink.anilist.mutation.updateAniChartHighlights({
+         *   highlights: {mediaId: 1, highlight: true},
+         * });
          * ```
          * @see https://docs.anilist.co/reference/object/anichartuser
-         * @param options - Optional per-request transport settings merged over the instance-level ones for this call only.
          */
         updateAniChartHighlights: (variables: UpdateAniChartHighlightsVariables, options?: RequestOptions) => Promise<string>;
     };
 };
 
-/** Options for the `fuzzyDate` convenience helper. All fields are optional. */
+/**
+ * Options for building a partial {@link FuzzyDateInput} with {@link fuzzyDate}.
+ *
+ * Omitted fields retain the zero-value representation required by AniList's fuzzy-date input.
+ *
+ * @see https://docs.anilist.co/reference/input/fuzzydateinput
+ */
 interface FuzzyDateOptions {
     /** The year, e.g. `2024`. */
     year?: number;
@@ -10858,7 +11367,13 @@ interface FuzzyDateOptions {
     day?: number;
 }
 
-/** A single entry flattened out of a `MediaListCollection`, with all its list memberships. */
+/**
+ * A media-list entry flattened from {@link MediaListCollectionResponse}, retaining every list group that contains it.
+ *
+ * This local representation makes duplicate membership explicit through `listNames` and the custom-list flags.
+ *
+ * @see https://docs.anilist.co/reference/object/medialistcollection
+ */
 interface FlattenedMediaListEntry {
     /** The id of the media list entry. */
     id: number;
@@ -10882,7 +11397,7 @@ interface FlattenedMediaListEntry {
 
 /**
  * Keys of `T` whose value is a readonly array — the items field of a page or
- * chunk response. `PageInfo` and `hasNextChunk` are never arrays, so they are
+ * chunk response. {@link PageInfo} and `hasNextChunk` are never arrays, so they are
  * excluded automatically.
  */
 type ArrayKeys<T> = {
@@ -10890,7 +11405,7 @@ type ArrayKeys<T> = {
 }[keyof T];
 /** Extract the element type of the array stored at key `K` of `T`. */
 type ArrayElement<T, K extends keyof T> = T[K] extends readonly (infer U)[] ? U : never;
-/** Options controlling a `paginate` traversal over `PageInfo`-based pages. */
+/** Options controlling a {@link paginate} traversal over {@link PageInfo}-based pages. */
 interface PaginateOptions {
     /**
      * Items requested per page. AniList caps this at 50; values above 50 are
@@ -10911,7 +11426,7 @@ interface PaginateOptions {
      */
     concurrency?: number;
 }
-/** Options controlling a `paginateChunks` traversal over `hasNextChunk`-based chunks. */
+/** Options controlling a {@link paginateChunks} traversal over `hasNextChunk`-based chunks. */
 interface ChunkPaginateOptions {
     /**
      * Entries requested per chunk. Values above the documented maximum of 500
@@ -10932,7 +11447,7 @@ interface ChunkPaginateOptions {
      */
     concurrency?: number;
 }
-/** The outcome of a `paginate` traversal. */
+/** The outcome of a {@link paginate} traversal. */
 interface PaginateResult<TItem> {
     /** Every item collected across all fetched pages, in page order. */
     items: TItem[];
@@ -10946,7 +11461,7 @@ interface PaginateResult<TItem> {
     /** `true` when the traversal stopped at `maxPages` before `hasNextPage` was false. */
     truncated: boolean;
 }
-/** The outcome of a `paginateChunks` traversal. */
+/** The outcome of a {@link paginateChunks} traversal. */
 interface ChunkPaginateResult<TItem> {
     /** Every item collected across all fetched chunks, in chunk order. */
     items: TItem[];
@@ -10961,7 +11476,7 @@ interface ChunkPaginateResult<TItem> {
     truncated: boolean;
 }
 /**
- * Iterate `PageInfo`-based pages until `hasNextPage` is false or `maxPages` is reached.
+ * Iterate {@link PageInfo}-based pages until `hasNextPage` is false or `maxPages` is reached.
  *
  * The helper calls `fetchPage(page, perPage)` for each page, extracts the items
  * array at `itemsKey`, and stops when AniList reports no further pages or when the
@@ -10990,7 +11505,7 @@ declare function paginate<TPage extends {
     pageInfo: PageInfo;
 }, K extends ArrayKeys<TPage> & keyof TPage>(fetchPage: (page: number, perPage: number) => Promise<TPage>, itemsKey: K, options?: PaginateOptions): Promise<PaginateResult<ArrayElement<TPage, K>>>;
 /**
- * Async generator that yields each `PageInfo`-based page response until
+ * Async generator that yields each {@link PageInfo}-based page response until
  * `hasNextPage` is false or `maxPages` is reached.
  *
  * Use this for streaming or early-exit workflows where collecting every item
@@ -11051,7 +11566,7 @@ declare function paginateChunks<TChunk extends {
  * The pagination and pure-helper members of the `AniListApi` type.
  */
 
-/** Callback that fetches a single `PageInfo`-based page. */
+/** Callback that fetches a single {@link PageInfo}-based page. */
 type PageFetcher<TPage extends {
     pageInfo: PageInfo;
 }> = (page: number, perPage: number) => Promise<TPage>;
@@ -11059,13 +11574,19 @@ type PageFetcher<TPage extends {
 type ChunkFetcher<TChunk extends {
     hasNextChunk: boolean;
 }> = (chunk: number, perChunk: number) => Promise<TChunk>;
+/**
+ * Pagination and transformation helpers exposed by `AniListApi`.
+ *
+ * @see https://docs.anilist.co/reference/object/pageinfo
+ */
 type AniListHelpers = {
     /**
-     * Iterates `PageInfo`-based pages until `hasNextPage` is false or `maxPages` is reached.
+     * {@link paginate} walks {@link PageInfo}-based pages until `hasNextPage` is false or `maxPages` is
+     * reached, collecting every item across pages.
      * @param fetchPage - Callback that fetches a single page given its 1-based number and `perPage`.
      * @param itemsKey - The key of the items array on the page response (e.g. `"media"`, `"users"`).
-     * @param options - Optional `perPage`, `startPage`, and `maxPages` controls.
-     * @returns The collected items, per-page snapshots, page count, and whether the guard truncated the run.
+     * @param options - Optional `perPage`, `startPage`, and `maxPages` controls; a {@link PaginateOptions}.
+     * @returns The collected items, per-page snapshots, page count, and whether the guard truncated the run; a {@link PaginateResult}.
      * @see https://docs.anilist.co/reference/object/pageinfo
      * @example
      * ```typescript
@@ -11082,9 +11603,10 @@ type AniListHelpers = {
         [P in keyof TPage]: TPage[P] extends readonly unknown[] ? P : never;
     }[keyof TPage] & keyof TPage>(fetchPage: PageFetcher<TPage>, itemsKey: K, options?: PaginateOptions) => Promise<PaginateResult<TPage[K] extends readonly (infer U)[] ? U : never>>;
     /**
-     * Async generator yielding each `PageInfo`-based page until `hasNextPage` is false or `maxPages` is reached.
+     * `paginatePages` is an async generator yielding each {@link PageInfo}-based page until
+     * `hasNextPage` is false or `maxPages` is reached.
      * @param fetchPage - Callback that fetches a single page given its 1-based number and `perPage`.
-     * @param options - Optional `perPage`, `startPage`, and `maxPages` controls.
+     * @param options - Optional `perPage`, `startPage`, and `maxPages` controls; a {@link PaginateOptions}.
      * @returns An async generator yielding each raw page response in turn.
      * @see https://docs.anilist.co/reference/object/pageinfo
      * @example
@@ -11100,11 +11622,12 @@ type AniListHelpers = {
         pageInfo: PageInfo;
     }>(fetchPage: PageFetcher<TPage>, options?: PaginateOptions) => AsyncGenerator<TPage>;
     /**
-     * Iterates `MediaListCollection` chunks until `hasNextChunk` is false or `maxChunks` is reached.
+     * {@link paginateChunks} iterates {@link MediaListCollectionResponse} chunks until `hasNextChunk` is
+     * false or `maxChunks` is reached, collecting every item across chunks.
      * @param fetchChunk - Callback that fetches a single chunk given its 1-based number and `perChunk`.
      * @param itemsKey - The key of the items array on the chunk response (e.g. `"lists"`).
-     * @param options - Optional `perChunk`, `startChunk`, and `maxChunks` controls.
-     * @returns The collected items, per-chunk snapshots, chunk count, and whether the guard truncated the run.
+     * @param options - Optional `perChunk`, `startChunk`, and `maxChunks` controls; a {@link ChunkPaginateOptions}.
+     * @returns The collected items, per-chunk snapshots, chunk count, and whether the guard truncated the run; a {@link ChunkPaginateResult}.
      * @see https://docs.anilist.co/reference/object/medialistcollection
      * @example
      * ```typescript
@@ -11123,9 +11646,9 @@ type AniListHelpers = {
         [P in keyof TChunk]: TChunk[P] extends readonly unknown[] ? P : never;
     }[keyof TChunk] & keyof TChunk>(fetchChunk: ChunkFetcher<TChunk>, itemsKey: K, options?: ChunkPaginateOptions) => Promise<ChunkPaginateResult<TChunk[K] extends readonly (infer U)[] ? U : never>>;
     /**
-     * Builds an AniList `FuzzyDateInput` from optional year, month, and day parts.
-     * @param options - The year, month, and day to include. All fields are optional.
-     * @returns A `FuzzyDateInput` object containing only the provided parts.
+     * {@link fuzzyDate} builds an AniList {@link FuzzyDateInput} from optional year, month, and day parts.
+     * @param options - The year, month, and day to include; a {@link FuzzyDateOptions}. All fields are optional.
+     * @returns A {@link FuzzyDateInput} object containing only the provided parts.
      * @see https://docs.anilist.co/reference/input/fuzzydateinput
      * @example
      * ```typescript
@@ -11134,9 +11657,10 @@ type AniListHelpers = {
      */
     fuzzyDate: (options?: FuzzyDateOptions) => FuzzyDateInput;
     /**
-     * Flattens a `MediaListCollection` response into a single array of entries tagged with their list group.
-     * @param response - The `MediaListCollectionResponse` returned by `mediaListCollection`.
-     * @returns A flat array of entries across all list groups.
+     * {@link flattenMediaListCollection} flattens a {@link MediaListCollectionResponse} into a single array of
+     * entries tagged with their list group.
+     * @param response - The {@link MediaListCollectionResponse} returned by `mediaListCollection`.
+     * @returns A flat array of {@link FlattenedMediaListEntry} across all list groups.
      * @see https://docs.anilist.co/reference/object/medialistcollection
      * @example
      * ```typescript
@@ -11153,12 +11677,12 @@ type AniListHelpers = {
  *
  * Adding an operation touches four sites: the operation class under `query/`
  * or `mutation/`, its declaration on one of the group types under `facade/`
- * (composed into `AniListApi` below), and its instance wiring in
+ * (composed into {@link AniListApi} below), and its instance wiring in
  * `wiring.ts`.
  */
 
 /**
- * Transport settings accepted by an `AniLink` client: `timeout`, `signal`,
+ * Transport settings accepted by an {@link AniLink} client: `timeout`, `signal`,
  * automatic retries under the default policy (`retry: false` opts out), opt-in
  * `paceWithRateLimit` pacing and `circuitBreaker` fast-fail, lifecycle hooks,
  * and `exposeRawAxiosError`.
@@ -11184,68 +11708,246 @@ type AniListHelpers = {
 type AniLinkOptions = RequestOptions;
 /**
  * The AniList API surface exposed at `aniLink.anilist`, composed from the
- * group types under `facade/`.
+ * {@link AniListCustom}, {@link AniListQueries}, {@link AniListMutations}, and
+ * {@link AniListHelpers} group types under `facade/`.
  */
 type AniListApi = AniListCustom & AniListQueries & AniListMutations & AniListHelpers;
 
 /**
- * Per-provider credential shapes accepted by the `AniLink` constructor.
+ * {@link MalPicture} is the image variants returned by MyAnimeList for an anime entity.
+ *
+ * It is the `main_picture` shape inside {@link MalAnime} and is selected via {@link MalRequestOptions.fields} through `MalAnimeOperation.get` and `MyAnimeListAnimeApi.get`.
+ *
+ * @see https://myanimelist.net/apiconfig/references/api/v2#tag/anime/operation/anime_anime_id_get
+ */
+interface MalPicture {
+    /** The large image URL, when MyAnimeList provides one. */
+    large?: string;
+    /** The medium image URL, when MyAnimeList provides one. */
+    medium?: string;
+}
+/**
+ * {@link MalAnime} is the typed portion of a MyAnimeList anime response returned by `MalAnimeOperation.get` and `MyAnimeListAnimeApi.get`.
+ *
+ * It always carries `id` and `title`; additional fields appear when requested via {@link MalRequestOptions.fields} and are exposed through the index signature without narrowing.
+ *
+ * @see https://myanimelist.net/apiconfig/references/api/v2#tag/anime/operation/anime_anime_id_get
+ */
+interface MalAnime {
+    /** The MyAnimeList numeric identifier. */
+    id: number;
+    /** The canonical MyAnimeList title. */
+    title: string;
+    /** Optional image variants requested through the `fields` query parameter. */
+    main_picture?: MalPicture;
+    /** The synopsis, when requested via the `fields` query parameter. */
+    synopsis?: string;
+    /** The publication/airing status, when requested (one of MAL's status values such as `finished_airing`). */
+    status?: string;
+    /** The average score out of 10, when requested via the `fields` query parameter. */
+    mean?: number;
+    /** The total number of episodes, when requested via the `fields` query parameter. */
+    num_episodes?: number;
+    /** The media type, when requested (for example `tv`, `movie`, or `ova`). */
+    media_type?: string;
+    /** The first air/start date in ISO 8601 format, when requested via the `fields` query parameter. */
+    start_date?: string;
+    /** The broadcast schedule, when requested via the `fields` query parameter. */
+    broadcast?: string;
+    /** The 24-hour broadcast start time (JST) in `HHMM` form, when requested via the `fields` query parameter. */
+    start_time?: string;
+    /** The average episode duration in seconds, when requested via the `fields` query parameter. */
+    average_episode_duration?: number;
+    /** Any additional fields requested by a caller remain available without narrowing. */
+    [field: string]: unknown;
+}
+/**
+ * {@link MalUser} is the typed portion of the authenticated MyAnimeList user response returned by `MalUserOperation.me` and `MyAnimeListUserApi.me`.
+ *
+ * It always carries `id` and `name`; additional fields appear when requested via {@link MalRequestOptions.fields} and are exposed through the index signature without narrowing.
+ *
+ * @see https://myanimelist.net/apiconfig/references/api/v2#tag/users/operation/users_user_id_get
+ */
+interface MalUser {
+    /** The MyAnimeList numeric user identifier. */
+    id: number;
+    /** The user's MyAnimeList name. */
+    name: string;
+    /** Optional profile location. */
+    location?: string;
+    /** Optional account creation timestamp. */
+    joined_at?: string;
+    /** The user's profile picture variants, when requested via the `fields` query parameter. */
+    picture?: MalPicture;
+    /** The user's gender, when requested via the `fields` query parameter. */
+    gender?: string;
+    /** The user's birthday in ISO 8601 format, when requested via the `fields` query parameter. */
+    birthday?: string;
+    /** Any additional fields requested by a caller remain available without narrowing. */
+    [field: string]: unknown;
+}
+/**
+ * {@link MalRequestOptions} is the public request options shared by MAL endpoint methods.
+ *
+ * It extends {@link RequestOptions} with the MyAnimeList `fields` selector consumed by `MalAnimeOperation.get` and `MalUserOperation.me` through `MyAnimeListApi`. Transport settings are merged over the instance defaults from `MalCredentials` via `buildMyAnimeListApi`.
+ *
+ * @see https://myanimelist.net/apiconfig/references/api/v2#tag/anime/operation/anime_anime_id_get
+ * @see https://myanimelist.net/apiconfig/references/api/v2#tag/users/operation/users_user_id_get
+ */
+interface MalRequestOptions extends RequestOptions {
+    /** A comma-separated field selector, or the same selector as an array. */
+    fields?: string | readonly string[];
+}
+
+/**
+ * {@link MyAnimeListAnimeApi} is the anime group exposed by {@link MyAnimeListApi} under `aniLink.mal.anime`.
+ *
+ * It is the facade boundary for MyAnimeList anime reads; the single `MalAnimeOperation.get | get` method delegates to `MalAnimeOperation` and returns a {@link MalAnime} shaped by {@link MalRequestOptions.fields}.
+ *
+ * @see https://myanimelist.net/apiconfig/references/api/v2#tag/anime/operation/anime_anime_id_get
+ */
+interface MyAnimeListAnimeApi {
+    /**
+     * {@link MyAnimeListAnimeApi.get} gets one anime by its MyAnimeList ID through `MalAnimeOperation.get`.
+     *
+     * It is the public facade for the `GET /anime/{id}` endpoint; use {@link MalRequestOptions.fields} to select the response shape and {@link MalRequestOptions} transport settings to override per call.
+     *
+     * @param id - The MyAnimeList anime ID.
+     * @param options - Optional field selection and transport settings; a {@link MalRequestOptions} merged over the instance defaults.
+     * @returns The requested {@link MalAnime}.
+     * @throws `AniLinkRestError` for a non-success MyAnimeList response.
+     * @throws `AniLinkNetworkError` for timeout, cancellation, or other transport failures.
+     * @example
+     * ```typescript
+     * const api = new AniLink({ mal: { accessToken: "mal-token" } }).mal;
+     * const anime = await api.anime.get(21, { fields: ["id", "title", "main_picture"] });
+     * ```
+     * @see https://myanimelist.net/apiconfig/references/api/v2#tag/anime/operation/anime_anime_id_get
+     */
+    get: (id: number, options?: MalRequestOptions) => Promise<MalAnime>;
+}
+/**
+ * {@link MyAnimeListUserApi} is the user group exposed by {@link MyAnimeListApi} under `aniLink.mal.user`.
+ *
+ * It is the facade boundary for the authenticated MyAnimeList user read; the single `MalUserOperation.me | me` method delegates to `MalUserOperation` and returns a {@link MalUser} shaped by {@link MalRequestOptions.fields}.
+ *
+ * @see https://myanimelist.net/apiconfig/references/api/v2#tag/users/operation/users_user_id_get
+ */
+interface MyAnimeListUserApi {
+    /**
+     * {@link MyAnimeListUserApi.me} gets the currently authenticated MyAnimeList user through `MalUserOperation.me`.
+     *
+     * It is the public facade for `GET /users/@me` and requires a MAL access token from `MalCredentials.accessToken` via `buildMyAnimeListApi`; use {@link MalRequestOptions.fields} to select the response shape.
+     *
+     * @param options - Optional field selection and transport settings; a {@link MalRequestOptions} merged over the instance defaults.
+     * @returns The authenticated {@link MalUser}.
+     * @throws `AniLinkAuthError` when no MAL access token is configured.
+     * @throws `AniLinkRestError` for a non-success MyAnimeList response.
+     * @throws `AniLinkNetworkError` for timeout, cancellation, or other transport failures.
+     * @example
+     * ```typescript
+     * const api = new AniLink({ mal: { accessToken: "mal-token" } }).mal;
+     * const user = await api.user.me({ fields: ["id", "name"] });
+     * ```
+     * @see https://myanimelist.net/apiconfig/references/api/v2#tag/users/operation/users_user_id_get
+     */
+    me: (options?: MalRequestOptions) => Promise<MalUser>;
+}
+/**
+ * {@link MyAnimeListApi} is the typed MyAnimeList REST surface exposed by `aniLink.mal`.
+ *
+ * It composes {@link MyAnimeListAnimeApi} and {@link MyAnimeListUserApi} from `MalAnimeOperation` and `MalUserOperation` via `buildMyAnimeListApi`. Every method accepts {@link MalRequestOptions} and returns {@link MalAnime} or {@link MalUser}; OAuth helpers `buildMalAuthorizationUrl`, `getMalAccessToken`, and `refreshMalAccessToken` supply the token for `MalCredentials`.
+ *
+ * @see https://myanimelist.net/apiconfig/references/api/v2
+ */
+interface MyAnimeListApi {
+    /** Anime operations via {@link MyAnimeListAnimeApi} and `MalAnimeOperation`. */
+    anime: MyAnimeListAnimeApi;
+    /** User operations via {@link MyAnimeListUserApi} and `MalUserOperation`. */
+    user: MyAnimeListUserApi;
+}
+
+/**
+ * Per-provider credential shapes accepted by the {@link AniLink} constructor.
  *
  * Every provider owns its own credentials: AniList authenticates with a
  * bearer token, while REST providers such as MyAnimeList carry their own
- * access-token (and later PKCE) fields. All shapes extend
- * {@link ProviderCredentials} so transport settings stay uniform across
- * providers.
+ * access-token and PKCE fields. All shapes extend {@link ProviderCredentials}
+ * so transport settings stay uniform across providers.
  */
 
 /**
- * Credential and transport settings shared by every provider's slot in an
- * {@link AniLinkCredentials} object. A provider-specific credentials type
- * extends this with its own auth fields; the transport settings always apply
- * to that provider's operations only.
+ * Transport settings shared by every provider's slot in an
+ * {@link AniLinkCredentials} object. Provider-specific credential types
+ * extend this with their own authentication fields; the settings always
+ * apply to that provider's operations only.
+ *
+ * @see {@link AniLinkCredentials}
  */
 interface ProviderCredentials extends RequestOptions {
-    /**
-     * The bearer token sent as the `Authorization` header on authenticated
-     * requests for this provider. Optional: omit it to use only public
-     * endpoints.
-     */
-    authToken?: string;
+    /** Provider-specific credentials are defined by the provider implementation. */
+    readonly [credential: string]: unknown;
 }
 /**
  * AniList-specific credentials. Currently a bearer token plus transport
  * settings; OAuth helper functions live in `apis/graphql/anilist/auth`.
+ *
+ * @see {@link resolveAniListCredentials}
  */
-type AniListCredentials = ProviderCredentials;
+interface AniListCredentials extends ProviderCredentials {
+    /** The bearer token sent on authenticated AniList requests. */
+    authToken?: string;
+}
 /**
- * MyAnimeList-specific credentials reserved by the multi-provider seam.
+ * MyAnimeList-specific credentials consumed by the REST provider.
  *
  * MAL authenticates with an OAuth2 access token obtained through its PKCE
- * flow; `accessToken` is the field name used by the future MAL wiring so the
- * constructor can already accept and store it without leaking it into other
- * providers' requests.
+ * flow; `accessToken` and `clientId` are translated into the provider-neutral
+ * request-auth value without leaking either field into other providers'
+ * requests.
+ *
+ * @see {@link resolveMalCredentials}
  */
 interface MalCredentials extends ProviderCredentials {
-    /**
-     * The MAL OAuth2 access token. Distinct from {@link ProviderCredentials.authToken}
-     * so each provider's token is stored under its own name until the MAL
-     * provider module consumes it.
-     */
+    /** The MAL OAuth2 access token, kept in this provider's credential slot. */
     accessToken?: string;
+    /** The MAL OAuth2 refresh token used to obtain a new access token. */
+    refreshToken?: string;
+    /** The MAL application client ID used by OAuth helpers. */
+    clientId?: string;
+    /** The MAL application secret, when the application requires one. */
+    clientSecret?: string;
 }
 /**
- * The per-provider credentials object accepted by the `AniLink` constructor.
+ * The per-provider credentials object accepted by the {@link AniLink} constructor.
  *
  * Each key targets exactly one provider namespace (`aniLink.anilist`,
  * `aniLink.mal`, …); credentials given under one key are never applied to
  * another provider's requests.
+ *
+ * @see {@link ProviderCredentials}
  */
 interface AniLinkCredentials {
     /** Credentials for the AniList provider surface. */
     anilist?: AniListCredentials;
-    /** Credentials for the MyAnimeList provider surface (reserved). */
+    /** Credentials for the MyAnimeList provider surface. */
     mal?: MalCredentials;
 }
+/**
+ * Normalized authentication and transport settings for one provider slot.
+ *
+ * Credential resolvers use this shape to keep provider-specific fields out of
+ * the shared operation-constructor seam while preserving provider-only auth.
+ *
+ * @see {@link resolveAniListCredentials}
+ * @see {@link resolveMalCredentials}
+ */
+interface ResolvedProviderCredentials {
+    /** Authentication material for the provider's request operations. */
+    auth?: RequestAuthInput;
+    /** Transport settings with provider-only authentication fields removed. */
+    options?: RequestOptions;
+}
 
 /** The AniList OAuth2 token endpoint used for code exchange and refresh. */
 declare const ANILIST_TOKEN_URL = "https://anilist.co/api/v2/oauth/token";
@@ -11257,7 +11959,7 @@ declare const ANILIST_AUTHORIZE_URL = "https://anilist.co/api/v2/oauth/authorize
  * rotate the refresh token.
  */
 interface AniListTokenResponse {
-    /** The bearer token to pass to the `AniLink` constructor. */
+    /** The bearer token to pass to the {@link AniLink} constructor. */
     access_token: string;
     /** The token type, typically `Bearer`. */
     token_type: string;
@@ -11296,7 +11998,7 @@ declare const buildAuthorizationUrl: (clientId: string, redirectUri: string, sta
  * @param redirectUri - The redirect URI registered for your AniList application. This parameter is optional but must match the URI used in {@link buildAuthorizationUrl} when AniList requires it.
  * @param signal - Optional `AbortSignal` to cancel the token exchange while it is in flight.
  * @returns A promise that resolves to the token response containing `access_token`.
- * @throws An `AniLinkApiError` when AniList rejects the exchange, for example with `invalid_grant` for an invalid or expired code, or an `AniLinkNetworkError` on transport failure. Errors never include the request body, so the client secret and code are not leaked.
+ * @throws An {@link AniLinkApiError} when AniList rejects the exchange, for example with `invalid_grant` for an invalid or expired code, or an {@link AniLinkNetworkError} on transport failure. Errors never include the request body, so the client secret and code are not leaked.
  * @example
  * ```typescript
  * const { access_token } = await getAccessToken(
@@ -11318,7 +12020,7 @@ declare const getAccessToken: (clientId: string, clientSecret: string, code: str
  * @param refreshToken - The refresh token from a previous token response.
  * @param signal - Optional `AbortSignal` to cancel the refresh while it is in flight.
  * @returns A promise that resolves to the token response containing a new `access_token`. The `refresh_token` field may be absent when AniList does not rotate it.
- * @throws An `AniLinkApiError` when AniList rejects the refresh, for example when the refresh token is invalid or revoked, or an `AniLinkNetworkError` on transport failure. Errors never include the request body, so the client secret and refresh token are not leaked.
+ * @throws An {@link AniLinkApiError} when AniList rejects the refresh, for example when the refresh token is invalid or revoked, or an {@link AniLinkNetworkError} on transport failure. Errors never include the request body, so the client secret and refresh token are not leaked.
  * @example
  * ```typescript
  * const { access_token } = await refreshAccessToken("1234", "secret", "stored-refresh-token");
@@ -11346,25 +12048,255 @@ declare const refreshAccessToken: (clientId: string, clientSecret: string, refre
 declare const getTokenExpiry: (response: AniListTokenResponse, now?: number) => Date;
 
 /**
- * `AniLink` is a class for interacting with the APIs.
- * It provides methods for querying and mutating data.
+ * {@link ProviderId} is the union of provider identifiers composed by {@link AniLink} and {@link ProviderClients}.
+ *
+ * It keys {@link PROVIDER_FACTORIES} and {@link AniLinkCredentials}, isolating each provider's credentials and transport settings.
+ *
+ * @see {@link ProviderClients}
+ * @see {@link buildProviderClients}
+ */
+type ProviderId = "anilist" | "mal";
+/**
+ * {@link ProviderClients} is the typed provider clients exposed by one {@link AniLink} instance.
+ *
+ * It composes {@link AniListApi} under `anilist` and {@link MyAnimeListApi} under `mal`, each built from its own credential slot via {@link PROVIDER_FACTORIES} and {@link buildProviderClients}.
+ *
+ * @see {@link AniLink}
+ * @see {@link buildProviderClients}
+ */
+interface ProviderClients {
+    /** The AniList GraphQL provider client, a {@link AniListApi} built from {@link AniListCredentials}. */
+    anilist: AniListApi;
+    /** The MyAnimeList REST provider client, a {@link MyAnimeListApi} built from {@link MalCredentials} via {@link buildMyAnimeListApi}. */
+    mal: MyAnimeListApi;
+}
+/**
+ * {@link ProviderFactory} is a provider factory that receives only that provider's credential slot.
+ *
+ * It is the shape of each entry in {@link PROVIDER_FACTORIES} and is invoked by {@link buildProviderClients} with isolated {@link AniListCredentials} or {@link MalCredentials} plus optional {@link RequestOptions}.
+ *
+ * @typeParam TCredentials - The credential slot for the provider, such as {@link AniListCredentials} or {@link MalCredentials}.
+ * @typeParam TClient - The client produced, such as {@link AniListApi} or {@link MyAnimeListApi}.
+ * @param credentials - The provider's credential slot.
+ * @param legacyOptions - Transport settings for the legacy `new AniLink(token, options)` form; only the AniList factory consumes this.
+ * @returns The typed client for the provider.
+ * @see {@link PROVIDER_FACTORIES}
+ * @see {@link buildProviderClients}
+ */
+type ProviderFactory<TCredentials, TClient> = (credentials?: TCredentials, legacyOptions?: RequestOptions) => TClient;
+/**
+ * {@link buildProviderClients} builds every public provider client from isolated credential slots.
+ *
+ * It invokes each {@link ProviderFactory} in {@link PROVIDER_FACTORIES} with its own {@link AniLinkCredentials} slot, producing {@link ProviderClients} with the AniList surface (`AniListApi`) and the MyAnimeList surface (`MyAnimeListApi`). The optional `legacyOptions` argument exists only for the positional `new AniLink(token, options)` constructor form; provider-scoped credentials carry their own {@link RequestOptions} and never share them with another slot.
+ *
+ * @param credentials - Per-provider credential slots; an {@link AniLinkCredentials} object.
+ * @param legacyOptions - Transport settings for the legacy AniList form; forwarded only to the AniList factory.
+ * @returns Typed clients for every registered provider, a {@link ProviderClients} object.
+ * @see {@link PROVIDER_FACTORIES}
+ * @see {@link ProviderClients}
+ * @example
+ * ```typescript
+ * const clients = buildProviderClients({
+ *     anilist: { authToken: "anilist-token" },
+ *     mal: { accessToken: "mal-token" },
+ * });
+ * const anime = await clients.mal.anime.get(21);
+ * ```
+ */
+declare function buildProviderClients(credentials?: AniLinkCredentials, legacyOptions?: AniLinkOptions): ProviderClients;
+
+/**
+ * {@link MAL_API_BASE_URL} is the base URL for the MyAnimeList API v2 consumed by `MalAnimeOperation` and `MalUserOperation`.
+ *
+ * It is the prefix for the built-in REST calls exposed through `MyAnimeListApi`.
+ *
+ * @see https://myanimelist.net/apiconfig/references/api/v2
+ */
+declare const MAL_API_BASE_URL = "https://api.myanimelist.net/v2";
+/**
+ * {@link MAL_AUTHORIZE_URL} is the MyAnimeList OAuth2 authorization endpoint used by `buildMalAuthorizationUrl`.
+ *
+ * It is the entry point for the PKCE flow that produces the code consumed by `getMalAccessToken`.
+ *
+ * @see https://myanimelist.net/apiconfig/references/authorization
+ */
+declare const MAL_AUTHORIZE_URL = "https://myanimelist.net/v1/oauth2/authorize";
+/**
+ * {@link MAL_TOKEN_URL} is the MyAnimeList OAuth2 token endpoint used by `getMalAccessToken` and `refreshMalAccessToken`.
+ *
+ * It exchanges the PKCE code or refresh token for a `MalTokenResponse`.
+ *
+ * @see https://myanimelist.net/apiconfig/references/authorization
+ */
+declare const MAL_TOKEN_URL = "https://myanimelist.net/v1/oauth2/token";
+/**
+ * {@link MAL_API_REFERENCE} is the MyAnimeList API v2 reference index linked from `MyAnimeListApi` and `buildMyAnimeListApi`.
+ *
+ * Use it as the generic fallback when a more specific endpoint reference is not available.
+ *
+ * @see https://myanimelist.net/apiconfig/references/api/v2
+ */
+declare const MAL_API_REFERENCE = "https://myanimelist.net/apiconfig/references/api/v2";
+
+/**
+ * {@link MalTokenResponse} is the successful MyAnimeList OAuth2 token response returned by {@link getMalAccessToken} and {@link refreshMalAccessToken}.
+ *
+ * It carries the bearer token consumed by `MalAnimeOperation` and `MalUserOperation` through `MalCredentials`.
+ *
+ * @see https://myanimelist.net/apiconfig/references/authorization
+ */
+interface MalTokenResponse {
+    /** The bearer access token used by MAL REST operations. */
+    access_token: string;
+    /** The token type, normally `Bearer`. */
+    token_type: string;
+    /** The access-token lifetime in seconds. */
+    expires_in: number;
+    /** A refresh token, when MAL issues one. */
+    refresh_token?: string;
+    /** The granted scopes, when MAL returns them. */
+    scope?: string;
+}
+/**
+ * {@link MalAuthorizationCodeRequest} is the input for {@link getMalAccessToken} when exchanging a MAL authorization code with PKCE.
+ *
+ * It carries the client identity and PKCE verifier initiated by {@link buildMalAuthorizationUrl}, plus optional {@link RequestOptions} for the token call.
+ *
+ * @see https://myanimelist.net/apiconfig/references/authorization
+ */
+interface MalAuthorizationCodeRequest {
+    /** The MAL application client ID. */
+    clientId: string;
+    /** The authorization code returned by the redirect. */
+    code: string;
+    /** The original PKCE code verifier. */
+    codeVerifier: string;
+    /** An optional client secret for applications that use one. */
+    clientSecret?: string;
+    /** Shared transport settings for the token request. */
+    options?: RequestOptions;
+}
+/**
+ * {@link MalRefreshTokenRequest} is the input for {@link refreshMalAccessToken} when refreshing a MAL access token.
+ *
+ * It carries the client identity and stored refresh token from a prior {@link MalTokenResponse}, plus optional {@link RequestOptions} for the token call.
+ *
+ * @see https://myanimelist.net/apiconfig/references/authorization
+ */
+interface MalRefreshTokenRequest {
+    /** The MAL application client ID. */
+    clientId: string;
+    /** The stored MAL refresh token. */
+    refreshToken: string;
+    /** An optional client secret for applications that use one. */
+    clientSecret?: string;
+    /** Shared transport settings for the token request. */
+    options?: RequestOptions;
+}
+/**
+ * {@link buildMalAuthorizationUrl} is the PKCE helper that builds the MyAnimeList OAuth2 authorization URL for {@link getMalAccessToken}.
+ *
+ * It encodes the client identity and PKCE challenge from {@link MalAuthorizationCodeRequest} and returns the URL to open in a browser. The current implementation sends `code_challenge_method=S256`; verify that method against the linked MAL authorization reference before relying on the helper. Validate the `state` on redirect before exchanging the code via {@link getMalAccessToken}.
+ *
+ * @param clientId - The MAL application client ID from {@link MalAuthorizationCodeRequest.clientId}.
+ * @param codeChallenge - The PKCE challenge generated for the login attempt; this helper sends it with the `S256` method.
+ * @param state - Optional opaque CSRF state to validate on the redirect.
+ * @returns The fully encoded authorization URL for the MAL OAuth flow.
+ * @example
+ * ```typescript
+ * const url = buildMalAuthorizationUrl("client-id", "pkce-challenge", "csrf-state");
+ * // Open url in a browser, then exchange the returned code with getMalAccessToken.
+ * ```
+ * @see https://myanimelist.net/apiconfig/references/authorization
+ */
+declare const buildMalAuthorizationUrl: (clientId: string, codeChallenge: string, state?: string) => string;
+/**
+ * {@link getMalAccessToken} exchanges a MAL authorization code for an access token through PKCE.
+ *
+ * It completes the flow started by {@link buildMalAuthorizationUrl} using the {@link MalAuthorizationCodeRequest} fields and returns a {@link MalTokenResponse} consumed by `MalCredentials` and `buildMyAnimeListApi`. Transport is shared with {@link RequestOptions}.
+ *
+ * @param request - The authorization-code fields and optional transport settings; a {@link MalAuthorizationCodeRequest}.
+ * @returns The {@link MalTokenResponse} for the authenticated session.
+ * @throws An {@link AniLinkApiError} or {@link AniLinkNetworkError} with sanitized token-request details.
+ * @example
+ * ```typescript
+ * const token = await getMalAccessToken({ clientId, code, codeVerifier });
+ * // token.access_token -> pass as MalCredentials.accessToken to buildMyAnimeListApi
+ * ```
+ * @see https://myanimelist.net/apiconfig/references/authorization
+ */
+declare const getMalAccessToken: (request: MalAuthorizationCodeRequest) => Promise<MalTokenResponse>;
+/**
+ * {@link refreshMalAccessToken} exchanges a MAL refresh token for a new access token.
+ *
+ * It uses the {@link MalRefreshTokenRequest} fields from a prior {@link MalTokenResponse} and returns a fresh {@link MalTokenResponse} for `MalCredentials` and `buildMyAnimeListApi`. Transport is shared with {@link RequestOptions}.
+ *
+ * @param request - The refresh-token fields and optional transport settings; a {@link MalRefreshTokenRequest}.
+ * @returns The refreshed {@link MalTokenResponse}.
+ * @throws An {@link AniLinkApiError} or {@link AniLinkNetworkError} with sanitized token-request details.
+ * @example
+ * ```typescript
+ * const token = await refreshMalAccessToken({ clientId, refreshToken });
+ * // token.access_token -> replace the stored MalCredentials.accessToken
+ * ```
+ * @see https://myanimelist.net/apiconfig/references/authorization
+ */
+declare const refreshMalAccessToken: (request: MalRefreshTokenRequest) => Promise<MalTokenResponse>;
+/**
+ * {@link getMalTokenExpiry} computes the absolute expiry time of a {@link MalTokenResponse}.
+ *
+ * It adds `expires_in` from the response returned by {@link getMalAccessToken} or {@link refreshMalAccessToken} to the supplied clock value, so callers can schedule refresh before the token held in `MalCredentials` expires.
+ *
+ * @param response - The {@link MalTokenResponse} whose `expires_in` to evaluate.
+ * @param now - The current time in milliseconds since the Unix epoch.
+ * @returns The moment the access token expires.
+ * @example
+ * ```typescript
+ * const expiresAt = getMalTokenExpiry(token);
+ * if (expiresAt.getTime() - Date.now() < 60_000) await refreshMalAccessToken({ clientId, refreshToken });
+ * ```
+ * @see https://myanimelist.net/apiconfig/references/authorization
+ */
+declare const getMalTokenExpiry: (response: MalTokenResponse, now?: number) => Date;
+
+/**
+ * {@link buildMyAnimeListApi} is the wiring helper that builds the {@link MyAnimeListApi} from provider-owned {@link MalCredentials}.
+ *
+ * It resolves credentials through {@link resolveMalCredentials} and composes {@link MalAnimeOperation} and {@link MalUserOperation} into the {@link MyAnimeListApi} facade exposed as `aniLink.mal`. Transport settings from {@link MalCredentials} flow to `MalRequestOptions` without leaking between providers.
+ *
+ * @param credentials - MAL access and OAuth credentials plus transport settings; a {@link MalCredentials} slot.
+ * @returns The composed {@link MyAnimeListApi} surface.
+ * @example
+ * ```typescript
+ * const api = buildMyAnimeListApi({ accessToken: "mal-token" });
+ * const anime = await api.anime.get(21);
+ * ```
+ * @see https://myanimelist.net/apiconfig/references/api/v2
+ */
+declare function buildMyAnimeListApi(credentials?: MalCredentials): MyAnimeListApi;
+
+/**
+ * {@link AniLink} is the public entry point for interacting with the AniList GraphQL
+ * and MyAnimeList REST APIs. A single instance composes an {@link AniListApi}
+ * (under `anilist`) and a {@link MyAnimeListApi} (under `mal`), each keeping its
+ * own credentials and transport settings.
  */
 declare class AniLink {
     /**
-     * Anilist API methods.
+     * The AniList GraphQL API surface, a {@link AniListApi} composed from the
+     * query, mutation, custom, and helper groups.
      * @public
      */
     anilist: AniListApi;
+    /** The MyAnimeList REST API methods, a {@link MyAnimeListApi} exposed under the `mal` namespace. */
+    mal: MyAnimeListApi;
     /**
-     * MyAnimeList API methods. Populated once the MAL provider module ships;
-     * the constructor already accepts and stores MAL credentials so adding
-     * the provider requires no further constructor change.
-     */
-    mal?: unknown;
-    /**
-     * Creates a new AniLink instance. The `authToken` parameter is optional and only required for authenticated queries and mutations. If no `authToken` is provided, only public queries will be available. You are able to create multiple AniLink instances with different `authToken`s.
+     * Creates a new {@link AniLink} instance. The `authToken` parameter is optional and only
+     * required for authenticated queries and mutations; without it only public queries are
+     * available. Multiple instances can hold different `authToken`s, each exposing an
+     * {@link AniListApi} under `anilist` and a {@link MyAnimeListApi} under `mal`.
      *
-     * Alternatively, pass a per-provider credentials object: each provider
+     * Alternatively, pass a per-provider {@link AniLinkCredentials} object: each provider
      * owns its own credentials shape, and credentials given under one key are
      * never applied to another provider's requests.
      * @param {string | AniLinkCredentials} [authToken] - The authentication token to use for AniList API requests, or a per-provider credentials object (`{ anilist?: …, mal?: … }`).
@@ -11390,8 +12322,8 @@ declare class AniLink {
      * });
      * ```
      */
-    constructor(authToken?: string | AniLinkCredentials, options?: AniLinkOptions & Partial<Record<never, never>>);
+    constructor(authToken?: string | AniLinkCredentials, options?: AniLinkOptions);
 }
 
-export { ANILIST_AUTHORIZE_URL, ANILIST_TOKEN_URL, AniLink, AniLinkApiError, AniLinkAuthError, AniLinkError, AniLinkErrorCodes, AniLinkGraphQLError, AniLinkNetworkError, AniLinkRestError, AniLinkValidationError, buildAuthorizationUrl, getAccessToken, getTokenExpiry, paginate, paginateChunks, paginatePages, refreshAccessToken };
-export type { AniLinkCredentials, AniLinkErrorCode, AniLinkOptions, AniListApi, AniListCredentials, AniListTokenResponse, ChunkPaginateOptions, ChunkPaginateResult, MalCredentials, PaginateOptions, PaginateResult, ProviderCredentials, RateLimitInfo };
+export { ANILIST_AUTHORIZE_URL, ANILIST_TOKEN_URL, AniLink, AniLinkApiError, AniLinkAuthError, AniLinkError, AniLinkErrorCodes, AniLinkGraphQLError, AniLinkNetworkError, AniLinkRestError, AniLinkValidationError, MAL_API_BASE_URL, MAL_API_REFERENCE, MAL_AUTHORIZE_URL, MAL_TOKEN_URL, buildAuthorizationUrl, buildMalAuthorizationUrl, buildMyAnimeListApi, buildProviderClients, getAccessToken, getMalAccessToken, getMalTokenExpiry, getTokenExpiry, paginate, paginateChunks, paginatePages, refreshAccessToken, refreshMalAccessToken };
+export type { AniLinkCredentials, AniLinkErrorCode, AniLinkOptions, AniListApi, AniListCredentials, AniListTokenResponse, ChunkPaginateOptions, ChunkPaginateResult, MalAnime as M, MalAuthorizationCodeRequest, MalCredentials, MalRefreshTokenRequest, MalTokenResponse, MyAnimeListApi, PaginateOptions, PaginateResult, ProviderClients, ProviderCredentials, ProviderFactory, ProviderId, RequestOptions as R, RateLimitInfo, RequestAuth, RequestAuthInput, ResolvedProviderCredentials, MalPicture as a, MalRequestOptions as b, MalUser as c, MyAnimeListAnimeApi as d, MyAnimeListUserApi as e };