@book000/pixivts 0.59.4 → 0.60.0-beta.10

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+//#region src/result.d.ts
 /**
  * Zero-dependency Result / ResultAsync implementation.
  *
@@ -17,41 +18,41 @@
  */
 /** Successful result carrying `value`. */
 interface OkResult<T> {
-    /** Always `true` — use this to narrow the union to `OkResult<T>`. */
-    readonly isOk: true;
-    /** Always `false` — use this to narrow the union to `OkResult<T>`. */
-    readonly isErr: false;
-    /** The success value. */
-    readonly value: T;
-    /** Returns an `OkResult` with `fn(value)`. */
-    map<U>(fn: (value: T) => U): OkResult<U>;
-    /** Returns `this` unchanged. */
-    mapErr<F>(_fn: (error: never) => F): OkResult<T>;
-    /** Calls `fn(value)` and returns its Result. */
-    andThen<U, F>(fn: (value: T) => Result<U, F>): Result<U, F>;
-    /** Calls `onOk` and returns its result. */
-    match<U>(onOk: (value: T) => U, _onErr: (error: never) => U): U;
-    /** Returns `value`. */
-    unwrapOr(_fallback: T): T;
+  /** Always `true` — use this to narrow the union to `OkResult<T>`. */
+  readonly isOk: true;
+  /** Always `false` — use this to narrow the union to `OkResult<T>`. */
+  readonly isErr: false;
+  /** The success value. */
+  readonly value: T;
+  /** Returns an `OkResult` with `fn(value)`. */
+  map<U>(fn: (value: T) => U): OkResult<U>;
+  /** Returns `this` unchanged. */
+  mapErr<F>(_fn: (error: never) => F): OkResult<T>;
+  /** Calls `fn(value)` and returns its Result. */
+  andThen<U, F>(fn: (value: T) => Result<U, F>): Result<U, F>;
+  /** Calls `onOk` and returns its result. */
+  match<U>(onOk: (value: T) => U, _onErr: (error: never) => U): U;
+  /** Returns `value`. */
+  unwrapOr(_fallback: T): T;
 }
 /** Failed result carrying `error`. */
 interface ErrResult<E> {
-    /** Always `false` — use this to narrow the union to `ErrResult<E>`. */
-    readonly isOk: false;
-    /** Always `true` — use this to narrow the union to `ErrResult<E>`. */
-    readonly isErr: true;
-    /** The error value. */
-    readonly error: E;
-    /** Returns `this` unchanged. */
-    map<U>(_fn: (value: never) => U): ErrResult<E>;
-    /** Returns an `ErrResult` with `fn(error)`. */
-    mapErr<F>(fn: (error: E) => F): ErrResult<F>;
-    /** Returns `this` unchanged. */
-    andThen<U, F>(_fn: (value: never) => Result<U, F>): ErrResult<E>;
-    /** Calls `onErr` and returns its result. */
-    match<U>(_onOk: (value: never) => U, onErr: (error: E) => U): U;
-    /** Returns `fallback`. */
-    unwrapOr<T>(fallback: T): T;
+  /** Always `false` — use this to narrow the union to `ErrResult<E>`. */
+  readonly isOk: false;
+  /** Always `true` — use this to narrow the union to `ErrResult<E>`. */
+  readonly isErr: true;
+  /** The error value. */
+  readonly error: E;
+  /** Returns `this` unchanged. */
+  map<U>(_fn: (value: never) => U): ErrResult<E>;
+  /** Returns an `ErrResult` with `fn(error)`. */
+  mapErr<F>(fn: (error: E) => F): ErrResult<F>;
+  /** Returns `this` unchanged. */
+  andThen<U, F>(_fn: (value: never) => Result<U, F>): ErrResult<E>;
+  /** Calls `onErr` and returns its result. */
+  match<U>(_onOk: (value: never) => U, onErr: (error: E) => U): U;
+  /** Returns `fallback`. */
+  unwrapOr<T>(fallback: T): T;
 }
 /** A value that is either `OkResult<T>` or `ErrResult<E>`. */
 type Result<T, E> = OkResult<T> | ErrResult<E>;
@@ -80,64 +81,65 @@ declare function err<E>(error: E): ErrResult<E>;
  * ```
  */
 declare class ResultAsync<T, E> implements PromiseLike<Result<T, E>> {
-    private readonly _promise;
-    constructor(promise: Promise<Result<T, E>>);
-    then<TResult1 = Result<T, E>, TResult2 = never>(onfulfilled?: ((value: Result<T, E>) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): PromiseLike<TResult1 | TResult2>;
-    /**
-     * Wraps a `Promise<T>` into a `ResultAsync<T, E>`.
-     *
-     * If the promise rejects, `onError` maps the rejection reason to `E`.
-     *
-     * @param promise - The promise to wrap
-     * @param onError - Error mapper
-     */
-    static fromPromise<T, E>(promise: Promise<T>, onError: (reason: unknown) => E): ResultAsync<T, E>;
-    /**
-     * Wraps an already-resolved `Result<T, E>` into a `ResultAsync<T, E>`.
-     *
-     * @param result - The result to wrap
-     */
-    static fromResult<T, E>(result: Result<T, E>): ResultAsync<T, E>;
-    /**
-     * Transforms the success value.
-     *
-     * If the inner result is `Err`, `fn` is not called.
-     *
-     * @param fn - Synchronous mapper
-     */
-    map<U>(fn: (value: T) => U): ResultAsync<U, E>;
-    /**
-     * Transforms the error value.
-     *
-     * If the inner result is `Ok`, `fn` is not called.
-     *
-     * @param fn - Synchronous error mapper
-     */
-    mapErr<F>(fn: (error: E) => F): ResultAsync<T, F>;
-    /**
-     * Chains another async operation that may fail.
-     *
-     * If the inner result is `Err`, `fn` is not called.
-     *
-     * @param fn - Async mapper that returns a `ResultAsync<U, F>`
-     */
-    andThen<U, F>(fn: (value: T) => ResultAsync<U, F> | Result<U, F>): ResultAsync<U, E | F>;
-    /**
-     * Pattern-matches on success / failure.
-     *
-     * @param onOk - Called with the success value
-     * @param onErr - Called with the error value
-     * @returns A `Promise<U>`
-     */
-    match<U>(onOk: (value: T) => U | Promise<U>, onErr: (error: E) => U | Promise<U>): Promise<U>;
-    /**
-     * Returns the success value, or `fallback` if the result is `Err`.
-     *
-     * @param fallback - The fallback value
-     */
-    unwrapOr(fallback: T): Promise<T>;
-}
-
+  private readonly _promise;
+  constructor(promise: Promise<Result<T, E>>);
+  then<TResult1 = Result<T, E>, TResult2 = never>(onfulfilled?: ((value: Result<T, E>) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): PromiseLike<TResult1 | TResult2>;
+  /**
+   * Wraps a `Promise<T>` into a `ResultAsync<T, E>`.
+   *
+   * If the promise rejects, `onError` maps the rejection reason to `E`.
+   *
+   * @param promise - The promise to wrap
+   * @param onError - Error mapper
+   */
+  static fromPromise<T, E>(promise: Promise<T>, onError: (reason: unknown) => E): ResultAsync<T, E>;
+  /**
+   * Wraps an already-resolved `Result<T, E>` into a `ResultAsync<T, E>`.
+   *
+   * @param result - The result to wrap
+   */
+  static fromResult<T, E>(result: Result<T, E>): ResultAsync<T, E>;
+  /**
+   * Transforms the success value.
+   *
+   * If the inner result is `Err`, `fn` is not called.
+   *
+   * @param fn - Synchronous mapper
+   */
+  map<U>(fn: (value: T) => U): ResultAsync<U, E>;
+  /**
+   * Transforms the error value.
+   *
+   * If the inner result is `Ok`, `fn` is not called.
+   *
+   * @param fn - Synchronous error mapper
+   */
+  mapErr<F>(fn: (error: E) => F): ResultAsync<T, F>;
+  /**
+   * Chains another async operation that may fail.
+   *
+   * If the inner result is `Err`, `fn` is not called.
+   *
+   * @param fn - Async mapper that returns a `ResultAsync<U, F>`
+   */
+  andThen<U, F>(fn: (value: T) => ResultAsync<U, F> | Result<U, F>): ResultAsync<U, E | F>;
+  /**
+   * Pattern-matches on success / failure.
+   *
+   * @param onOk - Called with the success value
+   * @param onErr - Called with the error value
+   * @returns A `Promise<U>`
+   */
+  match<U>(onOk: (value: T) => U | Promise<U>, onErr: (error: E) => U | Promise<U>): Promise<U>;
+  /**
+   * Returns the success value, or `fallback` if the result is `Err`.
+   *
+   * @param fallback - The fallback value
+   */
+  unwrapOr(fallback: T): Promise<T>;
+}
+//#endregion
+//#region src/auth.d.ts
 /**
  * Authentication manager for the pixiv API.
  *
@@ -150,12 +152,12 @@ declare class ResultAsync<T, E> implements PromiseLike<Result<T, E>> {
  */
 /** Auth credentials returned by the pixiv token endpoint. */
 interface AuthCredentials {
-    /** Numeric user ID returned as a string by the token endpoint. */
-    userId: string;
-    /** Short-lived bearer token for API requests. */
-    accessToken: string;
-    /** Long-lived token used to obtain new access tokens. */
-    refreshToken: string;
+  /** Numeric user ID returned as a string by the token endpoint. */
+  userId: string;
+  /** Short-lived bearer token for API requests. */
+  accessToken: string;
+  /** Long-lived token used to obtain new access tokens. */
+  refreshToken: string;
 }
 /**
  * Manages access tokens for the pixiv API.
@@ -165,29 +167,30 @@ interface AuthCredentials {
  * via the pixiv OAuth endpoint.
  */
 declare class AuthManager {
-    #private;
-    userId: string;
-    constructor(credentials: AuthCredentials);
-    /** Returns the current access token. */
-    get accessToken(): string;
-    /** Returns the current refresh token. */
-    get refreshToken(): string;
-    /**
-     * Exchanges the stored refresh token for a fresh access token.
-     *
-     * Updates the internal credentials on success.
-     * Throws if the token endpoint returns a non-200 response.
-     */
-    refresh(): Promise<void>;
-    /**
-     * Creates an `AuthManager` by performing the initial token refresh.
-     *
-     * @param refreshToken - Pixiv refresh token
-     * @returns Initialized `AuthManager`
-     */
-    static login(refreshToken: string): Promise<AuthManager>;
-}
-
+  #private;
+  userId: string;
+  constructor(credentials: AuthCredentials);
+  /** Returns the current access token. */
+  get accessToken(): string;
+  /** Returns the current refresh token. */
+  get refreshToken(): string;
+  /**
+   * Exchanges the stored refresh token for a fresh access token.
+   *
+   * Updates the internal credentials on success.
+   * Throws if the token endpoint returns a non-200 response.
+   */
+  refresh(): Promise<void>;
+  /**
+   * Creates an `AuthManager` by performing the initial token refresh.
+   *
+   * @param refreshToken - Pixiv refresh token
+   * @returns Initialized `AuthManager`
+   */
+  static login(refreshToken: string): Promise<AuthManager>;
+}
+//#endregion
+//#region src/interceptor.d.ts
 /**
  * Response interceptor types for the pixiv API client.
  *
@@ -209,24 +212,24 @@ type HttpMethod = 'GET' | 'POST';
  * HTTP call made by the pixiv client.
  */
 interface ResponseRecord {
-    /** HTTP method used for the request. */
-    method: HttpMethod;
-    /** API endpoint path (e.g. "/v1/illust/detail"). */
-    endpoint: string;
-    /** Full request URL including query string (null if unavailable). */
-    url: string | null;
-    /** JSON-serialized request headers (null if unavailable). */
-    requestHeaders: string | null;
-    /** URL-encoded request body for POST requests (null for GET). */
-    requestBody: string | null;
-    /** Whether the response body was parsed as JSON or left as plain text. */
-    responseType: 'JSON' | 'TEXT';
-    /** HTTP response status code. */
-    statusCode: number;
-    /** JSON-serialized response headers (null if unavailable). */
-    responseHeaders: string | null;
-    /** Serialized response body. */
-    responseBody: string;
+  /** HTTP method used for the request. */
+  method: HttpMethod;
+  /** API endpoint path (e.g. "/v1/illust/detail"). */
+  endpoint: string;
+  /** Full request URL including query string (null if unavailable). */
+  url: string | null;
+  /** JSON-serialized request headers (null if unavailable). */
+  requestHeaders: string | null;
+  /** URL-encoded request body for POST requests (null for GET). */
+  requestBody: string | null;
+  /** Whether the response body was parsed as JSON or left as plain text. */
+  responseType: 'JSON' | 'TEXT';
+  /** HTTP response status code. */
+  statusCode: number;
+  /** JSON-serialized response headers (null if unavailable). */
+  responseHeaders: string | null;
+  /** Serialized response body. */
+  responseBody: string;
 }
 /**
  * A callback invoked after every successful API response.
@@ -236,7 +239,8 @@ interface ResponseRecord {
  * asynchronously if persistence latency matters.
  */
 type ResponseInterceptor = (record: ResponseRecord) => void | Promise<void>;
-
+//#endregion
+//#region src/errors.d.ts
 /**
  * Discriminated union of all errors that can occur when using the pixiv API client.
  *
@@ -249,27 +253,18 @@ type ResponseInterceptor = (record: ResponseRecord) => void | Promise<void>;
  * ```
  */
 type PixivError = {
-    /** The request hit the rate limit and exhausted all retries. */
-    type: 'rate_limit';
-    /** Retry-After duration parsed from the last 429 response (milliseconds). */
-    retryAfter: number;
+  /** The request hit the rate limit and exhausted all retries. */type: 'rate_limit'; /** Retry-After duration parsed from the last 429 response (milliseconds). */
+  retryAfter: number;
 } | {
-    /** Authentication failed (401 response that could not be refreshed). */
-    type: 'auth_failed';
-    /** HTTP status code (always 401). */
-    status: number;
+  /** Authentication failed (401 response that could not be refreshed). */type: 'auth_failed'; /** HTTP status code (always 401). */
+  status: number;
 } | {
-    /** A network-level error occurred (fetch threw). */
-    type: 'network';
-    /** The underlying error thrown by fetch. */
-    cause: unknown;
+  /** A network-level error occurred (fetch threw). */type: 'network'; /** The underlying error thrown by fetch. */
+  cause: unknown;
 } | {
-    /** The API returned a non-2xx status code other than 401/429. */
-    type: 'api_error';
-    /** HTTP status code. */
-    status: number;
-    /** Parsed response body (object if JSON, string otherwise). */
-    body: unknown;
+  /** The API returned a non-2xx status code other than 401/429. */type: 'api_error'; /** HTTP status code. */
+  status: number; /** Parsed response body (object if JSON, string otherwise). */
+  body: unknown;
 };
 /**
  * An `Error` subclass that wraps a `PixivError` for use in thrown contexts
@@ -290,9 +285,9 @@ type PixivError = {
  * ```
  */
 declare class PixivFetchError extends Error {
-    /** The underlying structured `PixivError`. */
-    readonly pixivError: PixivError;
-    constructor(pixivError: PixivError);
+  /** The underlying structured `PixivError`. */
+  readonly pixivError: PixivError;
+  constructor(pixivError: PixivError);
 }
 /** Creates a rate-limit error. */
 declare function rateLimitError(retryAfter: number): PixivError;
@@ -302,23 +297,14 @@ declare function authFailedError(status: number): PixivError;
 declare function networkError(cause: unknown): PixivError;
 /** Creates an API error. */
 declare function apiError(status: number, body: unknown): PixivError;
-
-/**
- * HTTP client for the pixiv API.
- *
- * Wraps the global `fetch` API and adds:
- *   - 429 retry with Retry-After header parsing
- *   - 401 → token refresh → single retry
- *   - Response interceptor hook (for optional DB recording)
- *   - Image fetch helper (browser UA, Referer, no auth)
- */
-
+//#endregion
+//#region src/http.d.ts
 /** Options for controlling retry behaviour on rate-limited requests. */
 interface RateLimitRetryOptions {
-    /** Maximum number of retries when a 429 response is received. Defaults to 3. */
-    maxRetries: number;
-    /** Default wait time (ms) used when no Retry-After header is present. Defaults to 10_000. */
-    waitMs: number;
+  /** Maximum number of retries when a 429 response is received. Defaults to 3. */
+  maxRetries: number;
+  /** Default wait time (ms) used when no Retry-After header is present. Defaults to 10_000. */
+  waitMs: number;
 }
 /**
  * HTTP client for the pixiv API.
@@ -327,69 +313,57 @@ interface RateLimitRetryOptions {
  * A 429 → retry loop and a 401 → refresh → retry are handled internally.
  */
 declare class HttpClient {
-    #private;
-    constructor(auth: AuthManager, options?: {
-        retry?: Partial<RateLimitRetryOptions>;
-        onResponse?: ResponseInterceptor;
-    });
-    /**
-     * Sends a GET request to the pixiv API.
-     *
-     * @param path - API endpoint path (e.g. "/v1/illust/detail")
-     * @param params - Query parameters as a URLSearchParams instance
-     * @returns `ResultAsync<T, PixivError>`
-     */
-    get<T>(path: string, params?: URLSearchParams): ResultAsync<T, PixivError>;
-    /**
-     * Sends a POST request to the pixiv API.
-     *
-     * @param path - API endpoint path (e.g. "/v2/illust/bookmark/add")
-     * @param body - URL-encoded request body string
-     * @returns `ResultAsync<T, PixivError>`
-     */
-    post<T>(path: string, body: string): ResultAsync<T, PixivError>;
-    /**
-     * Fetches a pixiv image URL without an Authorization header.
-     *
-     * Uses a browser User-Agent and the pixiv Referer, which are required for
-     * image CDN access. Retry and interceptor are not applied here.
-     *
-     * @param imageUrl - Full image URL
-     * @returns `ResultAsync<Response, PixivError>`
-     */
-    fetchImage(imageUrl: string): ResultAsync<Response, PixivError>;
-    /**
-     * Sends a request to an absolute URL returned in a `next_url` field.
-     *
-     * Applies the same retry / interceptor / auth logic as `get()`.
-     *
-     * @param absoluteUrl - Full URL including query string
-     * @returns `ResultAsync<T, PixivError>`
-     */
-    getAbsolute<T>(absoluteUrl: string): ResultAsync<T, PixivError>;
-}
-
-/**
- * PaginatedResultAsync — pagination support for the pixiv API.
- *
- * Extends `ResultAsync<TPage, PixivError>` so that:
- *   - `await paginated` returns the first-page `Result<TPage, PixivError>` directly
- *   - `.pages()` is an async generator that yields each page
- *   - `.items()` is an async generator that yields individual items across all pages
- *
- * Pagination uses the `nextUrl` field returned by list endpoints. The URL is
- * fetched via `HttpClient.getAbsolute()` which reuses the same auth / retry /
- * interceptor pipeline as regular requests.
- */
-
+  #private;
+  constructor(auth: AuthManager, options?: {
+    retry?: Partial<RateLimitRetryOptions>;
+    onResponse?: ResponseInterceptor;
+  });
+  /**
+   * Sends a GET request to the pixiv API.
+   *
+   * @param path - API endpoint path (e.g. "/v1/illust/detail")
+   * @param params - Query parameters as a URLSearchParams instance
+   * @returns `ResultAsync<T, PixivError>`
+   */
+  get<T>(path: string, params?: URLSearchParams): ResultAsync<T, PixivError>;
+  /**
+   * Sends a POST request to the pixiv API.
+   *
+   * @param path - API endpoint path (e.g. "/v2/illust/bookmark/add")
+   * @param body - URL-encoded request body string
+   * @returns `ResultAsync<T, PixivError>`
+   */
+  post<T>(path: string, body: string): ResultAsync<T, PixivError>;
+  /**
+   * Fetches a pixiv image URL without an Authorization header.
+   *
+   * Uses a browser User-Agent and the pixiv Referer, which are required for
+   * image CDN access. Retry and interceptor are not applied here.
+   *
+   * @param imageUrl - Full image URL
+   * @returns `ResultAsync<Response, PixivError>`
+   */
+  fetchImage(imageUrl: string): ResultAsync<Response, PixivError>;
+  /**
+   * Sends a request to an absolute URL returned in a `next_url` field.
+   *
+   * Applies the same retry / interceptor / auth logic as `get()`.
+   *
+   * @param absoluteUrl - Full URL including query string
+   * @returns `ResultAsync<T, PixivError>`
+   */
+  getAbsolute<T>(absoluteUrl: string): ResultAsync<T, PixivError>;
+}
+//#endregion
+//#region src/paginated.d.ts
 /**
  * A page returned by a pixiv list endpoint.
  *
  * Must have a `nextUrl` field (null when there are no more pages).
  */
 interface PagedResponse {
-    /** URL to the next page, or `null` when there are no more pages. */
-    nextUrl: string | null;
+  /** URL to the next page, or `null` when there are no more pages. */
+  nextUrl: string | null;
 }
 /**
  * A `ResultAsync<TPage, PixivError>` with additional `.pages()` / `.items()`
@@ -398,42 +372,42 @@ interface PagedResponse {
  * Returned by all resource methods that produce a `nextUrl` field.
  */
 declare class PaginatedResultAsync<TPage extends PagedResponse, TItem> extends ResultAsync<TPage, PixivError> {
-    #private;
-    constructor(promise: Promise<Result<TPage, PixivError>>, http: HttpClient, getItems: (page: TPage) => TItem[]);
-    /**
-     * Creates a `PaginatedResultAsync` from a `ResultAsync`.
-     *
-     * @param inner - The first-page result
-     * @param http - HTTP client for fetching subsequent pages
-     * @param getItems - Extracts item array from a page
-     */
-    static fromResultAsync<TPage extends PagedResponse, TItem>(inner: ResultAsync<TPage, PixivError>, http: HttpClient, getItems: (page: TPage) => TItem[]): PaginatedResultAsync<TPage, TItem>;
-    /**
-     * Async generator that yields each page starting from the first.
-     *
-     * If any page fetch fails, the generator throws a `PixivFetchError`.
-     *
-     * @example
-     * ```ts
-     * for await (const page of client.illusts.search({ word: 'cat' }).pages()) {
-     *   console.log(page.illusts.length)
-     * }
-     * ```
-     */
-    pages(): AsyncGenerator<TPage, void, unknown>;
-    /**
-     * Async generator that yields individual items across all pages.
-     *
-     * If any page fetch fails, the generator throws a `PixivFetchError`.
-     *
-     * @example
-     * ```ts
-     * for await (const illust of client.illusts.search({ word: 'cat' }).items()) {
-     *   console.log(illust.title)
-     * }
-     * ```
-     */
-    items(): AsyncGenerator<TItem, void, unknown>;
+  #private;
+  constructor(promise: Promise<Result<TPage, PixivError>>, http: HttpClient, getItems: (page: TPage) => TItem[]);
+  /**
+   * Creates a `PaginatedResultAsync` from a `ResultAsync`.
+   *
+   * @param inner - The first-page result
+   * @param http - HTTP client for fetching subsequent pages
+   * @param getItems - Extracts item array from a page
+   */
+  static fromResultAsync<TPage extends PagedResponse, TItem>(inner: ResultAsync<TPage, PixivError>, http: HttpClient, getItems: (page: TPage) => TItem[]): PaginatedResultAsync<TPage, TItem>;
+  /**
+   * Async generator that yields each page starting from the first.
+   *
+   * If any page fetch fails, the generator throws a `PixivFetchError`.
+   *
+   * @example
+   * ```ts
+   * for await (const page of client.illusts.search({ word: 'cat' }).pages()) {
+   *   console.log(page.illusts.length)
+   * }
+   * ```
+   */
+  pages(): AsyncGenerator<TPage, void, unknown>;
+  /**
+   * Async generator that yields individual items across all pages.
+   *
+   * If any page fetch fails, the generator throws a `PixivFetchError`.
+   *
+   * @example
+   * ```ts
+   * for await (const illust of client.illusts.search({ word: 'cat' }).items()) {
+   *   console.log(illust.title)
+   * }
+   * ```
+   */
+  items(): AsyncGenerator<TItem, void, unknown>;
 }
 /**
  * Creates an immediately-failed `PaginatedResultAsync`.
@@ -445,7 +419,8 @@ declare class PaginatedResultAsync<TPage extends PagedResponse, TItem> extends R
  * @param getItems - Item extractor (used for signature compatibility)
  */
 declare function failedPaginated<TPage extends PagedResponse, TItem>(error: PixivError, http: HttpClient, getItems: (page: TPage) => TItem[]): PaginatedResultAsync<TPage, TItem>;
-
+//#endregion
+//#region src/params.d.ts
 /**
  * Typed cursor parameters extracted from a pixiv `next_url`.
  *
@@ -461,16 +436,16 @@ declare function failedPaginated<TPage extends PagedResponse, TItem>(error: Pixi
  * | `lastOrder` | `GET /v2/novel/series` |
  */
 interface ParsedNextUrl {
-    /** Cursor for `GET /v1/user/bookmarks/illust`. */
-    maxBookmarkId?: number;
-    /** Cursor for `GET /v1/illust/recommended` and `GET /v1/novel/recommended`. */
-    maxBookmarkIdForRecommend?: number;
-    /** Secondary cursor for `GET /v1/illust/recommended`. */
-    minBookmarkIdForRecentIllust?: number;
-    /** Zero-based offset for general list endpoints. */
-    offset?: number;
-    /** Cursor for `GET /v2/novel/series`. */
-    lastOrder?: number;
+  /** Cursor for `GET /v1/user/bookmarks/illust`. */
+  maxBookmarkId?: number;
+  /** Cursor for `GET /v1/illust/recommended` and `GET /v1/novel/recommended`. */
+  maxBookmarkIdForRecommend?: number;
+  /** Secondary cursor for `GET /v1/illust/recommended`. */
+  minBookmarkIdForRecentIllust?: number;
+  /** Zero-based offset for general list endpoints. */
+  offset?: number;
+  /** Cursor for `GET /v2/novel/series`. */
+  lastOrder?: number;
 }
 /**
  * Parses a pixiv `next_url` into a typed cursor object.
@@ -495,7 +470,8 @@ interface ParsedNextUrl {
  * @returns Typed cursor parameters; fields absent in the URL are `undefined`
  */
 declare function parseNextUrl(url: string): ParsedNextUrl;
-
+//#endregion
+//#region src/options.d.ts
 /**
  * Public option constants for @book000/pixivts.
  *
@@ -521,10 +497,10 @@ declare function parseNextUrl(url: string): ParsedNextUrl;
  * - `keyword` — general keyword search (novel only)
  */
 declare const SearchTarget: {
-    readonly PARTIAL_MATCH_FOR_TAGS: "partial_match_for_tags";
-    readonly EXACT_MATCH_FOR_TAGS: "exact_match_for_tags";
-    readonly TITLE_AND_CAPTION: "title_and_caption";
-    readonly KEYWORD: "keyword";
+  readonly PARTIAL_MATCH_FOR_TAGS: "partial_match_for_tags";
+  readonly EXACT_MATCH_FOR_TAGS: "exact_match_for_tags";
+  readonly TITLE_AND_CAPTION: "title_and_caption";
+  readonly KEYWORD: "keyword";
 };
 /**
  * Sort order for search results.
@@ -534,9 +510,9 @@ declare const SearchTarget: {
  * - `popular_desc` — most bookmarks first (premium only)
  */
 declare const SearchSort: {
-    readonly DATE_DESC: "date_desc";
-    readonly DATE_ASC: "date_asc";
-    readonly POPULAR_DESC: "popular_desc";
+  readonly DATE_DESC: "date_desc";
+  readonly DATE_ASC: "date_asc";
+  readonly POPULAR_DESC: "popular_desc";
 };
 /**
  * Date range filter for search results.
@@ -546,9 +522,9 @@ declare const SearchSort: {
  * - `within_last_month` — past 30 days
  */
 declare const SearchDuration: {
-    readonly WITHIN_LAST_DAY: "within_last_day";
-    readonly WITHIN_LAST_WEEK: "within_last_week";
-    readonly WITHIN_LAST_MONTH: "within_last_month";
+  readonly WITHIN_LAST_DAY: "within_last_day";
+  readonly WITHIN_LAST_WEEK: "within_last_week";
+  readonly WITHIN_LAST_MONTH: "within_last_month";
 };
 /**
  * Ranking mode for illust rankings.
@@ -556,19 +532,19 @@ declare const SearchDuration: {
  * R-18 modes require a premium account with R-18 content enabled.
  */
 declare const RankingMode: {
-    readonly DAY: "day";
-    readonly DAY_MALE: "day_male";
-    readonly DAY_FEMALE: "day_female";
-    readonly WEEK_ORIGINAL: "week_original";
-    readonly WEEK_ROOKIE: "week_rookie";
-    readonly WEEK: "week";
-    readonly MONTH: "month";
-    readonly DAY_AI: "day_ai";
-    readonly DAY_R18: "day_r18";
-    readonly WEEK_R18: "week_r18";
-    readonly DAY_MALE_R18: "day_male_r18";
-    readonly DAY_FEMALE_R18: "day_female_r18";
-    readonly DAY_R18_AI: "day_r18_ai";
+  readonly DAY: "day";
+  readonly DAY_MALE: "day_male";
+  readonly DAY_FEMALE: "day_female";
+  readonly WEEK_ORIGINAL: "week_original";
+  readonly WEEK_ROOKIE: "week_rookie";
+  readonly WEEK: "week";
+  readonly MONTH: "month";
+  readonly DAY_AI: "day_ai";
+  readonly DAY_R18: "day_r18";
+  readonly WEEK_R18: "week_r18";
+  readonly DAY_MALE_R18: "day_male_r18";
+  readonly DAY_FEMALE_R18: "day_female_r18";
+  readonly DAY_R18_AI: "day_r18_ai";
 };
 /**
  * Ranking mode for novel rankings.
@@ -576,14 +552,14 @@ declare const RankingMode: {
  * R-18 modes require a premium account with R-18 content enabled.
  */
 declare const NovelRankingMode: {
-    readonly DAY: "day";
-    readonly WEEK: "week";
-    readonly DAY_MALE: "day_male";
-    readonly DAY_FEMALE: "day_female";
-    readonly WEEK_ROOKIE: "week_rookie";
-    readonly DAY_R18: "day_r18";
-    readonly WEEK_R18: "week_r18";
-    readonly DAY_R18_AI: "day_r18_ai";
+  readonly DAY: "day";
+  readonly WEEK: "week";
+  readonly DAY_MALE: "day_male";
+  readonly DAY_FEMALE: "day_female";
+  readonly WEEK_ROOKIE: "week_rookie";
+  readonly DAY_R18: "day_r18";
+  readonly WEEK_R18: "week_r18";
+  readonly DAY_R18_AI: "day_r18_ai";
 };
 /**
  * Visibility restriction for bookmarks.
@@ -592,8 +568,8 @@ declare const NovelRankingMode: {
  * - `private` — visible only to the owner
  */
 declare const BookmarkRestrict: {
-    readonly PUBLIC: "public";
-    readonly PRIVATE: "private";
+  readonly PUBLIC: "public";
+  readonly PRIVATE: "private";
 };
 /**
  * Visibility restriction for follows.
@@ -602,8 +578,8 @@ declare const BookmarkRestrict: {
  * - `private` — visible only to the owner
  */
 declare const FollowRestrict: {
-    readonly PUBLIC: "public";
-    readonly PRIVATE: "private";
+  readonly PUBLIC: "public";
+  readonly PRIVATE: "private";
 };
 /**
  * OS filter used to request works compatible with the given platform.
@@ -612,8 +588,8 @@ declare const FollowRestrict: {
  * - `for_android` — Android-compatible works
  */
 declare const OSFilter: {
-    readonly FOR_IOS: "for_ios";
-    readonly FOR_ANDROID: "for_android";
+  readonly FOR_IOS: "for_ios";
+  readonly FOR_ANDROID: "for_android";
 };
 /**
  * Work type filter for user illust listings.
@@ -622,10 +598,11 @@ declare const OSFilter: {
  * - `manga` — manga only
  */
 declare const UserIllustType: {
-    readonly ILLUST: "illust";
-    readonly MANGA: "manga";
+  readonly ILLUST: "illust";
+  readonly MANGA: "manga";
 };
-
+//#endregion
+//#region src/types.d.ts
 /**
  * Public types for @book000/pixivts.
  *
@@ -642,19 +619,19 @@ declare const UserIllustType: {
  * Accessing these URLs requires setting an appropriate `Referer` header.
  */
 interface ImageUrls {
-    /** 360×360 thumbnail */
-    squareMedium: string;
-    /** Long side ≤ 540 px */
-    medium: string;
-    /** Width ≤ 600 px, height ≤ 1200 px */
-    large: string;
-    /** Original image (present in `metaPages` entries only) */
-    original?: string;
+  /** 360×360 thumbnail */
+  squareMedium: string;
+  /** Long side ≤ 540 px */
+  medium: string;
+  /** Width ≤ 600 px, height ≤ 1200 px */
+  large: string;
+  /** Original image (present in `metaPages` entries only) */
+  original?: string;
 }
 /** Profile image URLs for a user. */
 interface ProfileImageUrls {
-    /** Medium-size profile image URL. */
-    medium: string;
+  /** Medium-size profile image URL. */
+  medium: string;
 }
 /**
  * Minimal user info embedded in works, search results, and preview lists.
@@ -662,60 +639,68 @@ interface ProfileImageUrls {
  * Full profile data is returned by GET /v1/user/detail.
  */
 interface PixivUser {
-    /**
-     * Internal numeric user ID.
-     *
-     * NOTE: certain API endpoints return this as a string.  The core library
-     * normalises it to `number` before returning it to callers.
-     */
-    id: number;
-    /** Display name shown on the user's profile. */
-    name: string;
-    /** Login account name (distinct from the display `name`). */
-    account: string;
-    /** Set of profile image URLs at different sizes. */
-    profileImageUrls: ProfileImageUrls;
-    /** Whether the authenticated user follows this user. */
-    isFollowed?: boolean;
-    /** Whether this user has blocked access by the authenticated user. */
-    isAccessBlockingUser?: boolean;
-    /** Whether this user accepts illustration commission requests. */
-    isAcceptRequest?: boolean;
+  /**
+   * Internal numeric user ID.
+   *
+   * NOTE: certain API endpoints return this as a string.  The core library
+   * normalises it to `number` before returning it to callers.
+   */
+  id: number;
+  /** Display name shown on the user's profile. */
+  name: string;
+  /** Login account name (distinct from the display `name`). */
+  account: string;
+  /** Set of profile image URLs at different sizes. */
+  profileImageUrls: ProfileImageUrls;
+  /** Whether the authenticated user follows this user. */
+  isFollowed?: boolean;
+  /** Whether this user has blocked access by the authenticated user. */
+  isAccessBlockingUser?: boolean;
+  /** Whether this user accepts illustration commission requests. */
+  isAcceptRequest?: boolean;
 }
 /** Tag on a work. */
 interface Tag {
-    /** Tag name in Japanese. */
-    name: string;
-    /** Translated tag name, or `null` if no translation is available. */
-    translatedName: string | null;
-    /** Whether the tag was added by the work's uploader. */
-    addedByUploadedUser?: boolean;
+  /** Tag name in Japanese. */
+  name: string;
+  /** Translated tag name, or `null` if no translation is available. */
+  translatedName: string | null;
+  /** Whether the tag was added by the work's uploader. */
+  addedByUploadedUser?: boolean;
 }
 /** Series information embedded in a work item. */
 interface Series {
-    /** Series ID. */
-    id: number;
-    /** Series title. */
-    title: string;
+  /** Series ID. */
+  id: number;
+  /** Series title. */
+  title: string;
 }
 /** Privacy-policy blurb returned by recommended endpoints. */
 interface PrivacyPolicy {
-    /** Policy version string. */
-    version?: string;
-    /** Human-readable policy notice. */
-    message?: string;
-    /** URL to the full privacy-policy page. */
-    url?: string;
-}
-/** Original-image URL for a single-page illust. */
+  /** Policy version string. */
+  version?: string;
+  /** Human-readable policy notice. */
+  message?: string;
+  /** URL to the full privacy-policy page. */
+  url?: string;
+}
+/**
+ * Original-image URL for a single-page illust.
+ *
+ * For manga works the API returns `meta_single_page` as an empty object `{}`,
+ * so `originalImageUrl` may be absent even when the enclosing object is present.
+ */
 interface MetaSinglePage {
-    /** Direct URL to the original-resolution image. */
-    originalImageUrl: string;
+  /**
+   * Direct URL to the original-resolution image.
+   * Absent for manga works where `meta_single_page` is returned as `{}`.
+   */
+  originalImageUrl?: string;
 }
 /** Per-page image URLs for a multi-page work (manga). */
 interface MetaPages {
-    /** Full set of image URLs for this page, including the original. */
-    imageUrls: Required<ImageUrls>;
+  /** Full set of image URLs for this page, including the original. */
+  imageUrls: Required<ImageUrls>;
 }
 /**
  * A pixiv illust or manga work item as returned by the API.
@@ -724,95 +709,95 @@ interface MetaPages {
  * GET /v1/illust/ranking, GET /v1/illust/recommended, etc.
  */
 interface PixivIllustItem {
-    /**
-     * Work ID.
-     *
-     * Illusts and novels are numbered in separate sequences — the same ID
-     * can appear in both.
-     */
-    id: number;
-    /** Title of the work. */
-    title: string;
-    /** Work category: illustration, manga, or animated illustration. */
-    type: 'illust' | 'manga' | 'ugoira';
-    /** Thumbnail image URLs at various sizes. */
-    imageUrls: ImageUrls;
-    /** Work caption / description (may contain HTML). */
-    caption: string;
-    /** Content restriction level (0 = public, 1 = mypixiv-only, 2 = private). */
-    restrict: number;
-    /** Author of the work. */
-    user: PixivUser;
-    /** Tags attached to the work. */
-    tags: Tag[];
-    /** Creation tools listed by the author (e.g. "Photoshop"). */
-    tools: string[];
-    /** ISO 8601 date-time string of when the work was posted. */
-    createDate: string;
-    /** Number of images in a multi-page work (1 for single-page). */
-    pageCount: number;
-    /** Canvas width in pixels. */
-    width: number;
-    /** Canvas height in pixels. */
-    height: number;
-    /** Sanity / sensitivity level assigned by the pixiv content filter. */
-    sanityLevel: number;
-    /** Age restriction: 0 = all-ages, 1 = R-18, 2 = R-18G */
-    xRestrict: number;
-    /** Series this work belongs to, or `null` if not part of a series. */
-    series: Series | null;
-    /**
-     * For single-page works: `{ originalImageUrl: string }`.
-     * For multi-page works: `{}` (empty object).
-     */
-    metaSinglePage: MetaSinglePage | Record<string, never>;
-    /** Per-page image URLs for multi-page works (empty array for single-page). */
-    metaPages: MetaPages[];
-    /** Total number of views. */
-    totalView: number;
-    /** Total number of bookmarks. */
-    totalBookmarks: number;
-    /** Whether the authenticated user has bookmarked this work. */
-    isBookmarked: boolean;
-    /** Whether the work is publicly visible. */
-    visible: boolean;
-    /** Whether the work is muted for the authenticated user. */
-    isMuted: boolean;
-    /** Total number of comments (may be absent on some endpoints). */
-    totalComments?: number;
-    /** AI-generated content flag: 0 = no AI, 1 = partial AI, 2 = fully AI */
-    illustAiType: number;
-    /** Book-style rendering flag (0 = normal, 1 = book). */
-    illustBookStyle: number;
-    /** Controls who can post comments (may be absent). */
-    commentAccessControl?: number;
-    /** Additional access-restriction attributes (may be absent). */
-    restrictionAttributes?: string[];
+  /**
+   * Work ID.
+   *
+   * Illusts and novels are numbered in separate sequences — the same ID
+   * can appear in both.
+   */
+  id: number;
+  /** Title of the work. */
+  title: string;
+  /** Work category: illustration, manga, or animated illustration. */
+  type: 'illust' | 'manga' | 'ugoira';
+  /** Thumbnail image URLs at various sizes. */
+  imageUrls: ImageUrls;
+  /** Work caption / description (may contain HTML). */
+  caption: string;
+  /** Content restriction level (0 = public, 1 = mypixiv-only, 2 = private). */
+  restrict: number;
+  /** Author of the work. */
+  user: PixivUser;
+  /** Tags attached to the work. */
+  tags: Tag[];
+  /** Creation tools listed by the author (e.g. "Photoshop"). */
+  tools: string[];
+  /** ISO 8601 date-time string of when the work was posted. */
+  createDate: string;
+  /** Number of images in a multi-page work (1 for single-page). */
+  pageCount: number;
+  /** Canvas width in pixels. */
+  width: number;
+  /** Canvas height in pixels. */
+  height: number;
+  /** Sanity / sensitivity level assigned by the pixiv content filter. */
+  sanityLevel: number;
+  /** Age restriction: 0 = all-ages, 1 = R-18, 2 = R-18G */
+  xRestrict: number;
+  /** Series this work belongs to, or `null` if not part of a series. */
+  series: Series | null;
+  /**
+   * For single-page works: `{ originalImageUrl: string }`.
+   * For multi-page works (manga): `{}` (empty object; `originalImageUrl` will be `undefined`).
+   */
+  metaSinglePage: MetaSinglePage | Record<string, never>;
+  /** Per-page image URLs for multi-page works (empty array for single-page). */
+  metaPages: MetaPages[];
+  /** Total number of views. */
+  totalView: number;
+  /** Total number of bookmarks. */
+  totalBookmarks: number;
+  /** Whether the authenticated user has bookmarked this work. */
+  isBookmarked: boolean;
+  /** Whether the work is publicly visible. */
+  visible: boolean;
+  /** Whether the work is muted for the authenticated user. */
+  isMuted: boolean;
+  /** Total number of comments (may be absent on some endpoints). */
+  totalComments?: number;
+  /** AI-generated content flag: 0 = no AI, 1 = partial AI, 2 = fully AI */
+  illustAiType: number;
+  /** Book-style rendering flag (0 = normal, 1 = book). */
+  illustBookStyle: number;
+  /** Controls who can post comments (may be absent). */
+  commentAccessControl?: number;
+  /** Additional access-restriction attributes (may be absent). */
+  restrictionAttributes?: string[];
 }
 /** Illust series metadata returned by GET /v1/illust/series. */
 interface IllustSeriesDetail {
-    /** Series ID. */
-    id: number;
-    /** Series title. */
-    title: string;
-    /** Series description / caption. */
-    caption: string;
-    /** Cover image URLs. */
-    coverImageUrls: {
-        medium: string;
-    };
-    /** Number of works in the series. */
-    seriesWorkCount: number;
-    /** ISO 8601 date-time string of when the series was created. */
-    createDate: string;
-    /** Canvas width of the cover image in pixels. */
-    width: number;
-    /** Canvas height of the cover image in pixels. */
-    height: number;
-    /** Author of the series. */
-    user: PixivUser;
-    /** Whether the authenticated user has added this series to their watchlist. */
-    watchlistAdded: boolean;
+  /** Series ID. */
+  id: number;
+  /** Series title. */
+  title: string;
+  /** Series description / caption. */
+  caption: string;
+  /** Cover image URLs. */
+  coverImageUrls: {
+    medium: string;
+  };
+  /** Number of works in the series. */
+  seriesWorkCount: number;
+  /** ISO 8601 date-time string of when the series was created. */
+  createDate: string;
+  /** Canvas width of the cover image in pixels. */
+  width: number;
+  /** Canvas height of the cover image in pixels. */
+  height: number;
+  /** Author of the series. */
+  user: PixivUser;
+  /** Whether the authenticated user has added this series to their watchlist. */
+  watchlistAdded: boolean;
 }
 /**
  * A pixiv novel work item as returned by the API.
@@ -820,188 +805,187 @@ interface IllustSeriesDetail {
  * Returned by GET /v2/novel/detail, GET /v1/search/novel, etc.
  */
 interface PixivNovelItem {
-    /**
-     * Work ID.
-     *
-     * Novels and illusts are numbered in separate sequences — the same ID
-     * can appear in both.
-     */
-    id: number;
-    /** Title of the novel. */
-    title: string;
-    /** Synopsis / caption (may contain HTML). */
-    caption: string;
-    /** Content restriction level (0 = public, 1 = mypixiv-only, 2 = private). */
-    restrict: number;
-    /** Age restriction: 0 = all-ages, 1 = R-18, 2 = R-18G */
-    xRestrict: number;
-    /** Whether the novel is an original work (not fan fiction). */
-    isOriginal: boolean;
-    /** Cover image URLs. */
-    imageUrls: ImageUrls;
-    /** ISO 8601 date-time string of when the novel was posted. */
-    createDate: string;
-    /** Tags attached to the novel. */
-    tags: Tag[];
-    /** Number of pages (word-count chunks). */
-    pageCount: number;
-    /** Total character count of the novel body. */
-    textLength: number;
-    /** Author of the novel. */
-    user: PixivUser;
-    /**
-     * Series information.
-     *
-     * `{}` (empty object) if the novel does not belong to a series.
-     */
-    series: Series | Record<string, never>;
-    /** Whether the authenticated user has bookmarked this novel. */
-    isBookmarked: boolean;
-    /** Total number of bookmarks. */
-    totalBookmarks: number;
-    /** Total number of views. */
-    totalView: number;
-    /** Whether the novel is publicly visible. */
-    visible: boolean;
-    /** Total number of comments. */
-    totalComments: number;
-    /** Whether the novel is muted for the authenticated user. */
-    isMuted: boolean;
-    /** Whether the novel is restricted to mutual followers (mypixiv). */
-    isMypixivOnly: boolean;
-    /** Whether the novel contains explicit content beyond the `xRestrict` flag. */
-    isXRestricted: boolean;
-    /** AI-generated content flag: 0 = no AI, 1 = partial AI, 2 = fully AI */
-    novelAiType: number;
-    /** Controls who can post comments (may be absent). */
-    commentAccessControl?: number;
+  /**
+   * Work ID.
+   *
+   * Novels and illusts are numbered in separate sequences — the same ID
+   * can appear in both.
+   */
+  id: number;
+  /** Title of the novel. */
+  title: string;
+  /** Synopsis / caption (may contain HTML). */
+  caption: string;
+  /** Content restriction level (0 = public, 1 = mypixiv-only, 2 = private). */
+  restrict: number;
+  /** Age restriction: 0 = all-ages, 1 = R-18, 2 = R-18G */
+  xRestrict: number;
+  /** Whether the novel is an original work (not fan fiction). */
+  isOriginal: boolean;
+  /** Cover image URLs. */
+  imageUrls: ImageUrls;
+  /** ISO 8601 date-time string of when the novel was posted. */
+  createDate: string;
+  /** Tags attached to the novel. */
+  tags: Tag[];
+  /** Number of pages (word-count chunks). */
+  pageCount: number;
+  /** Total character count of the novel body. */
+  textLength: number;
+  /** Author of the novel. */
+  user: PixivUser;
+  /**
+   * Series information.
+   *
+   * `{}` (empty object) if the novel does not belong to a series.
+   */
+  series: Series | Record<string, never>;
+  /** Whether the authenticated user has bookmarked this novel. */
+  isBookmarked: boolean;
+  /** Total number of bookmarks. */
+  totalBookmarks: number;
+  /** Total number of views. */
+  totalView: number;
+  /** Whether the novel is publicly visible. */
+  visible: boolean;
+  /** Total number of comments. */
+  totalComments: number;
+  /** Whether the novel is muted for the authenticated user. */
+  isMuted: boolean;
+  /** Whether the novel is restricted to mutual followers (mypixiv). */
+  isMypixivOnly: boolean;
+  /** Whether the novel contains explicit content beyond the `xRestrict` flag. */
+  isXRestricted: boolean;
+  /** AI-generated content flag: 0 = no AI, 1 = partial AI, 2 = fully AI */
+  novelAiType: number;
+  /** Controls who can post comments (may be absent). */
+  commentAccessControl?: number;
 }
 /** Novel series details returned by GET /v2/novel/series. */
 interface NovelSeriesDetail {
-    /** Series ID. */
-    id: number;
-    /** Series title. */
-    title: string;
-    /** Series description / caption. */
-    caption: string;
-    /** Whether every novel in the series is original (not fan fiction). */
-    isOriginal: boolean;
-    /** Whether the series has been marked as concluded by the author. */
-    isConcluded: boolean;
-    /** Number of novels in the series. */
-    contentCount: number;
-    /** Total character count across all novels in the series. */
-    totalCharacterCount: number;
-    /** Author of the series. */
-    user: PixivUser;
-    /** Human-readable series label / tagline. */
-    displayText: string;
-    /** AI-generated content flag: 0 = no AI, 1 = partial AI, 2 = fully AI */
-    novelAiType: number;
-    /** Whether the authenticated user has added this series to their watchlist. */
-    watchlistAdded: boolean;
+  /** Series ID. */
+  id: number;
+  /** Series title. */
+  title: string;
+  /** Series description / caption. */
+  caption: string;
+  /** Whether every novel in the series is original (not fan fiction). */
+  isOriginal: boolean;
+  /** Whether the series has been marked as concluded by the author. */
+  isConcluded: boolean;
+  /** Number of novels in the series. */
+  contentCount: number;
+  /** Total character count across all novels in the series. */
+  totalCharacterCount: number;
+  /** Author of the series. */
+  user: PixivUser;
+  /** Human-readable series label / tagline. */
+  displayText: string;
+  /** AI-generated content flag: 0 = no AI, 1 = partial AI, 2 = fully AI */
+  novelAiType: number;
+  /** Whether the authenticated user has added this series to their watchlist. */
+  watchlistAdded: boolean;
 }
 /** User item with self-introduction; embedded in GET /v1/user/detail. */
 type PixivUserItem = PixivUser & {
-    /** Self-introduction text (line endings are \r\n) */
-    comment: string;
+  /** Self-introduction text (line endings are \r\n) */comment: string;
 };
 /** Visibility setting for a user profile field. */
 type Publicity = 'public' | 'private' | 'mypixiv';
 /** Detailed profile information for a user. */
 interface PixivUserProfile {
-    /** Personal website URL, or `null` if not set. */
-    webpage: string | null;
-    /** Disclosed gender. */
-    gender: 'male' | 'female' | 'unknown';
-    /** Birth date string (YYYY-MM-DD format, may be partial). */
-    birth: string;
-    /** Birth day portion (MM-DD format). */
-    birthDay: string;
-    /** Birth year. */
-    birthYear: number;
-    /** Region / prefecture. */
-    region: string;
-    /** Internal address ID. */
-    addressId: number;
-    /** Two-letter country code (ISO 3166-1 alpha-2). */
-    countryCode: string;
-    /** Occupation / job description. */
-    job: string;
-    /** Internal job category ID. */
-    jobId: number;
-    /** Number of users this user follows. */
-    totalFollowUsers: number;
-    /** Number of mutual-follow (mypixiv) connections. */
-    totalMypixivUsers: number;
-    /** Total number of public illusts. */
-    totalIllusts: number;
-    /** Total number of public manga works. */
-    totalManga: number;
-    /** Total number of public novels. */
-    totalNovels: number;
-    /** Total number of publicly bookmarked illusts. */
-    totalIllustBookmarksPublic: number;
-    /** Total number of illust series. */
-    totalIllustSeries: number;
-    /** Total number of novel series. */
-    totalNovelSeries: number;
-    /** Profile background image URL, or `null` if not set. */
-    backgroundImageUrl: string | null;
-    /** Linked Twitter/X account name (without @). */
-    twitterAccount: string;
-    /** Twitter/X profile URL, or `null` if not set. */
-    twitterUrl: string | null;
-    /** Pawoo profile URL, or `null` if not set. */
-    pawooUrl: string | null;
-    /** Whether the user has a premium (paid) account. */
-    isPremium: boolean;
-    /** Whether the user has set a custom profile image. */
-    isUsingCustomProfileImage: boolean;
+  /** Personal website URL, or `null` if not set. */
+  webpage: string | null;
+  /** Disclosed gender. */
+  gender: 'male' | 'female' | 'unknown';
+  /** Birth date string (YYYY-MM-DD format, may be partial). */
+  birth: string;
+  /** Birth day portion (MM-DD format). */
+  birthDay: string;
+  /** Birth year. */
+  birthYear: number;
+  /** Region / prefecture. */
+  region: string;
+  /** Internal address ID. */
+  addressId: number;
+  /** Two-letter country code (ISO 3166-1 alpha-2). */
+  countryCode: string;
+  /** Occupation / job description. */
+  job: string;
+  /** Internal job category ID. */
+  jobId: number;
+  /** Number of users this user follows. */
+  totalFollowUsers: number;
+  /** Number of mutual-follow (mypixiv) connections. */
+  totalMypixivUsers: number;
+  /** Total number of public illusts. */
+  totalIllusts: number;
+  /** Total number of public manga works. */
+  totalManga: number;
+  /** Total number of public novels. */
+  totalNovels: number;
+  /** Total number of publicly bookmarked illusts. */
+  totalIllustBookmarksPublic: number;
+  /** Total number of illust series. */
+  totalIllustSeries: number;
+  /** Total number of novel series. */
+  totalNovelSeries: number;
+  /** Profile background image URL, or `null` if not set. */
+  backgroundImageUrl: string | null;
+  /** Linked Twitter/X account name (without @). */
+  twitterAccount: string;
+  /** Twitter/X profile URL, or `null` if not set. */
+  twitterUrl: string | null;
+  /** Pawoo profile URL, or `null` if not set. */
+  pawooUrl: string | null;
+  /** Whether the user has a premium (paid) account. */
+  isPremium: boolean;
+  /** Whether the user has set a custom profile image. */
+  isUsingCustomProfileImage: boolean;
 }
 /** Visibility settings for a user's profile fields. */
 interface PixivUserProfilePublicity {
-    /** Visibility of the gender field. */
-    gender: Publicity;
-    /** Visibility of the region field. */
-    region: Publicity;
-    /** Visibility of the birth-day field. */
-    birthDay: Publicity;
-    /** Visibility of the birth-year field. */
-    birthYear: Publicity;
-    /** Visibility of the job field. */
-    job: Publicity;
-    /** Whether the Pawoo account link is visible. */
-    pawoo: boolean;
+  /** Visibility of the gender field. */
+  gender: Publicity;
+  /** Visibility of the region field. */
+  region: Publicity;
+  /** Visibility of the birth-day field. */
+  birthDay: Publicity;
+  /** Visibility of the birth-year field. */
+  birthYear: Publicity;
+  /** Visibility of the job field. */
+  job: Publicity;
+  /** Whether the Pawoo account link is visible. */
+  pawoo: boolean;
 }
 /** Workspace / desk setup information from a user's profile. */
 interface PixivUserProfileWorkspace {
-    /** PC / computer specs. */
-    pc: string;
-    /** Monitor model. */
-    monitor: string;
-    /** Drawing software / tool. */
-    tool: string;
-    /** Scanner model. */
-    scanner: string;
-    /** Tablet model. */
-    tablet: string;
-    /** Mouse model. */
-    mouse: string;
-    /** Printer model. */
-    printer: string;
-    /** Desktop wallpaper or environment description. */
-    desktop: string;
-    /** Music / background audio description. */
-    music: string;
-    /** Desk description. */
-    desk: string;
-    /** Chair description. */
-    chair: string;
-    /** Free-text comment about the workspace. */
-    comment: string;
-    /** Workspace image URL, or `null` if not set. */
-    workspaceImageUrl: string | null;
+  /** PC / computer specs. */
+  pc: string;
+  /** Monitor model. */
+  monitor: string;
+  /** Drawing software / tool. */
+  tool: string;
+  /** Scanner model. */
+  scanner: string;
+  /** Tablet model. */
+  tablet: string;
+  /** Mouse model. */
+  mouse: string;
+  /** Printer model. */
+  printer: string;
+  /** Desktop wallpaper or environment description. */
+  desktop: string;
+  /** Music / background audio description. */
+  music: string;
+  /** Desk description. */
+  desk: string;
+  /** Chair description. */
+  chair: string;
+  /** Free-text comment about the workspace. */
+  comment: string;
+  /** Workspace image URL, or `null` if not set. */
+  workspaceImageUrl: string | null;
 }
 /**
  * Preview item for a user in the GET /v1/user/following response.
@@ -1009,33 +993,33 @@ interface PixivUserProfileWorkspace {
  * Contains a few sample illusts and novels from that user.
  */
 interface PixivUserPreviewItem {
-    /** The user being previewed. */
-    user: PixivUser;
-    /** A small sample of the user's recent illusts. */
-    illusts: PixivIllustItem[];
-    /** A small sample of the user's recent novels. */
-    novels: PixivNovelItem[];
-    /** Whether this user is muted by the authenticated user. */
-    isMuted: boolean;
+  /** The user being previewed. */
+  user: PixivUser;
+  /** A small sample of the user's recent illusts. */
+  illusts: PixivIllustItem[];
+  /** A small sample of the user's recent novels. */
+  novels: PixivNovelItem[];
+  /** Whether this user is muted by the authenticated user. */
+  isMuted: boolean;
 }
 /** URLs for ugoira frame archives (ZIP files). */
 interface ZipUrls {
-    /** URL for the 600 px-long-side archive. */
-    medium: string;
+  /** URL for the 600 px-long-side archive. */
+  medium: string;
 }
 /** Timing info for a single ugoira frame. */
 interface Frame {
-    /** File name within the ZIP archive */
-    file: string;
-    /** Display duration in milliseconds */
-    delay: number;
+  /** File name within the ZIP archive */
+  file: string;
+  /** Display duration in milliseconds */
+  delay: number;
 }
 /** Ugoira metadata as returned by GET /v1/ugoira/metadata. */
 interface PixivUgoiraItem {
-    /** Archive URLs for the frame ZIP. */
-    zipUrls: ZipUrls;
-    /** Per-frame timing data (in order). */
-    frames: Frame[];
+  /** Archive URLs for the frame ZIP. */
+  zipUrls: ZipUrls;
+  /** Per-frame timing data (in order). */
+  frames: Frame[];
 }
 /**
  * Camelized shape of the JSON error body returned by the pixiv API.
@@ -1045,785 +1029,771 @@ interface PixivUgoiraItem {
  * are `lowerCamelCase`.
  */
 interface PixivApiErrorBody {
-    /** Error payload returned by the pixiv API (keys camelized). */
-    error: {
-        /** Localised error message intended for end users. */
-        userMessage: string;
-        /** Internal error message. */
-        message: string;
-        /** Short error reason / code. */
-        reason: string;
-        /** Additional details for the user-facing message (may be absent). */
-        userMessageDetails?: Record<string, unknown>;
-    };
+  /** Error payload returned by the pixiv API (keys camelized). */
+  error: {
+    /** Localised error message intended for end users. */userMessage: string; /** Internal error message. */
+    message: string; /** Short error reason / code. */
+    reason: string; /** Additional details for the user-facing message (may be absent). */
+    userMessageDetails?: Record<string, unknown>;
+  };
 }
 /** Response shape for GET /v1/illust/detail. */
 interface IllustDetailResponse {
-    /** The requested illust. */
-    illust: PixivIllustItem;
+  /** The requested illust. */
+  illust: PixivIllustItem;
 }
 /** Page response for illust list endpoints (search, related, ranking, etc.). */
 interface IllustListPage {
-    /** Illusts on this page. */
-    illusts: PixivIllustItem[];
-    /**
-     * Whether AI-generated works are shown in the results.
-     *
-     * Only present on search responses; absent on related/ranking/recommended endpoints.
-     */
-    showAi?: boolean;
-    /** URL to the next page, or `null` when this is the last page. */
-    nextUrl: string | null;
+  /** Illusts on this page. */
+  illusts: PixivIllustItem[];
+  /**
+   * Whether AI-generated works are shown in the results.
+   *
+   * Only present on search responses; absent on related/ranking/recommended endpoints.
+   */
+  showAi?: boolean;
+  /** URL to the next page, or `null` when this is the last page. */
+  nextUrl: string | null;
 }
 /** Page response for GET /v1/illust/recommended. */
 interface IllustRecommendedPage {
-    /** Recommended illusts. */
-    illusts: PixivIllustItem[];
-    /** Ranking illusts included alongside recommendations. */
-    rankingIllusts: PixivIllustItem[];
-    /** Whether an ongoing contest exists. */
-    contestExists: boolean;
-    /** Privacy-policy notice (present on the first page). */
-    privacyPolicy?: PrivacyPolicy;
-    /** URL to the next page, or `null` when this is the last page. */
-    nextUrl: string | null;
+  /** Recommended illusts. */
+  illusts: PixivIllustItem[];
+  /** Ranking illusts included alongside recommendations. */
+  rankingIllusts: PixivIllustItem[];
+  /** Whether an ongoing contest exists. */
+  contestExists: boolean;
+  /** Privacy-policy notice (present on the first page). */
+  privacyPolicy?: PrivacyPolicy;
+  /** URL to the next page, or `null` when this is the last page. */
+  nextUrl: string | null;
 }
 /** Page response for GET /v1/illust/series. */
 interface IllustSeriesPage {
-    /** Metadata for the series. */
-    illustSeriesDetail: IllustSeriesDetail;
-    /** First illust in the series. */
-    illustSeriesFirstIllust: PixivIllustItem;
-    /** Illusts on this page. */
-    illusts: PixivIllustItem[];
-    /** URL to the next page, or `null` when this is the last page. */
-    nextUrl: string | null;
+  /** Metadata for the series. */
+  illustSeriesDetail: IllustSeriesDetail;
+  /** First illust in the series. */
+  illustSeriesFirstIllust: PixivIllustItem;
+  /** Illusts on this page. */
+  illusts: PixivIllustItem[];
+  /** URL to the next page, or `null` when this is the last page. */
+  nextUrl: string | null;
 }
 /** Page response for GET /v1/manga/recommended. */
 interface MangaRecommendedPage {
-    /** Recommended manga works. */
-    illusts: PixivIllustItem[];
-    /** Ranking manga works included alongside recommendations. */
-    rankingIllusts: PixivIllustItem[];
-    /** Privacy-policy notice (present on the first page). */
-    privacyPolicy?: PrivacyPolicy;
-    /** URL to the next page, or `null` when this is the last page. */
-    nextUrl: string | null;
+  /** Recommended manga works. */
+  illusts: PixivIllustItem[];
+  /** Ranking manga works included alongside recommendations. */
+  rankingIllusts: PixivIllustItem[];
+  /** Privacy-policy notice (present on the first page). */
+  privacyPolicy?: PrivacyPolicy;
+  /** URL to the next page, or `null` when this is the last page. */
+  nextUrl: string | null;
 }
 /** Response shape for GET /v1/ugoira/metadata. */
 interface UgoiraMetadataResponse {
-    /** Ugoira metadata (ZIP URLs and per-frame timings). */
-    ugoiraMetadata: PixivUgoiraItem;
+  /** Ugoira metadata (ZIP URLs and per-frame timings). */
+  ugoiraMetadata: PixivUgoiraItem;
 }
 /** Response shape for GET /v2/novel/detail. */
 interface NovelDetailResponse {
-    /** The requested novel. */
-    novel: PixivNovelItem;
+  /** The requested novel. */
+  novel: PixivNovelItem;
 }
 /** Page response for novel list endpoints (search, related, ranking, etc.). */
 interface NovelListPage {
-    /** Novels on this page. */
-    novels: PixivNovelItem[];
-    /**
-     * Whether AI-generated works are shown in the results.
-     *
-     * Only present on search responses; absent on related/ranking/recommended endpoints.
-     */
-    showAi?: boolean;
-    /** URL to the next page, or `null` when this is the last page. */
-    nextUrl: string | null;
+  /** Novels on this page. */
+  novels: PixivNovelItem[];
+  /**
+   * Whether AI-generated works are shown in the results.
+   *
+   * Only present on search responses; absent on related/ranking/recommended endpoints.
+   */
+  showAi?: boolean;
+  /** URL to the next page, or `null` when this is the last page. */
+  nextUrl: string | null;
 }
 /** Page response for GET /v1/novel/recommended. */
 interface NovelRecommendedPage {
-    /** Recommended novels. */
-    novels: PixivNovelItem[];
-    /** Ranking novels included alongside recommendations. */
-    rankingNovels: PixivNovelItem[];
-    /** Privacy-policy notice (present on the first page). */
-    privacyPolicy?: PrivacyPolicy;
-    /** URL to the next page, or `null` when this is the last page. */
-    nextUrl: string | null;
+  /** Recommended novels. */
+  novels: PixivNovelItem[];
+  /** Ranking novels included alongside recommendations. */
+  rankingNovels: PixivNovelItem[];
+  /** Privacy-policy notice (present on the first page). */
+  privacyPolicy?: PrivacyPolicy;
+  /** URL to the next page, or `null` when this is the last page. */
+  nextUrl: string | null;
 }
 /** Page response for GET /v2/novel/series. */
 interface NovelSeriesPage {
-    /** Metadata for the series. */
-    novelSeriesDetail: NovelSeriesDetail;
-    /** First novel in the series. */
-    novelSeriesFirstNovel: PixivNovelItem;
-    /** Most recently published novel in the series. */
-    novelSeriesLatestNovel: PixivNovelItem;
-    /** Novels on this page. */
-    novels: PixivNovelItem[];
-    /** URL to the next page, or `null` when this is the last page. */
-    nextUrl: string | null;
+  /** Metadata for the series. */
+  novelSeriesDetail: NovelSeriesDetail;
+  /** First novel in the series. */
+  novelSeriesFirstNovel: PixivNovelItem;
+  /** Most recently published novel in the series. */
+  novelSeriesLatestNovel: PixivNovelItem;
+  /** Novels on this page. */
+  novels: PixivNovelItem[];
+  /** URL to the next page, or `null` when this is the last page. */
+  nextUrl: string | null;
 }
 /** Response shape for GET /v1/user/detail. */
 interface UserDetailResponse {
-    /** Basic user info with self-introduction. */
-    user: PixivUserItem;
-    /** Detailed profile data. */
-    profile: PixivUserProfile;
-    /** Visibility settings for profile fields. */
-    profilePublicity: PixivUserProfilePublicity;
-    /** Workspace / desk-setup information. */
-    workspace: PixivUserProfileWorkspace;
+  /** Basic user info with self-introduction. */
+  user: PixivUserItem;
+  /** Detailed profile data. */
+  profile: PixivUserProfile;
+  /** Visibility settings for profile fields. */
+  profilePublicity: PixivUserProfilePublicity;
+  /** Workspace / desk-setup information. */
+  workspace: PixivUserProfileWorkspace;
 }
 /** Page response for GET /v1/user/illusts. */
 interface UserIllustsPage {
-    /** The user whose illusts are listed. */
-    user: PixivUser;
-    /** Illusts on this page. */
-    illusts: PixivIllustItem[];
-    /** URL to the next page, or `null` when this is the last page. */
-    nextUrl: string | null;
+  /** The user whose illusts are listed. */
+  user: PixivUser;
+  /** Illusts on this page. */
+  illusts: PixivIllustItem[];
+  /** URL to the next page, or `null` when this is the last page. */
+  nextUrl: string | null;
 }
 /** Page response for GET /v1/user/novels. */
 interface UserNovelsPage {
-    /** The user whose novels are listed. */
-    user: PixivUser;
-    /** Novels on this page. */
-    novels: PixivNovelItem[];
-    /** URL to the next page, or `null` when this is the last page. */
-    nextUrl: string | null;
+  /** The user whose novels are listed. */
+  user: PixivUser;
+  /** Novels on this page. */
+  novels: PixivNovelItem[];
+  /** URL to the next page, or `null` when this is the last page. */
+  nextUrl: string | null;
 }
 /** Page response for GET /v1/user/bookmarks/illust. */
 interface UserBookmarksIllustPage {
-    /** Bookmarked illusts on this page. */
-    illusts: PixivIllustItem[];
-    /** URL to the next page, or `null` when this is the last page. */
-    nextUrl: string | null;
+  /** Bookmarked illusts on this page. */
+  illusts: PixivIllustItem[];
+  /** URL to the next page, or `null` when this is the last page. */
+  nextUrl: string | null;
 }
 /** Page response for GET /v1/user/bookmarks/novel. */
 interface UserBookmarksNovelPage {
-    /** Bookmarked novels on this page. */
-    novels: PixivNovelItem[];
-    /** URL to the next page, or `null` when this is the last page. */
-    nextUrl: string | null;
+  /** Bookmarked novels on this page. */
+  novels: PixivNovelItem[];
+  /** URL to the next page, or `null` when this is the last page. */
+  nextUrl: string | null;
 }
 /** Page response for GET /v1/user/following. */
 interface UserFollowingPage {
-    /** User preview items on this page. */
-    userPreviews: PixivUserPreviewItem[];
-    /** URL to the next page, or `null` when this is the last page. */
-    nextUrl: string | null;
+  /** User preview items on this page. */
+  userPreviews: PixivUserPreviewItem[];
+  /** URL to the next page, or `null` when this is the last page. */
+  nextUrl: string | null;
 }
-
-/**
- * IllustResource — methods for the illust API namespace.
- */
-
+//#endregion
+//#region src/resources/illusts.d.ts
 /** Parameters for fetching a single illust by ID. */
 interface IllustDetailParams {
-    /** ID of the illust to fetch. */
-    illustId: number;
-    /** OS filter to apply (default: `"for_ios"`). */
-    filter?: (typeof OSFilter)[keyof typeof OSFilter];
+  /** ID of the illust to fetch. */
+  illustId: number;
+  /** OS filter to apply (default: `"for_ios"`). */
+  filter?: (typeof OSFilter)[keyof typeof OSFilter];
 }
 /** Parameters for fetching related illusts. */
 interface IllustRelatedParams {
-    /** ID of the illust for which to fetch related works. */
-    illustId: number;
-    /** Additional seed illust IDs to influence recommendations. */
-    seedIllustIds?: number[];
-    /** OS filter to apply (default: `"for_ios"`). */
-    filter?: (typeof OSFilter)[keyof typeof OSFilter];
+  /** ID of the illust for which to fetch related works. */
+  illustId: number;
+  /** Additional seed illust IDs to influence recommendations. */
+  seedIllustIds?: number[];
+  /** OS filter to apply (default: `"for_ios"`). */
+  filter?: (typeof OSFilter)[keyof typeof OSFilter];
 }
 /** Parameters for searching illusts. */
 interface IllustSearchParams {
-    /** Search keyword. */
-    word: string;
-    /** How to match the keyword against works (default: `"partial_match_for_tags"`). */
-    searchTarget?: (typeof SearchTarget)[keyof typeof SearchTarget];
-    /** Sort order for results (default: `"date_desc"`). */
-    sort?: (typeof SearchSort)[keyof typeof SearchSort];
-    /** Date range preset filter (omit for no restriction). */
-    duration?: (typeof SearchDuration)[keyof typeof SearchDuration];
-    /** Start date for a custom date range (YYYY-MM-DD; requires `endDate`). */
-    startDate?: string;
-    /** End date for a custom date range (YYYY-MM-DD; requires `startDate`). */
-    endDate?: string;
-    /** OS filter to apply (default: `"for_ios"`). */
-    filter?: (typeof OSFilter)[keyof typeof OSFilter];
-    /** AI-generated content filter: `0` = hide AI works, `1` = show only AI works. */
-    searchAiType?: 0 | 1;
-    /** Zero-based offset for pagination. */
-    offset?: number;
+  /** Search keyword. */
+  word: string;
+  /** How to match the keyword against works (default: `"partial_match_for_tags"`). */
+  searchTarget?: (typeof SearchTarget)[keyof typeof SearchTarget];
+  /** Sort order for results (default: `"date_desc"`). */
+  sort?: (typeof SearchSort)[keyof typeof SearchSort];
+  /** Date range preset filter (omit for no restriction). */
+  duration?: (typeof SearchDuration)[keyof typeof SearchDuration];
+  /** Start date for a custom date range (YYYY-MM-DD; requires `endDate`). */
+  startDate?: string;
+  /** End date for a custom date range (YYYY-MM-DD; requires `startDate`). */
+  endDate?: string;
+  /** OS filter to apply (default: `"for_ios"`). */
+  filter?: (typeof OSFilter)[keyof typeof OSFilter];
+  /** AI-generated content filter: `0` = hide AI works, `1` = show only AI works. */
+  searchAiType?: 0 | 1;
+  /** Zero-based offset for pagination. */
+  offset?: number;
 }
 /** Parameters for fetching the illust ranking. */
 interface IllustRankingParams {
-    /** Ranking category (default: `"day"`). */
-    mode?: (typeof RankingMode)[keyof typeof RankingMode];
-    /** OS filter to apply (default: `"for_ios"`). */
-    filter?: (typeof OSFilter)[keyof typeof OSFilter];
-    /** Specific date to fetch rankings for (YYYY-MM-DD; omit for the latest). */
-    date?: string;
-    /** Zero-based offset for pagination. */
-    offset?: number;
+  /** Ranking category (default: `"day"`). */
+  mode?: (typeof RankingMode)[keyof typeof RankingMode];
+  /** OS filter to apply (default: `"for_ios"`). */
+  filter?: (typeof OSFilter)[keyof typeof OSFilter];
+  /** Specific date to fetch rankings for (YYYY-MM-DD; omit for the latest). */
+  date?: string;
+  /** Zero-based offset for pagination. */
+  offset?: number;
 }
 /** Parameters for fetching recommended illusts. */
 interface IllustRecommendedParams {
-    /** OS filter to apply (default: `"for_ios"`). */
-    filter?: (typeof OSFilter)[keyof typeof OSFilter];
-    /** Zero-based offset for pagination. */
-    offset?: number;
-    /**
-     * Cursor for resuming pagination: the `maxBookmarkIdForRecommend` value
-     * extracted from a previous page's `next_url` via {@link parseNextUrl}.
-     */
-    maxBookmarkIdForRecommend?: number;
-    /**
-     * Secondary cursor for resuming pagination: the `minBookmarkIdForRecentIllust`
-     * value extracted from a previous page's `next_url` via {@link parseNextUrl}.
-     */
-    minBookmarkIdForRecentIllust?: number;
+  /** OS filter to apply (default: `"for_ios"`). */
+  filter?: (typeof OSFilter)[keyof typeof OSFilter];
+  /** Zero-based offset for pagination. */
+  offset?: number;
+  /**
+   * Cursor for resuming pagination: the `maxBookmarkIdForRecommend` value
+   * extracted from a previous page's `next_url` via {@link parseNextUrl}.
+   */
+  maxBookmarkIdForRecommend?: number;
+  /**
+   * Secondary cursor for resuming pagination: the `minBookmarkIdForRecentIllust`
+   * value extracted from a previous page's `next_url` via {@link parseNextUrl}.
+   */
+  minBookmarkIdForRecentIllust?: number;
+  /**
+   * Content type filter for recommended works.
+   * - `"illust"` — illustration works only
+   * - `"manga"` — manga works only
+   * Omit to receive both types.
+   */
+  contentType?: 'illust' | 'manga';
+  /**
+   * Whether to include ranking label information in the response.
+   * Defaults to `true` when omitted.
+   */
+  includeRankingLabel?: boolean;
+  /**
+   * IDs of illusts already seen by the user.
+   * The API will exclude these from the recommendations.
+   * Serialised as repeated `viewed[]=<id>` query parameters.
+   */
+  viewed?: number[];
 }
 /** Parameters for fetching an illust series. */
 interface IllustSeriesParams {
-    /** ID of the illust series to fetch. */
-    illustSeriesId: number;
-    /** OS filter to apply (default: `"for_ios"`). */
-    filter?: (typeof OSFilter)[keyof typeof OSFilter];
+  /** ID of the illust series to fetch. */
+  illustSeriesId: number;
+  /** OS filter to apply (default: `"for_ios"`). */
+  filter?: (typeof OSFilter)[keyof typeof OSFilter];
 }
 /** Parameters for adding an illust bookmark. */
 interface IllustBookmarkAddParams {
-    /** ID of the illust to bookmark. */
-    illustId: number;
-    /** Bookmark visibility (default: `"public"`). */
-    restrict?: (typeof BookmarkRestrict)[keyof typeof BookmarkRestrict];
-    /** Tags to attach to the bookmark. */
-    tags?: string[];
+  /** ID of the illust to bookmark. */
+  illustId: number;
+  /** Bookmark visibility (default: `"public"`). */
+  restrict?: (typeof BookmarkRestrict)[keyof typeof BookmarkRestrict];
+  /** Tags to attach to the bookmark. */
+  tags?: string[];
 }
 /** Parameters for removing an illust bookmark. */
 interface IllustBookmarkDeleteParams {
-    /** ID of the illust to remove from bookmarks. */
-    illustId: number;
+  /** ID of the illust to remove from bookmarks. */
+  illustId: number;
 }
 /** Methods for the illust API namespace. */
 declare class IllustResource {
-    #private;
-    constructor(http: HttpClient);
-    /**
-     * Fetches a single illust by ID.
-     * GET /v1/illust/detail
-     *
-     * @param params - Request parameters
-     *
-     * @example
-     * ```ts
-     * const result = await client.illusts.detail({ illustId: 12345 })
-     * if (result.isOk) {
-     *   console.log(result.value.illust.title)
-     * } else {
-     *   console.error(result.error)
-     * }
-     * ```
-     */
-    detail(params: IllustDetailParams): ResultAsync<IllustDetailResponse, PixivError>;
-    /**
-     * Fetches related illusts for a given illust.
-     * GET /v2/illust/related
-     *
-     * @param params - Request parameters
-     */
-    related(params: IllustRelatedParams): PaginatedResultAsync<IllustListPage, IllustListPage['illusts'][number]>;
-    /**
-     * Searches for illusts.
-     * GET /v1/search/illust
-     *
-     * @param params - Request parameters
-     *
-     * @example
-     * ```ts
-     * // Iterate all results across pages
-     * for await (const illust of client.illusts.search({ word: 'cat' }).items()) {
-     *   console.log(illust.title)
-     * }
-     *
-     * // Fetch only the first page
-     * const page = await client.illusts.search({ word: 'cat' })
-     * if (page.isOk) {
-     *   console.log(page.value.illusts.length)
-     * }
-     * ```
-     */
-    search(params: IllustSearchParams): PaginatedResultAsync<IllustListPage, IllustListPage['illusts'][number]>;
-    /**
-     * Fetches the illust ranking.
-     * GET /v1/illust/ranking
-     *
-     * @param params - Request parameters
-     */
-    ranking(params?: IllustRankingParams): PaginatedResultAsync<IllustListPage, IllustListPage['illusts'][number]>;
-    /**
-     * Fetches recommended illusts.
-     * GET /v1/illust/recommended
-     *
-     * @param params - Request parameters
-     */
-    recommended(params?: IllustRecommendedParams): PaginatedResultAsync<IllustRecommendedPage, IllustRecommendedPage['illusts'][number]>;
-    /**
-     * Fetches an illust series.
-     * GET /v1/illust/series
-     *
-     * @param params - Request parameters
-     */
-    series(params: IllustSeriesParams): PaginatedResultAsync<IllustSeriesPage, IllustSeriesPage['illusts'][number]>;
-    /**
-     * Adds an illust bookmark.
-     * POST /v2/illust/bookmark/add
-     *
-     * @param params - Request parameters
-     */
-    bookmarkAdd(params: IllustBookmarkAddParams): ResultAsync<Record<string, never>, PixivError>;
-    /**
-     * Removes an illust bookmark.
-     * POST /v1/illust/bookmark/delete
-     *
-     * @param params - Request parameters
-     */
-    bookmarkDelete(params: IllustBookmarkDeleteParams): ResultAsync<Record<string, never>, PixivError>;
-}
-
-/**
- * NovelResource — methods for the novel API namespace.
- */
-
+  #private;
+  constructor(http: HttpClient);
+  /**
+   * Fetches a single illust by ID.
+   * GET /v1/illust/detail
+   *
+   * @param params - Request parameters
+   *
+   * @example
+   * ```ts
+   * const result = await client.illusts.detail({ illustId: 12345 })
+   * if (result.isOk) {
+   *   console.log(result.value.illust.title)
+   * } else {
+   *   console.error(result.error)
+   * }
+   * ```
+   */
+  detail(params: IllustDetailParams): ResultAsync<IllustDetailResponse, PixivError>;
+  /**
+   * Fetches related illusts for a given illust.
+   * GET /v2/illust/related
+   *
+   * @param params - Request parameters
+   */
+  related(params: IllustRelatedParams): PaginatedResultAsync<IllustListPage, IllustListPage['illusts'][number]>;
+  /**
+   * Searches for illusts.
+   * GET /v1/search/illust
+   *
+   * @param params - Request parameters
+   *
+   * @example
+   * ```ts
+   * // Iterate all results across pages
+   * for await (const illust of client.illusts.search({ word: 'cat' }).items()) {
+   *   console.log(illust.title)
+   * }
+   *
+   * // Fetch only the first page
+   * const page = await client.illusts.search({ word: 'cat' })
+   * if (page.isOk) {
+   *   console.log(page.value.illusts.length)
+   * }
+   * ```
+   */
+  search(params: IllustSearchParams): PaginatedResultAsync<IllustListPage, IllustListPage['illusts'][number]>;
+  /**
+   * Fetches the illust ranking.
+   * GET /v1/illust/ranking
+   *
+   * @param params - Request parameters
+   */
+  ranking(params?: IllustRankingParams): PaginatedResultAsync<IllustListPage, IllustListPage['illusts'][number]>;
+  /**
+   * Fetches recommended illusts.
+   * GET /v1/illust/recommended
+   *
+   * @param params - Request parameters
+   */
+  recommended(params?: IllustRecommendedParams): PaginatedResultAsync<IllustRecommendedPage, IllustRecommendedPage['illusts'][number]>;
+  /**
+   * Fetches an illust series.
+   * GET /v1/illust/series
+   *
+   * @param params - Request parameters
+   */
+  series(params: IllustSeriesParams): PaginatedResultAsync<IllustSeriesPage, IllustSeriesPage['illusts'][number]>;
+  /**
+   * Adds an illust bookmark.
+   * POST /v2/illust/bookmark/add
+   *
+   * @param params - Request parameters
+   */
+  bookmarkAdd(params: IllustBookmarkAddParams): ResultAsync<Record<string, never>, PixivError>;
+  /**
+   * Removes an illust bookmark.
+   * POST /v1/illust/bookmark/delete
+   *
+   * @param params - Request parameters
+   */
+  bookmarkDelete(params: IllustBookmarkDeleteParams): ResultAsync<Record<string, never>, PixivError>;
+}
+//#endregion
+//#region src/resources/novels.d.ts
 /** Parameters for fetching a single novel by ID. */
 interface NovelDetailParams {
-    /** ID of the novel to fetch. */
-    novelId: number;
+  /** ID of the novel to fetch. */
+  novelId: number;
 }
 /** Parameters for fetching the WebView HTML of a novel. */
 interface NovelTextParams {
-    /** ID of the novel whose WebView HTML to fetch. */
-    novelId: number;
+  /** ID of the novel whose WebView HTML to fetch. */
+  novelId: number;
 }
 /** Parameters for fetching related novels. */
 interface NovelRelatedParams {
-    /** ID of the novel for which to fetch related works. */
-    novelId: number;
+  /** ID of the novel for which to fetch related works. */
+  novelId: number;
 }
 /** Parameters for searching novels. */
 interface NovelSearchParams {
-    /** Search keyword. */
-    word: string;
-    /** How to match the keyword against works (default: `"partial_match_for_tags"`). */
-    searchTarget?: (typeof SearchTarget)[keyof typeof SearchTarget];
-    /** Sort order for results (default: `"date_desc"`). */
-    sort?: (typeof SearchSort)[keyof typeof SearchSort];
-    /** OS filter to apply (default: `"for_ios"`). */
-    filter?: (typeof OSFilter)[keyof typeof OSFilter];
-    /** Date range preset filter (omit for no restriction). */
-    duration?: (typeof SearchDuration)[keyof typeof SearchDuration];
-    /** Start date for a custom date range (YYYY-MM-DD; requires `endDate`). */
-    startDate?: string;
-    /** End date for a custom date range (YYYY-MM-DD; requires `startDate`). */
-    endDate?: string;
-    /** AI-generated content filter: `0` = hide AI works, `1` = show only AI works. */
-    searchAiType?: 0 | 1;
-    /** Zero-based offset for pagination. */
-    offset?: number;
+  /** Search keyword. */
+  word: string;
+  /** How to match the keyword against works (default: `"partial_match_for_tags"`). */
+  searchTarget?: (typeof SearchTarget)[keyof typeof SearchTarget];
+  /** Sort order for results (default: `"date_desc"`). */
+  sort?: (typeof SearchSort)[keyof typeof SearchSort];
+  /** OS filter to apply (default: `"for_ios"`). */
+  filter?: (typeof OSFilter)[keyof typeof OSFilter];
+  /** Date range preset filter (omit for no restriction). */
+  duration?: (typeof SearchDuration)[keyof typeof SearchDuration];
+  /** Start date for a custom date range (YYYY-MM-DD; requires `endDate`). */
+  startDate?: string;
+  /** End date for a custom date range (YYYY-MM-DD; requires `startDate`). */
+  endDate?: string;
+  /** AI-generated content filter: `0` = hide AI works, `1` = show only AI works. */
+  searchAiType?: 0 | 1;
+  /** Zero-based offset for pagination. */
+  offset?: number;
 }
 /** Parameters for fetching the novel ranking. */
 interface NovelRankingParams {
-    /** Ranking category (default: `"day"`). */
-    mode?: (typeof NovelRankingMode)[keyof typeof NovelRankingMode];
-    /** OS filter to apply (default: `"for_ios"`). */
-    filter?: (typeof OSFilter)[keyof typeof OSFilter];
-    /** Specific date to fetch rankings for (YYYY-MM-DD; omit for the latest). */
-    date?: string;
-    /** Zero-based offset for pagination. */
-    offset?: number;
+  /** Ranking category (default: `"day"`). */
+  mode?: (typeof NovelRankingMode)[keyof typeof NovelRankingMode];
+  /** OS filter to apply (default: `"for_ios"`). */
+  filter?: (typeof OSFilter)[keyof typeof OSFilter];
+  /** Specific date to fetch rankings for (YYYY-MM-DD; omit for the latest). */
+  date?: string;
+  /** Zero-based offset for pagination. */
+  offset?: number;
 }
 /** Parameters for fetching recommended novels. */
 interface NovelRecommendedParams {
-    /** OS filter to apply (default: `"for_ios"`). */
-    filter?: (typeof OSFilter)[keyof typeof OSFilter];
-    /** Zero-based offset for pagination. */
-    offset?: number;
-    /**
-     * Cursor for resuming pagination: the `maxBookmarkIdForRecommend` value
-     * extracted from a previous page's `next_url` via {@link parseNextUrl}.
-     */
-    maxBookmarkIdForRecommend?: number;
+  /** OS filter to apply (default: `"for_ios"`). */
+  filter?: (typeof OSFilter)[keyof typeof OSFilter];
+  /** Zero-based offset for pagination. */
+  offset?: number;
+  /**
+   * Cursor for resuming pagination: the `maxBookmarkIdForRecommend` value
+   * extracted from a previous page's `next_url` via {@link parseNextUrl}.
+   */
+  maxBookmarkIdForRecommend?: number;
 }
 /** Parameters for fetching a novel series. */
 interface NovelSeriesParams {
-    /** ID of the novel series to fetch. */
-    seriesId: number;
-    /** Order of the last novel already seen; used for cursor-based pagination. */
-    lastOrder?: number;
+  /** ID of the novel series to fetch. */
+  seriesId: number;
+  /** Order of the last novel already seen; used for cursor-based pagination. */
+  lastOrder?: number;
 }
 /** Parameters for adding a novel bookmark. */
 interface NovelBookmarkAddParams {
-    /** ID of the novel to bookmark. */
-    novelId: number;
-    /** Bookmark visibility (default: `"public"`). */
-    restrict?: (typeof BookmarkRestrict)[keyof typeof BookmarkRestrict];
-    /** Tags to attach to the bookmark. */
-    tags?: string[];
+  /** ID of the novel to bookmark. */
+  novelId: number;
+  /** Bookmark visibility (default: `"public"`). */
+  restrict?: (typeof BookmarkRestrict)[keyof typeof BookmarkRestrict];
+  /** Tags to attach to the bookmark. */
+  tags?: string[];
 }
 /** Parameters for removing a novel bookmark. */
 interface NovelBookmarkDeleteParams {
-    /** ID of the novel to remove from bookmarks. */
-    novelId: number;
+  /** ID of the novel to remove from bookmarks. */
+  novelId: number;
 }
 /** Methods for the novel API namespace. */
 declare class NovelResource {
-    #private;
-    constructor(http: HttpClient);
-    /**
-     * Fetches a single novel by ID.
-     * GET /v2/novel/detail
-     *
-     * @param params - Request parameters
-     *
-     * @example
-     * ```ts
-     * const result = await client.novels.detail({ novelId: 67890 })
-     * if (result.isOk) {
-     *   console.log(result.value.novel.title)
-     * } else {
-     *   console.error(result.error)
-     * }
-     * ```
-     */
-    detail(params: NovelDetailParams): ResultAsync<NovelDetailResponse, PixivError>;
-    /**
-     * Fetches the WebView HTML for a novel.
-     * GET /webview/v2/novel
-     *
-     * Returns the raw HTML page that the pixiv app renders in a WebView.
-     * To extract the plain text, parse the returned HTML (e.g. strip tags).
-     *
-     * @param params - Request parameters
-     */
-    text(params: NovelTextParams): ResultAsync<string, PixivError>;
-    /**
-     * Fetches related novels for a given novel.
-     * GET /v1/novel/related
-     *
-     * @param params - Request parameters
-     */
-    related(params: NovelRelatedParams): PaginatedResultAsync<NovelListPage, PixivNovelItem>;
-    /**
-     * Searches for novels.
-     * GET /v1/search/novel
-     *
-     * @param params - Request parameters
-     *
-     * @example
-     * ```ts
-     * // Iterate all results across pages
-     * for await (const novel of client.novels.search({ word: 'fantasy' }).items()) {
-     *   console.log(novel.title)
-     * }
-     *
-     * // Fetch only the first page
-     * const page = await client.novels.search({ word: 'fantasy' })
-     * if (page.isOk) {
-     *   console.log(page.value.novels.length)
-     * }
-     * ```
-     */
-    search(params: NovelSearchParams): PaginatedResultAsync<NovelListPage, PixivNovelItem>;
-    /**
-     * Fetches the novel ranking.
-     * GET /v1/novel/ranking
-     *
-     * @param params - Request parameters
-     */
-    ranking(params?: NovelRankingParams): PaginatedResultAsync<NovelListPage, PixivNovelItem>;
-    /**
-     * Fetches recommended novels.
-     * GET /v1/novel/recommended
-     *
-     * @param params - Request parameters
-     */
-    recommended(params?: NovelRecommendedParams): PaginatedResultAsync<NovelRecommendedPage, PixivNovelItem>;
-    /**
-     * Fetches a novel series.
-     * GET /v2/novel/series
-     *
-     * @param params - Request parameters
-     */
-    series(params: NovelSeriesParams): PaginatedResultAsync<NovelSeriesPage, PixivNovelItem>;
-    /**
-     * Adds a novel bookmark.
-     * POST /v2/novel/bookmark/add
-     *
-     * @param params - Request parameters
-     */
-    bookmarkAdd(params: NovelBookmarkAddParams): ResultAsync<Record<string, never>, PixivError>;
-    /**
-     * Removes a novel bookmark.
-     * POST /v1/novel/bookmark/delete
-     *
-     * @param params - Request parameters
-     */
-    bookmarkDelete(params: NovelBookmarkDeleteParams): ResultAsync<Record<string, never>, PixivError>;
-}
-
-/**
- * UserResource — methods for the user API namespace.
- */
-
+  #private;
+  constructor(http: HttpClient);
+  /**
+   * Fetches a single novel by ID.
+   * GET /v2/novel/detail
+   *
+   * @param params - Request parameters
+   *
+   * @example
+   * ```ts
+   * const result = await client.novels.detail({ novelId: 67890 })
+   * if (result.isOk) {
+   *   console.log(result.value.novel.title)
+   * } else {
+   *   console.error(result.error)
+   * }
+   * ```
+   */
+  detail(params: NovelDetailParams): ResultAsync<NovelDetailResponse, PixivError>;
+  /**
+   * Fetches the WebView HTML for a novel.
+   * GET /webview/v2/novel
+   *
+   * Returns the raw HTML page that the pixiv app renders in a WebView.
+   * To extract the plain text, parse the returned HTML (e.g. strip tags).
+   *
+   * @param params - Request parameters
+   */
+  text(params: NovelTextParams): ResultAsync<string, PixivError>;
+  /**
+   * Fetches related novels for a given novel.
+   * GET /v1/novel/related
+   *
+   * @param params - Request parameters
+   */
+  related(params: NovelRelatedParams): PaginatedResultAsync<NovelListPage, PixivNovelItem>;
+  /**
+   * Searches for novels.
+   * GET /v1/search/novel
+   *
+   * @param params - Request parameters
+   *
+   * @example
+   * ```ts
+   * // Iterate all results across pages
+   * for await (const novel of client.novels.search({ word: 'fantasy' }).items()) {
+   *   console.log(novel.title)
+   * }
+   *
+   * // Fetch only the first page
+   * const page = await client.novels.search({ word: 'fantasy' })
+   * if (page.isOk) {
+   *   console.log(page.value.novels.length)
+   * }
+   * ```
+   */
+  search(params: NovelSearchParams): PaginatedResultAsync<NovelListPage, PixivNovelItem>;
+  /**
+   * Fetches the novel ranking.
+   * GET /v1/novel/ranking
+   *
+   * @param params - Request parameters
+   */
+  ranking(params?: NovelRankingParams): PaginatedResultAsync<NovelListPage, PixivNovelItem>;
+  /**
+   * Fetches recommended novels.
+   * GET /v1/novel/recommended
+   *
+   * @param params - Request parameters
+   */
+  recommended(params?: NovelRecommendedParams): PaginatedResultAsync<NovelRecommendedPage, PixivNovelItem>;
+  /**
+   * Fetches a novel series.
+   * GET /v2/novel/series
+   *
+   * @param params - Request parameters
+   */
+  series(params: NovelSeriesParams): PaginatedResultAsync<NovelSeriesPage, PixivNovelItem>;
+  /**
+   * Adds a novel bookmark.
+   * POST /v2/novel/bookmark/add
+   *
+   * @param params - Request parameters
+   */
+  bookmarkAdd(params: NovelBookmarkAddParams): ResultAsync<Record<string, never>, PixivError>;
+  /**
+   * Removes a novel bookmark.
+   * POST /v1/novel/bookmark/delete
+   *
+   * @param params - Request parameters
+   */
+  bookmarkDelete(params: NovelBookmarkDeleteParams): ResultAsync<Record<string, never>, PixivError>;
+}
+//#endregion
+//#region src/resources/users.d.ts
 /** Parameters for fetching a user's bookmarked illusts. */
 interface UserBookmarksIllustParams {
-    /** ID of the user whose bookmarks to fetch. */
-    userId: number;
-    /** Visibility of the bookmarks to return (default: `"public"`). */
-    restrict?: (typeof BookmarkRestrict)[keyof typeof BookmarkRestrict];
-    /** OS filter to apply (default: `"for_ios"`). */
-    filter?: (typeof OSFilter)[keyof typeof OSFilter];
-    /** Limit results to bookmarks with this tag. */
-    tag?: string;
-    /** Fetch bookmarks older than this bookmark ID (cursor-based pagination). */
-    maxBookmarkId?: number;
-    /** Zero-based offset for pagination. */
-    offset?: number;
+  /** ID of the user whose bookmarks to fetch. */
+  userId: number;
+  /** Visibility of the bookmarks to return (default: `"public"`). */
+  restrict?: (typeof BookmarkRestrict)[keyof typeof BookmarkRestrict];
+  /** OS filter to apply (default: `"for_ios"`). */
+  filter?: (typeof OSFilter)[keyof typeof OSFilter];
+  /** Limit results to bookmarks with this tag. */
+  tag?: string;
+  /** Fetch bookmarks older than this bookmark ID (cursor-based pagination). */
+  maxBookmarkId?: number;
+  /** Zero-based offset for pagination. */
+  offset?: number;
 }
 /** Parameters for fetching a user's bookmarked novels. */
 interface UserBookmarksNovelParams {
-    /** ID of the user whose bookmarks to fetch. */
-    userId: number;
-    /** Visibility of the bookmarks to return (default: `"public"`). */
-    restrict?: (typeof BookmarkRestrict)[keyof typeof BookmarkRestrict];
-    /** OS filter to apply (default: `"for_ios"`). */
-    filter?: (typeof OSFilter)[keyof typeof OSFilter];
-    /** Limit results to bookmarks with this tag. */
-    tag?: string;
-    /** Fetch bookmarks older than this bookmark ID (cursor-based pagination). */
-    maxBookmarkId?: number;
-    /** Zero-based offset for pagination. */
-    offset?: number;
+  /** ID of the user whose bookmarks to fetch. */
+  userId: number;
+  /** Visibility of the bookmarks to return (default: `"public"`). */
+  restrict?: (typeof BookmarkRestrict)[keyof typeof BookmarkRestrict];
+  /** OS filter to apply (default: `"for_ios"`). */
+  filter?: (typeof OSFilter)[keyof typeof OSFilter];
+  /** Limit results to bookmarks with this tag. */
+  tag?: string;
+  /** Fetch bookmarks older than this bookmark ID (cursor-based pagination). */
+  maxBookmarkId?: number;
+  /** Zero-based offset for pagination. */
+  offset?: number;
 }
 /** Parameters for fetching a user's detail. */
 interface UserDetailParams {
-    /** ID of the user to fetch. */
-    userId: number;
-    /** OS filter to apply (default: `"for_ios"`). */
-    filter?: (typeof OSFilter)[keyof typeof OSFilter];
+  /** ID of the user to fetch. */
+  userId: number;
+  /** OS filter to apply (default: `"for_ios"`). */
+  filter?: (typeof OSFilter)[keyof typeof OSFilter];
 }
 /** Parameters for fetching a user's illusts. */
 interface UserIllustsParams {
-    /** ID of the user whose illusts to fetch. */
-    userId: number;
-    /** Work type to filter by (omit to return both illusts and manga). */
-    type?: (typeof UserIllustType)[keyof typeof UserIllustType];
-    /** OS filter to apply (default: `"for_ios"`). */
-    filter?: (typeof OSFilter)[keyof typeof OSFilter];
-    /** Zero-based offset for pagination. */
-    offset?: number;
+  /** ID of the user whose illusts to fetch. */
+  userId: number;
+  /** Work type to filter by (omit to return both illusts and manga). */
+  type?: (typeof UserIllustType)[keyof typeof UserIllustType];
+  /** OS filter to apply (default: `"for_ios"`). */
+  filter?: (typeof OSFilter)[keyof typeof OSFilter];
+  /** Zero-based offset for pagination. */
+  offset?: number;
 }
 /** Parameters for fetching a user's novels. */
 interface UserNovelsParams {
-    /** ID of the user whose novels to fetch. */
-    userId: number;
-    /** OS filter to apply (default: `"for_ios"`). */
-    filter?: (typeof OSFilter)[keyof typeof OSFilter];
-    /** Zero-based offset for pagination. */
-    offset?: number;
+  /** ID of the user whose novels to fetch. */
+  userId: number;
+  /** OS filter to apply (default: `"for_ios"`). */
+  filter?: (typeof OSFilter)[keyof typeof OSFilter];
+  /** Zero-based offset for pagination. */
+  offset?: number;
 }
 /** Parameters for fetching a user's following list. */
 interface UserFollowingParams {
-    /** ID of the user whose following list to fetch. */
-    userId: number;
-    /** Visibility of the follows to return (default: `"public"`). */
-    restrict?: (typeof FollowRestrict)[keyof typeof FollowRestrict];
-    /** Zero-based offset for pagination. */
-    offset?: number;
+  /** ID of the user whose following list to fetch. */
+  userId: number;
+  /** Visibility of the follows to return (default: `"public"`). */
+  restrict?: (typeof FollowRestrict)[keyof typeof FollowRestrict];
+  /** Zero-based offset for pagination. */
+  offset?: number;
 }
 /** Parameters for following a user. */
 interface UserFollowAddParams {
-    /** ID of the user to follow. */
-    userId: number;
-    /** Visibility of the follow (default: `"public"`). */
-    restrict?: (typeof FollowRestrict)[keyof typeof FollowRestrict];
+  /** ID of the user to follow. */
+  userId: number;
+  /** Visibility of the follow (default: `"public"`). */
+  restrict?: (typeof FollowRestrict)[keyof typeof FollowRestrict];
 }
 /** Parameters for unfollowing a user. */
 interface UserFollowDeleteParams {
-    /** ID of the user to unfollow. */
-    userId: number;
+  /** ID of the user to unfollow. */
+  userId: number;
 }
 /** Methods for the user bookmarks sub-namespace. */
 declare class UserBookmarksResource {
-    #private;
-    constructor(http: HttpClient);
-    /**
-     * Fetches a user's bookmarked illusts.
-     * GET /v1/user/bookmarks/illust
-     *
-     * @param params - Request parameters
-     *
-     * @example
-     * ```ts
-     * // Iterate all bookmarked illusts across pages
-     * for await (const illust of client.users.bookmarks.illusts({ userId: client.userId }).items()) {
-     *   console.log(illust.title)
-     * }
-     *
-     * // Resume from a saved cursor
-     * import { parseNextUrl } from '@book000/pixivts'
-     * const page = await client.users.bookmarks.illusts({ userId: client.userId })
-     * if (page.isOk && page.value.nextUrl) {
-     *   const cursor = parseNextUrl(page.value.nextUrl)
-     *   const next = await client.users.bookmarks.illusts({
-     *     userId: client.userId,
-     *     maxBookmarkId: cursor.maxBookmarkId,
-     *   })
-     * }
-     * ```
-     */
-    illusts(params: UserBookmarksIllustParams): PaginatedResultAsync<UserBookmarksIllustPage, PixivIllustItem>;
-    /**
-     * Fetches a user's bookmarked novels.
-     * GET /v1/user/bookmarks/novel
-     *
-     * @param params - Request parameters
-     *
-     * @example
-     * ```ts
-     * // Iterate all bookmarked novels across pages
-     * for await (const novel of client.users.bookmarks.novels({ userId: client.userId }).items()) {
-     *   console.log(novel.title)
-     * }
-     * ```
-     */
-    novels(params: UserBookmarksNovelParams): PaginatedResultAsync<UserBookmarksNovelPage, PixivNovelItem>;
+  #private;
+  constructor(http: HttpClient);
+  /**
+   * Fetches a user's bookmarked illusts.
+   * GET /v1/user/bookmarks/illust
+   *
+   * @param params - Request parameters
+   *
+   * @example
+   * ```ts
+   * // Iterate all bookmarked illusts across pages
+   * for await (const illust of client.users.bookmarks.illusts({ userId: client.userId }).items()) {
+   *   console.log(illust.title)
+   * }
+   *
+   * // Resume from a saved cursor
+   * import { parseNextUrl } from '@book000/pixivts'
+   * const page = await client.users.bookmarks.illusts({ userId: client.userId })
+   * if (page.isOk && page.value.nextUrl) {
+   *   const cursor = parseNextUrl(page.value.nextUrl)
+   *   const next = await client.users.bookmarks.illusts({
+   *     userId: client.userId,
+   *     maxBookmarkId: cursor.maxBookmarkId,
+   *   })
+   * }
+   * ```
+   */
+  illusts(params: UserBookmarksIllustParams): PaginatedResultAsync<UserBookmarksIllustPage, PixivIllustItem>;
+  /**
+   * Fetches a user's bookmarked novels.
+   * GET /v1/user/bookmarks/novel
+   *
+   * @param params - Request parameters
+   *
+   * @example
+   * ```ts
+   * // Iterate all bookmarked novels across pages
+   * for await (const novel of client.users.bookmarks.novels({ userId: client.userId }).items()) {
+   *   console.log(novel.title)
+   * }
+   * ```
+   */
+  novels(params: UserBookmarksNovelParams): PaginatedResultAsync<UserBookmarksNovelPage, PixivNovelItem>;
 }
 /** Methods for the user API namespace. */
 declare class UserResource {
-    #private;
-    /** User bookmarks sub-namespace. */
-    readonly bookmarks: UserBookmarksResource;
-    constructor(http: HttpClient);
-    /**
-     * Fetches detailed profile information for a user.
-     * GET /v1/user/detail
-     *
-     * @param params - Request parameters
-     */
-    detail(params: UserDetailParams): ResultAsync<UserDetailResponse, PixivError>;
-    /**
-     * Fetches illusts posted by a user.
-     * GET /v1/user/illusts
-     *
-     * @param params - Request parameters
-     */
-    illusts(params: UserIllustsParams): PaginatedResultAsync<UserIllustsPage, PixivIllustItem>;
-    /**
-     * Fetches novels posted by a user.
-     * GET /v1/user/novels
-     *
-     * @param params - Request parameters
-     */
-    novels(params: UserNovelsParams): PaginatedResultAsync<UserNovelsPage, PixivNovelItem>;
-    /**
-     * Fetches the list of users that a user is following.
-     * GET /v1/user/following
-     *
-     * @param params - Request parameters
-     */
-    following(params: UserFollowingParams): PaginatedResultAsync<UserFollowingPage, PixivUserPreviewItem>;
-    /**
-     * Follows a user.
-     * POST /v1/user/follow/add
-     *
-     * @param params - Request parameters
-     */
-    followAdd(params: UserFollowAddParams): ResultAsync<Record<string, never>, PixivError>;
-    /**
-     * Unfollows a user.
-     * POST /v1/user/follow/delete
-     *
-     * @param params - Request parameters
-     */
-    followDelete(params: UserFollowDeleteParams): ResultAsync<Record<string, never>, PixivError>;
-}
-
-/**
- * MangaResource — methods for the manga API namespace.
- */
-
+  #private;
+  /** User bookmarks sub-namespace. */
+  readonly bookmarks: UserBookmarksResource;
+  constructor(http: HttpClient);
+  /**
+   * Fetches detailed profile information for a user.
+   * GET /v1/user/detail
+   *
+   * @param params - Request parameters
+   */
+  detail(params: UserDetailParams): ResultAsync<UserDetailResponse, PixivError>;
+  /**
+   * Fetches illusts posted by a user.
+   * GET /v1/user/illusts
+   *
+   * @param params - Request parameters
+   */
+  illusts(params: UserIllustsParams): PaginatedResultAsync<UserIllustsPage, PixivIllustItem>;
+  /**
+   * Fetches novels posted by a user.
+   * GET /v1/user/novels
+   *
+   * @param params - Request parameters
+   */
+  novels(params: UserNovelsParams): PaginatedResultAsync<UserNovelsPage, PixivNovelItem>;
+  /**
+   * Fetches the list of users that a user is following.
+   * GET /v1/user/following
+   *
+   * @param params - Request parameters
+   */
+  following(params: UserFollowingParams): PaginatedResultAsync<UserFollowingPage, PixivUserPreviewItem>;
+  /**
+   * Follows a user.
+   * POST /v1/user/follow/add
+   *
+   * @param params - Request parameters
+   */
+  followAdd(params: UserFollowAddParams): ResultAsync<Record<string, never>, PixivError>;
+  /**
+   * Unfollows a user.
+   * POST /v1/user/follow/delete
+   *
+   * @param params - Request parameters
+   */
+  followDelete(params: UserFollowDeleteParams): ResultAsync<Record<string, never>, PixivError>;
+}
+//#endregion
+//#region src/resources/manga.d.ts
 /** Parameters for fetching recommended manga. */
 interface MangaRecommendedParams {
-    /** OS filter to apply (default: `"for_ios"`). */
-    filter?: (typeof OSFilter)[keyof typeof OSFilter];
-    /** Zero-based offset for pagination. */
-    offset?: number;
+  /** OS filter to apply (default: `"for_ios"`). */
+  filter?: (typeof OSFilter)[keyof typeof OSFilter];
+  /** Zero-based offset for pagination. */
+  offset?: number;
 }
 /** Methods for the manga API namespace. */
 declare class MangaResource {
-    #private;
-    constructor(http: HttpClient);
-    /**
-     * Fetches recommended manga.
-     * GET /v1/manga/recommended
-     *
-     * @param params - Request parameters
-     */
-    recommended(params?: MangaRecommendedParams): PaginatedResultAsync<MangaRecommendedPage, PixivIllustItem>;
-}
-
-/**
- * UgoiraResource — methods for the ugoira API namespace.
- */
-
+  #private;
+  constructor(http: HttpClient);
+  /**
+   * Fetches recommended manga.
+   * GET /v1/manga/recommended
+   *
+   * @param params - Request parameters
+   */
+  recommended(params?: MangaRecommendedParams): PaginatedResultAsync<MangaRecommendedPage, PixivIllustItem>;
+}
+//#endregion
+//#region src/resources/ugoira.d.ts
 /** Parameters for fetching ugoira metadata. */
 interface UgoiraMetadataParams {
-    /** ID of the ugoira illust whose metadata to fetch. */
-    illustId: number;
+  /** ID of the ugoira illust whose metadata to fetch. */
+  illustId: number;
 }
 /** Methods for the ugoira API namespace. */
 declare class UgoiraResource {
-    #private;
-    constructor(http: HttpClient);
-    /**
-     * Fetches ugoira metadata (ZIP URL and per-frame timings).
-     * GET /v1/ugoira/metadata
-     *
-     * @param params - Request parameters
-     */
-    metadata(params: UgoiraMetadataParams): ResultAsync<UgoiraMetadataResponse, PixivError>;
-}
-
-/**
- * ImageResource — helpers for fetching pixiv CDN images.
- */
-
+  #private;
+  constructor(http: HttpClient);
+  /**
+   * Fetches ugoira metadata (ZIP URL and per-frame timings).
+   * GET /v1/ugoira/metadata
+   *
+   * @param params - Request parameters
+   */
+  metadata(params: UgoiraMetadataParams): ResultAsync<UgoiraMetadataResponse, PixivError>;
+}
+//#endregion
+//#region src/resources/images.d.ts
 /** Methods for fetching pixiv images. */
 declare class ImageResource {
-    #private;
-    constructor(http: HttpClient);
-    /**
-     * Fetches a pixiv image.
-     *
-     * Uses a browser User-Agent and Referer (required for pixiv CDN).
-     * No Authorization header is sent.
-     *
-     * @param imageUrl - Full CDN image URL
-     */
-    fetch(imageUrl: string): ResultAsync<Response, PixivError>;
-}
-
-/**
- * PixivClient — main entry point for the @book000/pixivts library.
- *
- * @example
- * ```ts
- * const client = await PixivClient.of(process.env.PIXIV_REFRESH_TOKEN!)
- * const result = await client.illusts.detail({ illustId: 12345 })
- * if (result.isOk) console.log(result.value.illust.title)
- * ```
- */
-
+  #private;
+  constructor(http: HttpClient);
+  /**
+   * Fetches a pixiv image.
+   *
+   * Uses a browser User-Agent and Referer (required for pixiv CDN).
+   * No Authorization header is sent.
+   *
+   * @param imageUrl - Full CDN image URL
+   */
+  fetch(imageUrl: string): ResultAsync<Response, PixivError>;
+}
+//#endregion
+//#region src/client.d.ts
 /** Options for constructing a {@link PixivClient}. */
 interface PixivClientOptions {
-    /** Rate-limit retry configuration. */
-    retry?: Partial<RateLimitRetryOptions>;
-    /** Optional interceptor called after each successful response (DB seam). */
-    onResponse?: ResponseInterceptor;
+  /** Rate-limit retry configuration. */
+  retry?: Partial<RateLimitRetryOptions>;
+  /** Optional interceptor called after each successful response (DB seam). */
+  onResponse?: ResponseInterceptor;
 }
 /**
  * Main client for the pixiv API.
@@ -1832,62 +1802,63 @@ interface PixivClientOptions {
  * because initialisation requires an async token refresh.
  */
 declare class PixivClient {
-    #private;
-    /** Illust API namespace. */
-    readonly illusts: IllustResource;
-    /** Novel API namespace. */
-    readonly novels: NovelResource;
-    /** User API namespace. */
-    readonly users: UserResource;
-    /** Manga API namespace. */
-    readonly manga: MangaResource;
-    /** Ugoira API namespace. */
-    readonly ugoira: UgoiraResource;
-    /** Image fetch helpers. */
-    readonly images: ImageResource;
-    private constructor();
-    /**
-     * Numeric user ID of the authenticated account.
-     *
-     * Available immediately after {@link PixivClient.of} resolves.
-     * The pixiv OAuth endpoint returns the ID as a string; this getter
-     * normalises it to `number` for consistency with resource method params
-     * (e.g. `UserBookmarksIllustParams.userId`).
-     *
-     * @example
-     * ```ts
-     * const client = await PixivClient.of(refreshToken)
-     * const bookmarks = await client.users.bookmarks.illusts({ userId: client.userId })
-     * ```
-     */
-    get userId(): number;
-    /**
-     * Returns the current OAuth access token.
-     *
-     * The access token is short-lived and changes after each call to
-     * {@link PixivClient.of} and after each automatic token refresh triggered
-     * by a 401 response.
-     *
-     * @returns The current bearer access token string
-     */
-    getAccessToken(): string;
-    /**
-     * Returns the current OAuth refresh token.
-     *
-     * The refresh token is long-lived and is used to obtain new access tokens.
-     * It may rotate after a successful token refresh.
-     *
-     * @returns The current refresh token string
-     */
-    getRefreshToken(): string;
-    /**
-     * Creates a PixivClient by refreshing the given token.
-     *
-     * @param refreshToken - Pixiv refresh token
-     * @param options - Optional retry and response interceptor configuration
-     * @returns A fully initialised {@link PixivClient}
-     */
-    static of(refreshToken: string, options?: PixivClientOptions): Promise<PixivClient>;
-}
-
+  #private;
+  /** Illust API namespace. */
+  readonly illusts: IllustResource;
+  /** Novel API namespace. */
+  readonly novels: NovelResource;
+  /** User API namespace. */
+  readonly users: UserResource;
+  /** Manga API namespace. */
+  readonly manga: MangaResource;
+  /** Ugoira API namespace. */
+  readonly ugoira: UgoiraResource;
+  /** Image fetch helpers. */
+  readonly images: ImageResource;
+  private constructor();
+  /**
+   * Numeric user ID of the authenticated account.
+   *
+   * Available immediately after {@link PixivClient.of} resolves.
+   * The pixiv OAuth endpoint returns the ID as a string; this getter
+   * normalises it to `number` for consistency with resource method params
+   * (e.g. `UserBookmarksIllustParams.userId`).
+   *
+   * @example
+   * ```ts
+   * const client = await PixivClient.of(refreshToken)
+   * const bookmarks = await client.users.bookmarks.illusts({ userId: client.userId })
+   * ```
+   */
+  get userId(): number;
+  /**
+   * Returns the current OAuth access token.
+   *
+   * The access token is short-lived and changes after each call to
+   * {@link PixivClient.of} and after each automatic token refresh triggered
+   * by a 401 response.
+   *
+   * @returns The current bearer access token string
+   */
+  getAccessToken(): string;
+  /**
+   * Returns the current OAuth refresh token.
+   *
+   * The refresh token is long-lived and is used to obtain new access tokens.
+   * It may rotate after a successful token refresh.
+   *
+   * @returns The current refresh token string
+   */
+  getRefreshToken(): string;
+  /**
+   * Creates a PixivClient by refreshing the given token.
+   *
+   * @param refreshToken - Pixiv refresh token
+   * @param options - Optional retry and response interceptor configuration
+   * @returns A fully initialised {@link PixivClient}
+   */
+  static of(refreshToken: string, options?: PixivClientOptions): Promise<PixivClient>;
+}
+//#endregion
 export { BookmarkRestrict, type ErrResult, FollowRestrict, type Frame, type HttpMethod, type IllustBookmarkAddParams, type IllustBookmarkDeleteParams, type IllustDetailParams, type IllustDetailResponse, type IllustListPage, type IllustRankingParams, type IllustRecommendedPage, type IllustRecommendedParams, type IllustRelatedParams, type IllustSearchParams, type IllustSeriesDetail, type IllustSeriesPage, type IllustSeriesParams, type ImageUrls, type MangaRecommendedPage, type MetaPages, type MetaSinglePage, type NovelBookmarkAddParams, type NovelBookmarkDeleteParams, type NovelDetailParams, type NovelDetailResponse, type NovelListPage, NovelRankingMode, type NovelRankingParams, type NovelRecommendedPage, type NovelRecommendedParams, type NovelRelatedParams, type NovelSearchParams, type NovelSeriesDetail, type NovelSeriesPage, type NovelSeriesParams, type NovelTextParams, OSFilter, type OkResult, type PagedResponse, PaginatedResultAsync, type ParsedNextUrl, type PixivApiErrorBody, PixivClient, type PixivClientOptions, type PixivError, PixivFetchError, type PixivIllustItem, type PixivNovelItem, type PixivUgoiraItem, type PixivUser, type PixivUserItem, type PixivUserPreviewItem, type PixivUserProfile, type PixivUserProfilePublicity, type PixivUserProfileWorkspace, type PrivacyPolicy, type ProfileImageUrls, RankingMode, type ResponseInterceptor, type ResponseRecord, type Result, ResultAsync, SearchDuration, SearchSort, SearchTarget, type Series, type Tag, type UgoiraMetadataResponse, type UserBookmarksIllustPage, type UserBookmarksIllustParams, type UserBookmarksNovelPage, type UserBookmarksNovelParams, type UserDetailParams, type UserDetailResponse, type UserFollowAddParams, type UserFollowDeleteParams, type UserFollowingPage, type UserFollowingParams, UserIllustType, type UserIllustsPage, type UserIllustsParams, type UserNovelsPage, type UserNovelsParams, type ZipUrls, apiError, authFailedError, err, failedPaginated, networkError, ok, parseNextUrl, rateLimitError };
+//# sourceMappingURL=index.d.ts.map