@backstage/cli 0.34.4-next.2 → 0.34.4

package/CHANGELOG.md

@@ -1,5 +1,70 @@
 # @backstage/cli
 
+## 0.34.4
+
+### Patch Changes
+
+- f2cf564: Removed the script transform cache from the default Jest configuration. The script cache provided a moderate performance boost, but it is incompatible with Jest 30.
+- 33faad2: Allow using custom manifest location in the yarn plugin and version bump.
+
+  The Backstage yarn plugin and version bump allows two new environment variables to configure custom manifest location:
+
+  - `BACKSTAGE_VERSIONS_BASE_URL`: The base URL for fetching the Backstage version
+    manifest. Defaults to `https://versions.backstage.io/v1/releases/VERSION/manifest.json`.
+    Useful for running the plugin in environment without direct access to the internet,
+    for example by using a mirror of the versions API or a proxy.
+    Note that the environment variable is just the host name, and the path is appended by
+    the plugin. If you are using the yarn plugin, bump version command will also try
+    to fetch the new version of the yarn plugin from the same base URL (defaults to
+    `https://versions.backstage.io/v1/releases/RELEASE/yarn-plugin`)
+  - `BACKSTAGE_MANIFEST_FILE`: Path to a local manifest file. If set, the plugin
+    will not attempt to fetch the manifest from the network. Useful for running
+    the plugin in environment without internet access and without mirror of the
+    versions API.
+
+- 6ebc1ea: Fixed module federation config by only setting `import: false` on shared libraries for remote.
+- ab96bb7: Added a new `--entrypoint` option to the `package start` command, which allows you to specify a custom entry directory/file for development applications. This is particularly useful when maintaining separate dev apps for different versions of your plugin (e.g., stable and alpha).
+
+  **Example usage:**
+
+  Consider the following plugin dev folder structure:
+
+  ```
+  dev/
+    index.tsx
+    alpha/
+      index.ts
+  ```
+
+  - The default `yarn package start` command uses the `dev/` folder as the entry point and executes `dev/index.tsx` file;
+  - Running `yarn package start --entrypoint dev/alpha` will instead use `dev/alpha/` as the entry point and execute `dev/alpha/index.ts` file.
+
+- 024645e: Remove unused @octokit modules from cli package
+
+  - @octokit/graphql
+  - @octokit/graphql-schema
+  - @octokit/oauth-app
+
+- d14ef24: Added automatic detection and support for the Backstage Yarn plugin when generating new packages with `yarn new`. When the plugin is installed, new packages will automatically use `backstage:^` ranges for `@backstage/*` dependencies.
+- Updated dependencies
+  - @backstage/eslint-plugin@0.1.12
+  - @backstage/integration@1.18.1
+  - @backstage/config-loader@1.10.5
+  - @backstage/config@1.3.5
+
+## 0.34.4-next.3
+
+### Patch Changes
+
+- f2cf564: Removed the script transform cache from the default Jest configuration. The script cache provided a moderate performance boost, but it is incompatible with Jest 30.
+- 024645e: Remove unused @octokit modules from cli package
+
+  - @octokit/graphql
+  - @octokit/graphql-schema
+  - @octokit/oauth-app
+
+- d14ef24: Added automatic detection and support for the Backstage Yarn plugin when generating new packages with `yarn new`. When the plugin is installed, new packages will automatically use `backstage:^` ranges for `@backstage/*` dependencies.
+
 ## 0.34.4-next.2
 
 ### Patch Changes

package/config/jestCachingModuleLoader.js

@@ -16,29 +16,12 @@
 
 const { default: JestRuntime } = require('jest-runtime');
 
-const scriptTransformCache = new Map();
-
 module.exports = class CachingJestRuntime extends JestRuntime {
   constructor(config, ...restArgs) {
     super(config, ...restArgs);
     this.allowLoadAsEsm = config.extensionsToTreatAsEsm.includes('.mts');
   }
 
-  // This may or may not be a good idea. Theoretically I don't know why this would impact
-  // test correctness and flakiness, but it seems like it may introduce flakiness and strange failures.
-  // It does seem to speed up test execution by a fair amount though.
-  createScriptFromCode(scriptSource, filename) {
-    let script = scriptTransformCache.get(scriptSource);
-    if (!script) {
-      script = super.createScriptFromCode(scriptSource, filename);
-      // Tried to store the script object in a WeakRef here. It starts out at
-      // about 90% hit rate, but eventually drops all the way to 20%, and overall
-      // it seemed to increase memory usage by 20% or so.
-      scriptTransformCache.set(scriptSource, script);
-    }
-    return script;
-  }
-
   // Unfortunately we need to use this unstable API to make sure that .js files
   // are only loaded as modules where ESM is supported, i.e. Node.js packages.
   unstable_shouldLoadAsEsm(path, ...restArgs) {

package/dist/lib/version.cjs.js

@@ -61,20 +61,23 @@ function findVersion() {
 }
 const version = findVersion();
 fs__default.default.pathExistsSync(paths.paths.resolveOwn("src"));
-function createPackageVersionProvider(lockfile) {
+function createPackageVersionProvider(lockfile, options) {
   return (name, versionHint) => {
     const packageVersion = packageVersions[name];
+    const lockfileEntries = lockfile?.get(name);
+    const lockfileEntry = lockfileEntries?.find(
+      (entry) => entry.range.startsWith("workspace:")
+    );
+    if (lockfileEntry) {
+      return "workspace:^";
+    }
+    if (options?.preferBackstageProtocol && name.startsWith("@backstage/")) {
+      return "backstage:^";
+    }
     const targetVersion = versionHint || packageVersion;
     if (!targetVersion) {
       throw new Error(`No version available for package ${name}`);
     }
-    const lockfileEntries = lockfile?.get(name);
-    for (const specifier of ["^", "~", "*"]) {
-      const range = `workspace:${specifier}`;
-      if (lockfileEntries?.some((entry) => entry.range === range)) {
-        return range;
-      }
-    }
     const validRanges = lockfileEntries?.filter(
       (entry) => semver__default.default.satisfies(targetVersion, entry.range)
     );

package/dist/lib/yarnPlugin.cjs.js

@@ -0,0 +1,46 @@
+'use strict';
+
+var fs = require('fs-extra');
+var yaml = require('yaml');
+var z = require('zod');
+var paths = require('./paths.cjs.js');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
+
+var fs__default = /*#__PURE__*/_interopDefaultCompat(fs);
+var yaml__default = /*#__PURE__*/_interopDefaultCompat(yaml);
+var z__default = /*#__PURE__*/_interopDefaultCompat(z);
+
+const yarnRcSchema = z__default.default.object({
+  plugins: z__default.default.array(
+    z__default.default.object({
+      path: z__default.default.string()
+    })
+  ).optional()
+});
+async function getHasYarnPlugin() {
+  const yarnRcPath = paths.paths.resolveTargetRoot(".yarnrc.yml");
+  const yarnRcContent = await fs__default.default.readFile(yarnRcPath, "utf-8").catch((e) => {
+    if (e.code === "ENOENT") {
+      return "";
+    }
+    throw e;
+  });
+  if (!yarnRcContent) {
+    return false;
+  }
+  const parseResult = yarnRcSchema.safeParse(yaml__default.default.parse(yarnRcContent));
+  if (!parseResult.success) {
+    throw new Error(
+      `Unexpected content in .yarnrc.yml: ${parseResult.error.toString()}`
+    );
+  }
+  const yarnRc = parseResult.data;
+  const backstagePlugin = yarnRc.plugins?.some(
+    (plugin) => plugin.path === ".yarn/plugins/@yarnpkg/plugin-backstage.cjs"
+  );
+  return Boolean(backstagePlugin);
+}
+
+exports.getHasYarnPlugin = getHasYarnPlugin;
+//# sourceMappingURL=yarnPlugin.cjs.js.map

package/dist/modules/migrate/commands/versions/bump.cjs.js

@@ -2,15 +2,15 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
+var process$1 = require('process');
 var fs = require('fs-extra');
 var chalk = require('chalk');
 var minimatch = require('minimatch');
 var semver = require('semver');
-var yaml = require('yaml');
-var z = require('zod');
 var errors = require('@backstage/errors');
 var path = require('path');
 var paths = require('../../../../lib/paths.cjs.js');
+var yarnPlugin = require('../../../../lib/yarnPlugin.cjs.js');
 var Lockfile = require('../../../../lib/versioning/Lockfile.cjs.js');
 var packages = require('../../../../lib/versioning/packages.cjs.js');
 var cliCommon = require('@backstage/cli-common');
@@ -25,8 +25,6 @@ function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'defau
 var fs__default = /*#__PURE__*/_interopDefaultCompat(fs);
 var chalk__default = /*#__PURE__*/_interopDefaultCompat(chalk);
 var semver__default = /*#__PURE__*/_interopDefaultCompat(semver);
-var yaml__default = /*#__PURE__*/_interopDefaultCompat(yaml);
-var z__default = /*#__PURE__*/_interopDefaultCompat(z);
 
 maybeBootstrapProxy();
 function maybeBootstrapProxy() {
@@ -56,7 +54,7 @@ function extendsDefaultPattern(pattern) {
 var bump = async (opts) => {
   const lockfilePath = paths.paths.resolveTargetRoot("yarn.lock");
   const lockfile = await Lockfile.Lockfile.load(lockfilePath);
-  const hasYarnPlugin = await getHasYarnPlugin();
+  const hasYarnPlugin = await yarnPlugin.getHasYarnPlugin();
   let pattern = opts.pattern;
   if (!pattern) {
     console.log(`Using default pattern glob ${DEFAULT_PATTERN_GLOB}`);
@@ -68,7 +66,12 @@ var bump = async (opts) => {
   }
   let findTargetVersion;
   let releaseManifest;
-  if (semver__default.default.valid(opts.release)) {
+  if (process$1.env.BACKSTAGE_MANIFEST_FILE) {
+    releaseManifest = await fs__default.default.readJson(process$1.env.BACKSTAGE_MANIFEST_FILE);
+    findTargetVersion = createStrictVersionFinder({
+      releaseManifest
+    });
+  } else if (semver__default.default.valid(opts.release)) {
     releaseManifest = await releaseManifests.getManifestByVersion({ version: opts.release });
     findTargetVersion = createStrictVersionFinder({
       releaseManifest
@@ -76,15 +79,18 @@ var bump = async (opts) => {
   } else {
     if (opts.release === "next") {
       const next = await releaseManifests.getManifestByReleaseLine({
-        releaseLine: "next"
+        releaseLine: "next",
+        versionsBaseUrl: process$1.env.BACKSTAGE_VERSIONS_BASE_URL
       });
       const main = await releaseManifests.getManifestByReleaseLine({
-        releaseLine: "main"
+        releaseLine: "main",
+        versionsBaseUrl: process$1.env.BACKSTAGE_VERSIONS_BASE_URL
       });
       releaseManifest = semver__default.default.gt(next.releaseVersion, main.releaseVersion) ? next : main;
     } else {
       releaseManifest = await releaseManifests.getManifestByReleaseLine({
-        releaseLine: opts.release
+        releaseLine: opts.release,
+        versionsBaseUrl: process$1.env.BACKSTAGE_VERSIONS_BASE_URL
       });
     }
     findTargetVersion = createVersionFinder({
@@ -98,11 +104,8 @@ var bump = async (opts) => {
       `Updating yarn plugin to v${releaseManifest.releaseVersion}...`
     );
     console.log();
-    await run.run("yarn", [
-      "plugin",
-      "import",
-      `https://versions.backstage.io/v1/releases/${releaseManifest.releaseVersion}/yarn-plugin`
-    ]);
+    const yarnPluginUrl = process$1.env.BACKSTAGE_VERSIONS_BASE_URL ? `${process$1.env.BACKSTAGE_VERSIONS_BASE_URL}/v1/releases/${releaseManifest.releaseVersion}/yarn-plugin` : `https://versions.backstage.io/v1/releases/${releaseManifest.releaseVersion}/yarn-plugin`;
+    await run.run("yarn", ["plugin", "import", yarnPluginUrl]);
     console.log();
   }
   const dependencyMap = await packages.mapDependencies(paths.paths.targetDir, pattern);
@@ -377,35 +380,6 @@ async function asLockfileVersion(version) {
   }
   return version;
 }
-const yarnRcSchema = z__default.default.object({
-  plugins: z__default.default.array(
-    z__default.default.object({
-      path: z__default.default.string()
-    })
-  ).optional()
-});
-async function getHasYarnPlugin() {
-  const yarnRcPath = paths.paths.resolveTargetRoot(".yarnrc.yml");
-  const yarnRcContent = await fs__default.default.readFile(yarnRcPath, "utf-8").catch((e) => {
-    if (e.code === "ENOENT") {
-      return "";
-    }
-    throw e;
-  });
-  if (!yarnRcContent) {
-    return false;
-  }
-  const parseResult = yarnRcSchema.safeParse(yaml__default.default.parse(yarnRcContent));
-  if (!parseResult.success) {
-    throw new Error(
-      `Unexpected content in .yarnrc.yml: ${parseResult.error.toString()}`
-    );
-  }
-  const yarnRc = parseResult.data;
-  return yarnRc.plugins?.some(
-    (plugin) => plugin.path === ".yarn/plugins/@yarnpkg/plugin-backstage.cjs"
-  );
-}
 
 exports.bumpBackstageJsonVersion = bumpBackstageJsonVersion;
 exports.createStrictVersionFinder = createStrictVersionFinder;

package/dist/modules/new/lib/execution/PortableTemplater.cjs.js

@@ -17,6 +17,7 @@ require('../../../../lib/run.cjs.js');
 require('@backstage/errors');
 var paths = require('../../../../lib/paths.cjs.js');
 var version = require('../../../../lib/version.cjs.js');
+var yarnPlugin = require('../../../../lib/yarnPlugin.cjs.js');
 
 function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
 
@@ -47,7 +48,10 @@ class PortableTemplater {
       lockfile = await Lockfile.Lockfile.load(paths.paths.resolveTargetRoot("yarn.lock"));
     } catch {
     }
-    const versionProvider = version.createPackageVersionProvider(lockfile);
+    const hasYarnPlugin = await yarnPlugin.getHasYarnPlugin();
+    const versionProvider = version.createPackageVersionProvider(lockfile, {
+      preferBackstageProtocol: hasYarnPlugin
+    });
     const templater = new PortableTemplater(
       {
         versionQuery(name, versionHint) {

package/dist/packages/backend-defaults/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "0.13.0-next.2";
+var version = "0.13.0";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/dist/packages/backend-plugin-api/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "1.4.4-next.0";
+var version = "1.4.4";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/dist/packages/backend-test-utils/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "1.9.1-next.1";
+var version = "1.9.1";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/dist/packages/cli/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "0.34.4-next.2";
+var version = "0.34.4";
 var dependencies = {
 	"@backstage/catalog-model": "workspace:^",
 	"@backstage/cli-common": "workspace:^",
@@ -14,9 +14,6 @@ var dependencies = {
 	"@backstage/types": "workspace:^",
 	"@manypkg/get-packages": "^1.1.3",
 	"@module-federation/enhanced": "^0.9.0",
-	"@octokit/graphql": "^5.0.0",
-	"@octokit/graphql-schema": "^13.7.0",
-	"@octokit/oauth-app": "^4.2.0",
 	"@octokit/request": "^8.0.0",
 	"@rollup/plugin-commonjs": "^26.0.0",
 	"@rollup/plugin-json": "^6.0.0",

package/dist/packages/config/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "1.3.5-next.0";
+var version = "1.3.5";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/dist/packages/core-app-api/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "1.19.1-next.0";
+var version = "1.19.1";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/dist/packages/core-components/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "0.18.2-next.2";
+var version = "0.18.2";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/dist/packages/core-plugin-api/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "1.11.1-next.0";
+var version = "1.11.1";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/dist/packages/dev-utils/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "1.1.15-next.2";
+var version = "1.1.15";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/dist/packages/frontend-defaults/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "0.3.2-next.1";
+var version = "0.3.2";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/dist/packages/frontend-plugin-api/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "0.12.1-next.1";
+var version = "0.12.1";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/dist/packages/frontend-test-utils/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "0.3.7-next.1";
+var version = "0.4.0";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/dist/packages/test-utils/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "1.7.12-next.1";
+var version = "1.7.12";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/dist/packages/theme/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "0.6.9-next.0";
+var version = "0.7.0";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/dist/plugins/auth-backend/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "0.25.5-next.0";
+var version = "0.25.5";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/dist/plugins/auth-backend-module-guest-provider/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "0.2.13-next.0";
+var version = "0.2.13";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/dist/plugins/catalog-node/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "1.19.1-next.0";
+var version = "1.19.1";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/dist/plugins/scaffolder-node/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "0.12.0-next.1";
+var version = "0.12.0";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/dist/plugins/scaffolder-node-test-utils/package.json.cjs.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "0.3.4-next.1";
+var version = "0.3.4";
 
 exports.version = version;
 //# sourceMappingURL=package.json.cjs.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backstage/cli",
-  "version": "0.34.4-next.2",
+  "version": "0.34.4",
   "description": "CLI for developing Backstage plugins and apps",
   "backstage": {
     "role": "cli"
@@ -47,21 +47,18 @@
     ]
   },
   "dependencies": {
-    "@backstage/catalog-model": "1.7.5",
-    "@backstage/cli-common": "0.1.15",
-    "@backstage/cli-node": "0.2.14",
-    "@backstage/config": "1.3.5-next.0",
-    "@backstage/config-loader": "1.10.5-next.0",
-    "@backstage/errors": "1.2.7",
-    "@backstage/eslint-plugin": "0.1.11",
-    "@backstage/integration": "1.18.1-next.1",
-    "@backstage/release-manifests": "0.0.13",
-    "@backstage/types": "1.2.2",
+    "@backstage/catalog-model": "^1.7.5",
+    "@backstage/cli-common": "^0.1.15",
+    "@backstage/cli-node": "^0.2.14",
+    "@backstage/config": "^1.3.5",
+    "@backstage/config-loader": "^1.10.5",
+    "@backstage/errors": "^1.2.7",
+    "@backstage/eslint-plugin": "^0.1.12",
+    "@backstage/integration": "^1.18.1",
+    "@backstage/release-manifests": "^0.0.13",
+    "@backstage/types": "^1.2.2",
     "@manypkg/get-packages": "^1.1.3",
     "@module-federation/enhanced": "^0.9.0",
-    "@octokit/graphql": "^5.0.0",
-    "@octokit/graphql-schema": "^13.7.0",
-    "@octokit/oauth-app": "^4.2.0",
     "@octokit/request": "^8.0.0",
     "@rollup/plugin-commonjs": "^26.0.0",
     "@rollup/plugin-json": "^6.0.0",
@@ -154,22 +151,22 @@
     "zod-validation-error": "^3.4.0"
   },
   "devDependencies": {
-    "@backstage/backend-plugin-api": "1.4.4-next.0",
-    "@backstage/backend-test-utils": "1.9.1-next.1",
-    "@backstage/catalog-client": "1.12.0",
-    "@backstage/config": "1.3.5-next.0",
-    "@backstage/core-app-api": "1.19.1-next.0",
-    "@backstage/core-components": "0.18.2-next.2",
-    "@backstage/core-plugin-api": "1.11.1-next.0",
-    "@backstage/dev-utils": "1.1.15-next.2",
-    "@backstage/errors": "1.2.7",
-    "@backstage/plugin-auth-backend": "0.25.5-next.0",
-    "@backstage/plugin-auth-backend-module-guest-provider": "0.2.13-next.0",
-    "@backstage/plugin-catalog-node": "1.19.1-next.0",
-    "@backstage/plugin-scaffolder-node": "0.12.0-next.1",
-    "@backstage/plugin-scaffolder-node-test-utils": "0.3.4-next.1",
-    "@backstage/test-utils": "1.7.12-next.1",
-    "@backstage/theme": "0.6.9-next.0",
+    "@backstage/backend-plugin-api": "^1.4.4",
+    "@backstage/backend-test-utils": "^1.9.1",
+    "@backstage/catalog-client": "^1.12.0",
+    "@backstage/config": "^1.3.5",
+    "@backstage/core-app-api": "^1.19.1",
+    "@backstage/core-components": "^0.18.2",
+    "@backstage/core-plugin-api": "^1.11.1",
+    "@backstage/dev-utils": "^1.1.15",
+    "@backstage/errors": "^1.2.7",
+    "@backstage/plugin-auth-backend": "^0.25.5",
+    "@backstage/plugin-auth-backend-module-guest-provider": "^0.2.13",
+    "@backstage/plugin-catalog-node": "^1.19.1",
+    "@backstage/plugin-scaffolder-node": "^0.12.0",
+    "@backstage/plugin-scaffolder-node-test-utils": "^0.3.4",
+    "@backstage/test-utils": "^1.7.12",
+    "@backstage/theme": "^0.7.0",
     "@pmmmwh/react-refresh-webpack-plugin": "^0.5.7",
     "@types/cross-spawn": "^6.0.2",
     "@types/ejs": "^3.1.3",