di-bag-codemod 0.1.0

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "di-bag-codemod",
+  "version": "0.1.0",
+  "description": "Type-aware DI Bag 0.4-to-0.5 codemod for checker-authenticated API uses and explicit runtime-code and import rules.",
+  "keywords": ["di-bag", "codemod", "migration", "typescript", "dependency-injection", "agents", "coding-agents"],
+  "license": "MIT",
+  "repository": { "type": "git", "url": "git+https://github.com/dany-fedorov/di-bag.git", "directory": "tools/codemod" },
+  "homepage": "https://github.com/dany-fedorov/di-bag/tree/main/tools/codemod#readme",
+  "bugs": { "url": "https://github.com/dany-fedorov/di-bag/issues" },
+  "type": "module",
+  "bin": { "di-bag-codemod": "cli.mjs" },
+  "exports": { ".": "./lib/codemod.mjs", "./package.json": "./package.json" },
+  "files": ["cli.mjs", "lib", "rename-map.json", "rename-map.schema.json"],
+  "engines": { "node": ">=22" },
+  "publishConfig": { "access": "public" },
+  "scripts": { "test": "node --test test/*.test.mjs" },
+  "dependencies": { "typescript": "^6.0.3" }
+}

package/rename-map.json

@@ -0,0 +1,160 @@
+{
+  "$schema": "./rename-map.schema.json",
+  "version": 1,
+  "methods": [
+    { "owner": "Builder", "from": "buildAndStart", "to": "ensureServicesReady", "transform": "build-and-start", "transformNames": { "concurrency": "maxConcurrentServiceKeys" } },
+    { "owner": "Builder", "from": "register", "to": "withServices", "arity": [1] },
+    { "owner": "Builder", "from": "register", "to": "withTokenService", "arity": [2] },
+    { "owner": "Builder", "from": "alias", "to": "withServiceAlias", "arguments": { "kind": "bag", "names": ["aliasKey", "targetServiceKey"] } },
+    { "owner": "Builder", "from": "contribute", "to": "withCollectionContribution", "arguments": { "kind": "bag", "names": ["collectionToken", "provider"] } },
+    { "owner": "Builder", "from": "replace", "to": "withReplacedService" },
+    { "owner": "Builder", "from": "installModule", "to": "withInstalledModules", "arguments": { "kind": "array" } },
+    { "owner": "Builder", "from": "verifyGraph", "to": "verifyGraphAtCompileTime" },
+    { "owner": "Builder", "from": "buildModule", "to": "buildModule", "arguments": { "kind": "bag", "names": ["exportedServiceKeys"], "alreadyBag": true, "trailing": { "mode": "merge", "keys": { "label": "moduleLabel" } } } },
+    { "owner": "Builder", "from": "build", "to": "buildContainer" },
+    { "owner": "token()", "from": "of", "to": "forCollectionOf", "transform": "collection-token", "transformNames": { "single": "forService", "collection": "forCollectionOf" } },
+    { "owner": "DiBagApi", "from": "fromFactory", "to": "createProvider", "transform": "provider-sources", "transformNames": { "factory": "factory", "returnKind": "factoryReturnKind", "receivesContext": "factoryReceivesContext" } },
+    { "owner": "DiBagApi", "from": "fromSyncFactory", "to": "createProvider", "transform": "provider-sources", "transformNames": { "factory": "factory", "returnKind": "factoryReturnKind", "receivesContext": "factoryReceivesContext" } },
+    { "owner": "DiBagApi", "from": "fromAsyncFactory", "to": "createProvider", "transform": "provider-sources", "transformNames": { "factory": "factory", "returnKind": "factoryReturnKind", "receivesContext": "factoryReceivesContext" } },
+    { "owner": "DiBagApi", "from": "fromFunction", "to": "createProviderFromFunction", "transform": "provider-sources", "transformNames": { "dependencies": "dependencies", "callable": "factoryFunction", "returnKind": "factoryReturnKind", "receivesContext": "factoryReceivesContext" } },
+    { "owner": "DiBagApi", "from": "fromClass", "to": "createProviderFromClass", "transform": "provider-sources", "transformNames": { "dependencies": "dependencies", "callable": "serviceClass", "returnKind": "factoryReturnKind" } },
+    { "owner": "DiBagApi", "from": "fromPlugin", "to": "createProviderFromPlugin", "transform": "provider-sources", "transformNames": { "dependencies": "dependencies", "descriptor": "pluginDescriptor", "validator": "isValidPluginOutput", "returnKind": "factoryReturnKind" } },
+    { "owner": "DiBagApi", "from": "withDisposal", "to": "providerWithDisposal", "transform": "provider-facades", "transformNames": { "method": "providerWithDisposal", "provider": "provider", "disposeService": "disposeService" } },
+    { "owner": "DiBagApi", "from": "withLifetime", "to": "providerWithLifetime", "transform": "provider-facades", "transformNames": { "method": "providerWithLifetime", "provider": "provider", "lifetime": "lifetime", "allowsScopedDependencies": "allowsScopedDependencies" } },
+    { "owner": "DiBagApi", "from": "withMetadata", "to": "providerWithRegistrationMetadata", "transform": "provider-facades", "transformNames": { "registrationFacade": "providerWithRegistrationMetadata", "acquisitionFacade": "providerWithAcquisitionMetadata", "provider": "provider", "registrationMetadata": "registrationMetadata", "describeAcquisition": "describeAcquisition", "callbackReceives": "callbackReceives" } },
+    { "owner": "DiBagApi", "from": "transformService", "to": "providerWithTransformedService", "transform": "provider-facades", "transformNames": { "method": "providerWithTransformedService", "provider": "provider", "transformService": "transformService", "callbackReceives": "callbackReceives", "transformReturnKind": "transformReturnKind" } },
+    { "owner": "DiBagApi", "from": "token", "to": "createToken" },
+    { "owner": "DiBagApi", "from": "all", "to": "forCollectionOf", "transform": "collection-reference" },
+    { "owner": "Bag", "from": "resolveAll", "to": "resolveCollection", "transform": "collection-read" },
+    { "owner": "Bag", "from": "inspectAll", "to": "serviceSnapshot", "transform": "collection-read" },
+    { "owner": "Bag", "from": "inspect", "to": "serviceSnapshot" },
+    { "owner": "Bag", "from": "inspectGraph", "to": "graphSnapshot" },
+    { "owner": "Bag", "from": "createScope", "to": "createChildContainer", "arity": [0, 1, 2, 3], "transform": "container-derivation", "transformNames": { "keys": "replacedServiceKeys", "providers": "replacementProviders", "sharing": "sharedParentServiceKeys" } },
+    { "owner": "Bag", "from": "fork", "to": "createIndependentContainer", "arity": [0, 1, 2], "transform": "container-derivation", "transformNames": { "keys": "replacedServiceKeys", "providers": "replacementProviders" } },
+    { "owner": "Module", "from": "renameExport", "to": "withRenamedExport", "arguments": { "kind": "bag", "names": ["currentExportKey", "newExportKey"] } }
+  ],
+  "options": [
+    { "owner": "Bag", "method": "close", "argument": 0, "from": "signal", "to": "abortSignal" },
+    { "owner": "Bag", "method": "close", "argument": 0, "from": "timeoutMs", "to": "waitTimeoutMs" },
+    { "owner": "DiBagApi", "method": "withConfiguration", "argument": 0, "from": "observers", "to": "lifecycleObservers" },
+    { "owner": "DiBagApi", "method": "withLifetime", "argument": 2, "from": "allowScopedDependencies", "to": "allowsScopedDependencies" },
+    { "owner": "DiBagApi", "method": "transformService", "argument": 1, "from": "acquisitionMode", "to": "transformReturnKind" }
+  ],
+  "values": [
+    { "owner": "DiBagApi", "method": "transformService", "argument": 1, "path": ["acquisitionMode"], "from": "auto", "to": "auto-detect" },
+    { "owner": "DiBagApi", "method": "transformService", "argument": 1, "path": ["acquisitionMode"], "from": "raw", "to": "uninspected" },
+    { "owner": "DiBagApi", "method": "transformService", "argument": 1, "path": ["acquisitionMode"], "from": "nativePromise", "to": "native-promise" },
+    { "owner": "DiBagApi", "method": "withLifetime", "argument": 1, "from": "root", "to": "singleton:one-per-container-tree" },
+    { "owner": "DiBagApi", "method": "withLifetime", "argument": 1, "from": "scoped", "to": "scoped:one-per-container" },
+    { "owner": "DiBagApi", "method": "withLifetime", "argument": 1, "from": "transient", "to": "transient:one-per-resolve" },
+    { "owner": "BindingSnapshot", "property": "lifetime", "from": "root", "to": "singleton:one-per-container-tree" },
+    { "owner": "BindingSnapshot", "property": "lifetime", "from": "scoped", "to": "scoped:one-per-container" },
+    { "owner": "BindingSnapshot", "property": "lifetime", "from": "transient", "to": "transient:one-per-resolve" },
+    { "owner": "AcquisitionEventFields", "property": "lifetime", "from": "root", "to": "singleton:one-per-container-tree" },
+    { "owner": "AcquisitionEventFields", "property": "lifetime", "from": "scoped", "to": "scoped:one-per-container" },
+    { "owner": "AcquisitionEventFields", "property": "lifetime", "from": "transient", "to": "transient:one-per-resolve" },
+    { "owner": "LifecycleEvent", "property": "kind", "from": "scope-opened", "to": "container-opened" },
+    { "owner": "LifecycleEvent", "property": "kind", "from": "scope-closing", "to": "container-closing" },
+    { "owner": "LifecycleEvent", "property": "kind", "from": "scope-closed", "to": "container-closed" },
+    { "owner": "LifecycleEvent", "property": "kind", "from": "scope-close-failed", "to": "container-close-failed" },
+    { "owner": "LifecycleEvent", "property": "kind", "from": "cleanup-started", "to": "disposal-started" },
+    { "owner": "LifecycleEvent", "property": "kind", "from": "cleanup-failed", "to": "disposal-failed" },
+    { "owner": "LifecycleEvent", "property": "kind", "from": "cleanup-completed", "to": "disposal-completed" }
+  ],
+  "properties": [
+    { "owner": "Token", "from": "key", "to": "symbol" },
+    { "owner": "CollectionToken", "from": "key", "to": "symbol" },
+    { "owner": "AcquisitionContext", "from": "signal", "to": "abortSignal" },
+    { "owner": "Presence", "from": "present", "to": "isPresent" },
+    { "owner": "RegistrationSnapshot", "from": "label", "to": "bindingLabel" },
+    { "owner": "BindingSnapshot", "from": "keys", "to": "serviceKeys" },
+    { "owner": "BindingSnapshot", "from": "owned", "to": "isOwnedByContainer" },
+    { "owner": "BindingSnapshot", "from": "key", "to": "tokenSymbol" },
+    { "owner": "BindingSnapshot", "from": "kind", "to": "dependencyKind" },
+    { "owner": "GraphSnapshot", "from": "token", "to": "collectionTokenSymbol" },
+    { "owner": "GraphSnapshot", "from": "from", "to": "consumerBindingId" },
+    { "owner": "GraphSnapshot", "from": "to", "to": "dependencyBindingId" },
+    { "owner": "BindingSnapshot", "from": "acquisitionMode", "to": "factoryReturnKind" },
+    { "owner": "CloseOptions", "from": "signal", "to": "abortSignal" },
+    { "owner": "CloseOptions", "from": "timeoutMs", "to": "waitTimeoutMs" },
+    { "owner": "StartupOptions", "from": "signal", "to": "abortSignal" },
+    { "owner": "StartupOptions", "from": "timeoutMs", "to": "totalTimeoutMs" },
+    { "owner": "StartupOptions", "from": "startupOrder", "manual": "startupOrder is gone; use maxConcurrentServiceKeys: omit it for 'parallel', 1 for 'sequential', or the number" },
+    { "owner": "ModuleOptions", "from": "label", "to": "moduleLabel" },
+    { "owner": "DiBagStartupError", "from": "cleanupFailures", "to": "disposalFailures" },
+    { "owner": "DiBagStartupError", "from": "cleanupError", "to": "disposalError" },
+    { "owner": "DiBagStartupCancelledError", "from": "cleanupPromise", "to": "disposalPromise" },
+    { "owner": "DiBagCloseCancelledError", "from": "timeoutMs", "to": "waitTimeoutMs" },
+    { "owner": "DiBagCloseCancelledError", "from": "cleanupPromise", "to": "disposalPromise" },
+    { "owner": "CleanupFailure", "from": "label", "to": "bindingLabel" },
+    { "owner": "CloseProgress", "from": "pending", "to": "disposersStillRunning" },
+    { "owner": "CloseProgress", "from": "acquiring", "to": "acquisitionsStillPending" },
+    { "owner": "ObserverOptions", "from": "onEvent", "to": "onLifecycleEvent" },
+    { "owner": "ObserverOptions", "from": "onError", "to": "onObserverFailure" },
+    { "owner": "ScopeOptions", "from": "share", "to": "sharedParentServiceKeys" },
+    { "owner": "ScopeEventFields", "from": "scopeId", "to": "containerId" },
+    { "owner": "ScopeEventFields", "from": "parentScopeId", "to": "parentContainerId" },
+    { "owner": "AcquisitionEventFields", "from": "scopeId", "to": "containerId" },
+    { "owner": "AcquisitionEventFields", "from": "label", "to": "bindingLabel" },
+    { "owner": "GraphSnapshot", "from": "scopeId", "to": "containerId" },
+    { "owner": "Captive", "from": "root", "to": "singleton" },
+    { "owner": "LifetimeObligation", "from": "root", "to": "singleton" }
+  ],
+  "types": [
+    { "from": "AcquisitionMode", "to": "FactoryReturnKind", "literalValues": { "auto": "auto-detect", "raw": "uninspected", "nativePromise": "native-promise" } },
+    { "from": "AcquisitionContext", "to": "FactoryContext" },
+    { "from": "CompositionArguments", "to": "PositionalFactoryArguments" },
+    { "from": "CompositionFunction", "to": "PositionalFactoryFunction" },
+    { "from": "PluginAcquisitionMode", "to": "PluginReturnKind", "literalValues": { "raw": "uninspected", "nativePromise": "native-promise" } },
+    { "from": "PluginOptions", "to": "CreateProviderFromPluginOptions", "genericArguments": [{ "index": 0, "values": { "raw": "uninspected", "nativePromise": "native-promise" } }] },
+    { "from": "PluginProviderFactory", "to": "CreateProviderFromPlugin" },
+    { "from": "PluginProvider", "to": "PluginProvider", "genericArguments": [{ "index": 2, "values": { "raw": "uninspected", "nativePromise": "native-promise" } }] },
+    { "from": "StartupOptions", "to": "EnsureServicesReadyOptions" },
+    { "from": "DiBagStartupError", "to": "DiBagServiceReadinessError" },
+    { "from": "DiBagStartupCancelledError", "to": "DiBagServiceReadinessCancelledError" },
+    { "from": "DiBagCleanupError", "to": "DiBagDisposalError" },
+    { "from": "CleanupFailure", "to": "DisposalFailure" },
+    { "from": "BuilderContribute", "to": "BuilderWithCollectionContribution" },
+    { "from": "Bag", "to": "Container" },
+    { "from": "ScopeOptions", "to": "CreateChildContainerOptions" },
+    { "from": "CheckedScopeLifetimes", "to": "CheckedChildContainerLifetimes" },
+    { "from": "DisjointScopeSelection", "to": "DisjointChildContainerSelection" },
+    { "from": "ObserverOptions", "to": "LifecycleObserver" },
+    { "from": "Registration", "to": "ProviderOrFactory" },
+    { "from": "FactoryWithDisposal", "to": "Provider" },
+    { "from": "ScopeEventFields", "to": "ContainerEventFields" }
+  ],
+  "codes": [
+    { "from": "DI_BAG_MISSING_REGISTRATION", "to": "DI_BAG_UNKNOWN_SERVICE_KEY" },
+    { "from": "DI_BAG_INVALID_REPLACEMENT", "to": "DI_BAG_UNKNOWN_SERVICE_KEY" },
+    { "from": "DI_BAG_INVALID_ALIAS", "to": "DI_BAG_UNKNOWN_SERVICE_KEY" },
+    { "from": "DI_BAG_DUPLICATE_REGISTRATION", "to": "DI_BAG_DUPLICATE_SERVICE_KEY" },
+    { "from": "DI_BAG_DUPLICATE_METADATA", "to": "DI_BAG_DUPLICATE_METADATA_KEY" },
+    { "from": "DI_BAG_CYCLE", "to": "DI_BAG_DEPENDENCY_CYCLE" },
+    { "from": "DI_BAG_STARTUP_FAILED", "to": "DI_BAG_SERVICE_READINESS_FAILED" },
+    { "from": "DI_BAG_STARTUP_CANCELLED", "to": "DI_BAG_SERVICE_READINESS_CANCELLED" },
+    { "from": "DI_BAG_STARTUP_TIMEOUT", "to": "DI_BAG_SERVICE_READINESS_TIMEOUT" },
+    { "from": "DI_BAG_CLEANUP_FAILED", "to": "DI_BAG_DISPOSAL_FAILED" },
+    { "from": "DI_BAG_CLEANUP_AFTER_FACTORY", "to": "DI_BAG_DISPOSER_PUSHED_AFTER_FACTORY" },
+    { "from": "DI_BAG_INVALID_ACQUISITION_MODE", "to": "DI_BAG_INVALID_ARGUMENT" },
+    { "from": "DI_BAG_INVALID_CLEANUP", "to": "DI_BAG_INVALID_ARGUMENT" },
+    { "from": "DI_BAG_INVALID_CLOSE", "to": "DI_BAG_INVALID_ARGUMENT" },
+    { "from": "DI_BAG_INVALID_CONFIGURATION", "to": "DI_BAG_INVALID_ARGUMENT" },
+    { "from": "DI_BAG_INVALID_CONSTRUCTOR", "to": "DI_BAG_INVALID_ARGUMENT" },
+    { "from": "DI_BAG_INVALID_FACTORY", "to": "DI_BAG_INVALID_ARGUMENT" },
+    { "from": "DI_BAG_INVALID_FUNCTION", "to": "DI_BAG_INVALID_ARGUMENT" },
+    { "from": "DI_BAG_INVALID_LIFETIME", "to": "DI_BAG_INVALID_ARGUMENT" },
+    { "from": "DI_BAG_INVALID_PLUGIN_OPTIONS", "to": "DI_BAG_INVALID_ARGUMENT" },
+    { "from": "DI_BAG_INVALID_TRANSFORM", "to": "DI_BAG_INVALID_ARGUMENT" },
+    { "from": "DI_BAG_INVALID_EXPORT", "manual": "DI_BAG_INVALID_EXPORT was split: DI_BAG_UNKNOWN_SERVICE_KEY for a key the module does not export, DI_BAG_DUPLICATE_SERVICE_KEY for a rename onto an existing export, DI_BAG_INVALID_ARGUMENT for malformed input" },
+    { "from": "DI_BAG_INVALID_METADATA", "manual": "DI_BAG_INVALID_METADATA was split: DI_BAG_INVALID_ACQUISITION_METADATA when a describe callback returns a bad record, DI_BAG_INVALID_ARGUMENT for malformed input" },
+    { "from": "DI_BAG_INVALID_OVERRIDE", "manual": "DI_BAG_INVALID_OVERRIDE was split: DI_BAG_UNKNOWN_SERVICE_KEY, DI_BAG_MISSING_REPLACEMENT_PROVIDER, or DI_BAG_INVALID_ARGUMENT for malformed input" },
+    { "from": "DI_BAG_INVALID_REGISTRATION", "manual": "DI_BAG_INVALID_REGISTRATION was split: DI_BAG_INVALID_PROVIDER for a value that is neither a function nor a provider, DI_BAG_INVALID_ARGUMENT for malformed input" },
+    { "from": "DI_BAG_INVALID_SCOPE", "manual": "DI_BAG_INVALID_SCOPE was split: DI_BAG_UNKNOWN_SERVICE_KEY, DI_BAG_MISSING_REPLACEMENT_PROVIDER, DI_BAG_CONFLICTING_SERVICE_SELECTION, or DI_BAG_INVALID_ARGUMENT for malformed input" },
+    { "from": "DI_BAG_INVALID_STARTUP", "manual": "DI_BAG_INVALID_STARTUP was split: DI_BAG_UNKNOWN_SERVICE_KEY for an unknown key, DI_BAG_INVALID_ARGUMENT for malformed input" }
+  ],
+  "imports": [
+    { "from": "di-bag/node", "to": "di-bag" },
+    { "fromSuffix": "/src/node", "toSuffix": "/src" }
+  ]
+}

package/rename-map.schema.json

@@ -0,0 +1,208 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "di-bag-codemod rename map",
+  "description": "The distance from di-bag 0.4.0 to the current API. Owners are library declaration names: a class, interface or type alias is `Name`, a function is `name()`, a method's inline types are `Owner.method()`. Method and property targets must be safe bare identifiers; type targets must also not be TypeScript keywords or primitive type names.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version"],
+  "properties": {
+    "$schema": { "type": "string", "minLength": 1 },
+    "version": { "const": 1 },
+    "methods": {
+      "description": "A renamed or reshaped method. Several entries may share owner and from when `arity` tells them apart; the first match wins.",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["owner", "from", "to"],
+        "allOf": [
+          { "not": { "required": ["arguments", "transform"] } },
+          { "if": { "required": ["transformNames"] }, "then": { "required": ["transform"] } }
+        ],
+        "properties": {
+          "owner": { "type": "string", "minLength": 1 },
+          "from": { "type": "string", "minLength": 1 },
+          "to": { "type": "string", "minLength": 1, "pattern": "^[A-Za-z_$][A-Za-z0-9_$]*$", "description": "The 0.5 name. Equal to `from` when only the arguments change." },
+          "arity": { "type": "array", "items": { "type": "integer", "minimum": 0 }, "description": "Argument counts this entry applies to. Omit for any." },
+          "arguments": {
+            "oneOf": [
+              {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["kind", "names"],
+                "allOf": [
+                  { "if": { "required": ["alreadyBag"] }, "then": { "properties": { "names": { "maxItems": 1 } } } }
+                ],
+                "properties": {
+                  "kind": { "const": "bag" },
+                  "names": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1, "description": "Bag property for each positional argument, in order." },
+                  "alreadyBag": { "const": true, "description": "The one-argument form may already be this bag. The checker must prove whether it is a bag or a legacy positional value; ambiguous calls are left unchanged for manual migration." },
+                  "trailing": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": ["mode"],
+                    "properties": {
+                      "mode": { "enum": ["merge", "keep", "drop"], "description": "What happens to one extra argument after `names`: merge its properties into the bag, keep it as a second argument, or drop it." },
+                      "keys": { "type": "object", "additionalProperties": { "type": "string", "minLength": 1 }, "description": "Key renames applied while merging." }
+                    }
+                  }
+                }
+              },
+              {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["kind"],
+                "properties": { "kind": { "const": "array", "description": "Wrap the single argument in an array." } }
+              }
+            ]
+          },
+          "transform": { "type": "string", "minLength": 1, "description": "Id of a custom transform in lib/transforms/index.mjs. Excludes `arguments`." },
+          "transformNames": {
+            "type": "object",
+            "minProperties": 1,
+            "additionalProperties": { "type": "string", "minLength": 1 }
+          }
+        }
+      }
+    },
+    "options": {
+      "description": "A renamed key of an object-literal argument, found by position. Works even when the call does not type-check.",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["owner", "method", "argument", "from", "to"],
+        "properties": {
+          "owner": { "type": "string", "minLength": 1 },
+          "method": { "type": "string", "minLength": 1, "description": "The 0.4.0 method name." },
+          "argument": { "type": "integer", "minimum": 0 },
+          "path": { "type": "array", "items": { "type": "string", "minLength": 1 }, "description": "Keys leading to a nested object literal. Omit for the argument itself." },
+          "from": { "type": "string", "minLength": 1 },
+          "to": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "values": {
+      "description": "A renamed string value: either at an argument path of a call, or wherever a library property is compared with or assigned that string.",
+      "type": "array",
+      "items": {
+        "oneOf": [
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["owner", "method", "argument", "from", "to"],
+            "properties": {
+              "owner": { "type": "string", "minLength": 1 },
+              "method": { "type": "string", "minLength": 1 },
+              "argument": { "type": "integer", "minimum": 0 },
+              "path": { "type": "array", "items": { "type": "string", "minLength": 1 }, "description": "Keys leading to the string inside an object-literal argument. Omit when the argument is the string." },
+              "from": { "type": "string", "minLength": 1 },
+              "to": { "type": "string", "minLength": 1 }
+            }
+          },
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["owner", "property", "from", "to"],
+            "properties": {
+              "owner": { "type": "string", "minLength": 1 },
+              "property": { "type": "string", "minLength": 1 },
+              "from": { "type": "string", "minLength": 1 },
+              "to": { "type": "string", "minLength": 1 }
+            }
+          }
+        ]
+      }
+    },
+    "properties": {
+      "description": "A renamed property of a library type: property access, destructuring, and keys of object literals typed by it. `manual` reports every use instead.",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["owner", "from"],
+        "oneOf": [{ "required": ["to"] }, { "required": ["manual"] }],
+        "properties": {
+          "owner": { "type": "string", "minLength": 1 },
+          "from": { "type": "string", "minLength": 1 },
+          "to": { "type": "string", "minLength": 1, "pattern": "^[A-Za-z_$][A-Za-z0-9_$]*$" },
+          "manual": { "type": "string", "minLength": 1, "description": "The sentence shown to the person who has to decide." }
+        }
+      }
+    },
+    "types": {
+      "description": "A renamed export: classes, interfaces, type aliases and error classes, in imports and wherever they are referenced.",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["from", "to"],
+        "properties": {
+          "from": { "type": "string", "minLength": 1 },
+          "to": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "^[A-Za-z_$][A-Za-z0-9_$]*$",
+            "not": { "enum": ["abstract", "accessor", "any", "as", "asserts", "async", "await", "bigint", "boolean", "break", "case", "catch", "class", "const", "constructor", "continue", "debugger", "declare", "default", "delete", "do", "else", "enum", "export", "extends", "false", "finally", "for", "from", "function", "get", "global", "if", "implements", "import", "in", "infer", "instanceof", "interface", "intrinsic", "is", "keyof", "let", "module", "namespace", "never", "new", "null", "number", "object", "of", "out", "override", "package", "private", "protected", "public", "readonly", "require", "return", "satisfies", "set", "static", "string", "super", "switch", "symbol", "this", "throw", "true", "try", "type", "typeof", "undefined", "unique", "unknown", "using", "var", "void", "while", "with", "yield"] }
+          },
+          "genericArguments": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["index", "values"],
+              "properties": {
+                "index": { "type": "integer", "minimum": 0 },
+                "values": {
+                  "type": "object",
+                  "minProperties": 1,
+                  "additionalProperties": { "type": "string", "minLength": 1 }
+                }
+              }
+            }
+          },
+          "literalValues": {
+            "type": "object",
+            "minProperties": 1,
+            "additionalProperties": { "type": "string", "minLength": 1 }
+          }
+        }
+      }
+    },
+    "codes": {
+      "description": "A renamed runtime code. A code that was split has `manual` with the sentence that helps choose.",
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["from"],
+        "oneOf": [{ "required": ["to"] }, { "required": ["manual"] }],
+        "properties": {
+          "from": { "type": "string", "minLength": 1, "pattern": "^DI_BAG_[A-Z_]+$" },
+          "to": { "type": "string", "minLength": 1, "description": "The new code, or the word manual." },
+          "manual": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "imports": {
+      "description": "A rewritten module specifier: an exact match, or the end of a relative path.",
+      "type": "array",
+      "items": {
+        "oneOf": [
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["from", "to"],
+            "properties": { "from": { "type": "string", "minLength": 1 }, "to": { "type": "string", "minLength": 1 } }
+          },
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["fromSuffix", "toSuffix"],
+            "properties": { "fromSuffix": { "type": "string", "minLength": 1 }, "toSuffix": { "type": "string", "minLength": 1 } }
+          }
+        ]
+      }
+    }
+  }
+}