@codama/renderers-js 1.5.1 → 1.5.2

package/README.md

@@ -36,18 +36,21 @@ An object can be passed as a second argument to further configure the renderer.
 
 The `renderVisitor` accepts the following options.
 
-| Name                          | Type                                                                                                                    | Default | Description                                                                                                                                                                                                                                             |
-| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `deleteFolderBeforeRendering` | `boolean`                                                                                                               | `true`  | Whether the base directory should be cleaned before generating new files.                                                                                                                                                                               |
-| `formatCode`                  | `boolean`                                                                                                               | `true`  | Whether we should use Prettier to format the generated code.                                                                                                                                                                                            |
-| `prettierOptions`             | `PrettierOptions`                                                                                                       | `{}`    | The options to use when formatting the code using Prettier.                                                                                                                                                                                             |
-| `asyncResolvers`              | `string[]`                                                                                                              | `[]`    | The exhaustive list of `ResolverValueNode`'s names whose implementation is asynchronous in JavaScript.                                                                                                                                                  |
-| `customAccountData`           | `string[]`                                                                                                              | `[]`    | The names of all `AccountNodes` whose data should be manually written in JavaScript.                                                                                                                                                                    |
-| `customInstructionData`       | `string[]`                                                                                                              | `[]`    | The names of all `InstructionNodes` whose data should be manually written in JavaScript.                                                                                                                                                                |
-| `linkOverrides`               | `Record<'accounts' \| 'definedTypes' \| 'instructions' \| 'pdas' \| 'programs' \| 'resolvers', Record<string, string>>` | `{}`    | A object that overrides the import path of link nodes. For instance, `{ definedTypes: { counter: 'hooked' } }` uses the `hooked` folder to import any link node referring to the `counter` type.                                                        |
-| `dependencyMap`               | `Record<string, string>`                                                                                                | `{}`    | A mapping between import aliases and their actual package name or path in JavaScript.                                                                                                                                                                   |
-| `internalNodes`               | `string[]`                                                                                                              | `[]`    | The names of all nodes that should be generated but not exported by the `index.ts` files.                                                                                                                                                               |
-| `nameTransformers`            | `Partial<NameTransformers>`                                                                                             | `{}`    | An object that enables us to override the names of any generated type, constant or function.                                                                                                                                                            |
-| `nonScalarEnums`              | `string[]`                                                                                                              | `[]`    | The names of enum variants with no data that should be treated as a data union instead of a native `enum` type. This is only useful if you are referencing an enum value in your Codama IDL.                                                            |
-| `renderParentInstructions`    | `boolean`                                                                                                               | `false` | When using nested instructions, whether the parent instructions should also be rendered. When set to `false` (default), only the instruction leaves are being rendered.                                                                                 |
-| `useGranularImports`          | `boolean`                                                                                                               | `false` | Whether to import the `@solana/kit` library using sub-packages such as `@solana/addresses` or `@solana/codecs-strings`. When set to `true`, the main `@solana/kit` library is used which enables generated clients to install it as a `peerDependency`. |
+| Name                          | Type                                                                                                                    | Default | Description                                                                                                                                                                                                                                                                               |
+| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `deleteFolderBeforeRendering` | `boolean`                                                                                                               | `true`  | Whether the base directory should be cleaned before generating new files.                                                                                                                                                                                                                 |
+| `formatCode`                  | `boolean`                                                                                                               | `true`  | Whether we should use Prettier to format the generated code.                                                                                                                                                                                                                              |
+| `prettierOptions`             | `PrettierOptions`                                                                                                       | `{}`    | The options to use when formatting the code using Prettier.                                                                                                                                                                                                                               |
+| `asyncResolvers`              | `string[]`                                                                                                              | `[]`    | The exhaustive list of `ResolverValueNode`'s names whose implementation is asynchronous in JavaScript.                                                                                                                                                                                    |
+| `customAccountData`           | `string[]`                                                                                                              | `[]`    | The names of all `AccountNodes` whose data should be manually written in JavaScript.                                                                                                                                                                                                      |
+| `customInstructionData`       | `string[]`                                                                                                              | `[]`    | The names of all `InstructionNodes` whose data should be manually written in JavaScript.                                                                                                                                                                                                  |
+| `linkOverrides`               | `Record<'accounts' \| 'definedTypes' \| 'instructions' \| 'pdas' \| 'programs' \| 'resolvers', Record<string, string>>` | `{}`    | A object that overrides the import path of link nodes. For instance, `{ definedTypes: { counter: 'hooked' } }` uses the `hooked` folder to import any link node referring to the `counter` type.                                                                                          |
+| `dependencyMap`               | `Record<string, string>`                                                                                                | `{}`    | A mapping between import aliases and their actual package name or path in JavaScript.                                                                                                                                                                                                     |
+| `dependencyVersions`          | `Record<string, string>`                                                                                                | `{}`    | A mapping between external package names — e.g. `@solana/kit` — and the version range we should use for them — e.g. `^5.0.0`. The renderer offers default values for all external dependencies it relies on but this option may be used to override some of these values or add new ones. |
+| `internalNodes`               | `string[]`                                                                                                              | `[]`    | The names of all nodes that should be generated but not exported by the `index.ts` files.                                                                                                                                                                                                 |
+| `nameTransformers`            | `Partial<NameTransformers>`                                                                                             | `{}`    | An object that enables us to override the names of any generated type, constant or function.                                                                                                                                                                                              |
+| `nonScalarEnums`              | `string[]`                                                                                                              | `[]`    | The names of enum variants with no data that should be treated as a data union instead of a native `enum` type. This is only useful if you are referencing an enum value in your Codama IDL.                                                                                              |
+| `renderParentInstructions`    | `boolean`                                                                                                               | `false` | When using nested instructions, whether the parent instructions should also be rendered. When set to `false` (default), only the instruction leaves are being rendered.                                                                                                                   |
+| `useGranularImports`          | `boolean`                                                                                                               | `false` | Whether to import the `@solana/kit` library using sub-packages such as `@solana/addresses` or `@solana/codecs-strings`. When set to `true`, the main `@solana/kit` library is used which enables generated clients to install it as a `peerDependency`.                                   |
+| `syncPackageJson`             | `boolean`                                                                                                               | `false` | Whether to update the dependencies of the existing `package.json` — or create a new `package.json` when missing — at the provided `packageFolder` option if provided.                                                                                                                     |
+| `packageFolder`               | `string`                                                                                                                |         | The package folder of the generated JS client — i.e. where the `package.json` lives. Note that this option must be provided for the `syncPackageJson` option to work.                                                                                                                     |

package/dist/index.browser.cjs

@@ -34,6 +34,7 @@ __export(index_exports, {
   addToImportMap: () => addToImportMap,
   createImportMap: () => createImportMap,
   default: () => renderVisitor,
+  getExternalDependencies: () => getExternalDependencies,
   getNameApi: () => getNameApi,
   getRenderMapVisitor: () => getRenderMapVisitor,
   getTypeManifestVisitor: () => getTypeManifestVisitor,
@@ -149,6 +150,10 @@ function importMapToString(importMap, dependencyMap = {}, useGranularImports = f
     return `import { ${innerImports} } from '${module2}';`;
   }).join("\n");
 }
+function getExternalDependencies(importMap, dependencyMap, useGranularImports) {
+  const resolvedImports = resolveImportMapModules(importMap, dependencyMap, useGranularImports);
+  return new Set([...resolvedImports.keys()].filter((module2) => !module2.startsWith(".")));
+}
 function resolveImportMapModules(importMap, dependencyMap, useGranularImports) {
   const dependencyMapWithDefaults = {
     ...useGranularImports ? DEFAULT_GRANULAR_EXTERNAL_MODULE_MAP : DEFAULT_EXTERNAL_MODULE_MAP,
@@ -315,7 +320,7 @@ function mergeTypeManifests(manifests, options = {}) {
 
 // src/visitors/getRenderMapVisitor.ts
 var import_nodes29 = require("@codama/nodes");
-var import_renderers_core13 = require("@codama/renderers-core");
+var import_renderers_core14 = require("@codama/renderers-core");
 var import_visitors_core29 = require("@codama/visitors-core");
 
 // src/fragments/accountFetchHelpers.ts
@@ -492,6 +497,177 @@ function getImportFromFactory(overrides, customAccountData, customInstructionDat
   };
 }
 
+// src/utils/packageJson.ts
+var import_errors2 = require("@codama/errors");
+var import_renderers_core2 = require("@codama/renderers-core");
+var import_semver = require("semver");
+var DEFAULT_DEPENDENCY_VERSIONS = {
+  "@solana/accounts": "^5.0.0",
+  "@solana/addresses": "^5.0.0",
+  "@solana/codecs": "^5.0.0",
+  "@solana/errors": "^5.0.0",
+  "@solana/instructions": "^5.0.0",
+  "@solana/kit": "^5.0.0",
+  "@solana/programs": "^5.0.0",
+  "@solana/rpc-types": "^5.0.0",
+  "@solana/signers": "^5.0.0"
+};
+function syncPackageJson(renderMap, options) {
+  const shouldSyncPackageJson = options.syncPackageJson ?? false;
+  const packageFolder = options.packageFolder;
+  if (!packageFolder) {
+    if (shouldSyncPackageJson) {
+      (0, import_errors2.logWarn)("Cannot sync package.json. Please provide the 'packageFolder' option.");
+    }
+    return;
+  }
+  const packageJsonPath = (0, import_renderers_core2.joinPath)(packageFolder, "package.json");
+  const usedDependencies = getUsedDependencyVersions(
+    renderMap,
+    options.dependencyMap ?? {},
+    options.dependencyVersions ?? {},
+    options.useGranularImports ?? false
+  );
+  if (!shouldSyncPackageJson) {
+    if ((0, import_renderers_core2.fileExists)(packageJsonPath)) {
+      checkExistingPackageJson((0, import_renderers_core2.readJson)(packageJsonPath), usedDependencies);
+    }
+    return;
+  }
+  if ((0, import_renderers_core2.fileExists)(packageJsonPath)) {
+    const packageJson = updateExistingPackageJson((0, import_renderers_core2.readJson)(packageJsonPath), usedDependencies);
+    (0, import_renderers_core2.writeFile)(packageJsonPath, JSON.stringify(packageJson, null, 2) + "\n");
+  } else {
+    const packageJson = createNewPackageJson(usedDependencies);
+    (0, import_renderers_core2.writeFile)(packageJsonPath, JSON.stringify(packageJson, null, 2) + "\n");
+  }
+}
+function createNewPackageJson(dependencyVersions) {
+  return updateExistingPackageJson(
+    {
+      name: "js-client",
+      version: "1.0.0",
+      // eslint-disable-next-line sort-keys-fix/sort-keys-fix
+      description: "",
+      main: "src/index.ts",
+      scripts: { test: 'echo "Error: no test specified" && exit 1' },
+      // eslint-disable-next-line sort-keys-fix/sort-keys-fix
+      keywords: [],
+      // eslint-disable-next-line sort-keys-fix/sort-keys-fix
+      author: ""
+    },
+    dependencyVersions
+  );
+}
+function updateExistingPackageJson(packageJson, dependencyVersions) {
+  const updatedDependencies = { ...packageJson.dependencies };
+  const updatedPeerDependencies = { ...packageJson.peerDependencies };
+  const updatedDevDependencies = { ...packageJson.devDependencies };
+  for (const [dependency, requiredRange] of Object.entries(dependencyVersions)) {
+    let found = false;
+    if (updatedDependencies[dependency]) {
+      updateDependency(updatedDependencies, dependency, requiredRange);
+      found = true;
+    }
+    if (updatedPeerDependencies[dependency]) {
+      updateDependency(updatedPeerDependencies, dependency, requiredRange);
+      found = true;
+    }
+    if (updatedDevDependencies[dependency]) {
+      updateDependency(updatedDevDependencies, dependency, requiredRange);
+      found = true;
+    }
+    if (!found) {
+      const dependencyGroupToAdd = dependency === "@solana/kit" ? updatedPeerDependencies : updatedDependencies;
+      dependencyGroupToAdd[dependency] = requiredRange;
+    }
+  }
+  return {
+    ...packageJson,
+    ...Object.entries(updatedPeerDependencies).length > 0 ? { peerDependencies: updatedPeerDependencies } : {},
+    ...Object.entries(updatedDependencies).length > 0 ? { dependencies: updatedDependencies } : {},
+    ...Object.entries(updatedDevDependencies).length > 0 ? { devDependencies: updatedDevDependencies } : {}
+  };
+}
+function checkExistingPackageJson(packageJson, dependencyVersions) {
+  const missingDependencies = [];
+  const dependenciesToUpdate = [];
+  const existingDependencies = {
+    ...packageJson.devDependencies,
+    ...packageJson.peerDependencies,
+    ...packageJson.dependencies
+  };
+  for (const [dependency, requiredRange] of Object.entries(dependencyVersions)) {
+    if (!existingDependencies[dependency]) {
+      missingDependencies.push(dependency);
+    } else if (shouldUpdateRange(dependency, existingDependencies[dependency], requiredRange)) {
+      dependenciesToUpdate.push(dependency);
+    }
+  }
+  if (missingDependencies.length === 0 && dependenciesToUpdate.length === 0) return;
+  const missingList = missingDependencies.map((d) => `- ${d} missing: ${dependencyVersions[d]}
+`).join("");
+  const outdatedList = dependenciesToUpdate.map((d) => `- ${d} outdated: ${existingDependencies[d]} -> ${dependencyVersions[d]}
+`).join("");
+  (0, import_errors2.logWarn)(
+    `The following dependencies in your \`package.json\` are out-of-date or missing:
+${missingList}${outdatedList}`
+  );
+}
+function getUsedDependencyVersions(renderMap, dependencyMap, dependencyVersions, useGranularImports) {
+  const dependencyVersionsWithDefaults = {
+    ...DEFAULT_DEPENDENCY_VERSIONS,
+    ...dependencyVersions
+  };
+  const fragment2 = mergeFragments([...renderMap.values()], () => "");
+  const usedDependencies = getExternalDependencies(fragment2.imports, dependencyMap, useGranularImports);
+  const [usedDependencyVersion, missingDependencies] = [...usedDependencies].reduce(
+    ([acc, missingDependencies2], dependency) => {
+      const version = dependencyVersionsWithDefaults[dependency];
+      if (version) {
+        acc[dependency] = version;
+      } else {
+        missingDependencies2.add(dependency);
+      }
+      return [acc, missingDependencies2];
+    },
+    [{}, /* @__PURE__ */ new Set()]
+  );
+  if (missingDependencies.size > 0) {
+    throw new import_errors2.CodamaError(import_errors2.CODAMA_ERROR__RENDERERS__MISSING_DEPENDENCY_VERSIONS, {
+      dependencies: [...missingDependencies],
+      message: "Please add these dependencies to the `dependencyVersions` option."
+    });
+  }
+  return usedDependencyVersion;
+}
+function shouldUpdateRange(dependency, currentRange, requiredRange) {
+  try {
+    if ((0, import_semver.subset)(currentRange, requiredRange)) {
+      return false;
+    }
+    const minRequiredVersion = (0, import_semver.minVersion)(requiredRange);
+    const minCurrentVersion = (0, import_semver.minVersion)(currentRange);
+    if (!minCurrentVersion || !minRequiredVersion) {
+      throw new Error("Could not determine minimum versions.");
+    }
+    if ((0, import_semver.lt)(minCurrentVersion, minRequiredVersion)) {
+      return true;
+    }
+    return false;
+  } catch (error) {
+    console.warn(
+      `Could not parse the following ranges for dependency "${dependency}": [${currentRange}] and/or [${requiredRange}]. Caused by: ${error.message}`
+    );
+    return false;
+  }
+}
+function updateDependency(dependencyGroup, dependency, requiredRange) {
+  const currentRange = dependencyGroup[dependency];
+  if (!shouldUpdateRange(dependency, currentRange, requiredRange)) return;
+  dependencyGroup[dependency] = requiredRange;
+}
+
 // src/fragments/accountFetchHelpers.ts
 function getAccountFetchHelpersFragment(scope) {
   const { accountPath, typeManifest: typeManifest2, nameApi, customAccountData } = scope;
@@ -801,7 +977,7 @@ function getAccountPageFragment(scope) {
 
 // src/fragments/discriminatorCondition.ts
 var import_nodes10 = require("@codama/nodes");
-var import_renderers_core2 = require("@codama/renderers-core");
+var import_renderers_core3 = require("@codama/renderers-core");
 var import_visitors_core8 = require("@codama/visitors-core");
 var import_codecs_strings2 = require("@solana/codecs-strings");
 function getDiscriminatorConditionFragment(scope) {
@@ -821,7 +997,7 @@ function getDiscriminatorConditionFragment(scope) {
       }),
       (c) => c.join(" && ")
     ),
-    (f) => (0, import_renderers_core2.mapFragmentContent)(f, (c) => `if (${c}) { ${scope.ifTrue} }`)
+    (f) => (0, import_renderers_core3.mapFragmentContent)(f, (c) => `if (${c}) { ${scope.ifTrue} }`)
   );
 }
 function getSizeConditionFragment(discriminator, scope) {
@@ -987,7 +1163,7 @@ function getDefaultAddress(defaultValue, programId, linkables) {
 
 // src/fragments/instructionByteDelta.ts
 var import_nodes14 = require("@codama/nodes");
-var import_renderers_core3 = require("@codama/renderers-core");
+var import_renderers_core4 = require("@codama/renderers-core");
 var import_visitors_core10 = require("@codama/visitors-core");
 function getInstructionByteDeltaFragment(scope) {
   const { byteDeltas } = (0, import_visitors_core10.getLastNodeFromPath)(scope.instructionPath);
@@ -1020,7 +1196,7 @@ function getByteDeltaFragment(byteDelta, scope) {
     bytesFragment = fragment`${bytesFragment} + ${use("BASE_ACCOUNT_SIZE", "solanaAccounts")}`;
   }
   if (byteDelta.subtract) {
-    bytesFragment = (0, import_visitors_core10.pipe)(bytesFragment, (f) => (0, import_renderers_core3.mapFragmentContent)(f, (c) => `- (${c})`));
+    bytesFragment = (0, import_visitors_core10.pipe)(bytesFragment, (f) => (0, import_renderers_core4.mapFragmentContent)(f, (c) => `- (${c})`));
   }
   return [bytesFragment];
 }
@@ -1074,7 +1250,7 @@ function getInstructionDataFragment(scope) {
 }
 
 // src/fragments/instructionExtraArgs.ts
-var import_renderers_core4 = require("@codama/renderers-core");
+var import_renderers_core5 = require("@codama/renderers-core");
 var import_visitors_core12 = require("@codama/visitors-core");
 function getInstructionExtraArgsFragment(scope) {
   const { instructionPath, extraArgsManifest, nameApi } = scope;
@@ -1082,22 +1258,22 @@ function getInstructionExtraArgsFragment(scope) {
   if ((instructionNode.extraArguments ?? []).length === 0) return;
   const instructionExtraName = nameApi.instructionExtraType(instructionNode.name);
   const looseName = nameApi.dataArgsType(instructionExtraName);
-  return (0, import_renderers_core4.mapFragmentContent)(extraArgsManifest.looseType, (c) => `export type ${looseName} = ${c};`);
+  return (0, import_renderers_core5.mapFragmentContent)(extraArgsManifest.looseType, (c) => `export type ${looseName} = ${c};`);
 }
 
 // src/fragments/instructionFunction.ts
 var import_nodes20 = require("@codama/nodes");
-var import_renderers_core8 = require("@codama/renderers-core");
+var import_renderers_core9 = require("@codama/renderers-core");
 var import_visitors_core17 = require("@codama/visitors-core");
 
 // src/fragments/instructionInputResolved.ts
 var import_nodes17 = require("@codama/nodes");
-var import_renderers_core6 = require("@codama/renderers-core");
+var import_renderers_core7 = require("@codama/renderers-core");
 var import_visitors_core14 = require("@codama/visitors-core");
 
 // src/fragments/instructionInputDefault.ts
 var import_nodes16 = require("@codama/nodes");
-var import_renderers_core5 = require("@codama/renderers-core");
+var import_renderers_core6 = require("@codama/renderers-core");
 var import_visitors_core13 = require("@codama/visitors-core");
 function getInstructionInputDefaultFragment(scope) {
   const { input, optionalAccountStrategy, asyncResolvers, useAsync, nameApi, typeManifestVisitor, getImportFrom } = scope;
@@ -1197,12 +1373,12 @@ function getInstructionInputDefaultFragment(scope) {
         }
         return (0, import_visitors_core13.pipe)(
           (0, import_visitors_core13.visit)(seed.value, typeManifestVisitor).value,
-          (f) => (0, import_renderers_core5.mapFragmentContent)(f, (c) => `${seed.name}: ${c}`)
+          (f) => (0, import_renderers_core6.mapFragmentContent)(f, (c) => `${seed.name}: ${c}`)
         );
       });
       const pdaSeedsFragment = (0, import_visitors_core13.pipe)(
         mergeFragments(pdaSeeds, (renders) => renders.join(", ")),
-        (f) => (0, import_renderers_core5.mapFragmentContent)(f, (c) => `{ ${c} }`)
+        (f) => (0, import_renderers_core6.mapFragmentContent)(f, (c) => `{ ${c} }`)
       );
       if (pdaSeeds.length > 0) {
         pdaArgs.push(pdaSeedsFragment);
@@ -1283,7 +1459,7 @@ function getInstructionInputDefaultFragment(scope) {
         }
       }
       if (ifTrueRenderer && ifFalseRenderer) {
-        return (0, import_renderers_core5.setFragmentContent)(
+        return (0, import_renderers_core6.setFragmentContent)(
           conditionalFragment,
           `if (${condition}) {
 ${ifTrueRenderer.content}
@@ -1292,7 +1468,7 @@ ${ifFalseRenderer.content}
 }`
         );
       }
-      return (0, import_renderers_core5.setFragmentContent)(
+      return (0, import_renderers_core6.setFragmentContent)(
         conditionalFragment,
         `if (${condition}) {
 ${ifTrueRenderer ? ifTrueRenderer.content : ifFalseRenderer?.content}
@@ -1324,7 +1500,7 @@ function getInstructionInputResolvedFragment(scope) {
     if (!inputFragment.content) return [];
     const camelName = (0, import_nodes17.camelCase)(input.name);
     return [
-      (0, import_renderers_core6.mapFragmentContent)(
+      (0, import_renderers_core7.mapFragmentContent)(
         inputFragment,
         (c) => (0, import_nodes17.isNode)(input, "instructionArgumentNode") ? `if (!args.${camelName}) {
 ${c}
@@ -1342,7 +1518,7 @@ ${c}
 
 // src/fragments/instructionInputType.ts
 var import_nodes18 = require("@codama/nodes");
-var import_renderers_core7 = require("@codama/renderers-core");
+var import_renderers_core8 = require("@codama/renderers-core");
 var import_visitors_core15 = require("@codama/visitors-core");
 function getInstructionInputTypeFragment(scope) {
   const { instructionPath, useAsync, nameApi } = scope;
@@ -1402,7 +1578,7 @@ function getDataArgumentsFragments(scope) {
       (0, import_visitors_core15.pipe)(
         fragment`${nameApi.dataArgsType(customData.importAs)}`,
         (f) => mergeFragmentImports(f, [scope.dataArgsManifest.looseType.imports]),
-        (f) => (0, import_renderers_core7.mapFragmentContent)(f, (c) => `${c} & `)
+        (f) => (0, import_renderers_core8.mapFragmentContent)(f, (c) => `${c} & `)
       )
     ];
   }
@@ -1563,7 +1739,7 @@ function getInstructionFunctionFragment(scope) {
   const typeParams = getTypeParamsFragment(instructionNode, programAddressConstant);
   const returnType = getReturnTypeFragment(instructionTypeFragment, hasByteDeltas, useAsync);
   const inputType = getInstructionInputTypeFragment(scope);
-  const inputArg = (0, import_renderers_core8.mapFragmentContent)(getInputTypeCallFragment(scope), (c) => hasInput ? `input: ${c}, ` : "");
+  const inputArg = (0, import_renderers_core9.mapFragmentContent)(getInputTypeCallFragment(scope), (c) => hasInput ? `input: ${c}, ` : "");
   const functionBody = mergeFragments(
     [
       getProgramAddressInitializationFragment(programAddressConstant),
@@ -1694,7 +1870,7 @@ function getInstructionTypeFragment(scope) {
   });
   return (0, import_visitors_core17.pipe)(
     mergeFragments([fragment`TProgramAddress`, ...accountTypeParamsFragments], (c) => c.join(", ")),
-    (f) => (0, import_renderers_core8.mapFragmentContent)(f, (c) => `${instructionTypeName}<${c}>`)
+    (f) => (0, import_renderers_core9.mapFragmentContent)(f, (c) => `${instructionTypeName}<${c}>`)
   );
 }
 function getInputTypeCallFragment(scope) {
@@ -1707,7 +1883,7 @@ function getInputTypeCallFragment(scope) {
 }
 
 // src/fragments/instructionPage.ts
-var import_errors2 = require("@codama/errors");
+var import_errors3 = require("@codama/errors");
 var import_nodes23 = require("@codama/nodes");
 var import_visitors_core20 = require("@codama/visitors-core");
 
@@ -1822,7 +1998,7 @@ const getNextOptionalAccount = () => {
 
 // src/fragments/instructionType.ts
 var import_nodes22 = require("@codama/nodes");
-var import_renderers_core9 = require("@codama/renderers-core");
+var import_renderers_core10 = require("@codama/renderers-core");
 var import_visitors_core19 = require("@codama/visitors-core");
 function getInstructionTypeFragment2(scope) {
   const { instructionPath, nameApi, customInstructionData } = scope;
@@ -1847,7 +2023,7 @@ function getInstructionTypeFragment2(scope) {
   const usesLegacyOptionalAccounts = instructionNode.optionalAccountStrategy === "omitted";
   const accountMetasFragment = mergeFragments(
     instructionNode.accounts.map(
-      (account) => (0, import_renderers_core9.mapFragmentContent)(getInstructionAccountMetaFragment(account), (c) => {
+      (account) => (0, import_renderers_core10.mapFragmentContent)(getInstructionAccountMetaFragment(account), (c) => {
         const typeParam = `TAccount${(0, import_nodes22.pascalCase)(account.name)}`;
         const isLegacyOptional = account.isOptional && usesLegacyOptionalAccounts;
         const type = `${typeParam} extends string ? ${c} : ${typeParam}`;
@@ -1911,7 +2087,7 @@ function getRenamedArgsMap(instruction) {
   const allNames = [...instruction.accounts.map((account) => account.name), ...argNames];
   const duplicates = allNames.filter((e, i, a) => a.indexOf(e) !== i);
   if (duplicates.length === 0) return /* @__PURE__ */ new Map();
-  (0, import_errors2.logWarn)(
+  (0, import_errors3.logWarn)(
     `[JavaScript] Accounts and args of instruction [${instruction.name}] have the following conflicting attributes [${duplicates.join(", ")}]. Thus, the arguments have been renamed to avoid conflicts in the input type.`
   );
   return new Map(duplicates.map((name) => [(0, import_nodes23.camelCase)(name), (0, import_nodes23.camelCase)(`${name}Arg`)]));
@@ -1993,7 +2169,7 @@ function getPdaPageFragment(scope) {
 
 // src/fragments/programAccounts.ts
 var import_nodes25 = require("@codama/nodes");
-var import_renderers_core10 = require("@codama/renderers-core");
+var import_renderers_core11 = require("@codama/renderers-core");
 var import_visitors_core23 = require("@codama/visitors-core");
 function getProgramAccountsFragment(scope) {
   if (scope.programNode.accounts.length === 0) return;
@@ -2033,7 +2209,7 @@ function getProgramAccountsIdentifierFunctionFragment(scope) {
       }),
       (c) => c.join("\n")
     ),
-    (f) => (0, import_renderers_core10.mapFragmentContent)(
+    (f) => (0, import_renderers_core11.mapFragmentContent)(
       f,
       (discriminators) => `export function ${programAccountsIdentifierFunction}(account: { data: ReadonlyUint8Array } | ReadonlyUint8Array): ${programAccountsEnum} {
 const data = 'data' in account ? account.data : account;
@@ -2058,7 +2234,7 @@ function getProgramConstantFragment(scope) {
 
 // src/fragments/programInstructions.ts
 var import_nodes26 = require("@codama/nodes");
-var import_renderers_core11 = require("@codama/renderers-core");
+var import_renderers_core12 = require("@codama/renderers-core");
 var import_visitors_core25 = require("@codama/visitors-core");
 function getProgramInstructionsFragment(scope) {
   if (scope.programNode.instructions.length === 0) return;
@@ -2108,7 +2284,7 @@ function getProgramInstructionsIdentifierFunctionFragment(scope) {
   );
   return (0, import_visitors_core25.pipe)(
     discriminatorsFragment,
-    (f) => (0, import_renderers_core11.mapFragmentContent)(
+    (f) => (0, import_renderers_core12.mapFragmentContent)(
       f,
       (discriminators) => `export function ${programInstructionsIdentifierFunction}(instruction: { data: ReadonlyUint8Array } | ReadonlyUint8Array): ${programInstructionsEnum} {
 const data = 'data' in instruction ? instruction.data : instruction;
@@ -2350,7 +2526,7 @@ function getTypePageFragment(scope) {
 
 // src/visitors/getTypeManifestVisitor.ts
 var import_nodes28 = require("@codama/nodes");
-var import_renderers_core12 = require("@codama/renderers-core");
+var import_renderers_core13 = require("@codama/renderers-core");
 var import_visitors_core28 = require("@codama/visitors-core");
 function getTypeManifestVisitor(input) {
   const { nameApi, linkables, nonScalarEnums, customAccountData, customInstructionData, getImportFrom } = input;
@@ -2492,11 +2668,11 @@ function getTypeManifestVisitor(input) {
           encoder: fragment`['${name}', ${structManifest.encoder}]`,
           looseType: (0, import_visitors_core28.pipe)(
             structManifest.looseType,
-            (f) => (0, import_renderers_core12.mapFragmentContent)(f, (c) => `{ ${kindAttribute},${c.slice(1, -1)}}`)
+            (f) => (0, import_renderers_core13.mapFragmentContent)(f, (c) => `{ ${kindAttribute},${c.slice(1, -1)}}`)
           ),
           strictType: (0, import_visitors_core28.pipe)(
             structManifest.strictType,
-            (f) => (0, import_renderers_core12.mapFragmentContent)(f, (c) => `{ ${kindAttribute},${c.slice(1, -1)}}`)
+            (f) => (0, import_renderers_core13.mapFragmentContent)(f, (c) => `{ ${kindAttribute},${c.slice(1, -1)}}`)
           )
         });
       },
@@ -2522,11 +2698,11 @@ function getTypeManifestVisitor(input) {
           encoder: fragment`['${name}', ${structManifest.encoder}]`,
           looseType: (0, import_visitors_core28.pipe)(
             structManifest.looseType,
-            (f) => (0, import_renderers_core12.mapFragmentContent)(f, (c) => `{ ${kindAttribute},${c.slice(1, -1)}}`)
+            (f) => (0, import_renderers_core13.mapFragmentContent)(f, (c) => `{ ${kindAttribute},${c.slice(1, -1)}}`)
           ),
           strictType: (0, import_visitors_core28.pipe)(
             structManifest.strictType,
-            (f) => (0, import_renderers_core12.mapFragmentContent)(f, (c) => `{ ${kindAttribute},${c.slice(1, -1)}}`)
+            (f) => (0, import_renderers_core13.mapFragmentContent)(f, (c) => `{ ${kindAttribute},${c.slice(1, -1)}}`)
           )
         });
       },
@@ -2596,7 +2772,7 @@ function getTypeManifestVisitor(input) {
             ...manifest,
             value: (0, import_visitors_core28.pipe)(
               manifest.value,
-              (f) => (0, import_renderers_core12.setFragmentContent)(f, `${enumName}.${variantName2}`),
+              (f) => (0, import_renderers_core13.setFragmentContent)(f, `${enumName}.${variantName2}`),
               (f) => addFragmentImports(f, importFrom, [enumName])
             )
           });
@@ -2607,7 +2783,7 @@ function getTypeManifestVisitor(input) {
             ...manifest,
             value: (0, import_visitors_core28.pipe)(
               manifest.value,
-              (f) => (0, import_renderers_core12.setFragmentContent)(f, `${enumFunction}('${variantName}')`),
+              (f) => (0, import_renderers_core13.setFragmentContent)(f, `${enumFunction}('${variantName}')`),
               (f) => addFragmentImports(f, importFrom, [enumFunction])
             )
           });
@@ -2616,7 +2792,7 @@ function getTypeManifestVisitor(input) {
           ...manifest,
           value: (0, import_visitors_core28.pipe)(
             (0, import_visitors_core28.visit)(node.value, self).value,
-            (f) => (0, import_renderers_core12.mapFragmentContent)(f, (c) => `${enumFunction}('${variantName}', ${c})`),
+            (f) => (0, import_renderers_core13.mapFragmentContent)(f, (c) => `${enumFunction}('${variantName}', ${c})`),
             (f) => addFragmentImports(f, importFrom, [enumFunction])
           )
         });
@@ -3056,8 +3232,8 @@ function getArrayLikeSizeOption(count, visitor) {
   }
   const prefixManifest = (0, import_visitors_core28.visit)(count.prefix, visitor);
   return {
-    decoder: (0, import_visitors_core28.pipe)(prefixManifest.decoder, (f) => (0, import_renderers_core12.mapFragmentContent)(f, (c) => `size: ${c}`)),
-    encoder: (0, import_visitors_core28.pipe)(prefixManifest.encoder, (f) => (0, import_renderers_core12.mapFragmentContent)(f, (c) => `size: ${c}`))
+    decoder: (0, import_visitors_core28.pipe)(prefixManifest.decoder, (f) => (0, import_renderers_core13.mapFragmentContent)(f, (c) => `size: ${c}`)),
+    encoder: (0, import_visitors_core28.pipe)(prefixManifest.encoder, (f) => (0, import_renderers_core13.mapFragmentContent)(f, (c) => `size: ${c}`))
   };
 }
 
@@ -3072,6 +3248,7 @@ function getRenderMapVisitor(options = {}) {
     customAccountData,
     customInstructionData,
     dependencyMap: options.dependencyMap ?? {},
+    dependencyVersions: options.dependencyVersions ?? {},
     getImportFrom: getImportFromFactory(options.linkOverrides ?? {}, customAccountData, customInstructionData),
     linkables,
     nameApi: getNameApi({ ...DEFAULT_NAME_TRANSFORMERS, ...options.nameTransformers }),
@@ -3092,12 +3269,12 @@ function getRenderMapVisitor(options = {}) {
     });
   };
   return (0, import_visitors_core29.pipe)(
-    (0, import_visitors_core29.staticVisitor)(() => (0, import_renderers_core13.createRenderMap)(), {
+    (0, import_visitors_core29.staticVisitor)(() => (0, import_renderers_core14.createRenderMap)(), {
       keys: ["rootNode", "programNode", "pdaNode", "accountNode", "definedTypeNode", "instructionNode"]
     }),
     (v) => (0, import_visitors_core29.extendVisitor)(v, {
       visitAccount(node) {
-        return (0, import_renderers_core13.createRenderMap)(
+        return (0, import_renderers_core14.createRenderMap)(
           `accounts/${(0, import_nodes29.camelCase)(node.name)}.ts`,
           asPage(
             getAccountPageFragment({
@@ -3109,7 +3286,7 @@ function getRenderMapVisitor(options = {}) {
         );
       },
       visitDefinedType(node) {
-        return (0, import_renderers_core13.createRenderMap)(
+        return (0, import_renderers_core14.createRenderMap)(
           `types/${(0, import_nodes29.camelCase)(node.name)}.ts`,
           asPage(getTypePageFragment({ ...renderScope, node, size: (0, import_visitors_core29.visit)(node, byteSizeVisitor) }), {
             generatedTypes: "."
@@ -3117,7 +3294,7 @@ function getRenderMapVisitor(options = {}) {
         );
       },
       visitInstruction(node) {
-        return (0, import_renderers_core13.createRenderMap)(
+        return (0, import_renderers_core14.createRenderMap)(
           `instructions/${(0, import_nodes29.camelCase)(node.name)}.ts`,
           asPage(
             getInstructionPageFragment({
@@ -3130,7 +3307,7 @@ function getRenderMapVisitor(options = {}) {
         );
       },
       visitPda(node) {
-        return (0, import_renderers_core13.createRenderMap)(
+        return (0, import_renderers_core14.createRenderMap)(
           `pdas/${(0, import_nodes29.camelCase)(node.name)}.ts`,
           asPage(getPdaPageFragment({ ...renderScope, pdaPath: stack.getPath("pdaNode") }))
         );
@@ -3141,8 +3318,8 @@ function getRenderMapVisitor(options = {}) {
           ...getDefinedTypeNodesToExtract(node.instructions, customInstructionData)
         ];
         const scope = { ...renderScope, programNode: node };
-        return (0, import_renderers_core13.mergeRenderMaps)([
-          (0, import_renderers_core13.createRenderMap)({
+        return (0, import_renderers_core14.mergeRenderMaps)([
+          (0, import_renderers_core14.createRenderMap)({
             [`programs/${(0, import_nodes29.camelCase)(node.name)}.ts`]: asPage(getProgramPageFragment(scope)),
             [`errors/${(0, import_nodes29.camelCase)(node.name)}.ts`]: node.errors.length > 0 ? asPage(getErrorPageFragment(scope)) : void 0
           }),
@@ -3174,8 +3351,8 @@ function getRenderMapVisitor(options = {}) {
           pdasToExport,
           programsToExport
         };
-        return (0, import_renderers_core13.mergeRenderMaps)([
-          (0, import_renderers_core13.createRenderMap)({
+        return (0, import_renderers_core14.mergeRenderMaps)([
+          (0, import_renderers_core14.createRenderMap)({
             ["accounts/index.ts"]: asPage(getIndexPageFragment(accountsToExport)),
             ["errors/index.ts"]: asPage(getIndexPageFragment(programsWithErrorsToExport)),
             ["index.ts"]: asPage(getRootIndexPageFragment(scope)),
@@ -3195,7 +3372,7 @@ function getRenderMapVisitor(options = {}) {
 }
 
 // src/visitors/renderVisitor.ts
-var import_renderers_core14 = require("@codama/renderers-core");
+var import_renderers_core15 = require("@codama/renderers-core");
 var import_visitors_core30 = require("@codama/visitors-core");
 var estreePlugin = __toESM(require("prettier/plugins/estree"));
 var typeScriptPlugin = __toESM(require("prettier/plugins/typescript"));
@@ -3214,14 +3391,15 @@ var DEFAULT_PRETTIER_OPTIONS = {
 function renderVisitor(path, options = {}) {
   return (0, import_visitors_core30.rootNodeVisitor)(async (root) => {
     if (options.deleteFolderBeforeRendering ?? true) {
-      (0, import_renderers_core14.deleteDirectory)(path);
+      (0, import_renderers_core15.deleteDirectory)(path);
     }
     let renderMap = (0, import_visitors_core30.visit)(root, getRenderMapVisitor(options));
     if (options.formatCode ?? true) {
       const prettierOptions = { ...DEFAULT_PRETTIER_OPTIONS, ...options.prettierOptions };
-      renderMap = await (0, import_renderers_core14.mapRenderMapContentAsync)(renderMap, (code) => (0, import_standalone.format)(code, prettierOptions));
+      renderMap = await (0, import_renderers_core15.mapRenderMapContentAsync)(renderMap, (code) => (0, import_standalone.format)(code, prettierOptions));
     }
-    (0, import_renderers_core14.writeRenderMap)(renderMap, path);
+    syncPackageJson(renderMap, options);
+    (0, import_renderers_core15.writeRenderMap)(renderMap, path);
   });
 }
 //# sourceMappingURL=index.browser.cjs.map