openapi-typesafe 1.0.0-rc.4 → 1.0.0-rc.6

package/CHANGELOG.md

@@ -2,6 +2,220 @@
 
 This package is a fork of `openapi-typescript`. The entries above `7.13.0` are releases of openapi-typesafe; `7.13.0` and the entries below it are the upstream history up to the fork point (upstream commit `d46a319a`), with `openapi-typescript` versions.
 
+## 1.0.0-rc.6
+
+### Patch Changes
+
+- [#91](https://github.com/openapi-typesafe/openapi-typesafe/pull/91) [`b3fcff5`](https://github.com/openapi-typesafe/openapi-typesafe/commit/b3fcff541be5f8ddd0bbea19b95a60df26fda92e) Thanks [@fedorello](https://github.com/fedorello)! - A `$ref` to the `additionalProperties` of an object that also has `properties`
+  (`#/components/schemas/Stats/additionalProperties`) is typed as that schema again. Since the index
+  signature also takes the property types, `Stats["additionalProperties"]` read
+  `number | { count?: number }`, which accepted `5`, and a `$ref` one level deeper
+  (`.../additionalProperties/properties/count`) did not compile, also with `--fix ref-pointers`.
+
+- [#92](https://github.com/openapi-typesafe/openapi-typesafe/pull/92) [`cf9c4db`](https://github.com/openapi-typesafe/openapi-typesafe/commit/cf9c4db102193818022a30b46d6476bef2f98a93) Thanks [@fedorello](https://github.com/fedorello)! - With several APIs in `redocly.yaml`, an error about an output file (`OUTPUT_STALE`,
+  `OUTPUT_READ_FAILED`, `OUTPUT_WRITE_FAILED`, `CLI_OUTPUT_INVALID`, `CLI_OUTPUT_IS_INPUT`,
+  `CLI_OUTPUT_DUPLICATE`) starts with `API <name>:`, as the other errors of an API do.
+
+- [#92](https://github.com/openapi-typesafe/openapi-typesafe/pull/92) [`cf9c4db`](https://github.com/openapi-typesafe/openapi-typesafe/commit/cf9c4db102193818022a30b46d6476bef2f98a93) Thanks [@fedorello](https://github.com/fedorello)! - `--check` compares lines, not line ends: an output that Git checked out with CRLF line ends
+  (`core.autocrlf` on Windows) is no longer reported as stale (`OUTPUT_STALE`).
+
+- [#92](https://github.com/openapi-typesafe/openapi-typesafe/pull/92) [`cf9c4db`](https://github.com/openapi-typesafe/openapi-typesafe/commit/cf9c4db102193818022a30b46d6476bef2f98a93) Thanks [@fedorello](https://github.com/fedorello)! - A path with a colon in its name, such as `-o out:v2.ts` or the schema `spec:v2.yaml`, is read as a
+  file path. Any text before a colon was taken as a URL scheme, so the output failed with
+  `CLI_OUTPUT_INVALID`. A location is a URL when it starts with `http:`, `https:` or `file:`, or with
+  a scheme and `//`.
+
+- [#92](https://github.com/openapi-typesafe/openapi-typesafe/pull/92) [`cf9c4db`](https://github.com/openapi-typesafe/openapi-typesafe/commit/cf9c4db102193818022a30b46d6476bef2f98a93) Thanks [@fedorello](https://github.com/fedorello)! - Warnings and errors on stderr get colors only when stderr is a terminal. A log file that stderr
+  was redirected to got color escape sequences whenever stdout was a terminal.
+
+- [#92](https://github.com/openapi-typesafe/openapi-typesafe/pull/92) [`cf9c4db`](https://github.com/openapi-typesafe/openapi-typesafe/commit/cf9c4db102193818022a30b46d6476bef2f98a93) Thanks [@fedorello](https://github.com/fedorello)! - The Node API's `cwd` option is read like `localRefRoot`: a string such as `"file:///app/specs/"` is
+  a URL, where it was read as a relative path. A `cwd` of another type (a number), a URL of another
+  scheme, or a relative `localRefRoot` with an `http:` `cwd` rejects with `OPTION_INVALID` instead of
+  resolving a wrong directory or throwing a plain `TypeError`.
+
+- [#91](https://github.com/openapi-typesafe/openapi-typesafe/pull/91) [`b3fcff5`](https://github.com/openapi-typesafe/openapi-typesafe/commit/b3fcff541be5f8ddd0bbea19b95a60df26fda92e) Thanks [@fedorello](https://github.com/fedorello)! - `--enum-values` with `--path-params-as-types`: the arrays of a path with a `number` or `boolean`
+  path parameter compile. Their type indexed `FlattenedDeepRequired<paths>["/items/{id}"]`, a key
+  the type does not have (TS2339); it is now indexed by the path's template
+  (``FlattenedDeepRequired<paths>[`/items/${number}`]``), as a `$ref` into that path already was.
+
+- [#91](https://github.com/openapi-typesafe/openapi-typesafe/pull/91) [`b3fcff5`](https://github.com/openapi-typesafe/openapi-typesafe/commit/b3fcff541be5f8ddd0bbea19b95a60df26fda92e) Thanks [@fedorello](https://github.com/fedorello)! - With `--exclude-deprecated`, a `$ref` to a property it leaves out is typed as that property's
+  schema also when the object has `additionalProperties`. It was read through the index signature,
+  so a `type: string` property was typed as the `additionalProperties` type (`number`), without an
+  error.
+
+- [#92](https://github.com/openapi-typesafe/openapi-typesafe/pull/92) [`cf9c4db`](https://github.com/openapi-typesafe/openapi-typesafe/commit/cf9c4db102193818022a30b46d6476bef2f98a93) Thanks [@fedorello](https://github.com/fedorello)! - A second schema argument fails with the new error `CLI_INPUT_EXTRA` (exit code 2). Only the first
+  one was generated, so an unquoted glob that the shell expanded (`g/*.yaml`) generated one schema and
+  passed.
+
+- [#93](https://github.com/openapi-typesafe/openapi-typesafe/pull/93) [`25f631d`](https://github.com/openapi-typesafe/openapi-typesafe/commit/25f631d8dabed24e18a859b08e8395496e145118) Thanks [@fedorello](https://github.com/fedorello)! - Inline `postTransform` and `transformProperty` callbacks in `openapiTS(source, { … })` without
+  `irCallbacks` get their parameter types again (`ts.TypeNode`, `ts.PropertySignature`) instead of
+  an implicit `any` that `strict` rejects (TS7006), as with openapi-typescript 7.
+
+- [#92](https://github.com/openapi-typesafe/openapi-typesafe/pull/92) [`cf9c4db`](https://github.com/openapi-typesafe/openapi-typesafe/commit/cf9c4db102193818022a30b46d6476bef2f98a93) Thanks [@fedorello](https://github.com/fedorello)! - The `--no-` form of a flag that takes a value (`--no-output`, `--no-redocly`, `--no-fix`,
+  `--no-local-ref-root`, `--no-remote-ref-hosts`) fails with `CLI_FLAG_INVALID`. It used the text
+  `false` as the value: `--no-output` wrote the types to a file named `false`.
+
+- [#91](https://github.com/openapi-typesafe/openapi-typesafe/pull/91) [`b3fcff5`](https://github.com/openapi-typesafe/openapi-typesafe/commit/b3fcff541be5f8ddd0bbea19b95a60df26fda92e) Thanks [@fedorello](https://github.com/fedorello)! - A `$ref` to one pattern of `patternProperties`
+  (`#/components/schemas/Labels/patternProperties/^label_`) compiles without `--fix`: it is typed as
+  that pattern's schema instead of `components["schemas"]["Labels"]["patternProperties"]["^label_"]`
+  (TS2339).
+
+- [#92](https://github.com/openapi-typesafe/openapi-typesafe/pull/92) [`cf9c4db`](https://github.com/openapi-typesafe/openapi-typesafe/commit/cf9c4db102193818022a30b46d6476bef2f98a93) Thanks [@fedorello](https://github.com/fedorello)! - With several APIs in `redocly.yaml`, each API is linted with its own `rules` (and other lint
+  settings) from `apis.<name>`, as `redocly lint <name>` lints it. Every API was linted with the
+  root rules only.
+
+- [#92](https://github.com/openapi-typesafe/openapi-typesafe/pull/92) [`cf9c4db`](https://github.com/openapi-typesafe/openapi-typesafe/commit/cf9c4db102193818022a30b46d6476bef2f98a93) Thanks [@fedorello](https://github.com/fedorello)! - Remote `$ref` documents whose queries end in the same text after a `/` (a branch such as
+  `?ref=feature/new-api`) are each named after their own file. The pet document was named after the
+  owner document (`components["schemas"]["owner"]`), and the owner one `owner-2`.
+
+- [#92](https://github.com/openapi-typesafe/openapi-typesafe/pull/92) [`cf9c4db`](https://github.com/openapi-typesafe/openapi-typesafe/commit/cf9c4db102193818022a30b46d6476bef2f98a93) Thanks [@fedorello](https://github.com/fedorello)! - Relative `$ref`s of a remote document that redirects resolve from the URL it was redirected to.
+  A spec URL `https://host/latest` that redirects to `/static/v1/root.yaml` loaded `./pet.yaml` from
+  `https://host/pet.yaml`, which gave the types of another file or failed with a 404.
+
+- [#92](https://github.com/openapi-typesafe/openapi-typesafe/pull/92) [`cf9c4db`](https://github.com/openapi-typesafe/openapi-typesafe/commit/cf9c4db102193818022a30b46d6476bef2f98a93) Thanks [@fedorello](https://github.com/fedorello)! - An unknown flag before the schema no longer takes the schema path as its value:
+  `--alphabetise api.yaml -o out.ts` prints the notice for the flag and generates `api.yaml`, where it
+  read stdin instead. A schema path that looks like a number (`1.10`, `0x10`) is read as written.
+
+## 1.0.0-rc.5
+
+### Patch Changes
+
+- [#70](https://github.com/openapi-typesafe/openapi-typesafe/pull/70) [`d732870`](https://github.com/openapi-typesafe/openapi-typesafe/commit/d732870a9e1d207761c88614a95b778c4f0ebe9d) Thanks [@fedorello](https://github.com/fedorello)! - With several APIs in `redocly.yaml`, an error while an API is loaded or generated starts with
+  `API <name>:`, as its config errors do, so it tells which API failed. The code and the exit code
+  stay the same. Every warning, problem and debug line of an API's generation (a `$ref` it cannot
+  resolve, a lint problem) starts with `API <name>:` too. A notice that a root-types flag has no
+  effect follows the CLI flags together with each API's settings and names the API, and an invalid
+  `--local-ref-root` fails the run once instead of once for each API.
+
+- [#70](https://github.com/openapi-typesafe/openapi-typesafe/pull/70) [`d732870`](https://github.com/openapi-typesafe/openapi-typesafe/commit/d732870a9e1d207761c88614a95b778c4f0ebe9d) Thanks [@fedorello](https://github.com/fedorello)! - Types piped to a reader that stops early (`openapi-typesafe api.yaml | head`) no longer crash the
+  CLI with `EPIPE` and exit code `1`; the rest is dropped and the exit code stays `0`.
+
+- [#70](https://github.com/openapi-typesafe/openapi-typesafe/pull/70) [`d732870`](https://github.com/openapi-typesafe/openapi-typesafe/commit/d732870a9e1d207761c88614a95b778c4f0ebe9d) Thanks [@fedorello](https://github.com/fedorello)! - CLI flags are read by their names:
+  - A removed flag fails with `CLI_FLAG_REMOVED` written with a value too (`--redoc=redocly.yaml`),
+    in camelCase (`--immutableTypes`) and with `--no-` (`--no-immutable-types`).
+  - The boolean alias `-t` (`--export-type`) takes `=true` and `=false` as the flag does; another
+    value fails with `CLI_FLAG_INVALID`.
+  - A boolean flag takes no value, or `=true` or `=false`. Another value (`--enum=1`,
+    `--no-enum=true`) fails with `CLI_FLAG_INVALID` (exit code `2`) instead of turning the flag off.
+  - A flag given more than once takes the last value; `--output` and `--redocly` no longer fail with
+    a list.
+  - The notice that a root-types flag has no effect without `--root-types` follows the parsed flags:
+    `--rootTypes` and `--root-types=true` count, `--root-types=false` does not.
+
+- [#76](https://github.com/openapi-typesafe/openapi-typesafe/pull/76) [`e464bc3`](https://github.com/openapi-typesafe/openapi-typesafe/commit/e464bc3c9dcb243a4259307d6b667bde134d8468) Thanks [@fedorello](https://github.com/fedorello)! - A schema argument is a glob pattern, which fails with `CLI_GLOB_UNSUPPORTED`, only when it is a
+  path with a `*` that names no file. A URL with a `*` in its query (`…/openapi?fields=*`) and an
+  existing file whose name has a `*` are read as any other schema.
+
+- [#70](https://github.com/openapi-typesafe/openapi-typesafe/pull/70) [`d732870`](https://github.com/openapi-typesafe/openapi-typesafe/commit/d732870a9e1d207761c88614a95b778c4f0ebe9d) Thanks [@fedorello](https://github.com/fedorello)! - `--output` together with the APIs of `redocly.yaml` warns with `CLI_OUTPUT_IGNORED`: each API is
+  written to its `x-openapi-ts.output`, and the `--output` path was ignored without a word.
+
+- [#76](https://github.com/openapi-typesafe/openapi-typesafe/pull/76) [`e464bc3`](https://github.com/openapi-typesafe/openapi-typesafe/commit/e464bc3c9dcb243a4259307d6b667bde134d8468) Thanks [@fedorello](https://github.com/fedorello)! - The line for a written file and the notices about flags show a line break or an escape sequence in
+  a file name, a flag or an API name as an escape (`\n`, `\u001b`), as warnings and errors already
+  do, so a name cannot start a forged line in a CI log.
+
+- [#71](https://github.com/openapi-typesafe/openapi-typesafe/pull/71) [`2a03b07`](https://github.com/openapi-typesafe/openapi-typesafe/commit/2a03b072bf201e5e6eeec9ad9744a3f9d513b78a) Thanks [@fedorello](https://github.com/fedorello)! - `const: null` is typed `null`; it was `unknown`, as if the schema had no `const`.
+
+- [#71](https://github.com/openapi-typesafe/openapi-typesafe/pull/71) [`2a03b07`](https://github.com/openapi-typesafe/openapi-typesafe/commit/2a03b072bf201e5e6eeec9ad9744a3f9d513b78a) Thanks [@fedorello](https://github.com/fedorello)! - `--enum --dedupe-enums` no longer merges enums with other values. Their key joined the member
+  names and descriptions as text, and a member name stood in for its value, so `Flag` (`1`, `0`)
+  became the `Status` enum (`"A"`, `"I"`) when both named their members `Active` and `Inactive`, and
+  `["1", "2"]` and `[1, 2]`, or `["a", "b"]` and `["a:,b"]`, shared one enum. The key also paired
+  the values in sorted order with the names in document order, so `[desc, asc]` and `[asc, desc]`,
+  both named `[Desc, Asc]`, shared one enum and one of them typed `asc` as `Desc = "desc"`. Enums
+  with the same values and member names are still merged.
+
+- [#71](https://github.com/openapi-typesafe/openapi-typesafe/pull/71) [`2a03b07`](https://github.com/openapi-typesafe/openapi-typesafe/commit/2a03b072bf201e5e6eeec9ad9744a3f9d513b78a) Thanks [@fedorello](https://github.com/fedorello)! - The new fix `default-input-locations` finds parameters and request bodies by the document's
+  structure for `--default-non-nullable` (on by default). Without it, as in openapi-typescript, a
+  defaulted property stays optional wherever its location holds the word `parameters` or
+  `requestBody`, such as a response of `/system-parameters` or a property named `hyperparameters`.
+  It changes nothing with `--default-non-nullable=false`, so naming it then prints the warning
+  `FIX_NEEDS_OPTION`, as other fixes that need a flag do (`--fix all` does not).
+
+- [#71](https://github.com/openapi-typesafe/openapi-typesafe/pull/71) [`2a03b07`](https://github.com/openapi-typesafe/openapi-typesafe/commit/2a03b072bf201e5e6eeec9ad9744a3f9d513b78a) Thanks [@fedorello](https://github.com/fedorello)! - With `--exclude-deprecated`, a `$ref` to a property it leaves out
+  (`#/components/schemas/A/properties/old`) is typed as that property's schema, instead of naming a
+  key the type no longer has. The same holds for a `$ref` into a deprecated operation or response
+  header, and a `$ref` through another `$ref` (`Wrap/properties/o/properties/v`, where `o` is a
+  `$ref`) no longer warns `REF_NOT_FOUND`. With `--make-paths-enum`, `ApiPaths` lists only the
+  operations that `paths` keeps.
+
+- [#71](https://github.com/openapi-typesafe/openapi-typesafe/pull/71) [`2a03b07`](https://github.com/openapi-typesafe/openapi-typesafe/commit/2a03b072bf201e5e6eeec9ad9744a3f9d513b78a) Thanks [@fedorello](https://github.com/fedorello)! - `--fix exploded-query-objects`: an exploded object with `additionalProperties` next to other query
+  parameters no longer makes the whole `query` type unusable. Its index signature also takes the
+  value types of the other query keys (`{ page?: number } & Partial<{ [key: string]: string | number
+| undefined }>`), since TypeScript checks it against `page` too. A `$ref` to such an object is
+  written out in place when other query keys are next to it.
+
+- [#71](https://github.com/openapi-typesafe/openapi-typesafe/pull/71) [`2a03b07`](https://github.com/openapi-typesafe/openapi-typesafe/commit/2a03b072bf201e5e6eeec9ad9744a3f9d513b78a) Thanks [@fedorello](https://github.com/fedorello)! - An index signature from `additionalProperties` or `patternProperties` also takes the types of the
+  properties next to it that it does not admit (`{ total: number } & { [key: string]: string |
+number }`). TypeScript checks the signature against the declared keys too, so the old type took no
+  value with those properties.
+
+- [#76](https://github.com/openapi-typesafe/openapi-typesafe/pull/76) [`e464bc3`](https://github.com/openapi-typesafe/openapi-typesafe/commit/e464bc3c9dcb243a4259307d6b667bde134d8468) Thanks [@fedorello](https://github.com/fedorello)! - A YAML parse error of a string source or a stream (stdin in the CLI) names it `the schema string`
+  or `the schema stream`. It named `<cwd>/inline-source`, a file that does not exist.
+
+- [#71](https://github.com/openapi-typesafe/openapi-typesafe/pull/71) [`2a03b07`](https://github.com/openapi-typesafe/openapi-typesafe/commit/2a03b072bf201e5e6eeec9ad9744a3f9d513b78a) Thanks [@fedorello](https://github.com/fedorello)! - A discriminator `mapping` value that names a schema (`cat: Cat`), as OpenAPI allows, is read as
+  `#/components/schemas/Cat`, also in a document a `$ref` loads, where it names that document's
+  schemas. It failed with "Can't resolve $ref"; any other value is still a URI reference. A `mapping`
+  inside `example`, `examples`, `default`, `const`, `enum` or an `x-` value is data and stays as
+  written. A problem in a document other than the root now names that document: its path, or its URL
+  without the query.
+
+- [#71](https://github.com/openapi-typesafe/openapi-typesafe/pull/71) [`2a03b07`](https://github.com/openapi-typesafe/openapi-typesafe/commit/2a03b072bf201e5e6eeec9ad9744a3f9d513b78a) Thanks [@fedorello](https://github.com/fedorello)! - The `parameter-content` fix is now `parameter-header-content` and types a response header with
+  `content` by the schema of its media type too (`"X-Rate": { limit: number }`), not as a map of
+  media types. Configs that name `parameter-content` fail with `OPTION_FIX_UNKNOWN` until renamed.
+
+- [#71](https://github.com/openapi-typesafe/openapi-typesafe/pull/71) [`2a03b07`](https://github.com/openapi-typesafe/openapi-typesafe/commit/2a03b072bf201e5e6eeec9ad9744a3f9d513b78a) Thanks [@fedorello](https://github.com/fedorello)! - `--path-params-as-types` with only `boolean` path parameters in a path compiles:
+  ``[path: `/flags/${boolean}`]`` is no valid index signature (TS1337), so such a path is written as
+  the keys `"/flags/true"` and `"/flags/false"`, with the same path item type (2ⁿ keys for n boolean
+  parameters). A key that the document already has as a path is left out. Next to another parameter
+  (`` `/a/${number}/${boolean}` ``) the signature is valid and stays as it was.
+
+- [#71](https://github.com/openapi-typesafe/openapi-typesafe/pull/71) [`2a03b07`](https://github.com/openapi-typesafe/openapi-typesafe/commit/2a03b072bf201e5e6eeec9ad9744a3f9d513b78a) Thanks [@fedorello](https://github.com/fedorello)! - `--path-params-as-types`: a `$ref` into a path with a `number` or `boolean` path parameter
+  compiles. It was typed as `paths["/pets/{id}"]`, which names no key of
+  ``[path: `/pets/${number}`]`` (TS2339); it is now ``paths[`/pets/${number}`]``. A boolean path
+  is indexed by the keys it is written with (`paths["/flags/true" | "/flags/false"]`), without the
+  one a path of the document takes, so the `$ref` no longer gets that path's type too. With only
+  string parameters the URL matches the template, so that output stays as it was.
+
+- [#75](https://github.com/openapi-typesafe/openapi-typesafe/pull/75) [`a74608e`](https://github.com/openapi-typesafe/openapi-typesafe/commit/a74608ec36b0a938594e0d0fac10c9fb222c1742) Thanks [@fedorello](https://github.com/fedorello)! - `Readable` and `Writable` find the `$Read` and `$Write` properties of an object with an index
+  signature (`additionalProperties`). The keys were read through the index signature, so no
+  property was marked: a request body required the `readOnly` `id`, and a response kept the
+  `writeOnly` password. The helper types that `--read-write-markers` writes are fixed the same way.
+
+- [#70](https://github.com/openapi-typesafe/openapi-typesafe/pull/70) [`d732870`](https://github.com/openapi-typesafe/openapi-typesafe/commit/d732870a9e1d207761c88614a95b778c4f0ebe9d) Thanks [@fedorello](https://github.com/fedorello)! - The `$ref` limits are checked before anything loads:
+  - In the Node API, a `remoteRefHosts` that is no list of strings, or a `localRefRoot` that is no
+    path or `file:` URL, fails with `OPTION_INVALID` and `details.option`. It failed later as an error
+    of the document, such as `hosts.map is not a function`.
+  - `--local-ref-root https://…` fails with `CLI_FLAG_INVALID` (exit code `2`) instead of exit code
+    `3`, and a `local-ref-root` URL of another protocol in `redocly.yaml` with `CLI_CONFIG_INVALID`.
+  - In the Node API, a `localRefRoot` string with a scheme is a URL, as for `--local-ref-root`:
+    `"file:///specs/"` is that directory, not a path below `cwd`, and `"https://…"` fails with
+    `OPTION_INVALID`.
+
+- [#75](https://github.com/openapi-typesafe/openapi-typesafe/pull/75) [`a74608e`](https://github.com/openapi-typesafe/openapi-typesafe/commit/a74608ec36b0a938594e0d0fac10c9fb222c1742) Thanks [@fedorello](https://github.com/fedorello)! - More `$ref`s into a schema compile and get the type they point at:
+  - A `$ref` into the `content` of a header or parameter follows the generated type: the media type
+    member of a header (`components["headers"]["H"]["text/plain"]`), or with the
+    `parameter-header-content` fix the media type's type itself. A parameter typed `string` and
+    `content` next to a `schema` are typed in place. Before, `["content"]["text/plain"]["schema"]`
+    did not compile (TS2339).
+  - With `--read-write-markers`, a `$ref` through an optional property gets `NonNullable` as
+    without the flag; one through a `$Read` or `$Write` property is typed in place.
+  - A `$ref` through a property with a `default` that the output makes optional (in a request body,
+    or under a property named `hyperparameters`) gets `NonNullable`: the property is read as
+    optional or required by where it is, not where the `$ref` is.
+
+- [#71](https://github.com/openapi-typesafe/openapi-typesafe/pull/71) [`2a03b07`](https://github.com/openapi-typesafe/openapi-typesafe/commit/2a03b072bf201e5e6eeec9ad9744a3f9d513b78a) Thanks [@fedorello](https://github.com/fedorello)! - `--fix ref-siblings` also reads the keywords next to the `$ref` of an object property
+  (`owner: { $ref: Base, required: [id] }` is `WithRequired<Base, "id">`); it read them only for
+  components, array items, bodies and parameters.
+
+- [#66](https://github.com/openapi-typesafe/openapi-typesafe/pull/66) [`15344bf`](https://github.com/openapi-typesafe/openapi-typesafe/commit/15344bfb803ff9872a6d3f79b8279fbbbbfd14ea) Thanks [@fedorello](https://github.com/fedorello)! - A remote `$ref` to a document served as `text/plain` loads when its URL has a query after the
+  extension (`pet.yaml?token=…`), no extension at all (`/schemas/pet`) or a dot that names no text
+  format (`/schemas/v1.0`, `/schemas/pet.v2`); before, it was kept as text and failed with
+  `Expected SchemaObject, received string`. A URL whose extension or type names a text format
+  (`.md`, `.markdown`, `.txt`, `.html`, `.htm`, `text/markdown`, `text/html`) stays text, as a
+  Markdown `description` does.
+
+- [#71](https://github.com/openapi-typesafe/openapi-typesafe/pull/71) [`2a03b07`](https://github.com/openapi-typesafe/openapi-typesafe/commit/2a03b072bf201e5e6eeec9ad9744a3f9d513b78a) Thanks [@fedorello](https://github.com/fedorello)! - A webhook that is a `$ref` (often to `components/pathItems`) is typed as the path item it points
+  at, as a `$ref` in `paths` is: `petAdded: components["pathItems"]["PetEvent"]`. Every method of
+  such a webhook was `never`.
+
 ## 1.0.0-rc.4
 
 ### Minor Changes

package/dist/adapters/node-file-system/node-file-system.cjs

@@ -100,6 +100,13 @@ class NodeFileSystem {
       return false;
     }
   }
+  isFile(file) {
+    try {
+      return fs__default.statSync(file).isFile();
+    } catch {
+      return false;
+    }
+  }
   isSameFile(left, right) {
     const leftPath = node_url.fileURLToPath(left);
     const rightPath = node_url.fileURLToPath(right);

package/dist/adapters/node-file-system/node-file-system.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"node-file-system.cjs","sources":["../../../src/adapters/node-file-system/node-file-system.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport { fileURLToPath } from \"node:url\";\nimport type {\n  ClaimedFile,\n  DirectoryCheck,\n  FileClaims,\n  FileIdentity,\n  FileReader,\n  FileWriter,\n} from \"../../application/ports/file-system.js\";\nimport { ERROR_CODES, type ErrorCode, OpenAPITypesafeError } from \"../../domain/errors.js\";\nimport { claimFileAt, writeFileAt } from \"./file-claims.js\";\nimport {\n  type FileNumber,\n  fileIdentityKey,\n  isSameFileNumber,\n  type PathQueries,\n} from \"./file-identity.js\";\n\n/** The file ports on Node's `fs`, with the failures as typed errors (ADR-011). */\n\nfunction causeMessage(cause: unknown): string {\n  return cause instanceof Error ? cause.message : String(cause);\n}\n\n/**\n * The file number of a path, or undefined when it cannot be read. A missing output is the common\n * case; any other failure (no access, a file used as a directory) is reported by the read or write\n * that follows, so the identity check does not report it a second time.\n */\nfunction statusOf(filePath: string): FileNumber | undefined {\n  try {\n    const status = fs.statSync(filePath, { bigint: true });\n    return { device: status.dev, file: status.ino };\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * The native `realpath` resolves symbolic links and returns the letter case stored on disk, which\n * the JavaScript one does not do on a case-insensitive file system. A path that vanished since its\n * status was read keeps its own spelling.\n */\nfunction realPathOf(filePath: string): string {\n  try {\n    return fs.realpathSync.native(filePath);\n  } catch {\n    return filePath;\n  }\n}\n\n/** A directory that cannot be listed has no entry to tell its letter case rules by. */\nfunction entriesOf(directory: string): readonly string[] {\n  try {\n    return fs.readdirSync(directory);\n  } catch {\n    return [];\n  }\n}\n\n/**\n * The target of a symbolic link, as written in it; undefined for a path that is no link or cannot\n * be read. The key then treats the path as missing, and the claim at write time decides.\n */\nfunction linkTargetOf(filePath: string): string | undefined {\n  try {\n    return fs.readlinkSync(filePath);\n  } catch {\n    return undefined;\n  }\n}\n\nconst NODE_PATH_QUERIES: PathQueries = {\n  status: statusOf,\n  realPath: realPathOf,\n  entries: entriesOf,\n  linkTarget: linkTargetOf,\n};\n\n/** The path of a `file:` URL, or undefined for a URL that names no file on this platform. */\nfunction localPathOf(file: URL): string | undefined {\n  try {\n    return fileURLToPath(file);\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * A failed read or write as a typed error. The location is named by its path, or by the URL when\n * it names no local file: computing the path must not throw a second, untyped error here.\n */\nfunction fileError(code: ErrorCode, verb: string, file: URL, cause: unknown): OpenAPITypesafeError {\n  const name = localPathOf(file) ?? file.href;\n  return new OpenAPITypesafeError({\n    code,\n    message: `Cannot ${verb} ${name}: ${causeMessage(cause)}`,\n    details: { file: name },\n    cause,\n  });\n}\n\n/** Run a step that writes `file`, with its failure as `OUTPUT_WRITE_FAILED`. */\nfunction typedWrite<T>(file: URL, step: () => T): T {\n  try {\n    return step();\n  } catch (cause) {\n    throw fileError(ERROR_CODES.OUTPUT_WRITE_FAILED, \"write\", file, cause);\n  }\n}\n\nclass NodeFileSystem implements FileReader, FileWriter, FileIdentity, DirectoryCheck, FileClaims {\n  readText(file: URL): string {\n    try {\n      return fs.readFileSync(file, \"utf8\");\n    } catch (cause) {\n      throw fileError(ERROR_CODES.OUTPUT_READ_FAILED, \"read\", file, cause);\n    }\n  }\n\n  writeText(file: URL, contents: string): void {\n    try {\n      writeFileAt(fileURLToPath(file), contents, NODE_PATH_QUERIES);\n    } catch (cause) {\n      throw fileError(ERROR_CODES.OUTPUT_WRITE_FAILED, \"write\", file, cause);\n    }\n  }\n\n  claimFile(file: URL): ClaimedFile {\n    const claim = typedWrite(file, () => claimFileAt(fileURLToPath(file), NODE_PATH_QUERIES));\n    return {\n      identity: claim.identity,\n      release: () => typedWrite(file, () => claim.release()),\n    };\n  }\n\n  isDirectory(file: URL): boolean {\n    try {\n      return fs.statSync(file).isDirectory();\n    } catch {\n      // Missing or unreadable: not a directory; the write that follows reports a failure.\n      return false;\n    }\n  }\n\n  isSameFile(left: URL, right: URL): boolean {\n    const leftPath = fileURLToPath(left);\n    const rightPath = fileURLToPath(right);\n    if (leftPath === rightPath) {\n      return true;\n    }\n    const leftStatus = statusOf(leftPath);\n    const rightStatus = statusOf(rightPath);\n    if (leftStatus && rightStatus && isSameFileNumber(leftStatus, rightStatus)) {\n      return true;\n    }\n    return (\n      fileIdentityKey(leftPath, NODE_PATH_QUERIES) === fileIdentityKey(rightPath, NODE_PATH_QUERIES)\n    );\n  }\n}\n\n/** File access for the CLI. */\nexport function createNodeFileSystem(): FileReader &\n  FileWriter &\n  FileIdentity &\n  DirectoryCheck &\n  FileClaims {\n  return new NodeFileSystem();\n}\n"],"names":["fs","fileURLToPath","OpenAPITypesafeError","ERROR_CODES","writeFileAt","claimFileAt","isSameFileNumber","fileIdentityKey"],"mappings":";;;;;;;;;;;;AAqBA,SAAS,aAAa,KAAA,EAAwB;AAC5C,EAAA,OAAO,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU,OAAO,KAAK,CAAA;AAC9D;AAOA,SAAS,SAAS,QAAA,EAA0C;AAC1D,EAAA,IAAI;AACF,IAAA,MAAM,SAASA,WAAA,CAAG,QAAA,CAAS,UAAU,EAAE,MAAA,EAAQ,MAAM,CAAA;AACrD,IAAA,OAAO,EAAE,MAAA,EAAQ,MAAA,CAAO,GAAA,EAAK,IAAA,EAAM,OAAO,GAAA,EAAI;AAAA,EAChD,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,MAAA;AAAA,EACT;AACF;AAOA,SAAS,WAAW,QAAA,EAA0B;AAC5C,EAAA,IAAI;AACF,IAAA,OAAOA,WAAA,CAAG,YAAA,CAAa,MAAA,CAAO,QAAQ,CAAA;AAAA,EACxC,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,QAAA;AAAA,EACT;AACF;AAGA,SAAS,UAAU,SAAA,EAAsC;AACvD,EAAA,IAAI;AACF,IAAA,OAAOA,WAAA,CAAG,YAAY,SAAS,CAAA;AAAA,EACjC,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,EAAC;AAAA,EACV;AACF;AAMA,SAAS,aAAa,QAAA,EAAsC;AAC1D,EAAA,IAAI;AACF,IAAA,OAAOA,WAAA,CAAG,aAAa,QAAQ,CAAA;AAAA,EACjC,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,MAAA;AAAA,EACT;AACF;AAEA,MAAM,iBAAA,GAAiC;AAAA,EACrC,MAAA,EAAQ,QAAA;AAAA,EACR,QAAA,EAAU,UAAA;AAAA,EACV,OAAA,EAAS,SAAA;AAAA,EACT,UAAA,EAAY;AACd,CAAA;AAGA,SAAS,YAAY,IAAA,EAA+B;AAClD,EAAA,IAAI;AACF,IAAA,OAAOC,uBAAc,IAAI,CAAA;AAAA,EAC3B,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,MAAA;AAAA,EACT;AACF;AAMA,SAAS,SAAA,CAAU,IAAA,EAAiB,IAAA,EAAc,IAAA,EAAW,KAAA,EAAsC;AACjG,EAAA,MAAM,IAAA,GAAO,WAAA,CAAY,IAAI,CAAA,IAAK,IAAA,CAAK,IAAA;AACvC,EAAA,OAAO,IAAIC,2BAAA,CAAqB;AAAA,IAC9B,IAAA;AAAA,IACA,OAAA,EAAS,UAAU,IAAI,CAAA,CAAA,EAAI,IAAI,CAAA,EAAA,EAAK,YAAA,CAAa,KAAK,CAAC,CAAA,CAAA;AAAA,IACvD,OAAA,EAAS,EAAE,IAAA,EAAM,IAAA,EAAK;AAAA,IACtB;AAAA,GACD,CAAA;AACH;AAGA,SAAS,UAAA,CAAc,MAAW,IAAA,EAAkB;AAClD,EAAA,IAAI;AACF,IAAA,OAAO,IAAA,EAAK;AAAA,EACd,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,SAAA,CAAUC,kBAAA,CAAY,mBAAA,EAAqB,OAAA,EAAS,MAAM,KAAK,CAAA;AAAA,EACvE;AACF;AAEA,MAAM,cAAA,CAA2F;AAAA,EAC/F,SAAS,IAAA,EAAmB;AAC1B,IAAA,IAAI;AACF,MAAA,OAAOH,WAAA,CAAG,YAAA,CAAa,IAAA,EAAM,MAAM,CAAA;AAAA,IACrC,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,SAAA,CAAUG,kBAAA,CAAY,kBAAA,EAAoB,MAAA,EAAQ,MAAM,KAAK,CAAA;AAAA,IACrE;AAAA,EACF;AAAA,EAEA,SAAA,CAAU,MAAW,QAAA,EAAwB;AAC3C,IAAA,IAAI;AACF,MAAAC,sBAAA,CAAYH,sBAAA,CAAc,IAAI,CAAA,EAAG,QAAA,EAAU,iBAAiB,CAAA;AAAA,IAC9D,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,SAAA,CAAUE,kBAAA,CAAY,mBAAA,EAAqB,OAAA,EAAS,MAAM,KAAK,CAAA;AAAA,IACvE;AAAA,EACF;AAAA,EAEA,UAAU,IAAA,EAAwB;AAChC,IAAA,MAAM,KAAA,GAAQ,WAAW,IAAA,EAAM,MAAME,uBAAYJ,sBAAA,CAAc,IAAI,CAAA,EAAG,iBAAiB,CAAC,CAAA;AACxF,IAAA,OAAO;AAAA,MACL,UAAU,KAAA,CAAM,QAAA;AAAA,MAChB,SAAS,MAAM,UAAA,CAAW,MAAM,MAAM,KAAA,CAAM,SAAS;AAAA,KACvD;AAAA,EACF;AAAA,EAEA,YAAY,IAAA,EAAoB;AAC9B,IAAA,IAAI;AACF,MAAA,OAAOD,WAAA,CAAG,QAAA,CAAS,IAAI,CAAA,CAAE,WAAA,EAAY;AAAA,IACvC,CAAA,CAAA,MAAQ;AAEN,MAAA,OAAO,KAAA;AAAA,IACT;AAAA,EACF;AAAA,EAEA,UAAA,CAAW,MAAW,KAAA,EAAqB;AACzC,IAAA,MAAM,QAAA,GAAWC,uBAAc,IAAI,CAAA;AACnC,IAAA,MAAM,SAAA,GAAYA,uBAAc,KAAK,CAAA;AACrC,IAAA,IAAI,aAAa,SAAA,EAAW;AAC1B,MAAA,OAAO,IAAA;AAAA,IACT;AACA,IAAA,MAAM,UAAA,GAAa,SAAS,QAAQ,CAAA;AACpC,IAAA,MAAM,WAAA,GAAc,SAAS,SAAS,CAAA;AACtC,IAAA,IAAI,UAAA,IAAc,WAAA,IAAeK,6BAAA,CAAiB,UAAA,EAAY,WAAW,CAAA,EAAG;AAC1E,MAAA,OAAO,IAAA;AAAA,IACT;AACA,IAAA,OACEC,6BAAgB,QAAA,EAAU,iBAAiB,CAAA,KAAMA,4BAAA,CAAgB,WAAW,iBAAiB,CAAA;AAAA,EAEjG;AACF;AAGO,SAAS,oBAAA,GAIH;AACX,EAAA,OAAO,IAAI,cAAA,EAAe;AAC5B;;"}
+{"version":3,"file":"node-file-system.cjs","sources":["../../../src/adapters/node-file-system/node-file-system.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport { fileURLToPath } from \"node:url\";\nimport type {\n  ClaimedFile,\n  DirectoryCheck,\n  FileCheck,\n  FileClaims,\n  FileIdentity,\n  FileReader,\n  FileWriter,\n} from \"../../application/ports/file-system.js\";\nimport { ERROR_CODES, type ErrorCode, OpenAPITypesafeError } from \"../../domain/errors.js\";\nimport { claimFileAt, writeFileAt } from \"./file-claims.js\";\nimport {\n  type FileNumber,\n  fileIdentityKey,\n  isSameFileNumber,\n  type PathQueries,\n} from \"./file-identity.js\";\n\n/** The file ports on Node's `fs`, with the failures as typed errors (ADR-011). */\n\nfunction causeMessage(cause: unknown): string {\n  return cause instanceof Error ? cause.message : String(cause);\n}\n\n/**\n * The file number of a path, or undefined when it cannot be read. A missing output is the common\n * case; any other failure (no access, a file used as a directory) is reported by the read or write\n * that follows, so the identity check does not report it a second time.\n */\nfunction statusOf(filePath: string): FileNumber | undefined {\n  try {\n    const status = fs.statSync(filePath, { bigint: true });\n    return { device: status.dev, file: status.ino };\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * The native `realpath` resolves symbolic links and returns the letter case stored on disk, which\n * the JavaScript one does not do on a case-insensitive file system. A path that vanished since its\n * status was read keeps its own spelling.\n */\nfunction realPathOf(filePath: string): string {\n  try {\n    return fs.realpathSync.native(filePath);\n  } catch {\n    return filePath;\n  }\n}\n\n/** A directory that cannot be listed has no entry to tell its letter case rules by. */\nfunction entriesOf(directory: string): readonly string[] {\n  try {\n    return fs.readdirSync(directory);\n  } catch {\n    return [];\n  }\n}\n\n/**\n * The target of a symbolic link, as written in it; undefined for a path that is no link or cannot\n * be read. The key then treats the path as missing, and the claim at write time decides.\n */\nfunction linkTargetOf(filePath: string): string | undefined {\n  try {\n    return fs.readlinkSync(filePath);\n  } catch {\n    return undefined;\n  }\n}\n\nconst NODE_PATH_QUERIES: PathQueries = {\n  status: statusOf,\n  realPath: realPathOf,\n  entries: entriesOf,\n  linkTarget: linkTargetOf,\n};\n\n/** The path of a `file:` URL, or undefined for a URL that names no file on this platform. */\nfunction localPathOf(file: URL): string | undefined {\n  try {\n    return fileURLToPath(file);\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * A failed read or write as a typed error. The location is named by its path, or by the URL when\n * it names no local file: computing the path must not throw a second, untyped error here.\n */\nfunction fileError(code: ErrorCode, verb: string, file: URL, cause: unknown): OpenAPITypesafeError {\n  const name = localPathOf(file) ?? file.href;\n  return new OpenAPITypesafeError({\n    code,\n    message: `Cannot ${verb} ${name}: ${causeMessage(cause)}`,\n    details: { file: name },\n    cause,\n  });\n}\n\n/** Run a step that writes `file`, with its failure as `OUTPUT_WRITE_FAILED`. */\nfunction typedWrite<T>(file: URL, step: () => T): T {\n  try {\n    return step();\n  } catch (cause) {\n    throw fileError(ERROR_CODES.OUTPUT_WRITE_FAILED, \"write\", file, cause);\n  }\n}\n\nclass NodeFileSystem\n  implements FileReader, FileWriter, FileIdentity, DirectoryCheck, FileCheck, FileClaims\n{\n  readText(file: URL): string {\n    try {\n      return fs.readFileSync(file, \"utf8\");\n    } catch (cause) {\n      throw fileError(ERROR_CODES.OUTPUT_READ_FAILED, \"read\", file, cause);\n    }\n  }\n\n  writeText(file: URL, contents: string): void {\n    try {\n      writeFileAt(fileURLToPath(file), contents, NODE_PATH_QUERIES);\n    } catch (cause) {\n      throw fileError(ERROR_CODES.OUTPUT_WRITE_FAILED, \"write\", file, cause);\n    }\n  }\n\n  claimFile(file: URL): ClaimedFile {\n    const claim = typedWrite(file, () => claimFileAt(fileURLToPath(file), NODE_PATH_QUERIES));\n    return {\n      identity: claim.identity,\n      release: () => typedWrite(file, () => claim.release()),\n    };\n  }\n\n  isDirectory(file: URL): boolean {\n    try {\n      return fs.statSync(file).isDirectory();\n    } catch {\n      // Missing or unreadable: not a directory; the write that follows reports a failure.\n      return false;\n    }\n  }\n\n  isFile(file: URL): boolean {\n    try {\n      return fs.statSync(file).isFile();\n    } catch {\n      // Missing or unreadable: no file; the read that follows reports a failure.\n      return false;\n    }\n  }\n\n  isSameFile(left: URL, right: URL): boolean {\n    const leftPath = fileURLToPath(left);\n    const rightPath = fileURLToPath(right);\n    if (leftPath === rightPath) {\n      return true;\n    }\n    const leftStatus = statusOf(leftPath);\n    const rightStatus = statusOf(rightPath);\n    if (leftStatus && rightStatus && isSameFileNumber(leftStatus, rightStatus)) {\n      return true;\n    }\n    return (\n      fileIdentityKey(leftPath, NODE_PATH_QUERIES) === fileIdentityKey(rightPath, NODE_PATH_QUERIES)\n    );\n  }\n}\n\n/** File access for the CLI. */\nexport function createNodeFileSystem(): FileReader &\n  FileWriter &\n  FileIdentity &\n  DirectoryCheck &\n  FileCheck &\n  FileClaims {\n  return new NodeFileSystem();\n}\n"],"names":["fs","fileURLToPath","OpenAPITypesafeError","ERROR_CODES","writeFileAt","claimFileAt","isSameFileNumber","fileIdentityKey"],"mappings":"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"}

package/dist/adapters/node-file-system/node-file-system.mjs

@@ -94,6 +94,13 @@ class NodeFileSystem {
       return false;
     }
   }
+  isFile(file) {
+    try {
+      return fs.statSync(file).isFile();
+    } catch {
+      return false;
+    }
+  }
   isSameFile(left, right) {
     const leftPath = fileURLToPath(left);
     const rightPath = fileURLToPath(right);

package/dist/adapters/node-file-system/node-file-system.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"node-file-system.mjs","sources":["../../../src/adapters/node-file-system/node-file-system.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport { fileURLToPath } from \"node:url\";\nimport type {\n  ClaimedFile,\n  DirectoryCheck,\n  FileClaims,\n  FileIdentity,\n  FileReader,\n  FileWriter,\n} from \"../../application/ports/file-system.js\";\nimport { ERROR_CODES, type ErrorCode, OpenAPITypesafeError } from \"../../domain/errors.js\";\nimport { claimFileAt, writeFileAt } from \"./file-claims.js\";\nimport {\n  type FileNumber,\n  fileIdentityKey,\n  isSameFileNumber,\n  type PathQueries,\n} from \"./file-identity.js\";\n\n/** The file ports on Node's `fs`, with the failures as typed errors (ADR-011). */\n\nfunction causeMessage(cause: unknown): string {\n  return cause instanceof Error ? cause.message : String(cause);\n}\n\n/**\n * The file number of a path, or undefined when it cannot be read. A missing output is the common\n * case; any other failure (no access, a file used as a directory) is reported by the read or write\n * that follows, so the identity check does not report it a second time.\n */\nfunction statusOf(filePath: string): FileNumber | undefined {\n  try {\n    const status = fs.statSync(filePath, { bigint: true });\n    return { device: status.dev, file: status.ino };\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * The native `realpath` resolves symbolic links and returns the letter case stored on disk, which\n * the JavaScript one does not do on a case-insensitive file system. A path that vanished since its\n * status was read keeps its own spelling.\n */\nfunction realPathOf(filePath: string): string {\n  try {\n    return fs.realpathSync.native(filePath);\n  } catch {\n    return filePath;\n  }\n}\n\n/** A directory that cannot be listed has no entry to tell its letter case rules by. */\nfunction entriesOf(directory: string): readonly string[] {\n  try {\n    return fs.readdirSync(directory);\n  } catch {\n    return [];\n  }\n}\n\n/**\n * The target of a symbolic link, as written in it; undefined for a path that is no link or cannot\n * be read. The key then treats the path as missing, and the claim at write time decides.\n */\nfunction linkTargetOf(filePath: string): string | undefined {\n  try {\n    return fs.readlinkSync(filePath);\n  } catch {\n    return undefined;\n  }\n}\n\nconst NODE_PATH_QUERIES: PathQueries = {\n  status: statusOf,\n  realPath: realPathOf,\n  entries: entriesOf,\n  linkTarget: linkTargetOf,\n};\n\n/** The path of a `file:` URL, or undefined for a URL that names no file on this platform. */\nfunction localPathOf(file: URL): string | undefined {\n  try {\n    return fileURLToPath(file);\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * A failed read or write as a typed error. The location is named by its path, or by the URL when\n * it names no local file: computing the path must not throw a second, untyped error here.\n */\nfunction fileError(code: ErrorCode, verb: string, file: URL, cause: unknown): OpenAPITypesafeError {\n  const name = localPathOf(file) ?? file.href;\n  return new OpenAPITypesafeError({\n    code,\n    message: `Cannot ${verb} ${name}: ${causeMessage(cause)}`,\n    details: { file: name },\n    cause,\n  });\n}\n\n/** Run a step that writes `file`, with its failure as `OUTPUT_WRITE_FAILED`. */\nfunction typedWrite<T>(file: URL, step: () => T): T {\n  try {\n    return step();\n  } catch (cause) {\n    throw fileError(ERROR_CODES.OUTPUT_WRITE_FAILED, \"write\", file, cause);\n  }\n}\n\nclass NodeFileSystem implements FileReader, FileWriter, FileIdentity, DirectoryCheck, FileClaims {\n  readText(file: URL): string {\n    try {\n      return fs.readFileSync(file, \"utf8\");\n    } catch (cause) {\n      throw fileError(ERROR_CODES.OUTPUT_READ_FAILED, \"read\", file, cause);\n    }\n  }\n\n  writeText(file: URL, contents: string): void {\n    try {\n      writeFileAt(fileURLToPath(file), contents, NODE_PATH_QUERIES);\n    } catch (cause) {\n      throw fileError(ERROR_CODES.OUTPUT_WRITE_FAILED, \"write\", file, cause);\n    }\n  }\n\n  claimFile(file: URL): ClaimedFile {\n    const claim = typedWrite(file, () => claimFileAt(fileURLToPath(file), NODE_PATH_QUERIES));\n    return {\n      identity: claim.identity,\n      release: () => typedWrite(file, () => claim.release()),\n    };\n  }\n\n  isDirectory(file: URL): boolean {\n    try {\n      return fs.statSync(file).isDirectory();\n    } catch {\n      // Missing or unreadable: not a directory; the write that follows reports a failure.\n      return false;\n    }\n  }\n\n  isSameFile(left: URL, right: URL): boolean {\n    const leftPath = fileURLToPath(left);\n    const rightPath = fileURLToPath(right);\n    if (leftPath === rightPath) {\n      return true;\n    }\n    const leftStatus = statusOf(leftPath);\n    const rightStatus = statusOf(rightPath);\n    if (leftStatus && rightStatus && isSameFileNumber(leftStatus, rightStatus)) {\n      return true;\n    }\n    return (\n      fileIdentityKey(leftPath, NODE_PATH_QUERIES) === fileIdentityKey(rightPath, NODE_PATH_QUERIES)\n    );\n  }\n}\n\n/** File access for the CLI. */\nexport function createNodeFileSystem(): FileReader &\n  FileWriter &\n  FileIdentity &\n  DirectoryCheck &\n  FileClaims {\n  return new NodeFileSystem();\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"node-file-system.mjs","sources":["../../../src/adapters/node-file-system/node-file-system.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport { fileURLToPath } from \"node:url\";\nimport type {\n  ClaimedFile,\n  DirectoryCheck,\n  FileCheck,\n  FileClaims,\n  FileIdentity,\n  FileReader,\n  FileWriter,\n} from \"../../application/ports/file-system.js\";\nimport { ERROR_CODES, type ErrorCode, OpenAPITypesafeError } from \"../../domain/errors.js\";\nimport { claimFileAt, writeFileAt } from \"./file-claims.js\";\nimport {\n  type FileNumber,\n  fileIdentityKey,\n  isSameFileNumber,\n  type PathQueries,\n} from \"./file-identity.js\";\n\n/** The file ports on Node's `fs`, with the failures as typed errors (ADR-011). */\n\nfunction causeMessage(cause: unknown): string {\n  return cause instanceof Error ? cause.message : String(cause);\n}\n\n/**\n * The file number of a path, or undefined when it cannot be read. A missing output is the common\n * case; any other failure (no access, a file used as a directory) is reported by the read or write\n * that follows, so the identity check does not report it a second time.\n */\nfunction statusOf(filePath: string): FileNumber | undefined {\n  try {\n    const status = fs.statSync(filePath, { bigint: true });\n    return { device: status.dev, file: status.ino };\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * The native `realpath` resolves symbolic links and returns the letter case stored on disk, which\n * the JavaScript one does not do on a case-insensitive file system. A path that vanished since its\n * status was read keeps its own spelling.\n */\nfunction realPathOf(filePath: string): string {\n  try {\n    return fs.realpathSync.native(filePath);\n  } catch {\n    return filePath;\n  }\n}\n\n/** A directory that cannot be listed has no entry to tell its letter case rules by. */\nfunction entriesOf(directory: string): readonly string[] {\n  try {\n    return fs.readdirSync(directory);\n  } catch {\n    return [];\n  }\n}\n\n/**\n * The target of a symbolic link, as written in it; undefined for a path that is no link or cannot\n * be read. The key then treats the path as missing, and the claim at write time decides.\n */\nfunction linkTargetOf(filePath: string): string | undefined {\n  try {\n    return fs.readlinkSync(filePath);\n  } catch {\n    return undefined;\n  }\n}\n\nconst NODE_PATH_QUERIES: PathQueries = {\n  status: statusOf,\n  realPath: realPathOf,\n  entries: entriesOf,\n  linkTarget: linkTargetOf,\n};\n\n/** The path of a `file:` URL, or undefined for a URL that names no file on this platform. */\nfunction localPathOf(file: URL): string | undefined {\n  try {\n    return fileURLToPath(file);\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * A failed read or write as a typed error. The location is named by its path, or by the URL when\n * it names no local file: computing the path must not throw a second, untyped error here.\n */\nfunction fileError(code: ErrorCode, verb: string, file: URL, cause: unknown): OpenAPITypesafeError {\n  const name = localPathOf(file) ?? file.href;\n  return new OpenAPITypesafeError({\n    code,\n    message: `Cannot ${verb} ${name}: ${causeMessage(cause)}`,\n    details: { file: name },\n    cause,\n  });\n}\n\n/** Run a step that writes `file`, with its failure as `OUTPUT_WRITE_FAILED`. */\nfunction typedWrite<T>(file: URL, step: () => T): T {\n  try {\n    return step();\n  } catch (cause) {\n    throw fileError(ERROR_CODES.OUTPUT_WRITE_FAILED, \"write\", file, cause);\n  }\n}\n\nclass NodeFileSystem\n  implements FileReader, FileWriter, FileIdentity, DirectoryCheck, FileCheck, FileClaims\n{\n  readText(file: URL): string {\n    try {\n      return fs.readFileSync(file, \"utf8\");\n    } catch (cause) {\n      throw fileError(ERROR_CODES.OUTPUT_READ_FAILED, \"read\", file, cause);\n    }\n  }\n\n  writeText(file: URL, contents: string): void {\n    try {\n      writeFileAt(fileURLToPath(file), contents, NODE_PATH_QUERIES);\n    } catch (cause) {\n      throw fileError(ERROR_CODES.OUTPUT_WRITE_FAILED, \"write\", file, cause);\n    }\n  }\n\n  claimFile(file: URL): ClaimedFile {\n    const claim = typedWrite(file, () => claimFileAt(fileURLToPath(file), NODE_PATH_QUERIES));\n    return {\n      identity: claim.identity,\n      release: () => typedWrite(file, () => claim.release()),\n    };\n  }\n\n  isDirectory(file: URL): boolean {\n    try {\n      return fs.statSync(file).isDirectory();\n    } catch {\n      // Missing or unreadable: not a directory; the write that follows reports a failure.\n      return false;\n    }\n  }\n\n  isFile(file: URL): boolean {\n    try {\n      return fs.statSync(file).isFile();\n    } catch {\n      // Missing or unreadable: no file; the read that follows reports a failure.\n      return false;\n    }\n  }\n\n  isSameFile(left: URL, right: URL): boolean {\n    const leftPath = fileURLToPath(left);\n    const rightPath = fileURLToPath(right);\n    if (leftPath === rightPath) {\n      return true;\n    }\n    const leftStatus = statusOf(leftPath);\n    const rightStatus = statusOf(rightPath);\n    if (leftStatus && rightStatus && isSameFileNumber(leftStatus, rightStatus)) {\n      return true;\n    }\n    return (\n      fileIdentityKey(leftPath, NODE_PATH_QUERIES) === fileIdentityKey(rightPath, NODE_PATH_QUERIES)\n    );\n  }\n}\n\n/** File access for the CLI. */\nexport function createNodeFileSystem(): FileReader &\n  FileWriter &\n  FileIdentity &\n  DirectoryCheck &\n  FileCheck &\n  FileClaims {\n  return new NodeFileSystem();\n}\n"],"names":[],"mappings":"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"}

package/dist/adapters/pipe-safe-writer/pipe-safe-writer.cjs

@@ -0,0 +1,19 @@
+'use strict';
+
+const BROKEN_PIPE = "EPIPE";
+function isBrokenPipe(error) {
+  return error.code === BROKEN_PIPE;
+}
+function createPipeSafeWriter(stream) {
+  stream.on("error", (error) => {
+    if (!isBrokenPipe(error)) {
+      throw error;
+    }
+  });
+  return (text) => {
+    stream.write(text);
+  };
+}
+
+exports.createPipeSafeWriter = createPipeSafeWriter;
+//# sourceMappingURL=pipe-safe-writer.cjs.map

package/dist/adapters/pipe-safe-writer/pipe-safe-writer.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipe-safe-writer.cjs","sources":["../../../src/adapters/pipe-safe-writer/pipe-safe-writer.ts"],"sourcesContent":["import type { Writable } from \"node:stream\";\n\n/**\n * A writer for the CLI's stdout that stops when the reader closes the pipe (`| head`): the write\n * fails with `EPIPE`, which Node raises as an unhandled `error` event and a crash with exit code\n * 1. The reader has all it wanted, so the rest is dropped and the run ends as it would have.\n * Every other write error is thrown again, as before.\n */\n\nconst BROKEN_PIPE = \"EPIPE\";\n\nfunction isBrokenPipe(error: Error): boolean {\n  return (error as NodeJS.ErrnoException).code === BROKEN_PIPE;\n}\n\n/**\n * The text writer of the stream. After `EPIPE` the stream is destroyed, so later writes are\n * dropped by the stream itself and raise no second error.\n */\nexport function createPipeSafeWriter(stream: Writable): (text: string) => void {\n  stream.on(\"error\", (error: Error) => {\n    if (!isBrokenPipe(error)) {\n      throw error;\n    }\n  });\n  return (text) => {\n    stream.write(text);\n  };\n}\n"],"names":[],"mappings":";;AASA,MAAM,WAAA,GAAc,OAAA;AAEpB,SAAS,aAAa,KAAA,EAAuB;AAC3C,EAAA,OAAQ,MAAgC,IAAA,KAAS,WAAA;AACnD;AAMO,SAAS,qBAAqB,MAAA,EAA0C;AAC7E,EAAA,MAAA,CAAO,EAAA,CAAG,OAAA,EAAS,CAAC,KAAA,KAAiB;AACnC,IAAA,IAAI,CAAC,YAAA,CAAa,KAAK,CAAA,EAAG;AACxB,MAAA,MAAM,KAAA;AAAA,IACR;AAAA,EACF,CAAC,CAAA;AACD,EAAA,OAAO,CAAC,IAAA,KAAS;AACf,IAAA,MAAA,CAAO,MAAM,IAAI,CAAA;AAAA,EACnB,CAAA;AACF;;"}

package/dist/adapters/pipe-safe-writer/pipe-safe-writer.mjs

@@ -0,0 +1,17 @@
+const BROKEN_PIPE = "EPIPE";
+function isBrokenPipe(error) {
+  return error.code === BROKEN_PIPE;
+}
+function createPipeSafeWriter(stream) {
+  stream.on("error", (error) => {
+    if (!isBrokenPipe(error)) {
+      throw error;
+    }
+  });
+  return (text) => {
+    stream.write(text);
+  };
+}
+
+export { createPipeSafeWriter };
+//# sourceMappingURL=pipe-safe-writer.mjs.map

package/dist/adapters/pipe-safe-writer/pipe-safe-writer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipe-safe-writer.mjs","sources":["../../../src/adapters/pipe-safe-writer/pipe-safe-writer.ts"],"sourcesContent":["import type { Writable } from \"node:stream\";\n\n/**\n * A writer for the CLI's stdout that stops when the reader closes the pipe (`| head`): the write\n * fails with `EPIPE`, which Node raises as an unhandled `error` event and a crash with exit code\n * 1. The reader has all it wanted, so the rest is dropped and the run ends as it would have.\n * Every other write error is thrown again, as before.\n */\n\nconst BROKEN_PIPE = \"EPIPE\";\n\nfunction isBrokenPipe(error: Error): boolean {\n  return (error as NodeJS.ErrnoException).code === BROKEN_PIPE;\n}\n\n/**\n * The text writer of the stream. After `EPIPE` the stream is destroyed, so later writes are\n * dropped by the stream itself and raise no second error.\n */\nexport function createPipeSafeWriter(stream: Writable): (text: string) => void {\n  stream.on(\"error\", (error: Error) => {\n    if (!isBrokenPipe(error)) {\n      throw error;\n    }\n  });\n  return (text) => {\n    stream.write(text);\n  };\n}\n"],"names":[],"mappings":"AASA,MAAM,WAAA,GAAc,OAAA;AAEpB,SAAS,aAAa,KAAA,EAAuB;AAC3C,EAAA,OAAQ,MAAgC,IAAA,KAAS,WAAA;AACnD;AAMO,SAAS,qBAAqB,MAAA,EAA0C;AAC7E,EAAA,MAAA,CAAO,EAAA,CAAG,OAAA,EAAS,CAAC,KAAA,KAAiB;AACnC,IAAA,IAAI,CAAC,YAAA,CAAa,KAAK,CAAA,EAAG;AACxB,MAAA,MAAM,KAAA;AAAA,IACR;AAAA,EACF,CAAC,CAAA;AACD,EAAA,OAAO,CAAC,IAAA,KAAS;AACf,IAAA,MAAA,CAAO,MAAM,IAAI,CAAA;AAAA,EACnB,CAAA;AACF;;"}

package/dist/adapters/redocly-loader/bundled-mapping-copies.cjs

@@ -1,19 +1,11 @@
 'use strict';
 
 const jsonPointer = require('../../domain/openapi/json-pointer.cjs');
+const componentSchemas = require('./component-schemas.cjs');
 const refHolders = require('./ref-holders.cjs');
 
-const SCHEMAS_POINTER = jsonPointer.childPointer(jsonPointer.childPointer(jsonPointer.ROOT_POINTER, "components"), "schemas");
-function isContainer(value) {
-  return typeof value === "object" && value !== null;
-}
-function schemasOf(document) {
-  const components = isContainer(document) ? document.components : void 0;
-  const schemas = isContainer(components) ? components.schemas : void 0;
-  return isContainer(schemas) ? schemas : void 0;
-}
 function schemaKeysOf(document) {
-  return new Set(Object.keys(schemasOf(document) ?? {}));
+  return new Set(Object.keys(componentSchemas.componentSchemasOf(document) ?? {}));
 }
 function copiesIn(schemas, keysBefore) {
   const originals = /* @__PURE__ */ new Map();
@@ -26,38 +18,19 @@ function copiesIn(schemas, keysBefore) {
   for (const [key, value] of Object.entries(schemas)) {
     const original = keysBefore.has(key) ? void 0 : originals.get(value);
     if (original !== void 0) {
-      copies.set(`${SCHEMAS_POINTER}/${key}`, jsonPointer.childPointer(SCHEMAS_POINTER, original));
+      copies.set(`${componentSchemas.SCHEMAS_POINTER}/${key}`, jsonPointer.childPointer(componentSchemas.SCHEMAS_POINTER, original));
       delete schemas[key];
     }
   }
   return copies;
 }
-function mappingsOf(document) {
-  const mappings = [];
-  const visited = /* @__PURE__ */ new WeakSet();
-  const pending = [document];
-  for (let next = pending.pop(); next !== void 0; next = pending.pop()) {
-    if (!isContainer(next) || visited.has(next)) {
-      continue;
-    }
-    visited.add(next);
-    const mapping = isContainer(next.discriminator) ? next.discriminator.mapping : void 0;
-    if (isContainer(mapping)) {
-      mappings.push(mapping);
-    }
-    for (const child of Object.values(next)) {
-      pending.push(child);
-    }
-  }
-  return mappings;
-}
 function removeBundledMappingCopies(bundled, keysBefore) {
-  const schemas = schemasOf(bundled);
+  const schemas = componentSchemas.componentSchemasOf(bundled);
   const copies = schemas === void 0 ? /* @__PURE__ */ new Map() : copiesIn(schemas, keysBefore);
   if (copies.size === 0) {
     return;
   }
-  for (const mapping of mappingsOf(bundled)) {
+  for (const mapping of refHolders.findMappings(bundled)) {
     for (const [name, value] of Object.entries(mapping)) {
       const original = typeof value === "string" ? copies.get(value) : void 0;
       if (original !== void 0) {

package/dist/adapters/redocly-loader/bundled-mapping-copies.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"bundled-mapping-copies.cjs","sources":["../../../src/adapters/redocly-loader/bundled-mapping-copies.ts"],"sourcesContent":["import { childPointer, ROOT_POINTER } from \"../../domain/openapi/json-pointer.js\";\nimport { findRefHolders } from \"./ref-holders.js\";\n\n/**\n * Redocly 1.x bundles every discriminator `mapping` value as if it were an external `$ref`: it\n * stores the target schema under the raw last segment of the pointer. For a local schema whose\n * key needs an escape (`a~b`, written `a~0b`; `c/d`, written `c~1d`) that segment is no existing\n * key, so the bundle added `a~0b` and `c~1d` to `components.schemas` as copies of `a~b` and\n * `c/d`, and the generator wrote each type twice. A copy is the very object of the schema it\n * copies, so a key the bundle added whose value is the value of a key the document had is removed,\n * and the mapping values and `$ref`s that name it point at the original.\n */\n\ntype Schemas = Record<string, unknown>;\n\nconst SCHEMAS_POINTER = childPointer(childPointer(ROOT_POINTER, \"components\"), \"schemas\");\n\nfunction isContainer(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction schemasOf(document: unknown): Schemas | undefined {\n  const components = isContainer(document) ? document.components : undefined;\n  const schemas = isContainer(components) ? components.schemas : undefined;\n  return isContainer(schemas) ? schemas : undefined;\n}\n\n/** The keys of `components.schemas` before bundling: the bundle edits the document in place. */\nexport function schemaKeysOf(document: unknown): ReadonlySet<string> {\n  return new Set(Object.keys(schemasOf(document) ?? {}));\n}\n\n/** Each key the bundle added as a copy, with the pointer of the schema it copies. */\nfunction copiesIn(schemas: Schemas, keysBefore: ReadonlySet<string>): Map<string, string> {\n  const originals = new Map<unknown, string>();\n  for (const key of keysBefore) {\n    if (Object.hasOwn(schemas, key) && !originals.has(schemas[key])) {\n      originals.set(schemas[key], key);\n    }\n  }\n  const copies = new Map<string, string>();\n  for (const [key, value] of Object.entries(schemas)) {\n    const original = keysBefore.has(key) ? undefined : originals.get(value);\n    if (original !== undefined) {\n      copies.set(`${SCHEMAS_POINTER}/${key}`, childPointer(SCHEMAS_POINTER, original));\n      delete schemas[key];\n    }\n  }\n  return copies;\n}\n\n/** Every `discriminator.mapping` object of the document; the walk has its own stack. */\nfunction mappingsOf(document: unknown): Record<string, unknown>[] {\n  const mappings: Record<string, unknown>[] = [];\n  const visited = new WeakSet<object>();\n  const pending: unknown[] = [document];\n  for (let next = pending.pop(); next !== undefined; next = pending.pop()) {\n    if (!isContainer(next) || visited.has(next)) {\n      continue;\n    }\n    visited.add(next);\n    const mapping = isContainer(next.discriminator) ? next.discriminator.mapping : undefined;\n    if (isContainer(mapping)) {\n      mappings.push(mapping);\n    }\n    // One push per child: spreading an array of millions of children overflows the stack.\n    for (const child of Object.values(next)) {\n      pending.push(child);\n    }\n  }\n  return mappings;\n}\n\n/** Remove the bundle's copies of the document's own schemas, in place. */\nexport function removeBundledMappingCopies(\n  bundled: unknown,\n  keysBefore: ReadonlySet<string>,\n): void {\n  const schemas = schemasOf(bundled);\n  const copies = schemas === undefined ? new Map<string, string>() : copiesIn(schemas, keysBefore);\n  if (copies.size === 0) {\n    return;\n  }\n  for (const mapping of mappingsOf(bundled)) {\n    for (const [name, value] of Object.entries(mapping)) {\n      const original = typeof value === \"string\" ? copies.get(value) : undefined;\n      if (original !== undefined) {\n        mapping[name] = original;\n      }\n    }\n  }\n  for (const { node } of findRefHolders(bundled)) {\n    node.$ref = copies.get(node.$ref) ?? node.$ref;\n  }\n}\n"],"names":["childPointer","ROOT_POINTER","findRefHolders"],"mappings":";;;;;AAeA,MAAM,kBAAkBA,wBAAA,CAAaA,wBAAA,CAAaC,wBAAA,EAAc,YAAY,GAAG,SAAS,CAAA;AAExF,SAAS,YAAY,KAAA,EAAkD;AACrE,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,IAAA;AAChD;AAEA,SAAS,UAAU,QAAA,EAAwC;AACzD,EAAA,MAAM,UAAA,GAAa,WAAA,CAAY,QAAQ,CAAA,GAAI,SAAS,UAAA,GAAa,MAAA;AACjE,EAAA,MAAM,OAAA,GAAU,WAAA,CAAY,UAAU,CAAA,GAAI,WAAW,OAAA,GAAU,MAAA;AAC/D,EAAA,OAAO,WAAA,CAAY,OAAO,CAAA,GAAI,OAAA,GAAU,MAAA;AAC1C;AAGO,SAAS,aAAa,QAAA,EAAwC;AACnE,EAAA,OAAO,IAAI,IAAI,MAAA,CAAO,IAAA,CAAK,UAAU,QAAQ,CAAA,IAAK,EAAE,CAAC,CAAA;AACvD;AAGA,SAAS,QAAA,CAAS,SAAkB,UAAA,EAAsD;AACxF,EAAA,MAAM,SAAA,uBAAgB,GAAA,EAAqB;AAC3C,EAAA,KAAA,MAAW,OAAO,UAAA,EAAY;AAC5B,IAAA,IAAI,MAAA,CAAO,MAAA,CAAO,OAAA,EAAS,GAAG,CAAA,IAAK,CAAC,SAAA,CAAU,GAAA,CAAI,OAAA,CAAQ,GAAG,CAAC,CAAA,EAAG;AAC/D,MAAA,SAAA,CAAU,GAAA,CAAI,OAAA,CAAQ,GAAG,CAAA,EAAG,GAAG,CAAA;AAAA,IACjC;AAAA,EACF;AACA,EAAA,MAAM,MAAA,uBAAa,GAAA,EAAoB;AACvC,EAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,OAAO,CAAA,EAAG;AAClD,IAAA,MAAM,QAAA,GAAW,WAAW,GAAA,CAAI,GAAG,IAAI,MAAA,GAAY,SAAA,CAAU,IAAI,KAAK,CAAA;AACtE,IAAA,IAAI,aAAa,MAAA,EAAW;AAC1B,MAAA,MAAA,CAAO,GAAA,CAAI,GAAG,eAAe,CAAA,CAAA,EAAI,GAAG,CAAA,CAAA,EAAID,wBAAA,CAAa,eAAA,EAAiB,QAAQ,CAAC,CAAA;AAC/E,MAAA,OAAO,QAAQ,GAAG,CAAA;AAAA,IACpB;AAAA,EACF;AACA,EAAA,OAAO,MAAA;AACT;AAGA,SAAS,WAAW,QAAA,EAA8C;AAChE,EAAA,MAAM,WAAsC,EAAC;AAC7C,EAAA,MAAM,OAAA,uBAAc,OAAA,EAAgB;AACpC,EAAA,MAAM,OAAA,GAAqB,CAAC,QAAQ,CAAA;AACpC,EAAA,KAAA,IAAS,IAAA,GAAO,QAAQ,GAAA,EAAI,EAAG,SAAS,MAAA,EAAW,IAAA,GAAO,OAAA,CAAQ,GAAA,EAAI,EAAG;AACvE,IAAA,IAAI,CAAC,WAAA,CAAY,IAAI,KAAK,OAAA,CAAQ,GAAA,CAAI,IAAI,CAAA,EAAG;AAC3C,MAAA;AAAA,IACF;AACA,IAAA,OAAA,CAAQ,IAAI,IAAI,CAAA;AAChB,IAAA,MAAM,UAAU,WAAA,CAAY,IAAA,CAAK,aAAa,CAAA,GAAI,IAAA,CAAK,cAAc,OAAA,GAAU,MAAA;AAC/E,IAAA,IAAI,WAAA,CAAY,OAAO,CAAA,EAAG;AACxB,MAAA,QAAA,CAAS,KAAK,OAAO,CAAA;AAAA,IACvB;AAEA,IAAA,KAAA,MAAW,KAAA,IAAS,MAAA,CAAO,MAAA,CAAO,IAAI,CAAA,EAAG;AACvC,MAAA,OAAA,CAAQ,KAAK,KAAK,CAAA;AAAA,IACpB;AAAA,EACF;AACA,EAAA,OAAO,QAAA;AACT;AAGO,SAAS,0BAAA,CACd,SACA,UAAA,EACM;AACN,EAAA,MAAM,OAAA,GAAU,UAAU,OAAO,CAAA;AACjC,EAAA,MAAM,MAAA,GAAS,YAAY,MAAA,mBAAY,IAAI,KAAoB,GAAI,QAAA,CAAS,SAAS,UAAU,CAAA;AAC/F,EAAA,IAAI,MAAA,CAAO,SAAS,CAAA,EAAG;AACrB,IAAA;AAAA,EACF;AACA,EAAA,KAAA,MAAW,OAAA,IAAW,UAAA,CAAW,OAAO,CAAA,EAAG;AACzC,IAAA,KAAA,MAAW,CAAC,IAAA,EAAM,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,OAAO,CAAA,EAAG;AACnD,MAAA,MAAM,WAAW,OAAO,KAAA,KAAU,WAAW,MAAA,CAAO,GAAA,CAAI,KAAK,CAAA,GAAI,MAAA;AACjE,MAAA,IAAI,aAAa,MAAA,EAAW;AAC1B,QAAA,OAAA,CAAQ,IAAI,CAAA,GAAI,QAAA;AAAA,MAClB;AAAA,IACF;AAAA,EACF;AACA,EAAA,KAAA,MAAW,EAAE,IAAA,EAAK,IAAKE,yBAAA,CAAe,OAAO,CAAA,EAAG;AAC9C,IAAA,IAAA,CAAK,OAAO,MAAA,CAAO,GAAA,CAAI,IAAA,CAAK,IAAI,KAAK,IAAA,CAAK,IAAA;AAAA,EAC5C;AACF;;;"}
+{"version":3,"file":"bundled-mapping-copies.cjs","sources":["../../../src/adapters/redocly-loader/bundled-mapping-copies.ts"],"sourcesContent":["import { childPointer } from \"../../domain/openapi/json-pointer.js\";\nimport { type ComponentSchemas, componentSchemasOf, SCHEMAS_POINTER } from \"./component-schemas.js\";\nimport { findMappings, findRefHolders } from \"./ref-holders.js\";\n\n/**\n * Redocly 1.x bundles every discriminator `mapping` value as if it were an external `$ref`: it\n * stores the target schema under the raw last segment of the pointer. For a local schema whose\n * key needs an escape (`a~b`, written `a~0b`; `c/d`, written `c~1d`) that segment is no existing\n * key, so the bundle added `a~0b` and `c~1d` to `components.schemas` as copies of `a~b` and\n * `c/d`, and the generator wrote each type twice. A copy is the very object of the schema it\n * copies, so a key the bundle added whose value is the value of a key the document had is removed,\n * and the mapping values and `$ref`s that name it point at the original.\n */\n\n/** The keys of `components.schemas` before bundling: the bundle edits the document in place. */\nexport function schemaKeysOf(document: unknown): ReadonlySet<string> {\n  return new Set(Object.keys(componentSchemasOf(document) ?? {}));\n}\n\n/** Each key the bundle added as a copy, with the pointer of the schema it copies. */\nfunction copiesIn(schemas: ComponentSchemas, keysBefore: ReadonlySet<string>): Map<string, string> {\n  const originals = new Map<unknown, string>();\n  for (const key of keysBefore) {\n    if (Object.hasOwn(schemas, key) && !originals.has(schemas[key])) {\n      originals.set(schemas[key], key);\n    }\n  }\n  const copies = new Map<string, string>();\n  for (const [key, value] of Object.entries(schemas)) {\n    const original = keysBefore.has(key) ? undefined : originals.get(value);\n    if (original !== undefined) {\n      copies.set(`${SCHEMAS_POINTER}/${key}`, childPointer(SCHEMAS_POINTER, original));\n      delete schemas[key];\n    }\n  }\n  return copies;\n}\n\n/** Remove the bundle's copies of the document's own schemas, in place. */\nexport function removeBundledMappingCopies(\n  bundled: unknown,\n  keysBefore: ReadonlySet<string>,\n): void {\n  const schemas = componentSchemasOf(bundled);\n  const copies = schemas === undefined ? new Map<string, string>() : copiesIn(schemas, keysBefore);\n  if (copies.size === 0) {\n    return;\n  }\n  for (const mapping of findMappings(bundled)) {\n    for (const [name, value] of Object.entries(mapping)) {\n      const original = typeof value === \"string\" ? copies.get(value) : undefined;\n      if (original !== undefined) {\n        mapping[name] = original;\n      }\n    }\n  }\n  for (const { node } of findRefHolders(bundled)) {\n    node.$ref = copies.get(node.$ref) ?? node.$ref;\n  }\n}\n"],"names":["componentSchemasOf","SCHEMAS_POINTER","childPointer","findMappings","findRefHolders"],"mappings":";;;;;;AAeO,SAAS,aAAa,QAAA,EAAwC;AACnE,EAAA,OAAO,IAAI,IAAI,MAAA,CAAO,IAAA,CAAKA,oCAAmB,QAAQ,CAAA,IAAK,EAAE,CAAC,CAAA;AAChE;AAGA,SAAS,QAAA,CAAS,SAA2B,UAAA,EAAsD;AACjG,EAAA,MAAM,SAAA,uBAAgB,GAAA,EAAqB;AAC3C,EAAA,KAAA,MAAW,OAAO,UAAA,EAAY;AAC5B,IAAA,IAAI,MAAA,CAAO,MAAA,CAAO,OAAA,EAAS,GAAG,CAAA,IAAK,CAAC,SAAA,CAAU,GAAA,CAAI,OAAA,CAAQ,GAAG,CAAC,CAAA,EAAG;AAC/D,MAAA,SAAA,CAAU,GAAA,CAAI,OAAA,CAAQ,GAAG,CAAA,EAAG,GAAG,CAAA;AAAA,IACjC;AAAA,EACF;AACA,EAAA,MAAM,MAAA,uBAAa,GAAA,EAAoB;AACvC,EAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,OAAO,CAAA,EAAG;AAClD,IAAA,MAAM,QAAA,GAAW,WAAW,GAAA,CAAI,GAAG,IAAI,MAAA,GAAY,SAAA,CAAU,IAAI,KAAK,CAAA;AACtE,IAAA,IAAI,aAAa,MAAA,EAAW;AAC1B,MAAA,MAAA,CAAO,GAAA,CAAI,GAAGC,gCAAe,CAAA,CAAA,EAAI,GAAG,CAAA,CAAA,EAAIC,wBAAA,CAAaD,gCAAA,EAAiB,QAAQ,CAAC,CAAA;AAC/E,MAAA,OAAO,QAAQ,GAAG,CAAA;AAAA,IACpB;AAAA,EACF;AACA,EAAA,OAAO,MAAA;AACT;AAGO,SAAS,0BAAA,CACd,SACA,UAAA,EACM;AACN,EAAA,MAAM,OAAA,GAAUD,oCAAmB,OAAO,CAAA;AAC1C,EAAA,MAAM,MAAA,GAAS,YAAY,MAAA,mBAAY,IAAI,KAAoB,GAAI,QAAA,CAAS,SAAS,UAAU,CAAA;AAC/F,EAAA,IAAI,MAAA,CAAO,SAAS,CAAA,EAAG;AACrB,IAAA;AAAA,EACF;AACA,EAAA,KAAA,MAAW,OAAA,IAAWG,uBAAA,CAAa,OAAO,CAAA,EAAG;AAC3C,IAAA,KAAA,MAAW,CAAC,IAAA,EAAM,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,OAAO,CAAA,EAAG;AACnD,MAAA,MAAM,WAAW,OAAO,KAAA,KAAU,WAAW,MAAA,CAAO,GAAA,CAAI,KAAK,CAAA,GAAI,MAAA;AACjE,MAAA,IAAI,aAAa,MAAA,EAAW;AAC1B,QAAA,OAAA,CAAQ,IAAI,CAAA,GAAI,QAAA;AAAA,MAClB;AAAA,IACF;AAAA,EACF;AACA,EAAA,KAAA,MAAW,EAAE,IAAA,EAAK,IAAKC,yBAAA,CAAe,OAAO,CAAA,EAAG;AAC9C,IAAA,IAAA,CAAK,OAAO,MAAA,CAAO,GAAA,CAAI,IAAA,CAAK,IAAI,KAAK,IAAA,CAAK,IAAA;AAAA,EAC5C;AACF;;;"}

package/dist/adapters/redocly-loader/bundled-mapping-copies.mjs

@@ -1,17 +1,9 @@
-import { childPointer, ROOT_POINTER } from '../../domain/openapi/json-pointer.mjs';
-import { findRefHolders } from './ref-holders.mjs';
+import { childPointer } from '../../domain/openapi/json-pointer.mjs';
+import { componentSchemasOf, SCHEMAS_POINTER } from './component-schemas.mjs';
+import { findMappings, findRefHolders } from './ref-holders.mjs';
 
-const SCHEMAS_POINTER = childPointer(childPointer(ROOT_POINTER, "components"), "schemas");
-function isContainer(value) {
-  return typeof value === "object" && value !== null;
-}
-function schemasOf(document) {
-  const components = isContainer(document) ? document.components : void 0;
-  const schemas = isContainer(components) ? components.schemas : void 0;
-  return isContainer(schemas) ? schemas : void 0;
-}
 function schemaKeysOf(document) {
-  return new Set(Object.keys(schemasOf(document) ?? {}));
+  return new Set(Object.keys(componentSchemasOf(document) ?? {}));
 }
 function copiesIn(schemas, keysBefore) {
   const originals = /* @__PURE__ */ new Map();
@@ -30,32 +22,13 @@ function copiesIn(schemas, keysBefore) {
   }
   return copies;
 }
-function mappingsOf(document) {
-  const mappings = [];
-  const visited = /* @__PURE__ */ new WeakSet();
-  const pending = [document];
-  for (let next = pending.pop(); next !== void 0; next = pending.pop()) {
-    if (!isContainer(next) || visited.has(next)) {
-      continue;
-    }
-    visited.add(next);
-    const mapping = isContainer(next.discriminator) ? next.discriminator.mapping : void 0;
-    if (isContainer(mapping)) {
-      mappings.push(mapping);
-    }
-    for (const child of Object.values(next)) {
-      pending.push(child);
-    }
-  }
-  return mappings;
-}
 function removeBundledMappingCopies(bundled, keysBefore) {
-  const schemas = schemasOf(bundled);
+  const schemas = componentSchemasOf(bundled);
   const copies = schemas === void 0 ? /* @__PURE__ */ new Map() : copiesIn(schemas, keysBefore);
   if (copies.size === 0) {
     return;
   }
-  for (const mapping of mappingsOf(bundled)) {
+  for (const mapping of findMappings(bundled)) {
     for (const [name, value] of Object.entries(mapping)) {
       const original = typeof value === "string" ? copies.get(value) : void 0;
       if (original !== void 0) {

package/dist/adapters/redocly-loader/bundled-mapping-copies.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"bundled-mapping-copies.mjs","sources":["../../../src/adapters/redocly-loader/bundled-mapping-copies.ts"],"sourcesContent":["import { childPointer, ROOT_POINTER } from \"../../domain/openapi/json-pointer.js\";\nimport { findRefHolders } from \"./ref-holders.js\";\n\n/**\n * Redocly 1.x bundles every discriminator `mapping` value as if it were an external `$ref`: it\n * stores the target schema under the raw last segment of the pointer. For a local schema whose\n * key needs an escape (`a~b`, written `a~0b`; `c/d`, written `c~1d`) that segment is no existing\n * key, so the bundle added `a~0b` and `c~1d` to `components.schemas` as copies of `a~b` and\n * `c/d`, and the generator wrote each type twice. A copy is the very object of the schema it\n * copies, so a key the bundle added whose value is the value of a key the document had is removed,\n * and the mapping values and `$ref`s that name it point at the original.\n */\n\ntype Schemas = Record<string, unknown>;\n\nconst SCHEMAS_POINTER = childPointer(childPointer(ROOT_POINTER, \"components\"), \"schemas\");\n\nfunction isContainer(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction schemasOf(document: unknown): Schemas | undefined {\n  const components = isContainer(document) ? document.components : undefined;\n  const schemas = isContainer(components) ? components.schemas : undefined;\n  return isContainer(schemas) ? schemas : undefined;\n}\n\n/** The keys of `components.schemas` before bundling: the bundle edits the document in place. */\nexport function schemaKeysOf(document: unknown): ReadonlySet<string> {\n  return new Set(Object.keys(schemasOf(document) ?? {}));\n}\n\n/** Each key the bundle added as a copy, with the pointer of the schema it copies. */\nfunction copiesIn(schemas: Schemas, keysBefore: ReadonlySet<string>): Map<string, string> {\n  const originals = new Map<unknown, string>();\n  for (const key of keysBefore) {\n    if (Object.hasOwn(schemas, key) && !originals.has(schemas[key])) {\n      originals.set(schemas[key], key);\n    }\n  }\n  const copies = new Map<string, string>();\n  for (const [key, value] of Object.entries(schemas)) {\n    const original = keysBefore.has(key) ? undefined : originals.get(value);\n    if (original !== undefined) {\n      copies.set(`${SCHEMAS_POINTER}/${key}`, childPointer(SCHEMAS_POINTER, original));\n      delete schemas[key];\n    }\n  }\n  return copies;\n}\n\n/** Every `discriminator.mapping` object of the document; the walk has its own stack. */\nfunction mappingsOf(document: unknown): Record<string, unknown>[] {\n  const mappings: Record<string, unknown>[] = [];\n  const visited = new WeakSet<object>();\n  const pending: unknown[] = [document];\n  for (let next = pending.pop(); next !== undefined; next = pending.pop()) {\n    if (!isContainer(next) || visited.has(next)) {\n      continue;\n    }\n    visited.add(next);\n    const mapping = isContainer(next.discriminator) ? next.discriminator.mapping : undefined;\n    if (isContainer(mapping)) {\n      mappings.push(mapping);\n    }\n    // One push per child: spreading an array of millions of children overflows the stack.\n    for (const child of Object.values(next)) {\n      pending.push(child);\n    }\n  }\n  return mappings;\n}\n\n/** Remove the bundle's copies of the document's own schemas, in place. */\nexport function removeBundledMappingCopies(\n  bundled: unknown,\n  keysBefore: ReadonlySet<string>,\n): void {\n  const schemas = schemasOf(bundled);\n  const copies = schemas === undefined ? new Map<string, string>() : copiesIn(schemas, keysBefore);\n  if (copies.size === 0) {\n    return;\n  }\n  for (const mapping of mappingsOf(bundled)) {\n    for (const [name, value] of Object.entries(mapping)) {\n      const original = typeof value === \"string\" ? copies.get(value) : undefined;\n      if (original !== undefined) {\n        mapping[name] = original;\n      }\n    }\n  }\n  for (const { node } of findRefHolders(bundled)) {\n    node.$ref = copies.get(node.$ref) ?? node.$ref;\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"bundled-mapping-copies.mjs","sources":["../../../src/adapters/redocly-loader/bundled-mapping-copies.ts"],"sourcesContent":["import { childPointer } from \"../../domain/openapi/json-pointer.js\";\nimport { type ComponentSchemas, componentSchemasOf, SCHEMAS_POINTER } from \"./component-schemas.js\";\nimport { findMappings, findRefHolders } from \"./ref-holders.js\";\n\n/**\n * Redocly 1.x bundles every discriminator `mapping` value as if it were an external `$ref`: it\n * stores the target schema under the raw last segment of the pointer. For a local schema whose\n * key needs an escape (`a~b`, written `a~0b`; `c/d`, written `c~1d`) that segment is no existing\n * key, so the bundle added `a~0b` and `c~1d` to `components.schemas` as copies of `a~b` and\n * `c/d`, and the generator wrote each type twice. A copy is the very object of the schema it\n * copies, so a key the bundle added whose value is the value of a key the document had is removed,\n * and the mapping values and `$ref`s that name it point at the original.\n */\n\n/** The keys of `components.schemas` before bundling: the bundle edits the document in place. */\nexport function schemaKeysOf(document: unknown): ReadonlySet<string> {\n  return new Set(Object.keys(componentSchemasOf(document) ?? {}));\n}\n\n/** Each key the bundle added as a copy, with the pointer of the schema it copies. */\nfunction copiesIn(schemas: ComponentSchemas, keysBefore: ReadonlySet<string>): Map<string, string> {\n  const originals = new Map<unknown, string>();\n  for (const key of keysBefore) {\n    if (Object.hasOwn(schemas, key) && !originals.has(schemas[key])) {\n      originals.set(schemas[key], key);\n    }\n  }\n  const copies = new Map<string, string>();\n  for (const [key, value] of Object.entries(schemas)) {\n    const original = keysBefore.has(key) ? undefined : originals.get(value);\n    if (original !== undefined) {\n      copies.set(`${SCHEMAS_POINTER}/${key}`, childPointer(SCHEMAS_POINTER, original));\n      delete schemas[key];\n    }\n  }\n  return copies;\n}\n\n/** Remove the bundle's copies of the document's own schemas, in place. */\nexport function removeBundledMappingCopies(\n  bundled: unknown,\n  keysBefore: ReadonlySet<string>,\n): void {\n  const schemas = componentSchemasOf(bundled);\n  const copies = schemas === undefined ? new Map<string, string>() : copiesIn(schemas, keysBefore);\n  if (copies.size === 0) {\n    return;\n  }\n  for (const mapping of findMappings(bundled)) {\n    for (const [name, value] of Object.entries(mapping)) {\n      const original = typeof value === \"string\" ? copies.get(value) : undefined;\n      if (original !== undefined) {\n        mapping[name] = original;\n      }\n    }\n  }\n  for (const { node } of findRefHolders(bundled)) {\n    node.$ref = copies.get(node.$ref) ?? node.$ref;\n  }\n}\n"],"names":[],"mappings":";;;;AAeO,SAAS,aAAa,QAAA,EAAwC;AACnE,EAAA,OAAO,IAAI,IAAI,MAAA,CAAO,IAAA,CAAK,mBAAmB,QAAQ,CAAA,IAAK,EAAE,CAAC,CAAA;AAChE;AAGA,SAAS,QAAA,CAAS,SAA2B,UAAA,EAAsD;AACjG,EAAA,MAAM,SAAA,uBAAgB,GAAA,EAAqB;AAC3C,EAAA,KAAA,MAAW,OAAO,UAAA,EAAY;AAC5B,IAAA,IAAI,MAAA,CAAO,MAAA,CAAO,OAAA,EAAS,GAAG,CAAA,IAAK,CAAC,SAAA,CAAU,GAAA,CAAI,OAAA,CAAQ,GAAG,CAAC,CAAA,EAAG;AAC/D,MAAA,SAAA,CAAU,GAAA,CAAI,OAAA,CAAQ,GAAG,CAAA,EAAG,GAAG,CAAA;AAAA,IACjC;AAAA,EACF;AACA,EAAA,MAAM,MAAA,uBAAa,GAAA,EAAoB;AACvC,EAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,OAAO,CAAA,EAAG;AAClD,IAAA,MAAM,QAAA,GAAW,WAAW,GAAA,CAAI,GAAG,IAAI,MAAA,GAAY,SAAA,CAAU,IAAI,KAAK,CAAA;AACtE,IAAA,IAAI,aAAa,MAAA,EAAW;AAC1B,MAAA,MAAA,CAAO,GAAA,CAAI,GAAG,eAAe,CAAA,CAAA,EAAI,GAAG,CAAA,CAAA,EAAI,YAAA,CAAa,eAAA,EAAiB,QAAQ,CAAC,CAAA;AAC/E,MAAA,OAAO,QAAQ,GAAG,CAAA;AAAA,IACpB;AAAA,EACF;AACA,EAAA,OAAO,MAAA;AACT;AAGO,SAAS,0BAAA,CACd,SACA,UAAA,EACM;AACN,EAAA,MAAM,OAAA,GAAU,mBAAmB,OAAO,CAAA;AAC1C,EAAA,MAAM,MAAA,GAAS,YAAY,MAAA,mBAAY,IAAI,KAAoB,GAAI,QAAA,CAAS,SAAS,UAAU,CAAA;AAC/F,EAAA,IAAI,MAAA,CAAO,SAAS,CAAA,EAAG;AACrB,IAAA;AAAA,EACF;AACA,EAAA,KAAA,MAAW,OAAA,IAAW,YAAA,CAAa,OAAO,CAAA,EAAG;AAC3C,IAAA,KAAA,MAAW,CAAC,IAAA,EAAM,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,OAAO,CAAA,EAAG;AACnD,MAAA,MAAM,WAAW,OAAO,KAAA,KAAU,WAAW,MAAA,CAAO,GAAA,CAAI,KAAK,CAAA,GAAI,MAAA;AACjE,MAAA,IAAI,aAAa,MAAA,EAAW;AAC1B,QAAA,OAAA,CAAQ,IAAI,CAAA,GAAI,QAAA;AAAA,MAClB;AAAA,IACF;AAAA,EACF;AACA,EAAA,KAAA,MAAW,EAAE,IAAA,EAAK,IAAK,cAAA,CAAe,OAAO,CAAA,EAAG;AAC9C,IAAA,IAAA,CAAK,OAAO,MAAA,CAAO,GAAA,CAAI,IAAA,CAAK,IAAI,KAAK,IAAA,CAAK,IAAA;AAAA,EAC5C;AACF;;"}

package/dist/adapters/redocly-loader/component-schemas.cjs

@@ -0,0 +1,17 @@
+'use strict';
+
+const jsonPointer = require('../../domain/openapi/json-pointer.cjs');
+
+const SCHEMAS_POINTER = jsonPointer.childPointer(jsonPointer.childPointer(jsonPointer.ROOT_POINTER, "components"), "schemas");
+function isContainer(value) {
+  return typeof value === "object" && value !== null;
+}
+function componentSchemasOf(document) {
+  const components = isContainer(document) ? document.components : void 0;
+  const schemas = isContainer(components) ? components.schemas : void 0;
+  return isContainer(schemas) ? schemas : void 0;
+}
+
+exports.SCHEMAS_POINTER = SCHEMAS_POINTER;
+exports.componentSchemasOf = componentSchemasOf;
+//# sourceMappingURL=component-schemas.cjs.map

package/dist/adapters/redocly-loader/component-schemas.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-schemas.cjs","sources":["../../../src/adapters/redocly-loader/component-schemas.ts"],"sourcesContent":["import { childPointer, ROOT_POINTER } from \"../../domain/openapi/json-pointer.js\";\n\n/** `components.schemas` of a parsed document, which the loader repairs in place. */\n\nexport type ComponentSchemas = Record<string, unknown>;\n\n/** `#/components/schemas`. */\nexport const SCHEMAS_POINTER = childPointer(childPointer(ROOT_POINTER, \"components\"), \"schemas\");\n\nfunction isContainer(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\n/** The `components.schemas` object of a document, when it has one. */\nexport function componentSchemasOf(document: unknown): ComponentSchemas | undefined {\n  const components = isContainer(document) ? document.components : undefined;\n  const schemas = isContainer(components) ? components.schemas : undefined;\n  return isContainer(schemas) ? schemas : undefined;\n}\n"],"names":["childPointer","ROOT_POINTER"],"mappings":";;;;AAOO,MAAM,kBAAkBA,wBAAA,CAAaA,wBAAA,CAAaC,wBAAA,EAAc,YAAY,GAAG,SAAS;AAE/F,SAAS,YAAY,KAAA,EAAkD;AACrE,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,IAAA;AAChD;AAGO,SAAS,mBAAmB,QAAA,EAAiD;AAClF,EAAA,MAAM,UAAA,GAAa,WAAA,CAAY,QAAQ,CAAA,GAAI,SAAS,UAAA,GAAa,MAAA;AACjE,EAAA,MAAM,OAAA,GAAU,WAAA,CAAY,UAAU,CAAA,GAAI,WAAW,OAAA,GAAU,MAAA;AAC/D,EAAA,OAAO,WAAA,CAAY,OAAO,CAAA,GAAI,OAAA,GAAU,MAAA;AAC1C;;;"}