@ucdjs/test-utils 1.0.1-beta.1

package/dist/helpers-D3XLw9D1.d.mts

@@ -0,0 +1,1050 @@
+import { AsyncResponseResolverReturnType, DefaultBodyType, HttpResponseResolver, PathParams } from "msw";
+import { MockFetchFn } from "@luxass/msw-utils";
+import { Prettify } from "@luxass/utils";
+import { UnicodeFileTreeNode } from "@ucdjs/schemas";
+
+//#region src/.generated/api.d.ts
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+interface paths {
+  "/api/v1/versions": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * @description ## List All Unicode Versions
+     *
+     *     This endpoint retrieves a comprehensive list of all Unicode versions, including metadata and support status.
+     *
+     *     - Provides **version metadata** such as documentation URLs and public URLs
+     *     - Includes **draft versions** if available
+     *     - Supports **caching** for performance optimization
+     */
+    get: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path?: never;
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description List of Unicode Versions */200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["UnicodeVersionList"];
+          };
+        };
+        404: components["responses"]["NotFoundError"];
+        429: components["responses"]["TooManyRequestsError"];
+        500: components["responses"]["InternalServerError"];
+        502: components["responses"]["BadGatewayError"];
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/v1/versions/{version}": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * @description ## Get Unicode Version Details
+     *
+     *     This endpoint retrieves detailed information about a specific Unicode version.
+     *
+     *     - Provides **version metadata** such as version name, documentation URL, release date, and type (stable/draft)
+     *     - Includes **location information** (UCD URL and mapped version)
+     *     - Returns **statistics** about characters, blocks, and scripts (if available)
+     *     - Supports **caching** for performance optimization
+     */
+    get: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path: {
+          /** @description A Unicode Version */version: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description Detailed information about a Unicode version */200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["UnicodeVersionDetails"];
+          };
+        };
+        400: components["responses"]["BadRequestError"];
+        404: components["responses"]["NotFoundError"];
+        429: components["responses"]["TooManyRequestsError"];
+        500: components["responses"]["InternalServerError"];
+        502: components["responses"]["BadGatewayError"];
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/v1/versions/{version}/file-tree": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * @description This endpoint provides a **structured list of all files** inside the [`ucd folder`](https://unicode.org/Public/UCD/latest/ucd) associated with a specific Unicode version.
+     *
+     *     For older versions, the files are retrieved without the `/ucd` prefix, while for the latest version, the `/ucd` prefix is included.
+     */
+    get: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path: {
+          /** @description A Unicode Version */version: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description Structured list of files for a Unicode version */200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["UnicodeFileTree"];
+          };
+        };
+        400: components["responses"]["BadRequestError"];
+        429: components["responses"]["TooManyRequestsError"];
+        500: components["responses"]["InternalServerError"];
+        502: components["responses"]["BadGatewayError"];
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/api/v1/files/{wildcard}": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * @description This endpoint proxies requests to Unicode.org's Public directory, streaming files directly while transforming directory listings into structured JSON.
+     *
+     *     All paths are relative to `/api/v1/files` — for example, requesting `/api/v1/files/15.1.0/ucd/emoji/emoji-data.txt` fetches the emoji data file from Unicode version 15.1.0.
+     *
+     *     > [!IMPORTANT]
+     *     > The `{wildcard}` parameter accepts any valid path, including deeply nested ones like `15.1.0/ucd/emoji/emoji-data.txt`. In directory listing responses, paths for directories include a trailing slash (e.g., `/15.1.0/ucd/charts/`), while file paths do not.
+     *
+     *     > [!NOTE]
+     *     > To retrieve only metadata without downloading content, use a `HEAD` request instead. See [here](#tag/files/head/api/v1/files/{wildcard})
+     *
+     *     ### Directory Listing Features
+     *
+     *     When accessing a directory, you can filter and sort entries using these query parameters:
+     *
+     *     - `query` - Prefix-based search (case-insensitive) on entry names
+     *     - `pattern` - Glob pattern matching for filtering
+     *     - `type` - Filter by entry type: `all` (default), `files`, or `directories`
+     *     - `sort` - Sort by `name` (default) or `lastModified`
+     *     - `order` - Sort order: `asc` (default) or `desc`
+     *
+     *     ### Modifications
+     *
+     *     Directory responses are automatically transformed into JSON arrays containing file and directory entries. Files are streamed directly from Unicode.org with appropriate content types.
+     */
+    get: {
+      parameters: {
+        query?: {
+          /**
+           * @description A glob pattern to filter directory listing results by filename. Only applies when the response is a directory listing.
+           *     The matching is **case-insensitive**.
+           *
+           *     ## Supported Glob Syntax
+           *
+           *     | Pattern   | Description                                   | Example                                              |
+           *     |-----------|-----------------------------------------------|------------------------------------------------------|
+           *     | `*`     | Match any characters (except path separators) | `*.txt` matches `file.txt`                       |
+           *     | `?`     | Match a single character                      | `file?.txt` matches `file1.txt`                  |
+           *     | `{a,b}` | Match any of the patterns                     | `*.{txt,xml}` matches `file.txt` or `file.xml` |
+           *     | `[abc]` | Match any character in the set                | `file[123].txt` matches `file1.txt`              |
+           *
+           *     ## Examples
+           *
+           *     - `*.txt` - Match all text files
+           *     - `Uni*` - Match files starting with "Uni" (e.g., UnicodeData.txt)
+           *     - `*Data*` - Match files containing "Data"
+           *     - `*.{txt,xml}` - Match text or XML files
+           */
+          pattern?: string;
+          /**
+           * @description A search query to filter directory listing results. Entries are matched if their name **starts with** this value (case-insensitive).
+           *     This is useful for quick prefix-based searching within a directory.
+           *
+           *     ## Examples
+           *
+           *     - `Uni` - Match entries starting with "Uni" (e.g., UnicodeData.txt)
+           *     - `15` - Match version directories starting with "15"
+           */
+          query?: string;
+          /**
+           * @description Filter directory listing results by entry type.
+           *
+           *     - `all` (default) - Return both files and directories
+           *     - `files` - Return only files
+           *     - `directories` - Return only directories
+           */
+          type?: "all" | "files" | "directories";
+          /**
+           * @description The field to sort directory listing results by.
+           *
+           *     - `name` (default) - Sort alphabetically by entry name
+           *     - `lastModified` - Sort by last modification timestamp
+           */
+          sort?: "name" | "lastModified";
+          /**
+           * @description The sort order for directory listing results.
+           *
+           *     - `asc` (default) - Ascending order (A-Z, oldest first)
+           *     - `desc` - Descending order (Z-A, newest first)
+           */
+          order?: "asc" | "desc";
+        };
+        header?: never;
+        path: {
+          /**
+           * @description The path to the Unicode data resource you want to access. This can be any valid path from the official Unicode Public directory structure.
+           *
+           *     ## Path Format Options
+           *
+           *     | Pattern                        | Description                    | Example                             |
+           *     |--------------------------------|--------------------------------|-------------------------------------|
+           *     | `{version}/ucd/{filename}`   | UCD files for specific version | `15.1.0/ucd/UnicodeData.txt`      |
+           *     | `{version}/ucd/{sub}/{file}` | Files in subdirectories        | `15.1.0/ucd/emoji/emoji-data.txt` |
+           *     | `{version}`                  | List files for version         | `15.1.0`                          |
+           *     | `latest/ucd/{filename}`      | Latest version of file         | `latest/ucd/PropList.txt`         |
+           */
+          wildcard: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description Response from Unicode.org */200: {
+          headers: {
+            /** @description The type of the file or directory */"X-UCD-Stat-Type": "file" | "directory"; /** @description The size of the file in bytes (only for files) */
+            "X-UCD-Stat-Size"?: string; /** @description Number of children (only for directories) */
+            "X-UCD-Stat-Children"?: string; /** @description Number of child files (only for directories) */
+            "X-UCD-Stat-Children-Files"?: string; /** @description Number of child directories (only for directories) */
+            "X-UCD-Stat-Children-Dirs"?: string;
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["FileEntryList"];
+            "application/xml": string;
+            "text/plain": string;
+            "text/html": string;
+            "application/pdf": string;
+            "application/octet-stream": string;
+          };
+        };
+        400: components["responses"]["BadRequestError"];
+        404: components["responses"]["NotFoundError"];
+        500: components["responses"]["InternalServerError"];
+        502: components["responses"]["BadGatewayError"];
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    /**
+     * @description Retrieve metadata about a file or directory without downloading the content. Useful for checking existence, file size, and other metadata.
+     *
+     *     All paths are relative to `/api/v1/files`. Directory paths always include a trailing slash (e.g., `/15.1.0/ucd/charts/`), while file paths do not.
+     *
+     *     > [!NOTE]
+     *     > This endpoint returns the same headers as the `GET` request (file size, directory entry counts, last modified timestamps, content type) without the response body.
+     */
+    head: {
+      parameters: {
+        query?: {
+          /**
+           * @description A glob pattern to filter directory listing results by filename. Only applies when the response is a directory listing.
+           *     The matching is **case-insensitive**.
+           *
+           *     ## Supported Glob Syntax
+           *
+           *     | Pattern   | Description                                   | Example                                              |
+           *     |-----------|-----------------------------------------------|------------------------------------------------------|
+           *     | `*`     | Match any characters (except path separators) | `*.txt` matches `file.txt`                       |
+           *     | `?`     | Match a single character                      | `file?.txt` matches `file1.txt`                  |
+           *     | `{a,b}` | Match any of the patterns                     | `*.{txt,xml}` matches `file.txt` or `file.xml` |
+           *     | `[abc]` | Match any character in the set                | `file[123].txt` matches `file1.txt`              |
+           *
+           *     ## Examples
+           *
+           *     - `*.txt` - Match all text files
+           *     - `Uni*` - Match files starting with "Uni" (e.g., UnicodeData.txt)
+           *     - `*Data*` - Match files containing "Data"
+           *     - `*.{txt,xml}` - Match text or XML files
+           */
+          pattern?: string;
+          /**
+           * @description A search query to filter directory listing results. Entries are matched if their name **starts with** this value (case-insensitive).
+           *     This is useful for quick prefix-based searching within a directory.
+           *
+           *     ## Examples
+           *
+           *     - `Uni` - Match entries starting with "Uni" (e.g., UnicodeData.txt)
+           *     - `15` - Match version directories starting with "15"
+           */
+          query?: string;
+          /**
+           * @description Filter directory listing results by entry type.
+           *
+           *     - `all` (default) - Return both files and directories
+           *     - `files` - Return only files
+           *     - `directories` - Return only directories
+           */
+          type?: "all" | "files" | "directories";
+          /**
+           * @description The field to sort directory listing results by.
+           *
+           *     - `name` (default) - Sort alphabetically by entry name
+           *     - `lastModified` - Sort by last modification timestamp
+           */
+          sort?: "name" | "lastModified";
+          /**
+           * @description The sort order for directory listing results.
+           *
+           *     - `asc` (default) - Ascending order (A-Z, oldest first)
+           *     - `desc` - Descending order (Z-A, newest first)
+           */
+          order?: "asc" | "desc";
+        };
+        header?: never;
+        path: {
+          /**
+           * @description The path to the Unicode data resource you want to access. This can be any valid path from the official Unicode Public directory structure.
+           *
+           *     ## Path Format Options
+           *
+           *     | Pattern                        | Description                    | Example                             |
+           *     |--------------------------------|--------------------------------|-------------------------------------|
+           *     | `{version}/ucd/{filename}`   | UCD files for specific version | `15.1.0/ucd/UnicodeData.txt`      |
+           *     | `{version}/ucd/{sub}/{file}` | Files in subdirectories        | `15.1.0/ucd/emoji/emoji-data.txt` |
+           *     | `{version}`                  | List files for version         | `15.1.0`                          |
+           *     | `latest/ucd/{filename}`      | Latest version of file         | `latest/ucd/PropList.txt`         |
+           */
+          wildcard: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description Response from Unicode.org */200: {
+          headers: {
+            /** @description The type of the file or directory */"X-UCD-Stat-Type": "file" | "directory"; /** @description The size of the file in bytes (only for files) */
+            "X-UCD-Stat-Size": string; /** @description Number of children (only for directories) */
+            "X-UCD-Stat-Children"?: string; /** @description Number of child files (only for directories) */
+            "X-UCD-Stat-Children-Files"?: string; /** @description Number of child directories (only for directories) */
+            "X-UCD-Stat-Children-Dirs"?: string; /** @description The content type of the file */
+            "Content-Type": string; /** @description Last modification time from upstream */
+            "Last-Modified"?: string; /** @description Byte length when applicable */
+            "Content-Length": string;
+            [name: string]: unknown;
+          };
+          content?: never;
+        };
+      };
+    };
+    patch?: never;
+    trace?: never;
+  };
+  "/.well-known/ucd-config.json": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * @description ## UCD Configuration
+     *
+     *     This endpoint retrieves the UCD configuration, including available API endpoints for accessing Unicode data resources.
+     *
+     *     > [!NOTE]
+     *     > The configuration follows the [UCD.js Well-Known Configuration](https://ucdjs.dev/docs/usage/well-known) specification.
+     */
+    get: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path?: never;
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description Retrieves the UCD configuration */200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["UCDWellKnownConfig"];
+          };
+        };
+        502: components["responses"]["BadGatewayError"];
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/.well-known/ucd-store/{version}.json": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * @description ## UCD Store Manifest (Per Version)
+     *
+     *     This endpoint retrieves the UCD Store manifest for a specific Unicode version, containing metadata about expected files for that version.
+     *
+     *     This is the recommended endpoint for fetching manifest data, as it provides:
+     *     - Smaller payloads (only the requested version)
+     *     - Better caching (version-specific cache invalidation)
+     *     - Reduced server load
+     *
+     *     Each file entry includes:
+     *     - `name`: The filename only
+     *     - `path`: Path for the /api/v1/files endpoint (includes /ucd/ for versions >= 4.1.0)
+     *     - `storePath`: Path for the store subdomain (ucd-store.ucdjs.dev)
+     *
+     *     > [!NOTE]
+     *     > The monolithic endpoint `/.well-known/ucd-store.json` is deprecated. Use this per-version endpoint instead.
+     */
+    get: {
+      parameters: {
+        query?: never;
+        header?: never;
+        path: {
+          /** @description Unicode version (e.g., '16.0.0') */version: string;
+        };
+        cookie?: never;
+      };
+      requestBody?: never;
+      responses: {
+        /** @description The UCD Store manifest for the specified version */200: {
+          headers: {
+            [name: string]: unknown;
+          };
+          content: {
+            "application/json": components["schemas"]["UCDStoreVersionManifest"];
+          };
+        };
+        404: components["responses"]["NotFoundError"];
+        429: components["responses"]["TooManyRequestsError"];
+        500: components["responses"]["InternalServerError"];
+        502: components["responses"]["BadGatewayError"];
+      };
+    };
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+}
+interface components {
+  schemas: {
+    /**
+     * @description Standard error response format used consistently across all API endpoints.
+     *
+     *     Contains essential information for debugging and user feedback. The specific error scenarios and status codes are documented in the individual endpoint response definitions.
+     */
+    ApiError: {
+      /** @description Human-readable error message describing what went wrong */message: string; /** @description HTTP status code matching the response status */
+      status: number; /** @description ISO 8601 timestamp when the error occurred */
+      timestamp: string;
+    }; /** @description A list of Unicode versions with their metadata and support status. */
+    UnicodeVersionList: components["schemas"]["UnicodeVersion"][];
+    /**
+     * @description Represents a Unicode version with its metadata and support status.
+     * @example {
+     *       "version": "17.0.0",
+     *       "documentationUrl": "https://www.unicode.org/versions/Unicode17.0.0/",
+     *       "date": null,
+     *       "url": "https://www.unicode.org/Public/17.0.0",
+     *       "mappedUcdVersion": null,
+     *       "type": "draft"
+     *     }
+     * @example {
+     *       "version": "16.0.0",
+     *       "documentationUrl": "https://www.unicode.org/versions/Unicode16.0.0/",
+     *       "date": "2024",
+     *       "url": "https://www.unicode.org/Public/16.0.0",
+     *       "mappedUcdVersion": null,
+     *       "type": "stable"
+     *     }
+     * @example {
+     *       "version": "15.1.0",
+     *       "documentationUrl": "https://www.unicode.org/versions/Unicode15.1.0/",
+     *       "date": "2023",
+     *       "url": "https://www.unicode.org/Public/15.1.0",
+     *       "mappedUcdVersion": null,
+     *       "type": "stable"
+     *     }
+     */
+    UnicodeVersion: {
+      /** @description The version of the Unicode standard. */version: string;
+      /**
+       * Format: uri
+       * @description The URL to the Unicode version documentation.
+       */
+      documentationUrl: string; /** @description The year of the Unicode version. */
+      date: string | null;
+      /**
+       * Format: uri
+       * @description The URL to the Unicode Character Database (UCD) for this version.
+       */
+      url: string; /** @description The corresponding UCD version mapping for this Unicode version. Null if same as version. */
+      mappedUcdVersion: string | null;
+      /**
+       * @description The status of the Unicode version. 'unsupported' means the version exists but is not yet supported by the API.
+       * @enum {string}
+       */
+      type: "draft" | "stable" | "unsupported";
+    };
+    /**
+     * @description Detailed information about a Unicode version, including metadata and statistics.
+     * @example {
+     *       "version": "16.0.0",
+     *       "documentationUrl": "https://www.unicode.org/versions/Unicode16.0.0/",
+     *       "date": "2024",
+     *       "url": "https://www.unicode.org/Public/16.0.0",
+     *       "mappedUcdVersion": null,
+     *       "type": "stable",
+     *       "statistics": {
+     *         "totalCharacters": 149813,
+     *         "newCharacters": 5185,
+     *         "totalBlocks": 331,
+     *         "newBlocks": 4,
+     *         "totalScripts": 165,
+     *         "newScripts": 2
+     *       }
+     *     }
+     */
+    UnicodeVersionDetails: {
+      /** @description The version of the Unicode standard. */version: string;
+      /**
+       * Format: uri
+       * @description The URL to the Unicode version documentation.
+       */
+      documentationUrl: string; /** @description The year of the Unicode version. */
+      date: string | null;
+      /**
+       * Format: uri
+       * @description The URL to the Unicode Character Database (UCD) for this version.
+       */
+      url: string; /** @description The corresponding UCD version mapping for this Unicode version. Null if same as version. */
+      mappedUcdVersion: string | null;
+      /**
+       * @description The status of the Unicode version. 'unsupported' means the version exists but is not yet supported by the API.
+       * @enum {string}
+       */
+      type: "draft" | "stable" | "unsupported";
+      /**
+       * @description Statistics about this Unicode version. May be null if statistics are not available.
+       * @default {
+       *       "newBlocks": 0,
+       *       "newCharacters": 0,
+       *       "newScripts": 0,
+       *       "totalBlocks": 0,
+       *       "totalCharacters": 0,
+       *       "totalScripts": 0
+       *     }
+       */
+      statistics: {
+        /** @description Total number of characters in this Unicode version. */totalCharacters: number; /** @description Number of new characters added in this version. */
+        newCharacters: number; /** @description Total number of blocks in this Unicode version. */
+        totalBlocks: number; /** @description Number of new blocks added in this version. */
+        newBlocks: number; /** @description Total number of scripts in this Unicode version. */
+        totalScripts: number; /** @description Number of new scripts added in this version. */
+        newScripts: number;
+      };
+    }; /** @description A recursive file tree structure rooted at an array of entries. */
+    UnicodeFileTree: components["schemas"]["UnicodeFileTreeNode"][]; /** @description A recursive file tree node; directories include children, files do not. */
+    UnicodeFileTreeNode: components["schemas"]["UnicodeFileTreeDirectory"] | components["schemas"]["UnicodeFileTreeFile"]; /** @description A directory node in the Unicode file tree, containing child nodes. */
+    UnicodeFileTreeDirectory: {
+      name: string;
+      path: string;
+      lastModified: number | null; /** @enum {string} */
+      type: "directory";
+      children: components["schemas"]["UnicodeFileTreeNode"][];
+    }; /** @description A file node in the Unicode file tree. */
+    UnicodeFileTreeFile: {
+      name: string;
+      path: string;
+      lastModified: number | null; /** @enum {string} */
+      type: "file";
+    }; /** @description An array of file entries, each representing either a file or a directory. */
+    FileEntryList: ({
+      name: string;
+      path: string;
+      lastModified: number | null; /** @enum {string} */
+      type: "directory";
+    } | {
+      name: string;
+      path: string;
+      lastModified: number | null; /** @enum {string} */
+      type: "file";
+    })[];
+    /**
+     * @description Configuration schema for the .well-known/ucd-config.json endpoint.
+     *
+     *     This configuration provides clients with the necessary information to interact with the UCD API server, including endpoint paths and optional metadata about the server itself.
+     *
+     *     The `manifest` endpoint is deprecated. Use the per-version endpoint `/.well-known/ucd-store/{version}.json` instead for better performance and caching.
+     */
+    UCDWellKnownConfig: {
+      /** @default 1.0 */version: string;
+      endpoints: {
+        files: string;
+        manifest: string;
+        versions: string;
+      }; /** @default [] */
+      versions: string[];
+    };
+    /**
+     * @description Response schema for per-version manifest endpoint.
+     *     Matches the schema from /.well-known/ucd-store/{version}.json
+     */
+    UCDStoreVersionManifest: {
+      /** @description List of expected files for this version with their paths */expectedFiles: components["schemas"]["ExpectedFile"][];
+    }; /** @description A file expected to be present in a UCD version */
+    ExpectedFile: {
+      /** @description Filename only */name: string; /** @description Path relative to /api/v1/files endpoint (includes /ucd/ for versions >= 4.1.0) */
+      path: string; /** @description Path for store subdomain (without /ucd/ prefix) */
+      storePath: string;
+    };
+  };
+  responses: {
+    /** @description Bad request error */BadRequestError: {
+      headers: {
+        [name: string]: unknown;
+      };
+      content: {
+        "application/json": components["schemas"]["ApiError"];
+      };
+    }; /** @description Resource not found */
+    NotFoundError: {
+      headers: {
+        [name: string]: unknown;
+      };
+      content: {
+        "application/json": components["schemas"]["ApiError"];
+      };
+    }; /** @description Rate limit exceeded */
+    TooManyRequestsError: {
+      headers: {
+        [name: string]: unknown;
+      };
+      content: {
+        "application/json": components["schemas"]["ApiError"];
+      };
+    }; /** @description Internal server error */
+    InternalServerError: {
+      headers: {
+        [name: string]: unknown;
+      };
+      content: {
+        "application/json": components["schemas"]["ApiError"];
+      };
+    }; /** @description Bad gateway - upstream service failed */
+    BadGatewayError: {
+      headers: {
+        [name: string]: unknown;
+      };
+      content: {
+        "application/json": components["schemas"]["ApiError"];
+      };
+    };
+  };
+  parameters: never;
+  requestBodies: never;
+  headers: never;
+  pathItems: never;
+}
+//#endregion
+//#region src/mock-store/handlers/index.d.ts
+declare const MOCK_ROUTES: readonly [RouteHandlerDefinition<"/api/v1/files/{wildcard}">, RouteHandlerDefinition<"/api/v1/versions/{version}/file-tree">, RouteHandlerDefinition<"/.well-known/ucd-config.json">, RouteHandlerDefinition<"/.well-known/ucd-store/{version}.json">, RouteHandlerDefinition<"/api/v1/versions">];
+//#endregion
+//#region src/mock-store/types.d.ts
+interface ContentTypeToType {
+  "application/json": any;
+  "text/plain": string;
+  "application/octet-stream": Blob | File | ArrayBuffer | Uint8Array;
+}
+type EndpointWithGet = { [K in keyof paths]: paths[K] extends {
+  get: any;
+} ? K : never }[keyof paths];
+type TypedResponseResolver<Params extends PathParams<string> = PathParams, Response extends DefaultBodyType = DefaultBodyType> = HttpResponseResolver<Params, DefaultBodyType, Response>;
+type ExtractPathParams<Path extends string> = Path extends `${infer _Start}/{${infer Param}}${infer Rest}` ? PathParams<Param> & ExtractPathParams<Rest> : {};
+type InferContentTypes<Content> = Content extends Record<string, any> ? { [K in keyof Content]: K extends keyof ContentTypeToType ? Content[K] extends ContentTypeToType[K] ? Content[K] : ContentTypeToType[K] : Content[K] }[keyof Content] : never;
+type InferResponsesByEndpoint<Endpoint extends EndpointWithGet> = paths[Endpoint]["get"]["responses"] extends infer Responses ? { [StatusCode in keyof Responses]: Responses[StatusCode] extends {
+  content: infer Content;
+} ? InferContentTypes<Content> : never }[keyof Responses] : never;
+type InferEndpointConfig<Routes extends readonly RouteHandlerDefinition<any>[]> = { [K in Routes[number]["endpoint"]]: Extract<Routes[number], {
+  endpoint: K;
+}> extends RouteHandlerDefinition<infer E> ? InferResponsesByEndpoint<E> | ConfiguredResponse<InferResponsesByEndpoint<E>> | TypedResponseResolver<ExtractPathParams<E>, InferResponsesByEndpoint<E>> | true : never };
+interface MockRouteHandlerContext<Endpoint extends EndpointWithGet> {
+  url: string;
+  providedResponse: InferResponsesByEndpoint<Endpoint> | TypedResponseResolver<ExtractPathParams<Endpoint>, InferResponsesByEndpoint<Endpoint>> | true;
+  mockFetch: MockFetchFn;
+  versions: string[];
+  shouldUseDefaultValue: boolean;
+  files: MockStoreFiles;
+}
+interface RouteHandlerDefinition<Endpoint extends EndpointWithGet> {
+  endpoint: Endpoint;
+  setup: (context: MockRouteHandlerContext<Endpoint>) => void;
+}
+type DerivedEndpointConfig = InferEndpointConfig<typeof MOCK_ROUTES>;
+type DerivedResponses = Partial<{ [K in keyof DerivedEndpointConfig]: false | DerivedEndpointConfig[K] }>;
+type StoreVersionFileKey = "16.0.0" | "17.0.0";
+type StoreFileKeyWildcard = "*" | "root";
+type PartialRecord<K extends keyof any, T> = { [P in K]?: T };
+type MockStoreKey = StoreVersionFileKey | StoreFileKeyWildcard | (string & {});
+type MockStoreNode = Prettify<(Omit<UnicodeFileTreeNode, "type" | "path"> & {
+  type: "file";
+  path?: string;
+  _content?: string;
+}) | (Omit<UnicodeFileTreeNode, "type" | "path"> & {
+  type: "directory";
+  path?: string;
+  _content?: string;
+  children: MockStoreNode[];
+})>;
+type MockStoreFiles = PartialRecord<MockStoreKey, MockStoreNode[]>;
+interface MockStoreConfig {
+  /**
+   * The base URL for the store.
+   *
+   * @default "https://api.ucdjs.dev"
+   */
+  baseUrl?: string;
+  /**
+   * The responses to mock for the store endpoints.
+   *
+   * NOTE:
+   * If the value provided is `true`, then a default handler will be used.
+   * If the value is `false`, then no handler will be used.
+   * If the value provided is a specific response, then that response will be used.
+   *
+   * By default, all endpoints are disabled.
+   */
+  responses?: DerivedResponses;
+  /**
+   * The files to mock for the store endpoint.
+   *
+   * The keys are the version to mock the files for.
+   *
+   * It will be used by the following endpoints:
+   * - `/api/v1/versions/{version}/file-tree`
+   * - `/.well-known/ucd-store/{version}.json`
+   *
+   * A special key of `*` can be used to mock all versions.
+   */
+  files?: MockStoreFiles;
+  /**
+   * The versions to use for placeholders
+   * @default ["16.0.0","15.1.0","15.0.0"]
+   */
+  versions?: string[];
+  /**
+   * Custom mock fetch handlers to register
+   *
+   * @example
+   * ```ts
+   * customResponses: [
+   *   ["GET", "/custom-endpoint", () => HttpResponse.json({ custom: true })],
+   *   [["POST", "PUT"], "/another-endpoint", ({ params }) => {
+   *     const id = params.id;
+   *     return HttpResponse.json({ id });
+   *   }],
+   * ]
+   * ```
+   */
+  customResponses?: MockFetchParamTupleList[0][];
+  /**
+   * Callback invoked on each request to the mock store
+   *
+   * NOTE:
+   * This is not invoked for `customResponses` handlers.
+   *
+   * @example
+   * ```ts
+   * onRequest: ({ path, method, params, url }) => {
+   *   console.log(`Request to ${method} ${path} with params`, params);
+   * }
+   * ```
+   */
+  onRequest?: OnRequestCallback;
+}
+type MockFetchParamTupleList = MockFetchFn extends {
+  (...a: infer A): any;
+  (...a: infer B): any;
+  (...a: infer C): any;
+} ? [A, B, C] : never;
+interface ConfiguredResponseConfig<Response> {
+  /**
+   * The actual response to be returned
+   */
+  response: Response;
+  /**
+   *  Optional latency in milliseconds or "random" for a random delay between 100-999ms
+   */
+  latency?: number | "random";
+  /**
+   * Optional custom headers to add to the response
+   */
+  headers?: Record<string, string>;
+  /**
+   * Optional hook that runs before the resolver is called
+   */
+  before?: OnBeforeMockFetchCallback;
+  /**
+   * Optional hook that runs after the resolver returns
+   */
+  after?: OnAfterMockFetchCallback;
+}
+type ConfiguredResponse<Response> = Response & {};
+interface WrapMockFetchCallbackPayload {
+  path: string;
+  method: string;
+  params: Record<string, any>;
+  url: string;
+}
+interface WrapMockFetchCallbackPayloadWithResponse extends WrapMockFetchCallbackPayload {
+  response: AsyncResponseResolverReturnType<DefaultBodyType>;
+}
+type OnRequestCallback = (payload: WrapMockFetchCallbackPayload) => void;
+type OnBeforeMockFetchCallback = (payload: WrapMockFetchCallbackPayload) => void | Promise<void>;
+type OnAfterMockFetchCallback = (payload: WrapMockFetchCallbackPayloadWithResponse) => void | Promise<void>;
+//#endregion
+//#region src/mock-store/file-tree.d.ts
+/**
+ * A file tree node with optional content for mocking file downloads.
+ * The `_content` property is used by the files handler to return content.
+ */
+type FileTreeNodeWithContent = UnicodeFileTreeNode & {
+  _content?: string;
+};
+/**
+ * Input format for creating file trees.
+ * - String values represent file content
+ * - Nested objects represent directories with their contents
+ *
+ * @example
+ * ```ts
+ * // Simple flat files
+ * {
+ *   "UnicodeData.txt": "file content",
+ *   "Blocks.txt": "blocks content"
+ * }
+ *
+ * // Nested directories
+ * {
+ *   "UnicodeData.txt": "content",
+ *   "auxiliary": {
+ *     "GraphemeBreakProperty.txt": "content",
+ *     "WordBreakProperty.txt": "content"
+ *   }
+ * }
+ *
+ * // Deeply nested
+ * {
+ *   "extracted": {
+ *     "DerivedBidiClass.txt": "content",
+ *     "nested": {
+ *       "DeepFile.txt": "content"
+ *     }
+ *   }
+ * }
+ * ```
+ */
+interface FileTreeInput {
+  [name: string]: string | FileTreeInput;
+}
+/**
+ * Creates a file tree structure from a simplified input format.
+ *
+ * This utility converts a nested object structure into the UnicodeFileTreeNode format
+ * used by mockStoreApi. String values become files with that content, nested objects
+ * become directories.
+ *
+ * @param input - Object mapping names to content (files) or nested objects (directories)
+ * @param parentPath - Internal parameter for building nested paths (don't pass this)
+ * @returns Array of FileTreeNodeWithContent for use with mockStoreApi
+ *
+ * @example
+ * ```ts
+ * // Flat files
+ * createFileTree({
+ *   "UnicodeData.txt": "0041;LATIN CAPITAL LETTER A",
+ *   "Blocks.txt": "0000..007F; Basic Latin"
+ * })
+ *
+ * // With directories
+ * createFileTree({
+ *   "UnicodeData.txt": "content",
+ *   "auxiliary": {
+ *     "GraphemeBreakProperty.txt": "content"
+ *   }
+ * })
+ *
+ * // Use with mockStoreApi
+ * mockStoreApi({
+ *   versions: ["16.0.0"],
+ *   files: {
+ *     "*": createFileTree({
+ *       "UnicodeData.txt": "content",
+ *       "Blocks.txt": "content"
+ *     })
+ *   }
+ * })
+ * ```
+ */
+declare function createFileTree(input: FileTreeInput, parentPath?: string): FileTreeNodeWithContent[];
+//#endregion
+//#region src/mock-store/helpers.d.ts
+/**
+ * Bypass type checking for testing edge cases and invalid responses.
+ * This is useful for testing error handling with responses that don't match the schema.
+ *
+ * @template {any} T - The type of the response being passed through
+ * @param {T} response - Any response data to return without type checking
+ * @returns {any} The response cast to `any` to bypass TypeScript type checking
+ *
+ * @example
+ * ```ts
+ * // Test with invalid schema
+ * mockStoreApi({
+ *   responses: {
+ *     "/api/v1/versions": unsafeResponse({ invalid: "data" })
+ *   }
+ * });
+ *
+ * // Test with wrong type
+ * mockStoreApi({
+ *   responses: {
+ *     "/api/v1/versions": unsafeResponse("not-an-array")
+ *   }
+ * });
+ * ```
+ */
+declare function unsafeResponse<T = any>(response: T): any;
+/**
+ * Configures a response with optional latency and headers for mocking purposes.
+ * This allows simulating network conditions or custom response metadata in tests.
+ *
+ * The configuration is stored as a non-enumerable symbol property on the response object,
+ * ensuring it doesn't interfere with serialization or iteration.
+ *
+ * @template Response - The type of the response being configured
+ * @param config - The configuration object containing the response and optional settings
+ * @returns The configured response with metadata attached as a symbol property
+ * @throws {Error} If the config is invalid or missing required properties
+ * @throws {TypeError} If the response is not a function or non-null object
+ *
+ * @example
+ * ```ts
+ * // Configure with latency
+ * mockStoreApi({
+ *   responses: {
+ *     "/api/v1/versions": configure({
+ *       response: [...],
+ *       latency: 200
+ *     })
+ *   }
+ * });
+ *
+ * // Configure with custom headers
+ * mockStoreApi({
+ *   responses: {
+ *     "/api/v1/versions": configure({
+ *       response: [...],
+ *       headers: { "X-Custom-Header": "value" }
+ *     })
+ *   }
+ * });
+ *
+ * // Combine with unsafeResponse for testing
+ * mockStoreApi({
+ *   responses: {
+ *     "/api/v1/versions": configure({
+ *       response: unsafeResponse({ invalid: "data" }),
+ *       latency: "random"
+ *     })
+ *   }
+ * });
+ *
+ * // Configure with before/after hooks
+ * mockStoreApi({
+ *   responses: {
+ *     "/api/v1/versions/{version}/file-tree": configure({
+ *       response: true,
+ *       before: async () => {
+ *         // Custom logic before resolver
+ *       },
+ *       after: async () => {
+ *         // Custom logic after resolver
+ *       },
+ *     })
+ *   }
+ * });
+ * ```
+ */
+declare function configure<const Response>(config: ConfiguredResponseConfig<Response>): ConfiguredResponse<Response>;
+//#endregion
+export { createFileTree as a, FileTreeNodeWithContent as i, unsafeResponse as n, MockStoreConfig as o, FileTreeInput as r, MockStoreFiles as s, configure as t };