packages/localize/tools/src/translate/source_files/locale_plugin.ts - main - githubmirror/angular

packages/localize/tools/src/translate/source_files/locale_plugin.ts
100 строк4 KB
Angular Robot
build: update babel monorepo to v8
07 июл 2026, 00:05
07 июл 2026, 00:05731d665
/**
 * @license
 * Copyright Google LLC All Rights Reserved.
 *
 * Use of this source code is governed by an MIT-style license that can be
 * found in the LICENSE file at https://angular.dev/license
 */
import {NodePath, PluginObject, types as t} from '@babel/core';

import {isLocalize, TranslatePluginOptions} from '../../source_file_utils';

/**
 * This Babel plugin will replace the following code forms with a string literal containing the
 * given `locale`.
 *
 * * `$localize.locale`                                            -> `"locale"`
 * * `typeof $localize !== "undefined" && $localize.locale`        -> `"locale"`
 * * `xxx && typeof $localize !== "undefined" && $localize.locale` -> `"xxx && locale"`
 * * `$localize.locale || default`                                 -> `"locale" || default`
 *
 * @param locale The name of the locale to inline into the code.
 * @param options Additional options including the name of the `$localize` function.
 * @publicApi used by CLI
 */
export function makeLocalePlugin(
  locale: string,
  {localizeName = '$localize'}: TranslatePluginOptions = {},
): PluginObject {
  return {
    visitor: {
      MemberExpression(expression: NodePath<t.MemberExpression>) {
        const obj = expression.get('object');
        if (!isLocalize(obj, localizeName)) {
          return;
        }
        const property = expression.get('property') as NodePath;
        if (!property.isIdentifier({name: 'locale'})) {
          return;
        }
        if (
          expression.parentPath.isAssignmentExpression() &&
          expression.parentPath.get('left') === expression
        ) {
          return;
        }
        // Check for the `$localize.locale` being guarded by a check on the existence of
        // `$localize`.
        const parent = expression.parentPath;
        if (parent.isLogicalExpression({operator: '&&'}) && parent.get('right') === expression) {
          const left = parent.get('left');
          if (isLocalizeGuard(left, localizeName)) {
            // Replace `typeof $localize !== "undefined" && $localize.locale` with
            // `$localize.locale`
            parent.replaceWith(expression);
          } else if (
            left.isLogicalExpression({operator: '&&'}) &&
            isLocalizeGuard(left.get('right'), localizeName)
          ) {
            // The `$localize` is part of a preceding logical AND.
            // Replace XXX && typeof $localize !== "undefined" && $localize.locale` with `XXX &&
            // $localize.locale`
            left.replaceWith(left.get('left'));
          }
        }
        // Replace the `$localize.locale` with the string literal
        expression.replaceWith(t.stringLiteral(locale));
      },
    },
  };
}

/**
 * Returns true if the expression one of:
 * * `typeof $localize !== "undefined"`
 * * `"undefined" !== typeof $localize`
 * * `typeof $localize != "undefined"`
 * * `"undefined" != typeof $localize`
 *
 * @param expression the expression to check
 * @param localizeName the name of the `$localize` symbol
 */
function isLocalizeGuard(expression: NodePath, localizeName: string): boolean {
  if (
    !expression.isBinaryExpression() ||
    !(expression.node.operator === '!==' || expression.node.operator === '!=')
  ) {
    return false;
  }
  const left = expression.get('left');
  const right = expression.get('right');

  return (
    (left.isUnaryExpression({operator: 'typeof'}) &&
      isLocalize(left.get('argument'), localizeName) &&
      right.isStringLiteral({value: 'undefined'})) ||
    (right.isUnaryExpression({operator: 'typeof'}) &&
      isLocalize(right.get('argument'), localizeName) &&
      left.isStringLiteral({value: 'undefined'}))
  );
}