VariableDeclaration()

in packages/angular_devkit/build_angular/src/babel/plugins/adjust-typescript-enums.ts [30:160]


      VariableDeclaration(path: NodePath<types.VariableDeclaration>, state: PluginPass) {
        const { parentPath, node } = path;
        const { loose } = state.opts as { loose: boolean };

        if (node.kind !== 'var' || node.declarations.length !== 1) {
          return;
        }

        const declaration = path.get('declarations')[0];
        if (declaration.node.init) {
          return;
        }

        const declarationId = declaration.node.id;
        if (!types.isIdentifier(declarationId)) {
          return;
        }

        const hasExport =
          parentPath.isExportNamedDeclaration() || parentPath.isExportDefaultDeclaration();
        const origin = hasExport ? parentPath : path;
        const nextStatement = origin.getSibling(+origin.key + 1);
        if (!nextStatement.isExpressionStatement()) {
          return;
        }

        const nextExpression = nextStatement.get('expression');
        if (!nextExpression.isCallExpression() || nextExpression.node.arguments.length !== 1) {
          return;
        }

        const enumCallArgument = nextExpression.node.arguments[0];
        if (!types.isLogicalExpression(enumCallArgument, { operator: '||' })) {
          return;
        }

        // Check if identifiers match var declaration
        if (
          !types.isIdentifier(enumCallArgument.left) ||
          !nextExpression.scope.bindingIdentifierEquals(enumCallArgument.left.name, declarationId)
        ) {
          return;
        }

        const enumCallee = nextExpression.get('callee');
        if (!enumCallee.isFunctionExpression() || enumCallee.node.params.length !== 1) {
          return;
        }

        const enumCalleeParam = enumCallee.node.params[0];
        const isEnumCalleeMatching =
          types.isIdentifier(enumCalleeParam) && enumCalleeParam.name === declarationId.name;

        // Loose mode rewrites the enum to a shorter but less TypeScript-like form
        // Note: We only can apply the `loose` mode transformation if the callee parameter matches
        // with the declaration identifier name. This is necessary in case the the declaration id has
        // been renamed to avoid collisions, as the loose transform would then break the enum assignments
        // which rely on the differently-named callee identifier name.
        let enumAssignments: types.ExpressionStatement[] | undefined;
        if (loose && isEnumCalleeMatching) {
          enumAssignments = [];
        }

        // Check if all enum member values are pure.
        // If not, leave as-is due to potential side efects
        let hasElements = false;
        for (const enumStatement of enumCallee.get('body').get('body')) {
          if (!enumStatement.isExpressionStatement()) {
            return;
          }

          const enumValueAssignment = enumStatement.get('expression');
          if (
            !enumValueAssignment.isAssignmentExpression() ||
            !enumValueAssignment.get('right').isPure()
          ) {
            return;
          }

          hasElements = true;
          enumAssignments?.push(enumStatement.node);
        }

        // If there are no enum elements then there is nothing to wrap
        if (!hasElements) {
          return;
        }

        // Remove existing enum initializer
        const enumInitializer = nextExpression.node;
        nextExpression.remove();

        // Create IIFE block contents
        let blockContents;
        if (enumAssignments) {
          // Loose mode
          blockContents = [
            types.expressionStatement(
              types.assignmentExpression(
                '=',
                types.cloneNode(declarationId),
                types.logicalExpression(
                  '||',
                  types.cloneNode(declarationId),
                  types.objectExpression([]),
                ),
              ),
            ),
            ...enumAssignments,
          ];
        } else {
          blockContents = [types.expressionStatement(enumInitializer)];
        }

        // Wrap existing enum initializer in a pure annotated IIFE
        const container = types.arrowFunctionExpression(
          [],
          types.blockStatement([
            ...blockContents,
            types.returnStatement(types.cloneNode(declarationId)),
          ]),
        );
        const replacementInitializer = types.callExpression(
          types.parenthesizedExpression(container),
          [],
        );
        annotateAsPure(replacementInitializer);

        // Add the wrapped enum initializer directly to the variable declaration
        declaration.get('init').replaceWith(replacementInitializer);
      },