@cedarjs/babel-config 7.0.0-canary.3015 → 7.0.0-canary.3018

package/dist/api.d.ts

@@ -1,9 +1,17 @@
+import type * as BabelCore from '@babel/core';
 import type { PluginOptions, PluginTarget, TransformOptions } from '@babel/core';
 import type { RegisterHookOptions } from './common.js';
 export declare const TARGETS_NODE = "24";
-export declare const getApiSideBabelPresets: ({ presetEnv }?: {
-    presetEnv: boolean;
-}) => TransformOptions["presets"];
+interface ApiSideBabelPresetsOptions {
+    presetEnv?: boolean;
+    /**
+     * Maps a preset's package name to what is put in the `presets` option.
+     * Babel resolves bare package names relative to the file it compiles;
+     * passing a resolver that returns absolute paths makes resolution explicit.
+     */
+    resolvePreset?: (packageName: string) => string;
+}
+export declare const getApiSideBabelPresets: ({ presetEnv, resolvePreset, }?: ApiSideBabelPresetsOptions) => TransformOptions["presets"];
 export type PluginList = PluginShape[];
 type PluginShape = [PluginTarget, PluginOptions, undefined | string] | [PluginTarget, PluginOptions];
 export declare const getApiSideBabelPlugins: ({ forVite }?: {
@@ -43,14 +51,24 @@ export declare const getApiSideBabelOverrides: ({ forVite }?: {
  * (@cedarjs/eslint-config).
  */
 export declare const getApiSideDefaultBabelConfig: () => {
-    presets: import("@babel/core").PluginItem[] | null | undefined;
+    presets: BabelCore.PluginItem[] | null | undefined;
     plugins: PluginList;
-    overrides: TransformOptions[];
+    overrides: BabelCore.TransformOptions[];
     extends: string | undefined;
     babelrc: boolean;
     ignore: string[];
 };
 export declare const registerApiSideBabelHook: ({ plugins, ...rest }?: RegisterHookOptions) => void;
-export declare const transformWithBabel: (sourceCode: string, filename: string, plugins: TransformOptions["plugins"], sourceMaps?: TransformOptions["sourceMaps"], forVite?: boolean, inputSourceMap?: TransformOptions["inputSourceMap"]) => Promise<import("@babel/core").BabelFileResult | null>;
+/**
+ * Runs `sourceCode` through Babel with Cedar's api-side config plus the
+ * project's `api/babel.config.js` when there is one.
+ *
+ * `@babel/core` and `@babel/preset-typescript` are optional peer dependencies
+ * of this package, resolved from the project's api workspace; a missing
+ * install fails with an actionable error. Every caller checks for
+ * `api/babel.config.js` before calling this, so Babel is only ever loaded for
+ * projects that opted into a custom api-side Babel config.
+ */
+export declare const transformWithBabel: (sourceCode: string, filename: string, plugins: TransformOptions["plugins"], sourceMaps?: TransformOptions["sourceMaps"], forVite?: boolean, inputSourceMap?: TransformOptions["inputSourceMap"]) => Promise<BabelCore.BabelFileResult | null>;
 export {};
 //# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAMhF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAUtD,eAAO,MAAM,YAAY,OAAO,CAAA;AAEhC,eAAO,MAAM,sBAAsB,GACjC;;CAAoC,KAqBf,gBAAgB,CAAC,SAAS,CAChD,CAAA;AAKD,MAAM,MAAM,UAAU,GAAG,WAAW,EAAE,CAAA;AACtC,KAAK,WAAW,GACZ,CAAC,YAAY,EAAE,aAAa,EAAE,SAAS,GAAG,MAAM,CAAC,GACjD,CAAC,YAAY,EAAE,aAAa,CAAC,CAAA;AAEjC,eAAO,MAAM,sBAAsB,GAAI;;CAAwB,eA4G9D,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,6BAA6B,QAAO,UAEhD,CAAA;AAED,eAAO,MAAM,yBAAyB,0BAOrC,CAAA;AAED,eAAO,MAAM,wBAAwB,GAAI;;CAAwB,KAU3C,gBAAgB,EACrC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,4BAA4B;;;;;;;CASxC,CAAA;AAGD,eAAO,MAAM,wBAAwB,GAAI,uBAGtC,mBAAwB,SAc1B,CAAA;AAED,eAAO,MAAM,kBAAkB,GAC7B,YAAY,MAAM,EAClB,UAAU,MAAM,EAChB,SAAS,gBAAgB,CAAC,SAAS,CAAC,EACpC,aAAY,gBAAgB,CAAC,YAAY,CAAY,EACrD,iBAAe,EAIf,iBAAgB,gBAAgB,CAAC,gBAAgB,CAAa,0DAoB/D,CAAA"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,SAAS,MAAM,aAAa,CAAA;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAKhF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AActD,eAAO,MAAM,YAAY,OAAO,CAAA;AAKhC,UAAU,0BAA0B;IAClC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,CAAA;CAChD;AAED,eAAO,MAAM,sBAAsB,GAAI,gCAGpC,0BAA+B,KAoBX,gBAAgB,CAAC,SAAS,CAChD,CAAA;AAKD,MAAM,MAAM,UAAU,GAAG,WAAW,EAAE,CAAA;AACtC,KAAK,WAAW,GACZ,CAAC,YAAY,EAAE,aAAa,EAAE,SAAS,GAAG,MAAM,CAAC,GACjD,CAAC,YAAY,EAAE,aAAa,CAAC,CAAA;AAEjC,eAAO,MAAM,sBAAsB,GAAI;;CAAwB,eA4G9D,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,6BAA6B,QAAO,UAEhD,CAAA;AAED,eAAO,MAAM,yBAAyB,0BAOrC,CAAA;AAED,eAAO,MAAM,wBAAwB,GAAI;;CAAwB,KAU3C,gBAAgB,EACrC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,4BAA4B;;;;;;;CASxC,CAAA;AAGD,eAAO,MAAM,wBAAwB,GAAI,uBAGtC,mBAAwB,SAc1B,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,GAC7B,YAAY,MAAM,EAClB,UAAU,MAAM,EAChB,SAAS,gBAAgB,CAAC,SAAS,CAAC,EACpC,aAAY,gBAAgB,CAAC,YAAY,CAAY,EACrD,iBAAe,EAIf,iBAAgB,gBAAgB,CAAC,gBAAgB,CAAa,8CAyB/D,CAAA"}

package/dist/api.js

@@ -1,6 +1,5 @@
 import fs from "node:fs";
 import path from "node:path";
-import { transformAsync } from "@babel/core";
 import { resolvePath } from "babel-plugin-module-resolver";
 import { getPaths } from "@cedarjs/project-config";
 import {
@@ -11,11 +10,18 @@ import {
 import pluginRedwoodDirectoryNamedImport from "./plugins/babel-plugin-redwood-directory-named-import.js";
 import pluginRedwoodImportDir from "./plugins/babel-plugin-redwood-import-dir.js";
 import pluginRedwoodJobPathInjector from "./plugins/babel-plugin-redwood-job-path-injector.js";
+import {
+  loadBabelCoreFromProject,
+  resolveFromProject
+} from "./resolveFromProject.js";
 const TARGETS_NODE = "24";
-const getApiSideBabelPresets = ({ presetEnv } = { presetEnv: false }) => {
+const getApiSideBabelPresets = ({
+  presetEnv = false,
+  resolvePreset = (packageName) => packageName
+} = {}) => {
   return [
     [
-      "@babel/preset-typescript",
+      resolvePreset("@babel/preset-typescript"),
       {
         isTSX: true,
         allExtensions: true
@@ -24,7 +30,7 @@ const getApiSideBabelPresets = ({ presetEnv } = { presetEnv: false }) => {
     ],
     // Preset-env is required when we are not doing the transpilation with esbuild
     presetEnv && [
-      "@babel/preset-env",
+      resolvePreset("@babel/preset-env"),
       {
         targets: {
           node: TARGETS_NODE
@@ -171,10 +177,13 @@ const registerApiSideBabelHook = ({
   });
 };
 const transformWithBabel = async (sourceCode, filename, plugins, sourceMaps = "inline", forVite = false, inputSourceMap = void 0) => {
-  const result = transformAsync(sourceCode, {
-    presets: getApiSideBabelPresets(),
+  const customConfigPath = getApiSideBabelConfigPath();
+  const babel = loadBabelCoreFromProject();
+  const resolvePreset = resolveFromProject;
+  const result = babel.transformAsync(sourceCode, {
+    presets: getApiSideBabelPresets({ resolvePreset }),
     overrides: getApiSideBabelOverrides({ forVite }),
-    extends: getApiSideBabelConfigPath(),
+    extends: customConfigPath,
     babelrc: false,
     ignore: ["node_modules"],
     cwd: getPaths().api.base,

package/dist/resolveFromProject.d.ts

@@ -0,0 +1,38 @@
+import type * as BabelCore from '@babel/core';
+/**
+ * The packages a project has to install in its api workspace to use a custom
+ * `api/babel.config.js`. They are optional peer dependencies of
+ * `@cedarjs/babel-config`, so projects without a custom config never pay for
+ * them.
+ */
+export declare const API_BABEL_CONFIG_PACKAGES: readonly ["@babel/core", "@babel/preset-typescript"];
+/**
+ * The Babel major Cedar's api-side config is written for. The
+ * `@babel/preset-typescript` options Cedar passes (`isTSX`, `allExtensions`)
+ * only exist in this major.
+ */
+export declare const SUPPORTED_BABEL_MAJOR = 7;
+/**
+ * Builds the error thrown when `api/babel.config.js` exists but one of the
+ * packages it needs is missing from the project.
+ */
+export declare function getMissingApiBabelPackageMessage(packageName: string): string;
+/**
+ * Builds the error thrown when `api/babel.config.js` exists but the installed
+ * package is from a Babel major Cedar's api-side config doesn't support.
+ */
+export declare function getUnsupportedApiBabelVersionMessage(packageName: string, version: string): string;
+/**
+ * Resolves `packageName` to an absolute path from the project's api
+ * workspace. Throws an actionable error when the package isn't installed
+ * there (so the failure mode is the same no matter how the package manager
+ * laid out `node_modules`) or when it's from an unsupported Babel major.
+ */
+export declare function resolveFromProject(packageName: string): string;
+/**
+ * Loads the project's copy of `@babel/core`. Resolving from the project
+ * rather than from this package keeps `@babel/core` out of projects that
+ * don't use `api/babel.config.js`.
+ */
+export declare function loadBabelCoreFromProject(): typeof BabelCore;
+//# sourceMappingURL=resolveFromProject.d.ts.map

package/dist/resolveFromProject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveFromProject.d.ts","sourceRoot":"","sources":["../src/resolveFromProject.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,SAAS,MAAM,aAAa,CAAA;AAI7C;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,sDAG5B,CAAA;AAEV;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,IAAI,CAAA;AAMtC;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,WAAW,EAAE,MAAM,UAMnE;AAED;;;GAGG;AACH,wBAAgB,oCAAoC,CAClD,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,UAQhB;AA+BD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,UAcrD;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,SAAS,CAI3D"}

package/dist/resolveFromProject.js

@@ -0,0 +1,51 @@
+import { createRequire } from "node:module";
+import path from "node:path";
+import { getPaths } from "@cedarjs/project-config";
+const API_BABEL_CONFIG_PACKAGES = [
+  "@babel/core",
+  "@babel/preset-typescript"
+];
+const SUPPORTED_BABEL_MAJOR = 7;
+const INSTALL_COMMAND = `yarn workspace api add -D ${API_BABEL_CONFIG_PACKAGES.map(
+  (packageName) => `${packageName}@^${SUPPORTED_BABEL_MAJOR}`
+).join(" ")}`;
+function getMissingApiBabelPackageMessage(packageName) {
+  return `api/babel.config.js was found, but ${packageName} is not installed. Custom Babel configuration for the api side needs ${API_BABEL_CONFIG_PACKAGES.join(" and ")}: run \`${INSTALL_COMMAND}\`.`;
+}
+function getUnsupportedApiBabelVersionMessage(packageName, version) {
+  return `api/babel.config.js was found, but the installed ${packageName} (${version}) is not supported. Custom Babel configuration for the api side needs ${API_BABEL_CONFIG_PACKAGES.join(" and ")} ${SUPPORTED_BABEL_MAJOR}.x: run \`${INSTALL_COMMAND}\`.`;
+}
+function createProjectRequire() {
+  return createRequire(path.join(getPaths().api.base, "package.json"));
+}
+function assertSupportedMajor(packageName, resolvedPath) {
+  const packageJson = createRequire(resolvedPath)(
+    `${packageName}/package.json`
+  );
+  const version = typeof packageJson === "object" && packageJson !== null && "version" in packageJson && typeof packageJson.version === "string" ? packageJson.version : void 0;
+  if (version && Number(version.split(".")[0]) !== SUPPORTED_BABEL_MAJOR) {
+    throw new Error(getUnsupportedApiBabelVersionMessage(packageName, version));
+  }
+}
+function resolveFromProject(packageName) {
+  const projectRequire = createProjectRequire();
+  let resolvedPath;
+  try {
+    resolvedPath = projectRequire.resolve(packageName);
+  } catch {
+    throw new Error(getMissingApiBabelPackageMessage(packageName));
+  }
+  assertSupportedMajor(packageName, resolvedPath);
+  return resolvedPath;
+}
+function loadBabelCoreFromProject() {
+  return createProjectRequire()(resolveFromProject("@babel/core"));
+}
+export {
+  API_BABEL_CONFIG_PACKAGES,
+  SUPPORTED_BABEL_MAJOR,
+  getMissingApiBabelPackageMessage,
+  getUnsupportedApiBabelVersionMessage,
+  loadBabelCoreFromProject,
+  resolveFromProject
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cedarjs/babel-config",
-  "version": "7.0.0-canary.3015",
+  "version": "7.0.0-canary.3018",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/cedarjs/cedar.git",
@@ -26,15 +26,13 @@
     "test:watch": "vitest watch"
   },
   "dependencies": {
-    "@babel/core": "^7.26.10",
     "@babel/parser": "7.29.8",
     "@babel/plugin-transform-react-jsx": "7.29.7",
     "@babel/preset-env": "7.29.7",
     "@babel/preset-react": "7.29.7",
-    "@babel/preset-typescript": "7.29.7",
     "@babel/register": "7.29.7",
     "@babel/traverse": "7.29.8",
-    "@cedarjs/project-config": "7.0.0-canary.3015",
+    "@cedarjs/project-config": "7.0.0-canary.3018",
     "babel-plugin-auto-import": "1.1.0",
     "babel-plugin-graphql-tag": "3.3.0",
     "babel-plugin-module-resolver": "5.0.3",
@@ -43,7 +41,9 @@
     "typescript": "5.9.3"
   },
   "devDependencies": {
-    "@cedarjs/framework-tools": "7.0.0-canary.3015",
+    "@babel/core": "^7.26.10",
+    "@babel/preset-typescript": "7.29.7",
+    "@cedarjs/framework-tools": "7.0.0-canary.3018",
     "@types/babel-plugin-tester": "11.0.0",
     "@types/babel__core": "7.20.5",
     "@types/babel__register": "7.17.3",
@@ -51,6 +51,18 @@
     "babel-plugin-tester": "11.0.4",
     "vitest": "4.1.10"
   },
+  "peerDependencies": {
+    "@babel/core": "^7.26.10",
+    "@babel/preset-typescript": "^7.29.7"
+  },
+  "peerDependenciesMeta": {
+    "@babel/core": {
+      "optional": true
+    },
+    "@babel/preset-typescript": {
+      "optional": true
+    }
+  },
   "engines": {
     "node": ">=24"
   },