@docusaurus/babel 0.0.0-6082

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Facebook, Inc. and its affiliates.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

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

package/lib/babelTranslationsExtractor.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 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';
+import type { TranslationFileContent } from '@docusaurus/types';
+export type SourceCodeFileTranslations = {
+    sourceCodeFilePath: string;
+    translations: TranslationFileContent;
+    warnings: string[];
+};
+export declare function extractAllSourceCodeFileTranslations(sourceCodeFilePaths: string[], babelOptions: TransformOptions): Promise<SourceCodeFileTranslations[]>;
+export declare function extractSourceCodeFileTranslations(sourceCodeFilePath: string, babelOptions: TransformOptions): Promise<SourceCodeFileTranslations>;
+//# sourceMappingURL=babelTranslationsExtractor.d.ts.map

package/lib/babelTranslationsExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"babelTranslationsExtractor.d.ts","sourceRoot":"","sources":["../src/babelTranslationsExtractor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,mBAAmB,CAAC;AAE9D,MAAM,MAAM,0BAA0B,GAAG;IACvC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,sBAAsB,CAAC;IACrC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,wBAAsB,oCAAoC,CACxD,mBAAmB,EAAE,MAAM,EAAE,EAC7B,YAAY,EAAE,gBAAgB,GAC7B,OAAO,CAAC,0BAA0B,EAAE,CAAC,CAMvC;AAED,wBAAsB,iCAAiC,CACrD,kBAAkB,EAAE,MAAM,EAC1B,YAAY,EAAE,gBAAgB,GAC7B,OAAO,CAAC,0BAA0B,CAAC,CAsBrC"}

package/lib/babelTranslationsExtractor.js

@@ -0,0 +1,184 @@
+"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.extractAllSourceCodeFileTranslations = extractAllSourceCodeFileTranslations;
+exports.extractSourceCodeFileTranslations = extractSourceCodeFileTranslations;
+const tslib_1 = require("tslib");
+const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
+const traverse_1 = tslib_1.__importDefault(require("@babel/traverse"));
+const generator_1 = tslib_1.__importDefault(require("@babel/generator"));
+const core_1 = require("@babel/core");
+async function extractAllSourceCodeFileTranslations(sourceCodeFilePaths, babelOptions) {
+    return Promise.all(sourceCodeFilePaths.flatMap((sourceFilePath) => extractSourceCodeFileTranslations(sourceFilePath, babelOptions)));
+}
+async function extractSourceCodeFileTranslations(sourceCodeFilePath, babelOptions) {
+    try {
+        const code = await fs_extra_1.default.readFile(sourceCodeFilePath, 'utf8');
+        const ast = (0, core_1.parse)(code, {
+            ...babelOptions,
+            ast: true,
+            // filename is important, because babel does not process the same files
+            // according to their js/ts extensions.
+            // See https://x.com/NicoloRibaudo/status/1321130735605002243
+            filename: sourceCodeFilePath,
+        });
+        const translations = extractSourceCodeAstTranslations(ast, sourceCodeFilePath);
+        return translations;
+    }
+    catch (err) {
+        logger_1.default.error `Error while attempting to extract Docusaurus translations from source code file at path=${sourceCodeFilePath}.`;
+        throw err;
+    }
+}
+/*
+Need help understanding this?
+
+Useful resources:
+https://github.com/jamiebuilds/babel-handbook/blob/master/translations/en/plugin-handbook.md
+https://github.com/formatjs/formatjs/blob/main/packages/babel-plugin-formatjs/index.ts
+https://github.com/pugjs/babel-walk
+ */
+function extractSourceCodeAstTranslations(ast, sourceCodeFilePath) {
+    function sourceWarningPart(node) {
+        return `File: ${sourceCodeFilePath} at line ${node.loc?.start.line ?? '?'}
+Full code: ${(0, generator_1.default)(node).code}`;
+    }
+    const translations = {};
+    const warnings = [];
+    let translateComponentName;
+    let translateFunctionName;
+    // First pass: find import declarations of Translate / translate.
+    // If not found, don't process the rest to avoid false positives
+    (0, traverse_1.default)(ast, {
+        ImportDeclaration(path) {
+            if (path.node.importKind === 'type' ||
+                path.get('source').node.value !== '@docusaurus/Translate') {
+                return;
+            }
+            const importSpecifiers = path.get('specifiers');
+            const defaultImport = importSpecifiers.find((specifier) => specifier.node.type === 'ImportDefaultSpecifier');
+            const callbackImport = importSpecifiers.find((specifier) => specifier.node.type === 'ImportSpecifier' &&
+                (specifier.get('imported')
+                    .node.name === 'translate' ||
+                    specifier.get('imported')
+                        .node.value === 'translate'));
+            translateComponentName = defaultImport?.get('local').node.name;
+            translateFunctionName = callbackImport?.get('local').node.name;
+        },
+    });
+    (0, traverse_1.default)(ast, {
+        ...(translateComponentName && {
+            JSXElement(path) {
+                if (!path
+                    .get('openingElement')
+                    .get('name')
+                    .isJSXIdentifier({ name: translateComponentName })) {
+                    return;
+                }
+                function evaluateJSXProp(propName) {
+                    const attributePath = path
+                        .get('openingElement.attributes')
+                        .find((attr) => attr.isJSXAttribute() &&
+                        attr.get('name').isJSXIdentifier({ name: propName }));
+                    if (attributePath) {
+                        const attributeValue = attributePath.get('value');
+                        const attributeValueEvaluated = attributeValue.isJSXExpressionContainer()
+                            ? attributeValue.get('expression').evaluate()
+                            : attributeValue.evaluate();
+                        if (attributeValueEvaluated.confident &&
+                            typeof attributeValueEvaluated.value === 'string') {
+                            return attributeValueEvaluated.value;
+                        }
+                        warnings.push(`<Translate> prop=${propName} should be a statically evaluable object.
+Example: <Translate id="optional id" description="optional description">Message</Translate>
+Dynamically constructed values are not allowed, because they prevent translations to be extracted.
+${sourceWarningPart(path.node)}`);
+                    }
+                    return undefined;
+                }
+                const id = evaluateJSXProp('id');
+                const description = evaluateJSXProp('description');
+                let message;
+                const childrenPath = path.get('children');
+                // Handle empty content
+                if (!childrenPath.length) {
+                    if (!id) {
+                        warnings.push(`<Translate> without children must have id prop.
+Example: <Translate id="my-id" />
+${sourceWarningPart(path.node)}`);
+                    }
+                    else {
+                        translations[id] = {
+                            message: id,
+                            ...(description && { description }),
+                        };
+                    }
+                    return;
+                }
+                // Handle single non-empty content
+                const singleChildren = childrenPath
+                    // Remove empty/useless text nodes that might be around our
+                    // translation! Makes the translation system more reliable to JSX
+                    // formatting issues
+                    .filter((children) => !(children.isJSXText() &&
+                    children.node.value.replace('\n', '').trim() === ''))
+                    .pop();
+                const isJSXText = singleChildren?.isJSXText();
+                const isJSXExpressionContainer = singleChildren?.isJSXExpressionContainer() &&
+                    singleChildren.get('expression').evaluate().confident;
+                if (isJSXText || isJSXExpressionContainer) {
+                    message = isJSXText
+                        ? singleChildren.node.value.trim().replace(/\s+/g, ' ')
+                        : String(singleChildren.get('expression').evaluate().value);
+                    translations[id ?? message] = {
+                        message,
+                        ...(description && { description }),
+                    };
+                }
+                else {
+                    warnings.push(`Translate content could not be extracted. It has to be a static string and use optional but static props, like <Translate id="my-id" description="my-description">text</Translate>.
+${sourceWarningPart(path.node)}`);
+                }
+            },
+        }),
+        ...(translateFunctionName && {
+            CallExpression(path) {
+                if (!path.get('callee').isIdentifier({ name: translateFunctionName })) {
+                    return;
+                }
+                const args = path.get('arguments');
+                if (args.length === 1 || args.length === 2) {
+                    const firstArgPath = args[0];
+                    // translate("x" + "y"); => translate("xy");
+                    const firstArgEvaluated = firstArgPath.evaluate();
+                    if (firstArgEvaluated.confident &&
+                        typeof firstArgEvaluated.value === 'object') {
+                        const { message, id, description } = firstArgEvaluated.value;
+                        translations[String(id ?? message)] = {
+                            message: String(message ?? id),
+                            ...(Boolean(description) && { description: String(description) }),
+                        };
+                    }
+                    else {
+                        warnings.push(`translate() first arg should be a statically evaluable object.
+Example: translate({message: "text",id: "optional.id",description: "optional description"}
+Dynamically constructed values are not allowed, because they prevent translations to be extracted.
+${sourceWarningPart(path.node)}`);
+                    }
+                }
+                else {
+                    warnings.push(`translate() function only takes 1 or 2 args
+${sourceWarningPart(path.node)}`);
+                }
+            },
+        }),
+    });
+    return { sourceCodeFilePath, translations, warnings };
+}
+//# sourceMappingURL=babelTranslationsExtractor.js.map

package/lib/babelTranslationsExtractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"babelTranslationsExtractor.js","sourceRoot":"","sources":["../src/babelTranslationsExtractor.ts"],"names":[],"mappings":"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"}

package/lib/index.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.
+ */
+export { getCustomBabelConfigFilePath, getBabelOptions } from './utils';
+export { extractAllSourceCodeFileTranslations } from './babelTranslationsExtractor';
+//# 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;AAEtE,OAAO,EAAC,oCAAoC,EAAC,MAAM,8BAA8B,CAAC"}

package/lib/index.js

@@ -0,0 +1,15 @@
+"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.extractAllSourceCodeFileTranslations = 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; } });
+var babelTranslationsExtractor_1 = require("./babelTranslationsExtractor");
+Object.defineProperty(exports, "extractAllSourceCodeFileTranslations", { enumerable: true, get: function () { return babelTranslationsExtractor_1.extractAllSourceCodeFileTranslations; } });
+//# 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;AAErD,2EAAkF;AAA1E,kJAAA,oCAAoC,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,51 @@
+{
+  "name": "@docusaurus/babel",
+  "version": "0.0.0-6082",
+  "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/generator": "^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",
+    "@babel/traverse": "^7.22.8",
+    "@docusaurus/logger": "0.0.0-6082",
+    "@docusaurus/utils": "0.0.0-6082",
+    "babel-plugin-dynamic-import-node": "^2.3.3",
+    "fs-extra": "^11.1.1",
+    "tslib": "^2.6.0"
+  },
+  "engines": {
+    "node": ">=18.0"
+  },
+  "gitHead": "bbf50dffd0ec70f522b74e73406e4d18037d77f2"
+}

package/src/babelTranslationsExtractor.ts

@@ -0,0 +1,266 @@
+/**
+ * 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 logger from '@docusaurus/logger';
+import traverse, {type Node} from '@babel/traverse';
+import generate from '@babel/generator';
+import {
+  parse,
+  type types as t,
+  type NodePath,
+  type TransformOptions,
+} from '@babel/core';
+import type {TranslationFileContent} from '@docusaurus/types';
+
+export type SourceCodeFileTranslations = {
+  sourceCodeFilePath: string;
+  translations: TranslationFileContent;
+  warnings: string[];
+};
+
+export async function extractAllSourceCodeFileTranslations(
+  sourceCodeFilePaths: string[],
+  babelOptions: TransformOptions,
+): Promise<SourceCodeFileTranslations[]> {
+  return Promise.all(
+    sourceCodeFilePaths.flatMap((sourceFilePath) =>
+      extractSourceCodeFileTranslations(sourceFilePath, babelOptions),
+    ),
+  );
+}
+
+export async function extractSourceCodeFileTranslations(
+  sourceCodeFilePath: string,
+  babelOptions: TransformOptions,
+): Promise<SourceCodeFileTranslations> {
+  try {
+    const code = await fs.readFile(sourceCodeFilePath, 'utf8');
+
+    const ast = parse(code, {
+      ...babelOptions,
+      ast: true,
+      // filename is important, because babel does not process the same files
+      // according to their js/ts extensions.
+      // See https://x.com/NicoloRibaudo/status/1321130735605002243
+      filename: sourceCodeFilePath,
+    }) as Node;
+
+    const translations = extractSourceCodeAstTranslations(
+      ast,
+      sourceCodeFilePath,
+    );
+    return translations;
+  } catch (err) {
+    logger.error`Error while attempting to extract Docusaurus translations from source code file at path=${sourceCodeFilePath}.`;
+    throw err;
+  }
+}
+
+/*
+Need help understanding this?
+
+Useful resources:
+https://github.com/jamiebuilds/babel-handbook/blob/master/translations/en/plugin-handbook.md
+https://github.com/formatjs/formatjs/blob/main/packages/babel-plugin-formatjs/index.ts
+https://github.com/pugjs/babel-walk
+ */
+function extractSourceCodeAstTranslations(
+  ast: Node,
+  sourceCodeFilePath: string,
+): SourceCodeFileTranslations {
+  function sourceWarningPart(node: Node) {
+    return `File: ${sourceCodeFilePath} at line ${node.loc?.start.line ?? '?'}
+Full code: ${generate(node).code}`;
+  }
+
+  const translations: TranslationFileContent = {};
+  const warnings: string[] = [];
+  let translateComponentName: string | undefined;
+  let translateFunctionName: string | undefined;
+
+  // First pass: find import declarations of Translate / translate.
+  // If not found, don't process the rest to avoid false positives
+  traverse(ast, {
+    ImportDeclaration(path) {
+      if (
+        path.node.importKind === 'type' ||
+        path.get('source').node.value !== '@docusaurus/Translate'
+      ) {
+        return;
+      }
+      const importSpecifiers = path.get('specifiers');
+      const defaultImport = importSpecifiers.find(
+        (specifier): specifier is NodePath<t.ImportDefaultSpecifier> =>
+          specifier.node.type === 'ImportDefaultSpecifier',
+      );
+      const callbackImport = importSpecifiers.find(
+        (specifier): specifier is NodePath<t.ImportSpecifier> =>
+          specifier.node.type === 'ImportSpecifier' &&
+          ((
+            (specifier as NodePath<t.ImportSpecifier>).get('imported')
+              .node as t.Identifier
+          ).name === 'translate' ||
+            (
+              (specifier as NodePath<t.ImportSpecifier>).get('imported')
+                .node as t.StringLiteral
+            ).value === 'translate'),
+      );
+
+      translateComponentName = defaultImport?.get('local').node.name;
+      translateFunctionName = callbackImport?.get('local').node.name;
+    },
+  });
+
+  traverse(ast, {
+    ...(translateComponentName && {
+      JSXElement(path) {
+        if (
+          !path
+            .get('openingElement')
+            .get('name')
+            .isJSXIdentifier({name: translateComponentName})
+        ) {
+          return;
+        }
+        function evaluateJSXProp(propName: string): string | undefined {
+          const attributePath = path
+            .get('openingElement.attributes')
+            .find(
+              (attr) =>
+                attr.isJSXAttribute() &&
+                attr.get('name').isJSXIdentifier({name: propName}),
+            );
+
+          if (attributePath) {
+            const attributeValue = attributePath.get('value') as NodePath;
+
+            const attributeValueEvaluated =
+              attributeValue.isJSXExpressionContainer()
+                ? (attributeValue.get('expression') as NodePath).evaluate()
+                : attributeValue.evaluate();
+
+            if (
+              attributeValueEvaluated.confident &&
+              typeof attributeValueEvaluated.value === 'string'
+            ) {
+              return attributeValueEvaluated.value;
+            }
+            warnings.push(
+              `<Translate> prop=${propName} should be a statically evaluable object.
+Example: <Translate id="optional id" description="optional description">Message</Translate>
+Dynamically constructed values are not allowed, because they prevent translations to be extracted.
+${sourceWarningPart(path.node)}`,
+            );
+          }
+
+          return undefined;
+        }
+
+        const id = evaluateJSXProp('id');
+        const description = evaluateJSXProp('description');
+        let message: string;
+        const childrenPath = path.get('children');
+
+        // Handle empty content
+        if (!childrenPath.length) {
+          if (!id) {
+            warnings.push(`<Translate> without children must have id prop.
+Example: <Translate id="my-id" />
+${sourceWarningPart(path.node)}`);
+          } else {
+            translations[id] = {
+              message: id,
+              ...(description && {description}),
+            };
+          }
+
+          return;
+        }
+
+        // Handle single non-empty content
+        const singleChildren = childrenPath
+          // Remove empty/useless text nodes that might be around our
+          // translation! Makes the translation system more reliable to JSX
+          // formatting issues
+          .filter(
+            (children) =>
+              !(
+                children.isJSXText() &&
+                children.node.value.replace('\n', '').trim() === ''
+              ),
+          )
+          .pop();
+        const isJSXText = singleChildren?.isJSXText();
+        const isJSXExpressionContainer =
+          singleChildren?.isJSXExpressionContainer() &&
+          (singleChildren.get('expression') as NodePath).evaluate().confident;
+
+        if (isJSXText || isJSXExpressionContainer) {
+          message = isJSXText
+            ? singleChildren.node.value.trim().replace(/\s+/g, ' ')
+            : String(
+                (singleChildren.get('expression') as NodePath).evaluate().value,
+              );
+
+          translations[id ?? message] = {
+            message,
+            ...(description && {description}),
+          };
+        } else {
+          warnings.push(
+            `Translate content could not be extracted. It has to be a static string and use optional but static props, like <Translate id="my-id" description="my-description">text</Translate>.
+${sourceWarningPart(path.node)}`,
+          );
+        }
+      },
+    }),
+
+    ...(translateFunctionName && {
+      CallExpression(path) {
+        if (!path.get('callee').isIdentifier({name: translateFunctionName})) {
+          return;
+        }
+
+        const args = path.get('arguments');
+        if (args.length === 1 || args.length === 2) {
+          const firstArgPath = args[0]!;
+
+          // translate("x" + "y"); => translate("xy");
+          const firstArgEvaluated = firstArgPath.evaluate();
+
+          if (
+            firstArgEvaluated.confident &&
+            typeof firstArgEvaluated.value === 'object'
+          ) {
+            const {message, id, description} = firstArgEvaluated.value as {
+              [propName: string]: unknown;
+            };
+            translations[String(id ?? message)] = {
+              message: String(message ?? id),
+              ...(Boolean(description) && {description: String(description)}),
+            };
+          } else {
+            warnings.push(
+              `translate() first arg should be a statically evaluable object.
+Example: translate({message: "text",id: "optional.id",description: "optional description"}
+Dynamically constructed values are not allowed, because they prevent translations to be extracted.
+${sourceWarningPart(path.node)}`,
+            );
+          }
+        } else {
+          warnings.push(
+            `translate() function only takes 1 or 2 args
+${sourceWarningPart(path.node)}`,
+          );
+        }
+      },
+    }),
+  });
+
+  return {sourceCodeFilePath, translations, warnings};
+}

package/src/index.ts

@@ -0,0 +1,10 @@
+/**
+ * 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';
+
+export {extractAllSourceCodeFileTranslations} from './babelTranslationsExtractor';

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,
+  };
+}