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

package/src/api/string-to-ast.ts

@@ -1,27 +1,23 @@
-import { deprecate } from "node:util";
 import { parseStatements } from "../adapters/type-ast-bridge/ir-declarations-to-typescript.js";
 import { loadTypeScript } from "../adapters/type-ast-bridge/load-typescript.js";
+import { DEPRECATION_CODES } from "../domain/deprecations.js";
+import { defaultDeprecationReporter } from "./default-ports.js";
 import { IR_CALLBACKS_GUIDE_URL } from "./legacy-callback-warning.js";
 
 const STRING_TO_AST_DEPRECATION =
   "stringToAST() is deprecated and removed in 2.0. Return TypeScript type text from an IR " +
   `callback (irCallbacks: true) instead: ${IR_CALLBACKS_GUIDE_URL}`;
 
-/** Node's deprecation code for `stringToAST`, so users can filter or trace the warning. */
-export const STRING_TO_AST_DEPRECATION_CODE = "OPENAPI_TYPESAFE_DEP_STRING_TO_AST";
-
-function parseSource(source: string): unknown[] {
-  return [...parseStatements(loadTypeScript(), source)];
-}
-
 /**
  * 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.
  */
-export const stringToAST: (source: string) => unknown[] = deprecate(
-  parseSource,
-  STRING_TO_AST_DEPRECATION,
-  STRING_TO_AST_DEPRECATION_CODE,
-);
+export function stringToAST(source: string): unknown[] {
+  defaultDeprecationReporter().report(
+    DEPRECATION_CODES.OPENAPI_TYPESAFE_DEP_STRING_TO_AST,
+    STRING_TO_AST_DEPRECATION,
+  );
+  return [...parseStatements(loadTypeScript(), source)];
+}

package/src/api/transform-schema.ts

@@ -9,7 +9,7 @@ import {
 } from "../application/transform/footer/shared-enum-names.js";
 import type { IrDeclaration } from "../domain/ir/nodes.js";
 import type { DocumentObject } from "../domain/openapi/document-object.js";
-import { OutputFix } from "../domain/output-fixes.js";
+import { FIX } from "../domain/output-fixes.js";
 import type { GlobalContext, OpenAPI3 } from "../types.js";
 import { FirstSchemaNameRecorder } from "./discriminator-enum-names.js";
 import { documentDeclarations, type TransformedDocument } from "./document-declarations.js";
@@ -65,10 +65,10 @@ function sharedEnumNamesOf(
 
 /** The recorder of the run's fixes, or null where the first schema's name needs no first pass. */
 function enumNameRecorderOf(ctx: GlobalContext): EnumNameRecorder | null {
-  if (ctx.fix?.includes(OutputFix.DEDUPE_ENUM_NAMES)) {
+  if (ctx.fix?.includes(FIX.DEDUPE_ENUM_NAMES)) {
     return new SharedEnumNameRecorder();
   }
-  return ctx.fix?.includes(OutputFix.DISCRIMINATOR_VALUES) ? new FirstSchemaNameRecorder() : null;
+  return ctx.fix?.includes(FIX.DISCRIMINATOR_VALUES) ? new FirstSchemaNameRecorder() : null;
 }
 
 /** With a naming fix, `--enum` and `--dedupe-enums`, the run's footer names shared enums. */

package/src/application/ports/deprecation-reporter.ts

@@ -0,0 +1,9 @@
+import type { DeprecationCode } from "../../domain/deprecations.js";
+
+/**
+ * Where the generator reports the use of something 2.0 removes (ENGINEERING_PLAN 4.5). The
+ * adapter decides how often a code is shown; the Node.js one shows each code once per process.
+ */
+export interface DeprecationReporter {
+  report(code: DeprecationCode, message: string): void;
+}

package/src/application/transform/document/components.ts

@@ -19,7 +19,7 @@ import {
   singularizeComponentKind,
 } from "../../../domain/openapi/components-object.js";
 import { createRef } from "../../../domain/openapi/json-pointer.js";
-import { OutputFix } from "../../../domain/output-fixes.js";
+import { FIX } from "../../../domain/output-fixes.js";
 import { type DeprecatedEntryFilter, documentEntries } from "../document-entries.js";
 import type { SchemaLocation } from "../schema/schema-context.js";
 import { transformSchema } from "../schema/schema-transform.js";
@@ -174,7 +174,7 @@ export function componentsType(
   // A plain object, as in the original: its key order (integer-like names first) is the
   // output order.
   const aliases: Record<string, IrTypeAliasDeclaration> = {};
-  const displaced = context.options.fixes.has(OutputFix.ROOT_TYPE_NUMBERING) ? [] : null;
+  const displaced = context.options.fixes.has(FIX.ROOT_TYPE_NUMBERING) ? [] : null;
   const isKept = (item: unknown) => kept.has(item as object);
   const request = { components, isKept, aliases, displaced };
   const declaredKinds = DECLARED_COMPONENT_KINDS.filter((kind) => components[kind] !== undefined);

package/src/application/transform/document/parameters.ts

@@ -16,7 +16,7 @@ import {
   QUERYSTRING_LOCATION,
 } from "../../../domain/openapi/parameter-object.js";
 import type { SchemaObject } from "../../../domain/openapi/schema-object.js";
-import { OutputFix } from "../../../domain/output-fixes.js";
+import { FIX } from "../../../domain/output-fixes.js";
 import { refType } from "../ref-type.js";
 import type { SchemaLocation } from "../schema/schema-context.js";
 import { withSchemaComment } from "../schema-comment.js";
@@ -166,7 +166,7 @@ function querystringMember(
 /** With `exploded-query-objects`, whether the parameter's object keys are keys of `query`. */
 function isExplodedEntry(entry: ResolvedEntry, context: TransformContext): boolean {
   return (
-    context.options.fixes.has(OutputFix.EXPLODED_QUERY_OBJECTS) &&
+    context.options.fixes.has(FIX.EXPLODED_QUERY_OBJECTS) &&
     isExplodedQueryObject(entry.resolved, context.refs)
   );
 }

package/src/application/transform/document/paths.ts

@@ -14,7 +14,7 @@ import {
   pathItemOperations,
 } from "../../../domain/openapi/path-item-object.js";
 import type { ReferenceSchema, SchemaObject } from "../../../domain/openapi/schema-object.js";
-import { OutputFix } from "../../../domain/output-fixes.js";
+import { FIX } from "../../../domain/output-fixes.js";
 import { documentEntries } from "../document-entries.js";
 import { refType } from "../ref-type.js";
 import type { TransformContext } from "../transform-context.js";
@@ -112,7 +112,7 @@ function pathTemplateParts(
     const schema = parameters.get(match.slice(1, -1))?.schema as SchemaObject | undefined;
     return { match, type: PLACEHOLDERS.get(schema?.type) ?? STRING_PLACEHOLDER };
   });
-  return context.options.fixes.has(OutputFix.PATH_PARAM_TYPE_NAMES)
+  return context.options.fixes.has(FIX.PATH_PARAM_TYPE_NAMES)
     ? splitTemplateParts(url, matches)
     : replacedTemplateParts(url, matches);
 }

package/src/application/transform/ref-pointer/pointer-type.ts

@@ -1,6 +1,6 @@
 import { irReference } from "../../../domain/ir/constructors.js";
 import type { IrType } from "../../../domain/ir/nodes.js";
-import { OutputFix } from "../../../domain/output-fixes.js";
+import { FIX } from "../../../domain/output-fixes.js";
 import { InvalidRefError, refType } from "../ref-type.js";
 import type { SchemaRequest } from "../schema/schema-rule.js";
 import { generatedLocationOf } from "./generated-location.js";
@@ -62,9 +62,7 @@ function correctedType(
 
 function isCorrected(pointer: RefPointer, request: SchemaRequest): boolean {
   const { options, refs } = request.context;
-  return (
-    options.fixes.has(OutputFix.REF_POINTERS) || originalIndexFails({ pointer, options, refs })
-  );
+  return options.fixes.has(FIX.REF_POINTERS) || originalIndexFails({ pointer, options, refs });
 }
 
 /** The type of a schema `$ref`. Throws InvalidRefError when the `$ref` has no pointer. */

package/src/application/transform/schema/access-flags.ts

@@ -1,5 +1,5 @@
 import type { Schema, SchemaObject } from "../../../domain/openapi/schema-object.js";
-import { OutputFix } from "../../../domain/output-fixes.js";
+import { FIX } from "../../../domain/output-fixes.js";
 import type { SchemaContext } from "./schema-context.js";
 
 /** Whether a property is `readOnly` or `writeOnly` (JSON Schema 2020-12 Validation §9.4). */
@@ -56,7 +56,7 @@ export function propertyAccessFlags(value: Schema, context: SchemaContext): Acce
   if (typeof value !== "object") {
     return NO_FLAGS;
   }
-  if (!context.options.fixes.has(OutputFix.READ_WRITE_REFS)) {
+  if (!context.options.fixes.has(FIX.READ_WRITE_REFS)) {
     return ownFlags(value as SchemaObject);
   }
   return appliedFlags(value, context, new Set());

package/src/application/transform/schema/array-type.ts

@@ -7,7 +7,7 @@ import {
 } from "../../../domain/ir/constructors.js";
 import type { IrTupleElement, IrType } from "../../../domain/ir/nodes.js";
 import type { Schema, SchemaObject } from "../../../domain/openapi/schema-object.js";
-import { OutputFix } from "../../../domain/output-fixes.js";
+import { FIX } from "../../../domain/output-fixes.js";
 import { UNKNOWN_TYPE } from "../shared-types.js";
 import { unionOf } from "../type-combinators.js";
 import type { SchemaRequest } from "./schema-rule.js";
@@ -79,9 +79,7 @@ function prefixItemsTupleType(
 }
 
 function isPrefixItemsFixed(schema: SchemaObject, request: SchemaRequest): boolean {
-  return (
-    schema.prefixItems !== undefined && request.context.options.fixes.has(OutputFix.PREFIX_ITEMS)
-  );
+  return schema.prefixItems !== undefined && request.context.options.fixes.has(FIX.PREFIX_ITEMS);
 }
 
 /** The type of one item; `unknown` without `items`. */
@@ -193,7 +191,7 @@ function fixedArrayType(schema: SchemaObject, request: SchemaRequest): IrType {
 
 function isArrayLengthFixed(request: SchemaRequest): boolean {
   const { arrayLength, fixes } = request.context.options;
-  return arrayLength && fixes.has(OutputFix.ARRAY_LENGTH_TUPLES);
+  return arrayLength && fixes.has(FIX.ARRAY_LENGTH_TUPLES);
 }
 
 /** `type: array`, including tuples (`prefixItems`, array `items`) and `--array-length`. */

package/src/application/transform/schema/composition-type.ts

@@ -2,7 +2,7 @@ import { irKeyword, irRecord } from "../../../domain/ir/constructors.js";
 import type { IrType } from "../../../domain/ir/nodes.js";
 import { createRef } from "../../../domain/openapi/json-pointer.js";
 import type { Schema, SchemaObject } from "../../../domain/openapi/schema-object.js";
-import { OutputFix } from "../../../domain/output-fixes.js";
+import { FIX } from "../../../domain/output-fixes.js";
 import { requirableRefType } from "../ref-pointer/pointer-type.js";
 import { UNKNOWN_TYPE } from "../shared-types.js";
 import {
@@ -58,7 +58,7 @@ function keysToRequire(
   if (!request.context.discriminators.isHandled(ref)) {
     return defined;
   }
-  if (!request.context.options.fixes.has(OutputFix.DISCRIMINATOR_MEMBER_REQUIRED)) {
+  if (!request.context.options.fixes.has(FIX.DISCRIMINATOR_MEMBER_REQUIRED)) {
     return [];
   }
   return defined.filter((key) => !target.required?.includes(key));
@@ -131,7 +131,7 @@ function allOfItemType(
   const isUnion =
     unionItem !== undefined &&
     !unionItem.isMapped &&
-    request.context.options.fixes.has(OutputFix.ALLOF_DISCRIMINATED_UNION);
+    request.context.options.fixes.has(FIX.ALLOF_DISCRIMINATED_UNION);
   if (!propertyName || isUnion) {
     return type;
   }
@@ -173,7 +173,7 @@ function anyOfType(
   if (variants.length === 0 || previous === null) {
     return variants.length === 0 ? previous : unionOf(variants);
   }
-  if (!request.context.options.fixes.has(OutputFix.ANYOF_PROPERTIES)) {
+  if (!request.context.options.fixes.has(FIX.ANYOF_PROPERTIES)) {
     return unionOf([previous, ...variants]);
   }
   return Array.isArray(schema.type) ? previous : intersectionOf([previous, unionOf(variants)]);

package/src/application/transform/schema/enum-rule.ts

@@ -8,7 +8,7 @@ import {
 import type { IrType } from "../../../domain/ir/nodes.js";
 import { createRef, parseRefPointer } from "../../../domain/openapi/json-pointer.js";
 import type { SchemaObject } from "../../../domain/openapi/schema-object.js";
-import { OutputFix } from "../../../domain/output-fixes.js";
+import { FIX } from "../../../domain/output-fixes.js";
 import { literalType } from "../literal-type.js";
 import { refType } from "../ref-type.js";
 import { intersectionOf, unionOf } from "../type-combinators.js";
@@ -55,7 +55,7 @@ function hasEnumMetadata(schema: SchemaObject): boolean {
  */
 function tsEnumEntries(schema: SchemaObject, options: SchemaOptions): [unknown, number][] {
   const entries = (schema.enum ?? []).map((value, index): [unknown, number] => [value, index]);
-  return options.fixes.has(OutputFix.NULLABLE_ENUMS)
+  return options.fixes.has(FIX.NULLABLE_ENUMS)
     ? entries.filter(([value]) => value !== null)
     : entries;
 }
@@ -147,9 +147,7 @@ export function ownerEnumMembersType(
   request: SchemaRequest,
 ): IrType | null {
   const { options, discriminators, footer } = request.context;
-  const parent: DiscriminatorEnumParent | undefined = options.fixes.has(
-    OutputFix.DISCRIMINATOR_VALUES,
-  )
+  const parent: DiscriminatorEnumParent | undefined = options.fixes.has(FIX.DISCRIMINATOR_VALUES)
     ? discriminators.enumParentOf(key)
     : undefined;
   if (parent === undefined || !isTsEnum(parent.schema, options)) {
@@ -175,7 +173,7 @@ function tsEnumType(schema: SchemaObject, request: SchemaRequest): IrType {
       irReference(footer.addEnum(enumRequest(schema, request.location.path, options))),
       schema,
     );
-  return options.fixes.has(OutputFix.NULLABLE_ENUMS) && isNullAllowed(schema)
+  return options.fixes.has(FIX.NULLABLE_ENUMS) && isNullAllowed(schema)
     ? unionOf([type, irKeyword("null")])
     : type;
 }

package/src/application/transform/schema/presence-members.ts

@@ -1,5 +1,5 @@
 import type { Schema, SchemaObject } from "../../../domain/openapi/schema-object.js";
-import { OutputFix } from "../../../domain/output-fixes.js";
+import { FIX } from "../../../domain/output-fixes.js";
 import type { SchemaRequest } from "./schema-rule.js";
 
 /**
@@ -81,7 +81,7 @@ export interface AllOfMembers {
  */
 export function allOfMembers(members: readonly Schema[], request: SchemaRequest): AllOfMembers {
   const unchanged = { members, required: [] };
-  if (!request.context.options.fixes.has(OutputFix.ALLOF_REQUIRED)) {
+  if (!request.context.options.fixes.has(FIX.ALLOF_REQUIRED)) {
     return unchanged;
   }
   const schemas = members.map((member) => memberSchema(member, request));

package/src/application/transform/schema/required-variants.ts

@@ -1,6 +1,6 @@
 import type { IrType } from "../../../domain/ir/nodes.js";
 import type { Schema, SchemaObject } from "../../../domain/openapi/schema-object.js";
-import { OutputFix } from "../../../domain/output-fixes.js";
+import { FIX } from "../../../domain/output-fixes.js";
 import { unionOf, withRequiredKeys } from "../type-combinators.js";
 import { isKeptProperty } from "./object-type.js";
 import type { SchemaRequest } from "./schema-rule.js";
@@ -55,7 +55,7 @@ export function hasRequiredVariants(
   request: SchemaRequest,
 ): boolean {
   return (
-    request.context.options.fixes.has(OutputFix.ANYOF_ONEOF_REQUIRED) &&
+    request.context.options.fixes.has(FIX.ANYOF_ONEOF_REQUIRED) &&
     isObjectTyped(schema) &&
     requiredKeyLists(schema, variants, request) !== null
   );
@@ -73,7 +73,7 @@ export function requiredVariantsType(
   variants: readonly Schema[],
   request: SchemaRequest,
 ): IrType | null {
-  if (!request.context.options.fixes.has(OutputFix.ANYOF_ONEOF_REQUIRED) || previous === null) {
+  if (!request.context.options.fixes.has(FIX.ANYOF_ONEOF_REQUIRED) || previous === null) {
     return null;
   }
   const keyLists = isObjectTyped(schema) ? requiredKeyLists(schema, variants, request) : null;

package/src/application/transform/schema/unevaluated-properties.ts

@@ -6,7 +6,7 @@ import {
 } from "../../../domain/ir/constructors.js";
 import type { IrMember, IrType } from "../../../domain/ir/nodes.js";
 import type { Schema, SchemaObject } from "../../../domain/openapi/schema-object.js";
-import { OutputFix } from "../../../domain/output-fixes.js";
+import { FIX } from "../../../domain/output-fixes.js";
 import { HELPER_TYPES } from "../helper-types.js";
 import { UNKNOWN_TYPE } from "../shared-types.js";
 import { unionOf } from "../type-combinators.js";
@@ -32,7 +32,7 @@ import type { SchemaRequest } from "./schema-rule.js";
 function unevaluatedSchemaOf(schema: SchemaObject, request: SchemaRequest): Schema | null {
   const { unevaluatedProperties } = schema;
   if (
-    !request.context.options.fixes.has(OutputFix.UNEVALUATED_PROPERTIES) ||
+    !request.context.options.fixes.has(FIX.UNEVALUATED_PROPERTIES) ||
     unevaluatedProperties === undefined ||
     unevaluatedProperties === false ||
     schema.additionalProperties !== undefined

package/src/application/transform/schema-comment.ts

@@ -1,5 +1,5 @@
 import type { IrComment, IrPropertySignature } from "../../domain/ir/nodes.js";
-import { OutputFix } from "../../domain/output-fixes.js";
+import { FIX, type OutputFix } from "../../domain/output-fixes.js";
 
 /** Schema fields that produce JSDoc lines (the original `AnnotatedSchemaObject`). */
 export interface AnnotatedSchema {
@@ -44,7 +44,7 @@ export const ORIGINAL_SCHEMA_COMMENT: SchemaCommentOptions = { hasMemberDescript
 
 /** How the fixes turned on write a schema's JSDoc. */
 export function schemaCommentOptionsOf(fixes: ReadonlySet<OutputFix>): SchemaCommentOptions {
-  return { hasMemberDescriptions: fixes.has(OutputFix.ANYOF_ONEOF_DESCRIPTIONS) };
+  return { hasMemberDescriptions: fixes.has(FIX.ANYOF_ONEOF_DESCRIPTIONS) };
 }
 
 function formatValue(value: unknown): string {

package/src/domain/deprecations.ts

@@ -0,0 +1,15 @@
+/**
+ * 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. */
+export const DEPRECATION_CODES = {
+  OPENAPI_TYPESAFE_DEP_STRING_TO_AST: "OPENAPI_TYPESAFE_DEP_STRING_TO_AST",
+  OPENAPI_TYPESAFE_DEP_TS_TRANSFORM: "OPENAPI_TYPESAFE_DEP_TS_TRANSFORM",
+  OPENAPI_TYPESAFE_DEP_TS_POST_TRANSFORM: "OPENAPI_TYPESAFE_DEP_TS_POST_TRANSFORM",
+  OPENAPI_TYPESAFE_DEP_TS_TRANSFORM_PROPERTY: "OPENAPI_TYPESAFE_DEP_TS_TRANSFORM_PROPERTY",
+} as const;
+
+export type DeprecationCode = (typeof DEPRECATION_CODES)[keyof typeof DEPRECATION_CODES];

package/src/domain/errors.ts

@@ -7,7 +7,10 @@ import { redactUrlCredentials } from "./url-credentials.js";
  * 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.
+ */
 export const ERROR_CODES = {
   SCHEMA_SOURCE_EMPTY: "SCHEMA_SOURCE_EMPTY",
   SCHEMA_SOURCE_INVALID: "SCHEMA_SOURCE_INVALID",
@@ -39,7 +42,10 @@ export const ERROR_CODES = {
 
 export 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).
+ */
 export type ErrorDetails = Readonly<Record<string, unknown>>;
 
 export interface OpenAPITypesafeErrorInit {

package/src/domain/output-fixes.ts

@@ -3,9 +3,10 @@ import { ERROR_CODES, OpenAPITypesafeError } from "./errors.js";
 /**
  * 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).
  */
-export const OutputFix = {
+export const FIX = {
   /** An `allOf` `$ref` to a discriminated union is the union, without `Omit` or a schema name. */
   ALLOF_DISCRIMINATED_UNION: "allof-discriminated-union",
   /** An `allOf` member with only `required` makes those properties of the others required. */
@@ -48,18 +49,19 @@ export const OutputFix = {
   /** `unevaluatedProperties` types the keys no other keyword declares (an index signature). */
   UNEVALUATED_PROPERTIES: "unevaluated-properties",
 } as const;
-export type OutputFix = (typeof OutputFix)[keyof typeof OutputFix];
+/** The name of one opt-in output fix. */
+export type OutputFix = (typeof FIX)[keyof typeof FIX];
 
 /** Every fix of this version, in the order the docs list them. */
-export const OUTPUT_FIXES: readonly OutputFix[] = Object.values(OutputFix);
+export const OUTPUT_FIXES: readonly OutputFix[] = Object.values(FIX);
 
 /** The name that turns on every fix of the installed version. */
-export const ALL_OUTPUT_FIXES = "all";
+const ALL_FIXES = "all";
 
-/** A name the `fix` option accepts: one fix, or `all`. */
-export type OutputFixName = OutputFix | typeof ALL_OUTPUT_FIXES;
+/** A name the `fix` option accepts: one fix, or `"all"`. */
+export type OutputFixName = OutputFix | typeof ALL_FIXES;
 
-const KNOWN_NAMES: ReadonlySet<string> = new Set<string>([...OUTPUT_FIXES, ALL_OUTPUT_FIXES]);
+const KNOWN_NAMES: ReadonlySet<string> = new Set<string>([...OUTPUT_FIXES, ALL_FIXES]);
 
 function isOutputFixName(value: unknown): value is OutputFixName {
   return typeof value === "string" && KNOWN_NAMES.has(value);
@@ -82,7 +84,7 @@ export function outputFixNamesOf(values: readonly unknown[]): readonly OutputFix
 
 /** The fixes the names turn on; `all` stands for every fix of this version. */
 export function resolveOutputFixes(names: readonly OutputFixName[]): ReadonlySet<OutputFix> {
-  return new Set(names.flatMap((name) => (name === ALL_OUTPUT_FIXES ? OUTPUT_FIXES : [name])));
+  return new Set(names.flatMap((name) => (name === ALL_FIXES ? OUTPUT_FIXES : [name])));
 }
 
 /** A generator option that a fix works with; without it, the fix changes nothing (ADR-021). */
@@ -106,13 +108,11 @@ const NO_SCHEMA_PREFIX = {
 
 /** The options each fix needs, by fix name; `all` has none. */
 const REQUIREMENTS: Readonly<Partial<Record<OutputFixName, readonly OutputFixRequirement[]>>> = {
-  [OutputFix.ARRAY_LENGTH_TUPLES]: [{ option: "arrayLength", flag: "--array-length" }],
-  [OutputFix.DEDUPE_ENUM_NAMES]: [ENUM, { option: "dedupeEnums", flag: "--dedupe-enums" }],
-  [OutputFix.NULLABLE_ENUMS]: [ENUM],
-  [OutputFix.PATH_PARAM_TYPE_NAMES]: [
-    { option: "pathParamsAsTypes", flag: "--path-params-as-types" },
-  ],
-  [OutputFix.ROOT_TYPE_NUMBERING]: [ROOT_TYPES, NO_SCHEMA_PREFIX],
+  [FIX.ARRAY_LENGTH_TUPLES]: [{ option: "arrayLength", flag: "--array-length" }],
+  [FIX.DEDUPE_ENUM_NAMES]: [ENUM, { option: "dedupeEnums", flag: "--dedupe-enums" }],
+  [FIX.NULLABLE_ENUMS]: [ENUM],
+  [FIX.PATH_PARAM_TYPE_NAMES]: [{ option: "pathParamsAsTypes", flag: "--path-params-as-types" }],
+  [FIX.ROOT_TYPE_NUMBERING]: [ROOT_TYPES, NO_SCHEMA_PREFIX],
 };
 
 function describeRequirement(requirement: OutputFixRequirement): string {

package/src/domain/warnings.ts

@@ -12,7 +12,6 @@ export const WARNING_CODES = {
   DISCRIMINATOR_VALUE_NOT_ALLOWED: "DISCRIMINATOR_VALUE_NOT_ALLOWED",
   ENUM_VALUES_EXCLUDED: "ENUM_VALUES_EXCLUDED",
   FIX_NEEDS_OPTION: "FIX_NEEDS_OPTION",
-  LEGACY_CALLBACK_DEPRECATED: "LEGACY_CALLBACK_DEPRECATED",
   LINT_PROBLEM: "LINT_PROBLEM",
   PATH_TEMPLATES_IDENTICAL: "PATH_TEMPLATES_IDENTICAL",
   QUERYSTRING_NEXT_TO_QUERY: "QUERYSTRING_NEXT_TO_QUERY",

package/src/index.ts

@@ -34,6 +34,7 @@ export {
   UNDEFINED,
   UNKNOWN,
 } from "./api/type-helpers.js";
+export { DEPRECATION_CODES, type DeprecationCode } from "./domain/deprecations.js";
 export {
   ERROR_CODES,
   type ErrorCode,
@@ -42,12 +43,7 @@ export {
   OpenAPITypesafeError,
 } from "./domain/errors.js";
 export type * from "./domain/ir/nodes.js";
-export {
-  ALL_OUTPUT_FIXES,
-  OUTPUT_FIXES,
-  OutputFix,
-  type OutputFixName,
-} from "./domain/output-fixes.js";
+export { OUTPUT_FIXES, type OutputFix, type OutputFixName } from "./domain/output-fixes.js";
 export { WARNING_CODES, type WarningCode } from "./domain/warnings.js";
 export { default as transformComponentsObject } from "./transform/components-object.js";
 export { default as transformHeaderObject } from "./transform/header-object.js";