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

package/dist/index.d.cts

@@ -250,9 +250,10 @@ type FooterEntry = IrDeclaration | ts.Node;
 /**
  * Opt-in fixes of the output of valid schemas (ADR-021). Each one changes only the cases it names;
  * without any, the output is the same as openapi-typescript 7.13 gives. In 2.0 they become the
- * default.
+ * default. The object names the fixes for this package's code; the public API is the `OutputFix`
+ * union and the `OUTPUT_FIXES` list (ADR-021, amendment 1).
  */
-declare const OutputFix: {
+declare const FIX: {
     /** An `allOf` `$ref` to a discriminated union is the union, without `Omit` or a schema name. */
     readonly ALLOF_DISCRIMINATED_UNION: "allof-discriminated-union";
     /** An `allOf` member with only `required` makes those properties of the others required. */
@@ -279,6 +280,8 @@ declare const OutputFix: {
     readonly EXPLODED_QUERY_OBJECTS: "exploded-query-objects";
     /** `--enum` declares an enum that lists `null` without it, and the type adds `| null`. */
     readonly NULLABLE_ENUMS: "nullable-enums";
+    /** A parameter with `content` instead of `schema` is typed by the schema of its media type. */
+    readonly PARAMETER_CONTENT: "parameter-content";
     /** `--path-params-as-types` gives each `{name}` its placeholder, `{number}` included. */
     readonly PATH_PARAM_TYPE_NAMES: "path-param-type-names";
     /** A `prefixItems` tuple is open unless `items` or `unevaluatedItems` closes it (2020-12). */
@@ -290,18 +293,24 @@ declare const OutputFix: {
      * points at, also where the original type compiles through an index signature.
      */
     readonly REF_POINTERS: "ref-pointers";
+    /**
+     * OpenAPI 3.1 and 3.2: keywords next to a `$ref` (`required`, `properties`) apply too, so the
+     * type is the reference intersected with them. OpenAPI 3.0 ignores them, as its spec says.
+     */
+    readonly REF_SIBLINGS: "ref-siblings";
     /** Schemas of one root type name without the prefix each get an alias, the earlier numbered. */
     readonly ROOT_TYPE_NUMBERING: "root-type-numbering";
     /** `unevaluatedProperties` types the keys no other keyword declares (an index signature). */
     readonly UNEVALUATED_PROPERTIES: "unevaluated-properties";
 };
-type OutputFix = (typeof OutputFix)[keyof typeof OutputFix];
+/** The name of one opt-in output fix. */
+type OutputFix = (typeof FIX)[keyof typeof FIX];
 /** Every fix of this version, in the order the docs list them. */
 declare const OUTPUT_FIXES: readonly OutputFix[];
 /** The name that turns on every fix of the installed version. */
-declare const ALL_OUTPUT_FIXES = "all";
-/** A name the `fix` option accepts: one fix, or `all`. */
-type OutputFixName = OutputFix | typeof ALL_OUTPUT_FIXES;
+declare const ALL_FIXES = "all";
+/** A name the `fix` option accepts: one fix, or `"all"`. */
+type OutputFixName = OutputFix | typeof ALL_FIXES;
 
 interface Extensable {
     [key: `x-${string}`]: any;
@@ -1296,7 +1305,7 @@ interface OpenAPITSBaseOptions {
      * still fail the run.
      */
     lint?: boolean;
-    /** (optional) Should logging be suppressed? (necessary for STDOUT) */
+    /** Hide warnings (default: false). Every line of the logger goes to stderr, never to stdout. */
     silent?: boolean;
     /** Accepted for compatibility with openapi-typescript; not read. */
     version?: number;
@@ -1451,6 +1460,20 @@ interface TransformNodeOptions {
     ctx: GlobalContext;
 }
 
+/**
+ * Deprecations of what 2.0 removes. Each one is a Node.js `DeprecationWarning` with one of these
+ * codes, so `--no-deprecation`, `--throw-deprecation`, `--trace-deprecation` and
+ * `process.on("warning")` work on it as on Node's own (ADR-004, amendment of 2026-11-08).
+ */
+/** Every deprecation code. */
+declare const DEPRECATION_CODES: {
+    readonly OPENAPI_TYPESAFE_DEP_STRING_TO_AST: "OPENAPI_TYPESAFE_DEP_STRING_TO_AST";
+    readonly OPENAPI_TYPESAFE_DEP_TS_TRANSFORM: "OPENAPI_TYPESAFE_DEP_TS_TRANSFORM";
+    readonly OPENAPI_TYPESAFE_DEP_TS_POST_TRANSFORM: "OPENAPI_TYPESAFE_DEP_TS_POST_TRANSFORM";
+    readonly OPENAPI_TYPESAFE_DEP_TS_TRANSFORM_PROPERTY: "OPENAPI_TYPESAFE_DEP_TS_TRANSFORM_PROPERTY";
+};
+type DeprecationCode = (typeof DEPRECATION_CODES)[keyof typeof DEPRECATION_CODES];
+
 /** The debug groups of the original `DEBUG=openapi-ts:<group>` output. */
 type DebugGroup = "redoc" | "lint" | "bundle" | "ts";
 /**
@@ -1483,7 +1506,10 @@ declare function openapiTS(source: SchemaSource, options?: GeneratorOptions): Pr
  * `message` is English text for people; programs and the CLI decide by `code`. A bug (a broken
  * invariant) is a plain `Error`, not one of these.
  */
-/** Every error code. The set is closed: a new code must be handled by the CLI exit-code table. */
+/**
+ * Every error code. A minor release may add codes (ADR-034); each one needs a row in the CLI's
+ * exit-code table, which the compiler checks.
+ */
 declare const ERROR_CODES: {
     readonly SCHEMA_SOURCE_EMPTY: "SCHEMA_SOURCE_EMPTY";
     readonly SCHEMA_SOURCE_INVALID: "SCHEMA_SOURCE_INVALID";
@@ -1508,23 +1534,33 @@ declare const ERROR_CODES: {
     readonly CLI_CONFIG_OUTPUT_MISSING: "CLI_CONFIG_OUTPUT_MISSING";
     readonly CLI_CHECK_OUTPUT_MISSING: "CLI_CHECK_OUTPUT_MISSING";
     readonly CLI_INPUT_MISSING: "CLI_INPUT_MISSING";
+    readonly CLI_OUTPUT_IS_INPUT: "CLI_OUTPUT_IS_INPUT";
+    readonly CLI_OUTPUT_DUPLICATE: "CLI_OUTPUT_DUPLICATE";
+    readonly CLI_OUTPUT_INVALID: "CLI_OUTPUT_INVALID";
+    readonly CLI_LOCATION_INVALID: "CLI_LOCATION_INVALID";
     readonly OUTPUT_STALE: "OUTPUT_STALE";
     readonly OUTPUT_READ_FAILED: "OUTPUT_READ_FAILED";
     readonly OUTPUT_WRITE_FAILED: "OUTPUT_WRITE_FAILED";
 };
 type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
-/** Structured, JSON-serializable facts about a failure, for programs and logs. */
+/**
+ * Structured, JSON-serializable facts about a failure, for programs and logs. Only the keys that
+ * docs/node.md (Errors) lists are stable (ADR-034, amendment of 2026-11-08).
+ */
 type ErrorDetails = Readonly<Record<string, unknown>>;
 interface OpenAPITypesafeErrorInit {
     readonly code: ErrorCode;
     readonly message: string;
     readonly details?: ErrorDetails;
-    /** The lower-level error this one reports, if any (kept as the standard `cause`). */
+    /**
+     * The lower-level error this one reports, if any (kept as the standard `cause`; a copy with URL
+     * secrets hidden when its chain names one, see cause-secrets.ts).
+     */
     readonly cause?: unknown;
 }
 /**
  * The base of every expected failure; check `code`, not the class or the message. The message
- * never shows the user info of a URL (`url-credentials.ts`).
+ * and the `cause` chain never show the user info or the query of a URL (`url-secrets.ts`).
  */
 declare class OpenAPITypesafeError extends Error {
     readonly code: ErrorCode;
@@ -1751,7 +1787,11 @@ declare function createDiscriminatorProperty(discriminator: DiscriminatorObject,
     path: string;
     readonly?: boolean;
 }): IrPropertySignature;
-/** Create a $ref pointer (even from other $refs) */
+/**
+ * Create a $ref pointer (even from other $refs). A part that contains `#/` is read as a `$ref`
+ * and contributes its decoded segments, so it throws URIError for a malformed percent escape; any
+ * other part is one segment. To append raw document keys, escape each one instead.
+ */
 declare function createRef(parts: (number | string | undefined | null)[]): string;
 /**
  * Print debug message (cribbed from the `debug` package, but without all the bells & whistles
@@ -1787,15 +1827,13 @@ declare function walk(obj: unknown, cb: (value: Record<string, unknown>, path: (
  */
 declare function warn(msg: string, silent?: boolean): void;
 
-/** Node's deprecation code for `stringToAST`, so users can filter or trace the warning. */
-declare const STRING_TO_AST_DEPRECATION_CODE = "OPENAPI_TYPESAFE_DEP_STRING_TO_AST";
 /**
  * Convert an arbitrary string to TS (assuming it’s valid). Parses with the TypeScript bridge, so
- * it needs TypeScript 6 or earlier (or `@typescript/typescript6`). Node's `util.deprecate` warns
- * on the first call only.
+ * it needs TypeScript 6 or earlier (or `@typescript/typescript6`). Emits a Node.js
+ * `DeprecationWarning` (`OPENAPI_TYPESAFE_DEP_STRING_TO_AST`) on the first call only.
  * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 7). Use type text in IR callbacks.
  */
-declare const stringToAST: (source: string) => unknown[];
+declare function stringToAST(source: string): unknown[];
 
 /**
  * The whole document as IR declarations (ENGINEERING_PLAN 6.1–6.2); `openapiTS` returns the same
@@ -1816,7 +1854,6 @@ declare const WARNING_CODES: {
     readonly DISCRIMINATOR_VALUE_NOT_ALLOWED: "DISCRIMINATOR_VALUE_NOT_ALLOWED";
     readonly ENUM_VALUES_EXCLUDED: "ENUM_VALUES_EXCLUDED";
     readonly FIX_NEEDS_OPTION: "FIX_NEEDS_OPTION";
-    readonly LEGACY_CALLBACK_DEPRECATED: "LEGACY_CALLBACK_DEPRECATED";
     readonly LINT_PROBLEM: "LINT_PROBLEM";
     readonly PATH_TEMPLATES_IDENTICAL: "PATH_TEMPLATES_IDENTICAL";
     readonly QUERYSTRING_NEXT_TO_QUERY: "QUERYSTRING_NEXT_TO_QUERY";
@@ -1944,5 +1981,5 @@ declare function transformSchemaObject(schemaObject: SchemaObject | ReferenceObj
 /** Transform SchemaObjects without the `postTransform` callback at the top level. */
 declare function transformSchemaObjectWithComposition(schemaObject: SchemaObject | ReferenceObject, options: TransformNodeOptions, fromAdditionalProperties?: boolean): IrType;
 
-export { ALL_OUTPUT_FIXES, BOOLEAN, COMMENT_HEADER, ERROR_CODES, FALSE, JS_ENUM_INVALID_CHARS_RE, JS_PROPERTY_INDEX_INVALID_CHARS_RE, JS_PROPERTY_INDEX_RE, NEVER, NULL, NUMBER, OUTPUT_FIXES, OpenAPITypesafeError, OutputFix, QUESTION_TOKEN, SPECIAL_CHARACTER_MAP, STRING, STRING_TO_AST_DEPRECATION_CODE, TRUE, UNDEFINED, UNKNOWN, WARNING_CODES, addJSDocComment, astToString, c, createDiscriminatorProperty, createRef, debug, openapiTS as default, enumCache, error, formatTime, getEntries, injectOperationObject, isOpenAPITypesafeError, oapiRef, resolveRef, scanDiscriminators, stringToAST, transformComponentsObject, transformHeaderObject, transformMediaTypeObject, transformOperationObject, transformParameterObject, transformPathItemObject, transformPathsObject, transformRequestBodyObject, transformResponseObject, transformResponsesObject, transformSchema, transformSchemaObject, transformSchemaObjectWithComposition, tsArrayLiteralExpression, tsDedupe, tsEnum, tsEnumMember, tsIntersection, tsIsPrimitive, tsLiteral, tsModifiers, tsNullable, tsOmit, tsPropertyIndex, tsReadonlyArray, tsRecord, tsUnion, tsWithRequired, walk, warn };
-export type { $defs, AnnotatedSchemaObject, ArraySubtype, AstToStringInput, AstToStringOptions, BooleanSubtype, CallbackObject, ComponentsObject, ContactObject, DiscriminatorObject, EncodingObject, ErrorCode, ErrorDetails, ExampleObject, Extensable, ExternalDocumentationObject, FooterEntry, GeneratorOptions, GlobalContext, HeaderObject, InfoObject, IntegerSubtype, IrArrayType, IrBooleanLiteralType, IrCallbackOptions, IrCallbackType, IrComment, IrConstArrayDeclaration, IrDeclaration, IrEnumDeclaration, IrEnumMember, IrIndexSignature, IrIndexedAccessType, IrInterfaceDeclaration, IrIntersectionType, IrKeyword, IrKeywordType, IrMember, IrNumberLiteralType, IrObjectType, IrPostTransform, IrPropertyName, IrPropertySignature, IrRawDeclaration, IrRawType, IrReadonlyType, IrReferenceType, IrStringEncoding, IrStringLiteralType, IrTransform, IrTransformObject, IrTransformProperty, IrTupleElement, IrTupleType, IrType, IrTypeAliasDeclaration, IrUnionType, LegacyCallbackName, LegacyCallbackOptions, LicenseObject, LinkObject, MediaTypeObject, Method, NullSubtype, NumberSubtype, OAuthFlowObject, OAuthFlowsObject, OapiRefOptions, ObjectSubtype, OpenAPI3, OpenAPITSBaseOptions, OpenAPITSIrOptions, OpenAPITSOptions, OperationObject, OutputFixName, ParameterObject, PathItemObject, PathsObject, ReferenceObject, RequestBodyObject, ResolveRefOptions, ResponseObject, ResponsesObject, SchemaObject, SchemaSource, SecurityRequirementObject, SecuritySchemeObject, ServerObject, ServerVariableObject, StringSubtype, TagObject, TransformNodeOptions, TransformObject, TypeInput, WarningCode, WebhooksObject, XMLObject };
+export { BOOLEAN, COMMENT_HEADER, DEPRECATION_CODES, ERROR_CODES, FALSE, JS_ENUM_INVALID_CHARS_RE, JS_PROPERTY_INDEX_INVALID_CHARS_RE, JS_PROPERTY_INDEX_RE, NEVER, NULL, NUMBER, OUTPUT_FIXES, OpenAPITypesafeError, QUESTION_TOKEN, SPECIAL_CHARACTER_MAP, STRING, TRUE, UNDEFINED, UNKNOWN, WARNING_CODES, addJSDocComment, astToString, c, createDiscriminatorProperty, createRef, debug, openapiTS as default, enumCache, error, formatTime, getEntries, injectOperationObject, isOpenAPITypesafeError, oapiRef, resolveRef, scanDiscriminators, stringToAST, transformComponentsObject, transformHeaderObject, transformMediaTypeObject, transformOperationObject, transformParameterObject, transformPathItemObject, transformPathsObject, transformRequestBodyObject, transformResponseObject, transformResponsesObject, transformSchema, transformSchemaObject, transformSchemaObjectWithComposition, tsArrayLiteralExpression, tsDedupe, tsEnum, tsEnumMember, tsIntersection, tsIsPrimitive, tsLiteral, tsModifiers, tsNullable, tsOmit, tsPropertyIndex, tsReadonlyArray, tsRecord, tsUnion, tsWithRequired, walk, warn };
+export type { $defs, AnnotatedSchemaObject, ArraySubtype, AstToStringInput, AstToStringOptions, BooleanSubtype, CallbackObject, ComponentsObject, ContactObject, DeprecationCode, DiscriminatorObject, EncodingObject, ErrorCode, ErrorDetails, ExampleObject, Extensable, ExternalDocumentationObject, FooterEntry, GeneratorOptions, GlobalContext, HeaderObject, InfoObject, IntegerSubtype, IrArrayType, IrBooleanLiteralType, IrCallbackOptions, IrCallbackType, IrComment, IrConstArrayDeclaration, IrDeclaration, IrEnumDeclaration, IrEnumMember, IrIndexSignature, IrIndexedAccessType, IrInterfaceDeclaration, IrIntersectionType, IrKeyword, IrKeywordType, IrMember, IrNumberLiteralType, IrObjectType, IrPostTransform, IrPropertyName, IrPropertySignature, IrRawDeclaration, IrRawType, IrReadonlyType, IrReferenceType, IrStringEncoding, IrStringLiteralType, IrTransform, IrTransformObject, IrTransformProperty, IrTupleElement, IrTupleType, IrType, IrTypeAliasDeclaration, IrUnionType, LegacyCallbackName, LegacyCallbackOptions, LicenseObject, LinkObject, MediaTypeObject, Method, NullSubtype, NumberSubtype, OAuthFlowObject, OAuthFlowsObject, OapiRefOptions, ObjectSubtype, OpenAPI3, OpenAPITSBaseOptions, OpenAPITSIrOptions, OpenAPITSOptions, OperationObject, OutputFix, OutputFixName, ParameterObject, PathItemObject, PathsObject, ReferenceObject, RequestBodyObject, ResolveRefOptions, ResponseObject, ResponsesObject, SchemaObject, SchemaSource, SecurityRequirementObject, SecuritySchemeObject, ServerObject, ServerVariableObject, StringSubtype, TagObject, TransformNodeOptions, TransformObject, TypeInput, WarningCode, WebhooksObject, XMLObject };

package/dist/index.d.mts

@@ -250,9 +250,10 @@ type FooterEntry = IrDeclaration | ts.Node;
 /**
  * Opt-in fixes of the output of valid schemas (ADR-021). Each one changes only the cases it names;
  * without any, the output is the same as openapi-typescript 7.13 gives. In 2.0 they become the
- * default.
+ * default. The object names the fixes for this package's code; the public API is the `OutputFix`
+ * union and the `OUTPUT_FIXES` list (ADR-021, amendment 1).
  */
-declare const OutputFix: {
+declare const FIX: {
     /** An `allOf` `$ref` to a discriminated union is the union, without `Omit` or a schema name. */
     readonly ALLOF_DISCRIMINATED_UNION: "allof-discriminated-union";
     /** An `allOf` member with only `required` makes those properties of the others required. */
@@ -279,6 +280,8 @@ declare const OutputFix: {
     readonly EXPLODED_QUERY_OBJECTS: "exploded-query-objects";
     /** `--enum` declares an enum that lists `null` without it, and the type adds `| null`. */
     readonly NULLABLE_ENUMS: "nullable-enums";
+    /** A parameter with `content` instead of `schema` is typed by the schema of its media type. */
+    readonly PARAMETER_CONTENT: "parameter-content";
     /** `--path-params-as-types` gives each `{name}` its placeholder, `{number}` included. */
     readonly PATH_PARAM_TYPE_NAMES: "path-param-type-names";
     /** A `prefixItems` tuple is open unless `items` or `unevaluatedItems` closes it (2020-12). */
@@ -290,18 +293,24 @@ declare const OutputFix: {
      * points at, also where the original type compiles through an index signature.
      */
     readonly REF_POINTERS: "ref-pointers";
+    /**
+     * OpenAPI 3.1 and 3.2: keywords next to a `$ref` (`required`, `properties`) apply too, so the
+     * type is the reference intersected with them. OpenAPI 3.0 ignores them, as its spec says.
+     */
+    readonly REF_SIBLINGS: "ref-siblings";
     /** Schemas of one root type name without the prefix each get an alias, the earlier numbered. */
     readonly ROOT_TYPE_NUMBERING: "root-type-numbering";
     /** `unevaluatedProperties` types the keys no other keyword declares (an index signature). */
     readonly UNEVALUATED_PROPERTIES: "unevaluated-properties";
 };
-type OutputFix = (typeof OutputFix)[keyof typeof OutputFix];
+/** The name of one opt-in output fix. */
+type OutputFix = (typeof FIX)[keyof typeof FIX];
 /** Every fix of this version, in the order the docs list them. */
 declare const OUTPUT_FIXES: readonly OutputFix[];
 /** The name that turns on every fix of the installed version. */
-declare const ALL_OUTPUT_FIXES = "all";
-/** A name the `fix` option accepts: one fix, or `all`. */
-type OutputFixName = OutputFix | typeof ALL_OUTPUT_FIXES;
+declare const ALL_FIXES = "all";
+/** A name the `fix` option accepts: one fix, or `"all"`. */
+type OutputFixName = OutputFix | typeof ALL_FIXES;
 
 interface Extensable {
     [key: `x-${string}`]: any;
@@ -1296,7 +1305,7 @@ interface OpenAPITSBaseOptions {
      * still fail the run.
      */
     lint?: boolean;
-    /** (optional) Should logging be suppressed? (necessary for STDOUT) */
+    /** Hide warnings (default: false). Every line of the logger goes to stderr, never to stdout. */
     silent?: boolean;
     /** Accepted for compatibility with openapi-typescript; not read. */
     version?: number;
@@ -1451,6 +1460,20 @@ interface TransformNodeOptions {
     ctx: GlobalContext;
 }
 
+/**
+ * Deprecations of what 2.0 removes. Each one is a Node.js `DeprecationWarning` with one of these
+ * codes, so `--no-deprecation`, `--throw-deprecation`, `--trace-deprecation` and
+ * `process.on("warning")` work on it as on Node's own (ADR-004, amendment of 2026-11-08).
+ */
+/** Every deprecation code. */
+declare const DEPRECATION_CODES: {
+    readonly OPENAPI_TYPESAFE_DEP_STRING_TO_AST: "OPENAPI_TYPESAFE_DEP_STRING_TO_AST";
+    readonly OPENAPI_TYPESAFE_DEP_TS_TRANSFORM: "OPENAPI_TYPESAFE_DEP_TS_TRANSFORM";
+    readonly OPENAPI_TYPESAFE_DEP_TS_POST_TRANSFORM: "OPENAPI_TYPESAFE_DEP_TS_POST_TRANSFORM";
+    readonly OPENAPI_TYPESAFE_DEP_TS_TRANSFORM_PROPERTY: "OPENAPI_TYPESAFE_DEP_TS_TRANSFORM_PROPERTY";
+};
+type DeprecationCode = (typeof DEPRECATION_CODES)[keyof typeof DEPRECATION_CODES];
+
 /** The debug groups of the original `DEBUG=openapi-ts:<group>` output. */
 type DebugGroup = "redoc" | "lint" | "bundle" | "ts";
 /**
@@ -1483,7 +1506,10 @@ declare function openapiTS(source: SchemaSource, options?: GeneratorOptions): Pr
  * `message` is English text for people; programs and the CLI decide by `code`. A bug (a broken
  * invariant) is a plain `Error`, not one of these.
  */
-/** Every error code. The set is closed: a new code must be handled by the CLI exit-code table. */
+/**
+ * Every error code. A minor release may add codes (ADR-034); each one needs a row in the CLI's
+ * exit-code table, which the compiler checks.
+ */
 declare const ERROR_CODES: {
     readonly SCHEMA_SOURCE_EMPTY: "SCHEMA_SOURCE_EMPTY";
     readonly SCHEMA_SOURCE_INVALID: "SCHEMA_SOURCE_INVALID";
@@ -1508,23 +1534,33 @@ declare const ERROR_CODES: {
     readonly CLI_CONFIG_OUTPUT_MISSING: "CLI_CONFIG_OUTPUT_MISSING";
     readonly CLI_CHECK_OUTPUT_MISSING: "CLI_CHECK_OUTPUT_MISSING";
     readonly CLI_INPUT_MISSING: "CLI_INPUT_MISSING";
+    readonly CLI_OUTPUT_IS_INPUT: "CLI_OUTPUT_IS_INPUT";
+    readonly CLI_OUTPUT_DUPLICATE: "CLI_OUTPUT_DUPLICATE";
+    readonly CLI_OUTPUT_INVALID: "CLI_OUTPUT_INVALID";
+    readonly CLI_LOCATION_INVALID: "CLI_LOCATION_INVALID";
     readonly OUTPUT_STALE: "OUTPUT_STALE";
     readonly OUTPUT_READ_FAILED: "OUTPUT_READ_FAILED";
     readonly OUTPUT_WRITE_FAILED: "OUTPUT_WRITE_FAILED";
 };
 type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
-/** Structured, JSON-serializable facts about a failure, for programs and logs. */
+/**
+ * Structured, JSON-serializable facts about a failure, for programs and logs. Only the keys that
+ * docs/node.md (Errors) lists are stable (ADR-034, amendment of 2026-11-08).
+ */
 type ErrorDetails = Readonly<Record<string, unknown>>;
 interface OpenAPITypesafeErrorInit {
     readonly code: ErrorCode;
     readonly message: string;
     readonly details?: ErrorDetails;
-    /** The lower-level error this one reports, if any (kept as the standard `cause`). */
+    /**
+     * The lower-level error this one reports, if any (kept as the standard `cause`; a copy with URL
+     * secrets hidden when its chain names one, see cause-secrets.ts).
+     */
     readonly cause?: unknown;
 }
 /**
  * The base of every expected failure; check `code`, not the class or the message. The message
- * never shows the user info of a URL (`url-credentials.ts`).
+ * and the `cause` chain never show the user info or the query of a URL (`url-secrets.ts`).
  */
 declare class OpenAPITypesafeError extends Error {
     readonly code: ErrorCode;
@@ -1751,7 +1787,11 @@ declare function createDiscriminatorProperty(discriminator: DiscriminatorObject,
     path: string;
     readonly?: boolean;
 }): IrPropertySignature;
-/** Create a $ref pointer (even from other $refs) */
+/**
+ * Create a $ref pointer (even from other $refs). A part that contains `#/` is read as a `$ref`
+ * and contributes its decoded segments, so it throws URIError for a malformed percent escape; any
+ * other part is one segment. To append raw document keys, escape each one instead.
+ */
 declare function createRef(parts: (number | string | undefined | null)[]): string;
 /**
  * Print debug message (cribbed from the `debug` package, but without all the bells & whistles
@@ -1787,15 +1827,13 @@ declare function walk(obj: unknown, cb: (value: Record<string, unknown>, path: (
  */
 declare function warn(msg: string, silent?: boolean): void;
 
-/** Node's deprecation code for `stringToAST`, so users can filter or trace the warning. */
-declare const STRING_TO_AST_DEPRECATION_CODE = "OPENAPI_TYPESAFE_DEP_STRING_TO_AST";
 /**
  * Convert an arbitrary string to TS (assuming it’s valid). Parses with the TypeScript bridge, so
- * it needs TypeScript 6 or earlier (or `@typescript/typescript6`). Node's `util.deprecate` warns
- * on the first call only.
+ * it needs TypeScript 6 or earlier (or `@typescript/typescript6`). Emits a Node.js
+ * `DeprecationWarning` (`OPENAPI_TYPESAFE_DEP_STRING_TO_AST`) on the first call only.
  * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 7). Use type text in IR callbacks.
  */
-declare const stringToAST: (source: string) => unknown[];
+declare function stringToAST(source: string): unknown[];
 
 /**
  * The whole document as IR declarations (ENGINEERING_PLAN 6.1–6.2); `openapiTS` returns the same
@@ -1816,7 +1854,6 @@ declare const WARNING_CODES: {
     readonly DISCRIMINATOR_VALUE_NOT_ALLOWED: "DISCRIMINATOR_VALUE_NOT_ALLOWED";
     readonly ENUM_VALUES_EXCLUDED: "ENUM_VALUES_EXCLUDED";
     readonly FIX_NEEDS_OPTION: "FIX_NEEDS_OPTION";
-    readonly LEGACY_CALLBACK_DEPRECATED: "LEGACY_CALLBACK_DEPRECATED";
     readonly LINT_PROBLEM: "LINT_PROBLEM";
     readonly PATH_TEMPLATES_IDENTICAL: "PATH_TEMPLATES_IDENTICAL";
     readonly QUERYSTRING_NEXT_TO_QUERY: "QUERYSTRING_NEXT_TO_QUERY";
@@ -1944,5 +1981,5 @@ declare function transformSchemaObject(schemaObject: SchemaObject | ReferenceObj
 /** Transform SchemaObjects without the `postTransform` callback at the top level. */
 declare function transformSchemaObjectWithComposition(schemaObject: SchemaObject | ReferenceObject, options: TransformNodeOptions, fromAdditionalProperties?: boolean): IrType;
 
-export { ALL_OUTPUT_FIXES, BOOLEAN, COMMENT_HEADER, ERROR_CODES, FALSE, JS_ENUM_INVALID_CHARS_RE, JS_PROPERTY_INDEX_INVALID_CHARS_RE, JS_PROPERTY_INDEX_RE, NEVER, NULL, NUMBER, OUTPUT_FIXES, OpenAPITypesafeError, OutputFix, QUESTION_TOKEN, SPECIAL_CHARACTER_MAP, STRING, STRING_TO_AST_DEPRECATION_CODE, TRUE, UNDEFINED, UNKNOWN, WARNING_CODES, addJSDocComment, astToString, c, createDiscriminatorProperty, createRef, debug, openapiTS as default, enumCache, error, formatTime, getEntries, injectOperationObject, isOpenAPITypesafeError, oapiRef, resolveRef, scanDiscriminators, stringToAST, transformComponentsObject, transformHeaderObject, transformMediaTypeObject, transformOperationObject, transformParameterObject, transformPathItemObject, transformPathsObject, transformRequestBodyObject, transformResponseObject, transformResponsesObject, transformSchema, transformSchemaObject, transformSchemaObjectWithComposition, tsArrayLiteralExpression, tsDedupe, tsEnum, tsEnumMember, tsIntersection, tsIsPrimitive, tsLiteral, tsModifiers, tsNullable, tsOmit, tsPropertyIndex, tsReadonlyArray, tsRecord, tsUnion, tsWithRequired, walk, warn };
-export type { $defs, AnnotatedSchemaObject, ArraySubtype, AstToStringInput, AstToStringOptions, BooleanSubtype, CallbackObject, ComponentsObject, ContactObject, DiscriminatorObject, EncodingObject, ErrorCode, ErrorDetails, ExampleObject, Extensable, ExternalDocumentationObject, FooterEntry, GeneratorOptions, GlobalContext, HeaderObject, InfoObject, IntegerSubtype, IrArrayType, IrBooleanLiteralType, IrCallbackOptions, IrCallbackType, IrComment, IrConstArrayDeclaration, IrDeclaration, IrEnumDeclaration, IrEnumMember, IrIndexSignature, IrIndexedAccessType, IrInterfaceDeclaration, IrIntersectionType, IrKeyword, IrKeywordType, IrMember, IrNumberLiteralType, IrObjectType, IrPostTransform, IrPropertyName, IrPropertySignature, IrRawDeclaration, IrRawType, IrReadonlyType, IrReferenceType, IrStringEncoding, IrStringLiteralType, IrTransform, IrTransformObject, IrTransformProperty, IrTupleElement, IrTupleType, IrType, IrTypeAliasDeclaration, IrUnionType, LegacyCallbackName, LegacyCallbackOptions, LicenseObject, LinkObject, MediaTypeObject, Method, NullSubtype, NumberSubtype, OAuthFlowObject, OAuthFlowsObject, OapiRefOptions, ObjectSubtype, OpenAPI3, OpenAPITSBaseOptions, OpenAPITSIrOptions, OpenAPITSOptions, OperationObject, OutputFixName, ParameterObject, PathItemObject, PathsObject, ReferenceObject, RequestBodyObject, ResolveRefOptions, ResponseObject, ResponsesObject, SchemaObject, SchemaSource, SecurityRequirementObject, SecuritySchemeObject, ServerObject, ServerVariableObject, StringSubtype, TagObject, TransformNodeOptions, TransformObject, TypeInput, WarningCode, WebhooksObject, XMLObject };
+export { BOOLEAN, COMMENT_HEADER, DEPRECATION_CODES, ERROR_CODES, FALSE, JS_ENUM_INVALID_CHARS_RE, JS_PROPERTY_INDEX_INVALID_CHARS_RE, JS_PROPERTY_INDEX_RE, NEVER, NULL, NUMBER, OUTPUT_FIXES, OpenAPITypesafeError, QUESTION_TOKEN, SPECIAL_CHARACTER_MAP, STRING, TRUE, UNDEFINED, UNKNOWN, WARNING_CODES, addJSDocComment, astToString, c, createDiscriminatorProperty, createRef, debug, openapiTS as default, enumCache, error, formatTime, getEntries, injectOperationObject, isOpenAPITypesafeError, oapiRef, resolveRef, scanDiscriminators, stringToAST, transformComponentsObject, transformHeaderObject, transformMediaTypeObject, transformOperationObject, transformParameterObject, transformPathItemObject, transformPathsObject, transformRequestBodyObject, transformResponseObject, transformResponsesObject, transformSchema, transformSchemaObject, transformSchemaObjectWithComposition, tsArrayLiteralExpression, tsDedupe, tsEnum, tsEnumMember, tsIntersection, tsIsPrimitive, tsLiteral, tsModifiers, tsNullable, tsOmit, tsPropertyIndex, tsReadonlyArray, tsRecord, tsUnion, tsWithRequired, walk, warn };
+export type { $defs, AnnotatedSchemaObject, ArraySubtype, AstToStringInput, AstToStringOptions, BooleanSubtype, CallbackObject, ComponentsObject, ContactObject, DeprecationCode, DiscriminatorObject, EncodingObject, ErrorCode, ErrorDetails, ExampleObject, Extensable, ExternalDocumentationObject, FooterEntry, GeneratorOptions, GlobalContext, HeaderObject, InfoObject, IntegerSubtype, IrArrayType, IrBooleanLiteralType, IrCallbackOptions, IrCallbackType, IrComment, IrConstArrayDeclaration, IrDeclaration, IrEnumDeclaration, IrEnumMember, IrIndexSignature, IrIndexedAccessType, IrInterfaceDeclaration, IrIntersectionType, IrKeyword, IrKeywordType, IrMember, IrNumberLiteralType, IrObjectType, IrPostTransform, IrPropertyName, IrPropertySignature, IrRawDeclaration, IrRawType, IrReadonlyType, IrReferenceType, IrStringEncoding, IrStringLiteralType, IrTransform, IrTransformObject, IrTransformProperty, IrTupleElement, IrTupleType, IrType, IrTypeAliasDeclaration, IrUnionType, LegacyCallbackName, LegacyCallbackOptions, LicenseObject, LinkObject, MediaTypeObject, Method, NullSubtype, NumberSubtype, OAuthFlowObject, OAuthFlowsObject, OapiRefOptions, ObjectSubtype, OpenAPI3, OpenAPITSBaseOptions, OpenAPITSIrOptions, OpenAPITSOptions, OperationObject, OutputFix, OutputFixName, ParameterObject, PathItemObject, PathsObject, ReferenceObject, RequestBodyObject, ResolveRefOptions, ResponseObject, ResponsesObject, SchemaObject, SchemaSource, SecurityRequirementObject, SecuritySchemeObject, ServerObject, ServerVariableObject, StringSubtype, TagObject, TransformNodeOptions, TransformObject, TypeInput, WarningCode, WebhooksObject, XMLObject };

package/dist/index.d.ts

@@ -250,9 +250,10 @@ type FooterEntry = IrDeclaration | ts.Node;
 /**
  * Opt-in fixes of the output of valid schemas (ADR-021). Each one changes only the cases it names;
  * without any, the output is the same as openapi-typescript 7.13 gives. In 2.0 they become the
- * default.
+ * default. The object names the fixes for this package's code; the public API is the `OutputFix`
+ * union and the `OUTPUT_FIXES` list (ADR-021, amendment 1).
  */
-declare const OutputFix: {
+declare const FIX: {
     /** An `allOf` `$ref` to a discriminated union is the union, without `Omit` or a schema name. */
     readonly ALLOF_DISCRIMINATED_UNION: "allof-discriminated-union";
     /** An `allOf` member with only `required` makes those properties of the others required. */
@@ -279,6 +280,8 @@ declare const OutputFix: {
     readonly EXPLODED_QUERY_OBJECTS: "exploded-query-objects";
     /** `--enum` declares an enum that lists `null` without it, and the type adds `| null`. */
     readonly NULLABLE_ENUMS: "nullable-enums";
+    /** A parameter with `content` instead of `schema` is typed by the schema of its media type. */
+    readonly PARAMETER_CONTENT: "parameter-content";
     /** `--path-params-as-types` gives each `{name}` its placeholder, `{number}` included. */
     readonly PATH_PARAM_TYPE_NAMES: "path-param-type-names";
     /** A `prefixItems` tuple is open unless `items` or `unevaluatedItems` closes it (2020-12). */
@@ -290,18 +293,24 @@ declare const OutputFix: {
      * points at, also where the original type compiles through an index signature.
      */
     readonly REF_POINTERS: "ref-pointers";
+    /**
+     * OpenAPI 3.1 and 3.2: keywords next to a `$ref` (`required`, `properties`) apply too, so the
+     * type is the reference intersected with them. OpenAPI 3.0 ignores them, as its spec says.
+     */
+    readonly REF_SIBLINGS: "ref-siblings";
     /** Schemas of one root type name without the prefix each get an alias, the earlier numbered. */
     readonly ROOT_TYPE_NUMBERING: "root-type-numbering";
     /** `unevaluatedProperties` types the keys no other keyword declares (an index signature). */
     readonly UNEVALUATED_PROPERTIES: "unevaluated-properties";
 };
-type OutputFix = (typeof OutputFix)[keyof typeof OutputFix];
+/** The name of one opt-in output fix. */
+type OutputFix = (typeof FIX)[keyof typeof FIX];
 /** Every fix of this version, in the order the docs list them. */
 declare const OUTPUT_FIXES: readonly OutputFix[];
 /** The name that turns on every fix of the installed version. */
-declare const ALL_OUTPUT_FIXES = "all";
-/** A name the `fix` option accepts: one fix, or `all`. */
-type OutputFixName = OutputFix | typeof ALL_OUTPUT_FIXES;
+declare const ALL_FIXES = "all";
+/** A name the `fix` option accepts: one fix, or `"all"`. */
+type OutputFixName = OutputFix | typeof ALL_FIXES;
 
 interface Extensable {
     [key: `x-${string}`]: any;
@@ -1296,7 +1305,7 @@ interface OpenAPITSBaseOptions {
      * still fail the run.
      */
     lint?: boolean;
-    /** (optional) Should logging be suppressed? (necessary for STDOUT) */
+    /** Hide warnings (default: false). Every line of the logger goes to stderr, never to stdout. */
     silent?: boolean;
     /** Accepted for compatibility with openapi-typescript; not read. */
     version?: number;
@@ -1451,6 +1460,20 @@ interface TransformNodeOptions {
     ctx: GlobalContext;
 }
 
+/**
+ * Deprecations of what 2.0 removes. Each one is a Node.js `DeprecationWarning` with one of these
+ * codes, so `--no-deprecation`, `--throw-deprecation`, `--trace-deprecation` and
+ * `process.on("warning")` work on it as on Node's own (ADR-004, amendment of 2026-11-08).
+ */
+/** Every deprecation code. */
+declare const DEPRECATION_CODES: {
+    readonly OPENAPI_TYPESAFE_DEP_STRING_TO_AST: "OPENAPI_TYPESAFE_DEP_STRING_TO_AST";
+    readonly OPENAPI_TYPESAFE_DEP_TS_TRANSFORM: "OPENAPI_TYPESAFE_DEP_TS_TRANSFORM";
+    readonly OPENAPI_TYPESAFE_DEP_TS_POST_TRANSFORM: "OPENAPI_TYPESAFE_DEP_TS_POST_TRANSFORM";
+    readonly OPENAPI_TYPESAFE_DEP_TS_TRANSFORM_PROPERTY: "OPENAPI_TYPESAFE_DEP_TS_TRANSFORM_PROPERTY";
+};
+type DeprecationCode = (typeof DEPRECATION_CODES)[keyof typeof DEPRECATION_CODES];
+
 /** The debug groups of the original `DEBUG=openapi-ts:<group>` output. */
 type DebugGroup = "redoc" | "lint" | "bundle" | "ts";
 /**
@@ -1483,7 +1506,10 @@ declare function openapiTS(source: SchemaSource, options?: GeneratorOptions): Pr
  * `message` is English text for people; programs and the CLI decide by `code`. A bug (a broken
  * invariant) is a plain `Error`, not one of these.
  */
-/** Every error code. The set is closed: a new code must be handled by the CLI exit-code table. */
+/**
+ * Every error code. A minor release may add codes (ADR-034); each one needs a row in the CLI's
+ * exit-code table, which the compiler checks.
+ */
 declare const ERROR_CODES: {
     readonly SCHEMA_SOURCE_EMPTY: "SCHEMA_SOURCE_EMPTY";
     readonly SCHEMA_SOURCE_INVALID: "SCHEMA_SOURCE_INVALID";
@@ -1508,23 +1534,33 @@ declare const ERROR_CODES: {
     readonly CLI_CONFIG_OUTPUT_MISSING: "CLI_CONFIG_OUTPUT_MISSING";
     readonly CLI_CHECK_OUTPUT_MISSING: "CLI_CHECK_OUTPUT_MISSING";
     readonly CLI_INPUT_MISSING: "CLI_INPUT_MISSING";
+    readonly CLI_OUTPUT_IS_INPUT: "CLI_OUTPUT_IS_INPUT";
+    readonly CLI_OUTPUT_DUPLICATE: "CLI_OUTPUT_DUPLICATE";
+    readonly CLI_OUTPUT_INVALID: "CLI_OUTPUT_INVALID";
+    readonly CLI_LOCATION_INVALID: "CLI_LOCATION_INVALID";
     readonly OUTPUT_STALE: "OUTPUT_STALE";
     readonly OUTPUT_READ_FAILED: "OUTPUT_READ_FAILED";
     readonly OUTPUT_WRITE_FAILED: "OUTPUT_WRITE_FAILED";
 };
 type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
-/** Structured, JSON-serializable facts about a failure, for programs and logs. */
+/**
+ * Structured, JSON-serializable facts about a failure, for programs and logs. Only the keys that
+ * docs/node.md (Errors) lists are stable (ADR-034, amendment of 2026-11-08).
+ */
 type ErrorDetails = Readonly<Record<string, unknown>>;
 interface OpenAPITypesafeErrorInit {
     readonly code: ErrorCode;
     readonly message: string;
     readonly details?: ErrorDetails;
-    /** The lower-level error this one reports, if any (kept as the standard `cause`). */
+    /**
+     * The lower-level error this one reports, if any (kept as the standard `cause`; a copy with URL
+     * secrets hidden when its chain names one, see cause-secrets.ts).
+     */
     readonly cause?: unknown;
 }
 /**
  * The base of every expected failure; check `code`, not the class or the message. The message
- * never shows the user info of a URL (`url-credentials.ts`).
+ * and the `cause` chain never show the user info or the query of a URL (`url-secrets.ts`).
  */
 declare class OpenAPITypesafeError extends Error {
     readonly code: ErrorCode;
@@ -1751,7 +1787,11 @@ declare function createDiscriminatorProperty(discriminator: DiscriminatorObject,
     path: string;
     readonly?: boolean;
 }): IrPropertySignature;
-/** Create a $ref pointer (even from other $refs) */
+/**
+ * Create a $ref pointer (even from other $refs). A part that contains `#/` is read as a `$ref`
+ * and contributes its decoded segments, so it throws URIError for a malformed percent escape; any
+ * other part is one segment. To append raw document keys, escape each one instead.
+ */
 declare function createRef(parts: (number | string | undefined | null)[]): string;
 /**
  * Print debug message (cribbed from the `debug` package, but without all the bells & whistles
@@ -1787,15 +1827,13 @@ declare function walk(obj: unknown, cb: (value: Record<string, unknown>, path: (
  */
 declare function warn(msg: string, silent?: boolean): void;
 
-/** Node's deprecation code for `stringToAST`, so users can filter or trace the warning. */
-declare const STRING_TO_AST_DEPRECATION_CODE = "OPENAPI_TYPESAFE_DEP_STRING_TO_AST";
 /**
  * Convert an arbitrary string to TS (assuming it’s valid). Parses with the TypeScript bridge, so
- * it needs TypeScript 6 or earlier (or `@typescript/typescript6`). Node's `util.deprecate` warns
- * on the first call only.
+ * it needs TypeScript 6 or earlier (or `@typescript/typescript6`). Emits a Node.js
+ * `DeprecationWarning` (`OPENAPI_TYPESAFE_DEP_STRING_TO_AST`) on the first call only.
  * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 7). Use type text in IR callbacks.
  */
-declare const stringToAST: (source: string) => unknown[];
+declare function stringToAST(source: string): unknown[];
 
 /**
  * The whole document as IR declarations (ENGINEERING_PLAN 6.1–6.2); `openapiTS` returns the same
@@ -1816,7 +1854,6 @@ declare const WARNING_CODES: {
     readonly DISCRIMINATOR_VALUE_NOT_ALLOWED: "DISCRIMINATOR_VALUE_NOT_ALLOWED";
     readonly ENUM_VALUES_EXCLUDED: "ENUM_VALUES_EXCLUDED";
     readonly FIX_NEEDS_OPTION: "FIX_NEEDS_OPTION";
-    readonly LEGACY_CALLBACK_DEPRECATED: "LEGACY_CALLBACK_DEPRECATED";
     readonly LINT_PROBLEM: "LINT_PROBLEM";
     readonly PATH_TEMPLATES_IDENTICAL: "PATH_TEMPLATES_IDENTICAL";
     readonly QUERYSTRING_NEXT_TO_QUERY: "QUERYSTRING_NEXT_TO_QUERY";
@@ -1944,5 +1981,5 @@ declare function transformSchemaObject(schemaObject: SchemaObject | ReferenceObj
 /** Transform SchemaObjects without the `postTransform` callback at the top level. */
 declare function transformSchemaObjectWithComposition(schemaObject: SchemaObject | ReferenceObject, options: TransformNodeOptions, fromAdditionalProperties?: boolean): IrType;
 
-export { ALL_OUTPUT_FIXES, BOOLEAN, COMMENT_HEADER, ERROR_CODES, FALSE, JS_ENUM_INVALID_CHARS_RE, JS_PROPERTY_INDEX_INVALID_CHARS_RE, JS_PROPERTY_INDEX_RE, NEVER, NULL, NUMBER, OUTPUT_FIXES, OpenAPITypesafeError, OutputFix, QUESTION_TOKEN, SPECIAL_CHARACTER_MAP, STRING, STRING_TO_AST_DEPRECATION_CODE, TRUE, UNDEFINED, UNKNOWN, WARNING_CODES, addJSDocComment, astToString, c, createDiscriminatorProperty, createRef, debug, openapiTS as default, enumCache, error, formatTime, getEntries, injectOperationObject, isOpenAPITypesafeError, oapiRef, resolveRef, scanDiscriminators, stringToAST, transformComponentsObject, transformHeaderObject, transformMediaTypeObject, transformOperationObject, transformParameterObject, transformPathItemObject, transformPathsObject, transformRequestBodyObject, transformResponseObject, transformResponsesObject, transformSchema, transformSchemaObject, transformSchemaObjectWithComposition, tsArrayLiteralExpression, tsDedupe, tsEnum, tsEnumMember, tsIntersection, tsIsPrimitive, tsLiteral, tsModifiers, tsNullable, tsOmit, tsPropertyIndex, tsReadonlyArray, tsRecord, tsUnion, tsWithRequired, walk, warn };
-export type { $defs, AnnotatedSchemaObject, ArraySubtype, AstToStringInput, AstToStringOptions, BooleanSubtype, CallbackObject, ComponentsObject, ContactObject, DiscriminatorObject, EncodingObject, ErrorCode, ErrorDetails, ExampleObject, Extensable, ExternalDocumentationObject, FooterEntry, GeneratorOptions, GlobalContext, HeaderObject, InfoObject, IntegerSubtype, IrArrayType, IrBooleanLiteralType, IrCallbackOptions, IrCallbackType, IrComment, IrConstArrayDeclaration, IrDeclaration, IrEnumDeclaration, IrEnumMember, IrIndexSignature, IrIndexedAccessType, IrInterfaceDeclaration, IrIntersectionType, IrKeyword, IrKeywordType, IrMember, IrNumberLiteralType, IrObjectType, IrPostTransform, IrPropertyName, IrPropertySignature, IrRawDeclaration, IrRawType, IrReadonlyType, IrReferenceType, IrStringEncoding, IrStringLiteralType, IrTransform, IrTransformObject, IrTransformProperty, IrTupleElement, IrTupleType, IrType, IrTypeAliasDeclaration, IrUnionType, LegacyCallbackName, LegacyCallbackOptions, LicenseObject, LinkObject, MediaTypeObject, Method, NullSubtype, NumberSubtype, OAuthFlowObject, OAuthFlowsObject, OapiRefOptions, ObjectSubtype, OpenAPI3, OpenAPITSBaseOptions, OpenAPITSIrOptions, OpenAPITSOptions, OperationObject, OutputFixName, ParameterObject, PathItemObject, PathsObject, ReferenceObject, RequestBodyObject, ResolveRefOptions, ResponseObject, ResponsesObject, SchemaObject, SchemaSource, SecurityRequirementObject, SecuritySchemeObject, ServerObject, ServerVariableObject, StringSubtype, TagObject, TransformNodeOptions, TransformObject, TypeInput, WarningCode, WebhooksObject, XMLObject };
+export { BOOLEAN, COMMENT_HEADER, DEPRECATION_CODES, ERROR_CODES, FALSE, JS_ENUM_INVALID_CHARS_RE, JS_PROPERTY_INDEX_INVALID_CHARS_RE, JS_PROPERTY_INDEX_RE, NEVER, NULL, NUMBER, OUTPUT_FIXES, OpenAPITypesafeError, QUESTION_TOKEN, SPECIAL_CHARACTER_MAP, STRING, TRUE, UNDEFINED, UNKNOWN, WARNING_CODES, addJSDocComment, astToString, c, createDiscriminatorProperty, createRef, debug, openapiTS as default, enumCache, error, formatTime, getEntries, injectOperationObject, isOpenAPITypesafeError, oapiRef, resolveRef, scanDiscriminators, stringToAST, transformComponentsObject, transformHeaderObject, transformMediaTypeObject, transformOperationObject, transformParameterObject, transformPathItemObject, transformPathsObject, transformRequestBodyObject, transformResponseObject, transformResponsesObject, transformSchema, transformSchemaObject, transformSchemaObjectWithComposition, tsArrayLiteralExpression, tsDedupe, tsEnum, tsEnumMember, tsIntersection, tsIsPrimitive, tsLiteral, tsModifiers, tsNullable, tsOmit, tsPropertyIndex, tsReadonlyArray, tsRecord, tsUnion, tsWithRequired, walk, warn };
+export type { $defs, AnnotatedSchemaObject, ArraySubtype, AstToStringInput, AstToStringOptions, BooleanSubtype, CallbackObject, ComponentsObject, ContactObject, DeprecationCode, DiscriminatorObject, EncodingObject, ErrorCode, ErrorDetails, ExampleObject, Extensable, ExternalDocumentationObject, FooterEntry, GeneratorOptions, GlobalContext, HeaderObject, InfoObject, IntegerSubtype, IrArrayType, IrBooleanLiteralType, IrCallbackOptions, IrCallbackType, IrComment, IrConstArrayDeclaration, IrDeclaration, IrEnumDeclaration, IrEnumMember, IrIndexSignature, IrIndexedAccessType, IrInterfaceDeclaration, IrIntersectionType, IrKeyword, IrKeywordType, IrMember, IrNumberLiteralType, IrObjectType, IrPostTransform, IrPropertyName, IrPropertySignature, IrRawDeclaration, IrRawType, IrReadonlyType, IrReferenceType, IrStringEncoding, IrStringLiteralType, IrTransform, IrTransformObject, IrTransformProperty, IrTupleElement, IrTupleType, IrType, IrTypeAliasDeclaration, IrUnionType, LegacyCallbackName, LegacyCallbackOptions, LicenseObject, LinkObject, MediaTypeObject, Method, NullSubtype, NumberSubtype, OAuthFlowObject, OAuthFlowsObject, OapiRefOptions, ObjectSubtype, OpenAPI3, OpenAPITSBaseOptions, OpenAPITSIrOptions, OpenAPITSOptions, OperationObject, OutputFix, OutputFixName, ParameterObject, PathItemObject, PathsObject, ReferenceObject, RequestBodyObject, ResolveRefOptions, ResponseObject, ResponsesObject, SchemaObject, SchemaSource, SecurityRequirementObject, SecuritySchemeObject, ServerObject, ServerVariableObject, StringSubtype, TagObject, TransformNodeOptions, TransformObject, TypeInput, WarningCode, WebhooksObject, XMLObject };

package/dist/index.mjs

@@ -4,11 +4,12 @@ export { COMMENT_HEADER } from './api/comment-header.mjs';
 export { scanDiscriminators } from './api/discriminator-scan.mjs';
 export { JS_ENUM_INVALID_CHARS_RE, JS_PROPERTY_INDEX_INVALID_CHARS_RE, JS_PROPERTY_INDEX_RE, QUESTION_TOKEN, SPECIAL_CHARACTER_MAP, addJSDocComment, enumCache, tsArrayLiteralExpression, tsDedupe, tsEnum, tsEnumMember, tsIsPrimitive, tsModifiers, tsPropertyIndex, tsReadonlyArray } from './api/legacy-ts-helpers.mjs';
 export { c, createDiscriminatorProperty, createRef, debug, error, formatTime, getEntries, resolveRef, walk, warn } from './api/legacy-utils.mjs';
-export { STRING_TO_AST_DEPRECATION_CODE, stringToAST } from './api/string-to-ast.mjs';
+export { stringToAST } from './api/string-to-ast.mjs';
 export { default as transformSchema } from './api/transform-schema.mjs';
 export { BOOLEAN, FALSE, NEVER, NULL, NUMBER, STRING, TRUE, UNDEFINED, UNKNOWN, oapiRef, tsIntersection, tsLiteral, tsNullable, tsOmit, tsRecord, tsUnion, tsWithRequired } from './api/type-helpers.mjs';
+export { DEPRECATION_CODES } from './domain/deprecations.mjs';
 export { ERROR_CODES, OpenAPITypesafeError, isOpenAPITypesafeError } from './domain/errors.mjs';
-export { ALL_OUTPUT_FIXES, OUTPUT_FIXES, OutputFix } from './domain/output-fixes.mjs';
+export { OUTPUT_FIXES } from './domain/output-fixes.mjs';
 export { WARNING_CODES } from './domain/warnings.mjs';
 export { default as transformComponentsObject } from './transform/components-object.mjs';
 export { default as transformHeaderObject } from './transform/header-object.mjs';

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "openapi-typesafe",
   "description": "Convert OpenAPI 3.0, 3.1 & 3.2 schemas to TypeScript",
-  "version": "1.0.0-rc.2",
+  "version": "1.0.0-rc.4",
   "author": {
     "name": "Fedor Chishchin",
     "url": "https://github.com/fedorello"
@@ -35,6 +35,7 @@
     "./*": "./*"
   },
   "files": [
+    "CHANGELOG.md",
     "bin",
     "dist",
     "src"
@@ -61,7 +62,7 @@
   },
   "peerDependencies": {
     "@typescript/typescript6": "^6.0.0",
-    "typescript": ">=5.0.0"
+    "typescript": ">=5.4.0"
   },
   "peerDependenciesMeta": {
     "@typescript/typescript6": {
@@ -72,7 +73,7 @@
     }
   },
   "dependencies": {
-    "@redocly/openapi-core": "^1.34.23",
+    "@redocly/openapi-core": "^1.34.22",
     "ansi-colors": "^4.1.3",
     "change-case": "^5.4.4",
     "parse-json": "^8.3.0",
@@ -106,11 +107,9 @@
     "lint:ts": "tsc --noEmit && tsc -p tsconfig.strict.json",
     "test": "pnpm run test:js && pnpm run test:examples && pnpm run test:exports",
     "test:js": "vitest run",
-    "test:exports": "pnpm run build && ../../scripts/check-exports.sh",
+    "test:exports": "../../scripts/check-exports.sh",
     "test:examples": "tsc -p tsconfig.examples.json --noEmit",
     "update:examples": "pnpm run build && pnpm run download:schemas && vite-node ./scripts/update-examples.ts",
-    "prepublish": "pnpm run build",
-    "version": "pnpm run build",
     "lint:deps": "depcruise src --config .dependency-cruiser.cjs",
     "test:coverage": "vitest run --coverage",
     "lint:sizes": "vite-node scripts/size-rules/check-sizes.ts src"

package/src/adapters/node-deprecations/node-deprecations.ts

@@ -0,0 +1,14 @@
+import { deprecate } from "node:util";
+import type { DeprecationReporter } from "../../application/ports/deprecation-reporter.js";
+
+/**
+ * Deprecations as Node.js `DeprecationWarning`s. `util.deprecate` warns once per process for each
+ * code, also across wrappers, and honours `--no-deprecation` and `--throw-deprecation`.
+ */
+export function createNodeDeprecationReporter(): DeprecationReporter {
+  return {
+    report(code, message) {
+      deprecate(() => undefined, message, code)();
+    },
+  };
+}