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

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. */
@@ -295,13 +296,14 @@ declare const OutputFix: {
     /** `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;
@@ -1451,6 +1453,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 +1499,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";
@@ -1513,7 +1532,10 @@ declare const ERROR_CODES: {
     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;
@@ -1787,15 +1809,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 +1836,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 +1963,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. */
@@ -295,13 +296,14 @@ declare const OutputFix: {
     /** `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;
@@ -1451,6 +1453,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 +1499,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";
@@ -1513,7 +1532,10 @@ declare const ERROR_CODES: {
     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;
@@ -1787,15 +1809,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 +1836,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 +1963,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. */
@@ -295,13 +296,14 @@ declare const OutputFix: {
     /** `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;
@@ -1451,6 +1453,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 +1499,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";
@@ -1513,7 +1532,10 @@ declare const ERROR_CODES: {
     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;
@@ -1787,15 +1809,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 +1836,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 +1963,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.3",
   "author": {
     "name": "Fedor Chishchin",
     "url": "https://github.com/fedorello"
@@ -72,7 +72,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",

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)();
+    },
+  };
+}

package/src/api/default-ports.ts

@@ -1,8 +1,10 @@
 import { performance } from "node:perf_hooks";
 import { createConfig, type Config as RedoclyConfig } from "@redocly/openapi-core";
 import supportsColor from "supports-color";
+import { createNodeDeprecationReporter } from "../adapters/node-deprecations/node-deprecations.js";
 import type { RemoteDocumentLimits } from "../adapters/redocly-loader/remote-fetch.js";
 import { createTerminalLogger } from "../adapters/terminal-logger/terminal-logger.js";
+import type { DeprecationReporter } from "../application/ports/deprecation-reporter.js";
 import type { Logger } from "../application/ports/logger.js";
 
 /**
@@ -26,6 +28,11 @@ export function defaultLogger(silent: boolean): Logger {
   });
 }
 
+/** Deprecations as Node.js `DeprecationWarning`s, each code once per process. */
+export function defaultDeprecationReporter(): DeprecationReporter {
+  return createNodeDeprecationReporter();
+}
+
 /**
  * How long one remote `$ref` (or a remote source) may take to load. Large documents (the 27 MB
  * Cloudflare spec) download in seconds; a minute covers slow hosts, while Node's own fetch would

package/src/api/discriminator-conflict-warnings.ts

@@ -3,7 +3,7 @@ import {
   type DiscriminatorValueConflict,
   findDiscriminatorValueConflicts,
 } from "../domain/openapi/discriminator-conflicts.js";
-import { OutputFix } from "../domain/output-fixes.js";
+import { FIX, type OutputFix } from "../domain/output-fixes.js";
 import { WARNING_CODES, warningText } from "../domain/warnings.js";
 
 const DOCS_BASE_URL = "https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs";
@@ -36,7 +36,7 @@ export function warnDiscriminatorValueConflicts(
   fixes: readonly OutputFix[],
   logger: Logger,
 ): void {
-  const isUnionReused = fixes.includes(OutputFix.ALLOF_DISCRIMINATED_UNION);
+  const isUnionReused = fixes.includes(FIX.ALLOF_DISCRIMINATED_UNION);
   for (const conflict of findDiscriminatorValueConflicts(document, { isUnionReused })) {
     logger.warn(warningText(warningOf(conflict), WARNING_CODES.DISCRIMINATOR_VALUE_NOT_ALLOWED));
   }

package/src/api/discriminator-patch.ts

@@ -1,5 +1,5 @@
 import type { Logger } from "../application/ports/logger.js";
-import { OutputFix } from "../domain/output-fixes.js";
+import { FIX, type OutputFix } from "../domain/output-fixes.js";
 import { WARNING_CODES, warningText } from "../domain/warnings.js";
 import type { DiscriminatorObject, OpenAPI3, SchemaObject } from "../types.js";
 import { addEnumProperty, declaresValues, type EnumPatch } from "./discriminator-enum.js";
@@ -46,7 +46,7 @@ export interface ScanState extends DiscriminatorScanOptions {
 
 /** Whether `discriminator-values` is on: values of two discriminators merge into one enum. */
 export function mergesValues(state: ScanState): boolean {
-  return state.fixes.has(OutputFix.DISCRIMINATOR_VALUES);
+  return state.fixes.has(FIX.DISCRIMINATOR_VALUES);
 }
 
 function patchedSchema(state: ScanState, patch: EnumPatch): SchemaObject | undefined {
@@ -60,8 +60,7 @@ function patchedSchema(state: ScanState, patch: EnumPatch): SchemaObject | undef
  */
 function isDeclared(state: ScanState, patch: EnumPatch): boolean {
   return (
-    state.fixes.has(OutputFix.DISCRIMINATOR_VALUES) &&
-    declaresValues(patchedSchema(state, patch), patch)
+    state.fixes.has(FIX.DISCRIMINATOR_VALUES) && declaresValues(patchedSchema(state, patch), patch)
   );
 }
 
@@ -70,7 +69,7 @@ function isDeclared(state: ScanState, patch: EnumPatch): boolean {
  * added, or a discriminator object that a schema inherited.
  */
 export function recordEnumParent(state: ScanState, owner: DiscriminatorOwner, key: object): void {
-  if (!state.fixes.has(OutputFix.DISCRIMINATOR_VALUES)) {
+  if (!state.fixes.has(FIX.DISCRIMINATOR_VALUES)) {
     return;
   }
   const { silent, logger } = state;

package/src/api/discriminator-scan.ts

@@ -1,6 +1,6 @@
 import type { Logger } from "../application/ports/logger.js";
 import { isUnionMember, unionAt } from "../domain/openapi/discriminated-union.js";
-import { OutputFix } from "../domain/output-fixes.js";
+import { FIX } from "../domain/output-fixes.js";
 import type {
   DiscriminatorObject,
   GeneratorOptions,
@@ -121,7 +121,7 @@ function valuesMappedTo(discriminator: DiscriminatorObject, ref: string): string
  * schema that the union's mapping names is a member.
  */
 function inheritsDiscriminator(state: ScanState, parentRef: string, ref: string): boolean {
-  if (!state.fixes.has(OutputFix.ALLOF_DISCRIMINATED_UNION)) {
+  if (!state.fixes.has(FIX.ALLOF_DISCRIMINATED_UNION)) {
     return true;
   }
   const resolve = (target: string) => resolveDocumentRef(state.schema, target, state);
@@ -141,7 +141,7 @@ function recordInherited(
   discriminator: DiscriminatorObject,
   ownerRef: string,
 ): void {
-  if (state.fixes.has(OutputFix.DISCRIMINATOR_VALUES) && state.owners.has(ref)) {
+  if (state.fixes.has(FIX.DISCRIMINATOR_VALUES) && state.owners.has(ref)) {
     return;
   }
   const inherited = { ...discriminator };

package/src/api/document-run.ts

@@ -2,6 +2,7 @@ import path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import type { Config as RedoclyConfig } from "@redocly/openapi-core";
 import { sourceEmptyError } from "../adapters/redocly-loader/schema-load-errors.js";
+import type { DeprecationReporter } from "../application/ports/deprecation-reporter.js";
 import type { Logger } from "../application/ports/logger.js";
 import type { RefAccess, SchemaLoader } from "../application/ports/schema-loader.js";
 import { withStackOverflowReported } from "../application/stack-overflow.js";
@@ -25,6 +26,8 @@ import { warnUnsupportedFeatures } from "./unsupported-feature-warnings.js";
 export interface GeneratorPorts {
   readonly loader: SchemaLoader;
   readonly logger: Logger;
+  /** Where the run reports the deprecated callback forms (ADR-004). */
+  readonly deprecations: DeprecationReporter;
   /** The Redocly config the loader uses; the run's context exposes it as `ctx.redoc`. */
   readonly redoc: RedoclyConfig;
   /** A monotonic time in milliseconds, for debug durations. */
@@ -47,6 +50,7 @@ type ContextFlags = Omit<
   | "runFooter"
   | "legacyCallbackWarnings"
   | "logger"
+  | "deprecations"
   | "fix"
 >;
 
@@ -175,6 +179,7 @@ export async function createDocumentRun(
     redoc: ports.redoc,
     resolve: ($ref) => resolveDocumentRef(schema, $ref, { silent, logger }),
     logger,
+    deprecations: ports.deprecations,
   };
   return { schema, ctx };
 }

package/src/api/legacy-callback-warning.ts

@@ -1,6 +1,6 @@
-import { WARNING_CODES, warningText } from "../domain/warnings.js";
+import { DEPRECATION_CODES, type DeprecationCode } from "../domain/deprecations.js";
 import type { LegacyCallbackName } from "../types.js";
-import { defaultLogger } from "./default-ports.js";
+import { defaultDeprecationReporter } from "./default-ports.js";
 import type { RunContext } from "./run-context.js";
 
 /** Where the IR callbacks are documented; the warning points users there. */
@@ -13,6 +13,12 @@ const USES: Readonly<Record<LegacyCallbackName, string>> = {
   transformProperty: "`transformProperty` receives TypeScript nodes",
 };
 
+const CODES: Readonly<Record<LegacyCallbackName, DeprecationCode>> = {
+  transform: DEPRECATION_CODES.OPENAPI_TYPESAFE_DEP_TS_TRANSFORM,
+  postTransform: DEPRECATION_CODES.OPENAPI_TYPESAFE_DEP_TS_POST_TRANSFORM,
+  transformProperty: DEPRECATION_CODES.OPENAPI_TYPESAFE_DEP_TS_TRANSFORM_PROPERTY,
+};
+
 function message(name: LegacyCallbackName): string {
   return (
     `${USES[name]}. This form works in 1.x through the TypeScript bridge and is removed in 2.0. ` +
@@ -20,14 +26,15 @@ function message(name: LegacyCallbackName): string {
   );
 }
 
-/** Warn once per run and callback; `silent` runs record the use but print nothing. */
+/**
+ * Report a deprecated callback form once per run and callback, as a deprecation (not through the
+ * logger, so `silent` does not hide it). The Node.js reporter shows each code once per process.
+ */
 export function warnLegacyCallback(ctx: RunContext, name: LegacyCallbackName): void {
   ctx.legacyCallbackWarnings ??= new Set();
   if (ctx.legacyCallbackWarnings.has(name)) {
     return;
   }
   ctx.legacyCallbackWarnings.add(name);
-  (ctx.logger ?? defaultLogger(ctx.silent)).warn(
-    warningText(message(name), WARNING_CODES.LEGACY_CALLBACK_DEPRECATED),
-  );
+  (ctx.deprecations ?? defaultDeprecationReporter()).report(CODES[name], message(name));
 }

package/src/api/openapi-ts.ts

@@ -4,6 +4,7 @@ import type { IrDeclaration } from "../domain/ir/nodes.js";
 import type { GeneratorOptions, SchemaSource } from "../types.js";
 import {
   DEFAULT_REMOTE_DOCUMENT_LIMITS,
+  defaultDeprecationReporter,
   defaultLogger,
   defaultRedoclyConfig,
   monotonicNow,
@@ -34,7 +35,10 @@ export async function generateDeclarations(
   return result;
 }
 
-/** The default ports: the terminal logger, the given or default Redocly config, Redocly loading. */
+/**
+ * The default ports: the terminal logger, Node.js deprecation warnings, the given or default
+ * Redocly config, Redocly loading.
+ */
 export async function defaultGeneratorPorts(options: GeneratorOptions): Promise<GeneratorPorts> {
   const logger = defaultLogger(options.silent ?? false);
   const redoc = options.redocly ?? (await defaultRedoclyConfig());
@@ -45,7 +49,7 @@ export async function defaultGeneratorPorts(options: GeneratorOptions): Promise<
     remoteRefTimeoutMs: REMOTE_REF_TIMEOUT_MS,
     remoteDocumentLimits: DEFAULT_REMOTE_DOCUMENT_LIMITS,
   });
-  return { loader, logger, redoc, now: monotonicNow };
+  return { loader, logger, deprecations: defaultDeprecationReporter(), redoc, now: monotonicNow };
 }
 
 /**

package/src/api/run-context.ts

@@ -1,3 +1,4 @@
+import type { DeprecationReporter } from "../application/ports/deprecation-reporter.js";
 import type { Logger } from "../application/ports/logger.js";
 import type { DocumentFooter } from "../application/transform/transform-context.js";
 import type { GlobalContext, LegacyCallbackName, SchemaObject } from "../types.js";
@@ -31,4 +32,6 @@ export interface RunContext extends GlobalContext {
   legacyCallbackWarnings?: Set<LegacyCallbackName>;
   /** Where this run reports warnings and debug output; without it, the terminal. */
   logger?: Logger;
+  /** Where this run reports deprecated forms; without it, Node.js `DeprecationWarning`s. */
+  deprecations?: DeprecationReporter;
 }