import { XPathItemObject } from './path-item-object';
/**
 * Holds the relative paths to the individual endpoints and their operations.
 * The path is appended to the URL from the [`Server Object`][1]
 * in order to construct the full URL. The Paths MAY be empty, due to
 * [Access Control List (ACL) constraints][2].
 *
 * ### Path Templating Matching
 *
 * Assuming the following paths, the concrete definition, `/pets/mine`,
 * will be matched first if used:
 *
```
  /pets/{petId}
  /pets/mine
```
 *
 * The following paths are considered identical and invalid:
```
  /pets/{petId}
  /pets/{name}
```
 *
 * The following may lead to ambiguous resolution:
```
  /{entity}/me
  /books/{id}
```
 *
 * ### Paths Object Example
 *
 * - Example with JSON
```json
{
  "/pets": {
    "get": {
      "description": "Returns all pets from the system that the user has access to",
      "responses": {
        "200": {
          "description": "A list of pets.",
          "content": {
            "application/json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/pet"
                }
              }
            }
          }
        }
      }
    }
  }
}
```
 *
 * - Example with YAML
```yaml
/pets:
  get:
    description: Returns all pets from the system that the user has access to
    responses:
      '200':
        description: A list of pets.
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/pet'
```
 *
 * This object MAY be extended with [Specification Extensions][3].
 *
 * [1]: https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#server-object
 * [2]: https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#security-filtering
 * [3]: https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#specification-extensions
 */
export type XPathsObject<T extends PathFieldPattern = any> = {
    [P in T]: XPathItemObject;
};
/**
 * @todo Trek github:
 * - https://github.com/microsoft/TypeScript/issues/42192
 * - https://github.com/microsoft/TypeScript/pull/26797
 */
export type PathFieldPattern = `/${any}`;