@docusaurus/babel 3.5.2

package/README.md

@@ -0,0 +1,3 @@
+# `@docusaurus/babel`
+
+Docusaurus package for Babel-related utils.

package/lib/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+export { getCustomBabelConfigFilePath, getBabelOptions } from './utils';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAC,4BAA4B,EAAE,eAAe,EAAC,MAAM,SAAS,CAAC"}

package/lib/index.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBabelOptions = exports.getCustomBabelConfigFilePath = void 0;
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "getCustomBabelConfigFilePath", { enumerable: true, get: function () { return utils_1.getCustomBabelConfigFilePath; } });
+Object.defineProperty(exports, "getBabelOptions", { enumerable: true, get: function () { return utils_1.getBabelOptions; } });
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,iCAAsE;AAA9D,qHAAA,4BAA4B,OAAA;AAAE,wGAAA,eAAe,OAAA"}

package/lib/preset.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import type { ConfigAPI, TransformOptions } from '@babel/core';
+export default function babelPresets(api: ConfigAPI): TransformOptions;
+//# sourceMappingURL=preset.d.ts.map

package/lib/preset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset.d.ts","sourceRoot":"","sources":["../src/preset.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAC,SAAS,EAAE,gBAAgB,EAAC,MAAM,aAAa,CAAC;AAsE7D,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,GAAG,EAAE,SAAS,GAAG,gBAAgB,CAGrE"}

package/lib/preset.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = babelPresets;
+const tslib_1 = require("tslib");
+const path_1 = tslib_1.__importDefault(require("path"));
+function getTransformOptions(isServer) {
+    const absoluteRuntimePath = path_1.default.dirname(require.resolve(`@babel/runtime/package.json`));
+    return {
+        // All optional newlines and whitespace will be omitted when generating code
+        // in compact mode
+        compact: true,
+        presets: [
+            isServer
+                ? [
+                    require.resolve('@babel/preset-env'),
+                    {
+                        targets: {
+                            node: 'current',
+                        },
+                    },
+                ]
+                : [
+                    require.resolve('@babel/preset-env'),
+                    {
+                        useBuiltIns: 'entry',
+                        loose: true,
+                        corejs: '3',
+                        // Do not transform modules to CJS
+                        modules: false,
+                        // Exclude transforms that make all code slower
+                        exclude: ['transform-typeof-symbol'],
+                    },
+                ],
+            [
+                require.resolve('@babel/preset-react'),
+                {
+                    runtime: 'automatic',
+                },
+            ],
+            require.resolve('@babel/preset-typescript'),
+        ],
+        plugins: [
+            // Polyfills the runtime needed for async/await, generators, and friends
+            // https://babeljs.io/docs/en/babel-plugin-transform-runtime
+            [
+                require.resolve('@babel/plugin-transform-runtime'),
+                {
+                    corejs: false,
+                    helpers: true,
+                    // By default, it assumes @babel/runtime@7.0.0. Since we use >7.0.0,
+                    // better to explicitly specify the version so that it can reuse the
+                    // helper better. See https://github.com/babel/babel/issues/10261
+                    // eslint-disable-next-line @typescript-eslint/no-var-requires, global-require
+                    version: require('@babel/runtime/package.json')
+                        .version,
+                    regenerator: true,
+                    useESModules: true,
+                    // Undocumented option that lets us encapsulate our runtime, ensuring
+                    // the correct version is used
+                    // https://github.com/babel/babel/blob/090c364a90fe73d36a30707fc612ce037bdbbb24/packages/babel-plugin-transform-runtime/src/index.js#L35-L42
+                    absoluteRuntime: absoluteRuntimePath,
+                },
+            ],
+            // Adds syntax support for import()
+            isServer
+                ? require.resolve('babel-plugin-dynamic-import-node')
+                : require.resolve('@babel/plugin-syntax-dynamic-import'),
+        ],
+    };
+}
+function babelPresets(api) {
+    const callerName = api.caller((caller) => caller?.name);
+    return getTransformOptions(callerName === 'server');
+}
+//# sourceMappingURL=preset.js.map

package/lib/preset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset.js","sourceRoot":"","sources":["../src/preset.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAyEH,+BAGC;;AA1ED,wDAAwB;AAGxB,SAAS,mBAAmB,CAAC,QAAiB;IAC5C,MAAM,mBAAmB,GAAG,cAAI,CAAC,OAAO,CACtC,OAAO,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAC/C,CAAC;IACF,OAAO;QACL,4EAA4E;QAC5E,kBAAkB;QAClB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE;YACP,QAAQ;gBACN,CAAC,CAAC;oBACE,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC;oBACpC;wBACE,OAAO,EAAE;4BACP,IAAI,EAAE,SAAS;yBAChB;qBACF;iBACF;gBACH,CAAC,CAAC;oBACE,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC;oBACpC;wBACE,WAAW,EAAE,OAAO;wBACpB,KAAK,EAAE,IAAI;wBACX,MAAM,EAAE,GAAG;wBACX,kCAAkC;wBAClC,OAAO,EAAE,KAAK;wBACd,+CAA+C;wBAC/C,OAAO,EAAE,CAAC,yBAAyB,CAAC;qBACrC;iBACF;YACL;gBACE,OAAO,CAAC,OAAO,CAAC,qBAAqB,CAAC;gBACtC;oBACE,OAAO,EAAE,WAAW;iBACrB;aACF;YACD,OAAO,CAAC,OAAO,CAAC,0BAA0B,CAAC;SAC5C;QACD,OAAO,EAAE;YACP,wEAAwE;YACxE,4DAA4D;YAC5D;gBACE,OAAO,CAAC,OAAO,CAAC,iCAAiC,CAAC;gBAClD;oBACE,MAAM,EAAE,KAAK;oBACb,OAAO,EAAE,IAAI;oBACb,oEAAoE;oBACpE,oEAAoE;oBACpE,iEAAiE;oBACjE,8EAA8E;oBAC9E,OAAO,EAAG,OAAO,CAAC,6BAA6B,CAAuB;yBACnE,OAAO;oBACV,WAAW,EAAE,IAAI;oBACjB,YAAY,EAAE,IAAI;oBAClB,qEAAqE;oBACrE,8BAA8B;oBAC9B,4IAA4I;oBAC5I,eAAe,EAAE,mBAAmB;iBACrC;aACF;YACD,mCAAmC;YACnC,QAAQ;gBACN,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,kCAAkC,CAAC;gBACrD,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,qCAAqC,CAAC;SAC3D;KACF,CAAC;AACJ,CAAC;AAED,SAAwB,YAAY,CAAC,GAAc;IACjD,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACxD,OAAO,mBAAmB,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC;AACtD,CAAC"}

package/lib/utils.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import type { TransformOptions } from '@babel/core';
+export declare function getCustomBabelConfigFilePath(siteDir: string): Promise<string | undefined>;
+export declare function getBabelOptions({ isServer, babelOptions, }?: {
+    isServer?: boolean;
+    babelOptions?: TransformOptions | string;
+}): TransformOptions;
+//# sourceMappingURL=utils.d.ts.map

package/lib/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,aAAa,CAAC;AAElD,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAQ7B;AAED,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,YAAY,GACb,GAAE;IACD,QAAQ,CAAC,EAAE,OAAO,CAAC;IAGnB,YAAY,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;CACrC,GAAG,gBAAgB,CAiBxB"}

package/lib/utils.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCustomBabelConfigFilePath = getCustomBabelConfigFilePath;
+exports.getBabelOptions = getBabelOptions;
+const tslib_1 = require("tslib");
+const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+const path_1 = tslib_1.__importDefault(require("path"));
+const utils_1 = require("@docusaurus/utils");
+async function getCustomBabelConfigFilePath(siteDir) {
+    const customBabelConfigurationPath = path_1.default.join(siteDir, utils_1.BABEL_CONFIG_FILE_NAME);
+    return (await fs_extra_1.default.pathExists(customBabelConfigurationPath))
+        ? customBabelConfigurationPath
+        : undefined;
+}
+function getBabelOptions({ isServer, babelOptions, } = {}) {
+    const caller = { name: isServer ? 'server' : 'client' };
+    if (typeof babelOptions === 'string') {
+        return {
+            babelrc: false,
+            configFile: babelOptions,
+            caller,
+        };
+    }
+    return {
+        ...(babelOptions ?? {
+            presets: [require.resolve('@docusaurus/babel/preset')],
+        }),
+        babelrc: false,
+        configFile: false,
+        caller,
+    };
+}
+//# sourceMappingURL=utils.js.map

package/lib/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAOH,oEAUC;AAED,0CAyBC;;AA1CD,gEAA0B;AAC1B,wDAAwB;AACxB,6CAAyD;AAGlD,KAAK,UAAU,4BAA4B,CAChD,OAAe;IAEf,MAAM,4BAA4B,GAAG,cAAI,CAAC,IAAI,CAC5C,OAAO,EACP,8BAAsB,CACvB,CAAC;IACF,OAAO,CAAC,MAAM,kBAAE,CAAC,UAAU,CAAC,4BAA4B,CAAC,CAAC;QACxD,CAAC,CAAC,4BAA4B;QAC9B,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,SAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,YAAY,MAMV,EAAE;IACJ,MAAM,MAAM,GAAG,EAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAC,CAAC;IACtD,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;QACrC,OAAO;YACL,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,YAAY;YACxB,MAAM;SACP,CAAC;IACJ,CAAC;IACD,OAAO;QACL,GAAG,CAAC,YAAY,IAAI;YAClB,OAAO,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC;SACvD,CAAC;QACF,OAAO,EAAE,KAAK;QACd,UAAU,EAAE,KAAK;QACjB,MAAM;KACP,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@docusaurus/babel",
+  "version": "3.5.2",
+  "description": "Docusaurus package for Babel-related utils.",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    "./preset": {
+      "types": "./lib/preset.d.ts",
+      "default": "./lib/preset.js"
+    },
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/facebook/docusaurus.git",
+    "directory": "packages/docusaurus-babel"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@babel/core": "^7.23.3",
+    "@babel/plugin-syntax-dynamic-import": "^7.8.3",
+    "@babel/plugin-transform-runtime": "^7.22.9",
+    "@babel/preset-env": "^7.22.9",
+    "@babel/preset-react": "^7.22.5",
+    "@babel/preset-typescript": "^7.22.5",
+    "@babel/runtime": "^7.22.6",
+    "@babel/runtime-corejs3": "^7.22.6",
+    "@docusaurus/utils": "3.5.2",
+    "babel-loader": "^9.1.3",
+    "babel-plugin-dynamic-import-node": "^2.3.3",
+    "fs-extra": "^11.1.1"
+  },
+  "engines": {
+    "node": ">=18.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,8 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+export {getCustomBabelConfigFilePath, getBabelOptions} from './utils';

package/src/preset.ts

@@ -0,0 +1,82 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import path from 'path';
+import type {ConfigAPI, TransformOptions} from '@babel/core';
+
+function getTransformOptions(isServer: boolean): TransformOptions {
+  const absoluteRuntimePath = path.dirname(
+    require.resolve(`@babel/runtime/package.json`),
+  );
+  return {
+    // All optional newlines and whitespace will be omitted when generating code
+    // in compact mode
+    compact: true,
+    presets: [
+      isServer
+        ? [
+            require.resolve('@babel/preset-env'),
+            {
+              targets: {
+                node: 'current',
+              },
+            },
+          ]
+        : [
+            require.resolve('@babel/preset-env'),
+            {
+              useBuiltIns: 'entry',
+              loose: true,
+              corejs: '3',
+              // Do not transform modules to CJS
+              modules: false,
+              // Exclude transforms that make all code slower
+              exclude: ['transform-typeof-symbol'],
+            },
+          ],
+      [
+        require.resolve('@babel/preset-react'),
+        {
+          runtime: 'automatic',
+        },
+      ],
+      require.resolve('@babel/preset-typescript'),
+    ],
+    plugins: [
+      // Polyfills the runtime needed for async/await, generators, and friends
+      // https://babeljs.io/docs/en/babel-plugin-transform-runtime
+      [
+        require.resolve('@babel/plugin-transform-runtime'),
+        {
+          corejs: false,
+          helpers: true,
+          // By default, it assumes @babel/runtime@7.0.0. Since we use >7.0.0,
+          // better to explicitly specify the version so that it can reuse the
+          // helper better. See https://github.com/babel/babel/issues/10261
+          // eslint-disable-next-line @typescript-eslint/no-var-requires, global-require
+          version: (require('@babel/runtime/package.json') as {version: string})
+            .version,
+          regenerator: true,
+          useESModules: true,
+          // Undocumented option that lets us encapsulate our runtime, ensuring
+          // the correct version is used
+          // https://github.com/babel/babel/blob/090c364a90fe73d36a30707fc612ce037bdbbb24/packages/babel-plugin-transform-runtime/src/index.js#L35-L42
+          absoluteRuntime: absoluteRuntimePath,
+        },
+      ],
+      // Adds syntax support for import()
+      isServer
+        ? require.resolve('babel-plugin-dynamic-import-node')
+        : require.resolve('@babel/plugin-syntax-dynamic-import'),
+    ],
+  };
+}
+
+export default function babelPresets(api: ConfigAPI): TransformOptions {
+  const callerName = api.caller((caller) => caller?.name);
+  return getTransformOptions(callerName === 'server');
+}

package/src/utils.ts

@@ -0,0 +1,50 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import fs from 'fs-extra';
+import path from 'path';
+import {BABEL_CONFIG_FILE_NAME} from '@docusaurus/utils';
+import type {TransformOptions} from '@babel/core';
+
+export async function getCustomBabelConfigFilePath(
+  siteDir: string,
+): Promise<string | undefined> {
+  const customBabelConfigurationPath = path.join(
+    siteDir,
+    BABEL_CONFIG_FILE_NAME,
+  );
+  return (await fs.pathExists(customBabelConfigurationPath))
+    ? customBabelConfigurationPath
+    : undefined;
+}
+
+export function getBabelOptions({
+  isServer,
+  babelOptions,
+}: {
+  isServer?: boolean;
+  // TODO Docusaurus v4 fix this
+  //  weird to have getBabelOptions take a babelOptions param
+  babelOptions?: TransformOptions | string;
+} = {}): TransformOptions {
+  const caller = {name: isServer ? 'server' : 'client'};
+  if (typeof babelOptions === 'string') {
+    return {
+      babelrc: false,
+      configFile: babelOptions,
+      caller,
+    };
+  }
+  return {
+    ...(babelOptions ?? {
+      presets: [require.resolve('@docusaurus/babel/preset')],
+    }),
+    babelrc: false,
+    configFile: false,
+    caller,
+  };
+}