0x1998 - MANAGER

Düzenlenen Dosya: StripComponentSyntax.js

/**
 * Copyright (c) Meta Platforms, Inc. and affiliates.
 *
 * This source code is licensed under the MIT license found in the
 * LICENSE file in the root directory of this source tree.
 *
 * 
 * @format
 */

/**
 * This transforms component syntax (https://flow.org/en/docs/react/component-syntax/)
 * and hook syntax (https://flow.org/en/docs/react/hook-syntax/).
 *
 * It is expected that all transforms create valid ESTree AST output. If
 * the transform requires outputting Babel specific AST nodes then it
 * should live in `ConvertESTreeToBabel.js`
 */
'use strict';

Object.defineProperty(exports, "__esModule", {
  value: true
});
exports.transformProgram = transformProgram;

var _SimpleTransform = require("../transform/SimpleTransform");

var _astNodeMutationHelpers = require("../transform/astNodeMutationHelpers");

var _SimpleTraverser = require("../traverse/SimpleTraverser");

var _createSyntaxError = require("../utils/createSyntaxError");

const nodeWith = _SimpleTransform.SimpleTransform.nodeWith; // Rely on the mapper to fix up parent relationships.

const EMPTY_PARENT = null;

function createDefaultPosition() {
  return {
    line: 1,
    column: 0
  };
}

function mapDeclareComponent(node) {
  return {
    type: 'DeclareVariable',
    id: nodeWith(node.id, {
      typeAnnotation: {
        type: 'TypeAnnotation',
        typeAnnotation: {
          type: 'AnyTypeAnnotation',
          loc: node.loc,
          range: node.range,
          parent: EMPTY_PARENT
        },
        loc: node.loc,
        range: node.range,
        parent: EMPTY_PARENT
      }
    }),
    kind: 'const',
    loc: node.loc,
    range: node.range,
    parent: node.parent
  };
}

function getComponentParameterName(paramName) {
  switch (paramName.type) {
    case 'Identifier':
      return paramName.name;

case 'Literal':
      return paramName.value;

default:
      throw (0, _createSyntaxError.createSyntaxError)(paramName, `Unknown Component parameter name type of "${paramName.type}"`);
  }
}

function createPropsTypeAnnotation(propTypes, spread, loc, range) {
  // Create empty loc for type annotation nodes
  const createParamsTypeLoc = () => ({
    loc: {
      start: (loc == null ? void 0 : loc.start) != null ? loc.start : createDefaultPosition(),
      end: (loc == null ? void 0 : loc.end) != null ? loc.end : createDefaultPosition()
    },
    range: range != null ? range : [0, 0],
    parent: EMPTY_PARENT
  }); // Optimize `{...Props}` -> `Props`

if (spread != null && propTypes.length === 0) {
    return {
      type: 'TypeAnnotation',
      typeAnnotation: spread.argument,
      ...createParamsTypeLoc()
    };
  }

const typeProperties = [...propTypes];

if (spread != null) {
    // Spread needs to be the first type, as inline properties take precedence.
    typeProperties.unshift(spread);
  }

const propTypeObj = {
    type: 'ObjectTypeAnnotation',
    callProperties: [],
    properties: typeProperties,
    indexers: [],
    internalSlots: [],
    exact: false,
    inexact: false,
    ...createParamsTypeLoc()
  };
  return {
    type: 'TypeAnnotation',
    typeAnnotation: {
      type: 'GenericTypeAnnotation',
      id: {
        type: 'Identifier',
        name: '$ReadOnly',
        optional: false,
        typeAnnotation: null,
        ...createParamsTypeLoc()
      },
      typeParameters: {
        type: 'TypeParameterInstantiation',
        params: [propTypeObj],
        ...createParamsTypeLoc()
      },
      ...createParamsTypeLoc()
    },
    ...createParamsTypeLoc()
  };
}

function mapComponentParameters(params, options) {
  var _options$reactRuntime;

if (params.length === 0) {
    return {
      props: null,
      ref: null
    };
  } // Optimize `component Foo(...props: Props) {}` to `function Foo(props: Props) {}

if (params.length === 1 && params[0].type === 'RestElement' && params[0].argument.type === 'Identifier') {
    const restElementArgument = params[0].argument;
    return {
      props: restElementArgument,
      ref: null
    };
  } // Filter out any ref param and capture it's details when targeting React 18.
  // React 19+ treats ref as a regular prop for function components.

let refParam = null;
  const paramsWithoutRef = ((_options$reactRuntime = options.reactRuntimeTarget) != null ? _options$reactRuntime : '18') === '18' ? params.filter(param => {
    if (param.type === 'ComponentParameter' && getComponentParameterName(param.name) === 'ref') {
      refParam = param;
      return false;
    }

return true;
  }) : params;
  const [propTypes, spread] = paramsWithoutRef.reduce(([propTypes, spread], param) => {
    switch (param.type) {
      case 'RestElement':
        {
          if (spread != null) {
            throw (0, _createSyntaxError.createSyntaxError)(param, `Invalid state, multiple rest elements found as Component Parameters`);
          }

return [propTypes, mapComponentParameterRestElementType(param)];
        }

case 'ComponentParameter':
        {
          propTypes.push(mapComponentParameterType(param));
          return [propTypes, spread];
        }
    }
  }, [[], null]);
  const propsProperties = paramsWithoutRef.flatMap(mapComponentParameter);
  let props = null;

if (propsProperties.length === 0) {
    if (refParam == null) {
      throw new Error('StripComponentSyntax: Invalid state, ref should always be set at this point if props are empty');
    }

const emptyParamsLoc = {
      start: refParam.loc.start,
      end: refParam.loc.start
    };
    const emptyParamsRange = [refParam.range[0], refParam.range[0]]; // no properties provided (must have had a single ref)

props = {
      type: 'Identifier',
      name: '_$$empty_props_placeholder$$',
      optional: false,
      typeAnnotation: createPropsTypeAnnotation([], null, emptyParamsLoc, emptyParamsRange),
      loc: emptyParamsLoc,
      range: emptyParamsRange,
      parent: EMPTY_PARENT
    };
  } else {
    const lastPropsProperty = propsProperties[propsProperties.length - 1];
    props = {
      type: 'ObjectPattern',
      properties: propsProperties,
      typeAnnotation: createPropsTypeAnnotation(propTypes, spread, {
        start: lastPropsProperty.loc.end,
        end: lastPropsProperty.loc.end
      }, [lastPropsProperty.range[1], lastPropsProperty.range[1]]),
      loc: {
        start: propsProperties[0].loc.start,
        end: lastPropsProperty.loc.end
      },
      range: [propsProperties[0].range[0], lastPropsProperty.range[1]],
      parent: EMPTY_PARENT
    };
  }

let ref = null;

if (refParam != null) {
    ref = refParam.local;
  }

return {
    props,
    ref
  };
}

function mapComponentParameterType(param) {
  var _typeAnnotation$typeA;

const typeAnnotation = param.local.type === 'AssignmentPattern' ? param.local.left.typeAnnotation : param.local.typeAnnotation;
  const optional = param.local.type === 'AssignmentPattern' ? true : param.local.type === 'Identifier' ? param.local.optional : false;
  return {
    type: 'ObjectTypeProperty',
    key: (0, _astNodeMutationHelpers.shallowCloneNode)(param.name),
    value: (_typeAnnotation$typeA = typeAnnotation == null ? void 0 : typeAnnotation.typeAnnotation) != null ? _typeAnnotation$typeA : {
      type: 'AnyTypeAnnotation',
      loc: param.local.loc,
      range: param.local.range,
      parent: EMPTY_PARENT
    },
    kind: 'init',
    optional,
    method: false,
    static: false,
    proto: false,
    variance: null,
    loc: param.local.loc,
    range: param.local.range,
    parent: EMPTY_PARENT
  };
}

function mapComponentParameterRestElementType(param) {
  var _param$argument$typeA, _param$argument$typeA2;

if (param.argument.type !== 'Identifier' && param.argument.type !== 'ObjectPattern') {
    throw (0, _createSyntaxError.createSyntaxError)(param, `Invalid ${param.argument.type} encountered in restParameter`);
  }

return {
    type: 'ObjectTypeSpreadProperty',
    argument: (_param$argument$typeA = (_param$argument$typeA2 = param.argument.typeAnnotation) == null ? void 0 : _param$argument$typeA2.typeAnnotation) != null ? _param$argument$typeA : {
      type: 'AnyTypeAnnotation',
      loc: param.loc,
      range: param.range,
      parent: EMPTY_PARENT
    },
    loc: param.loc,
    range: param.range,
    parent: EMPTY_PARENT
  };
}

function mapComponentParameter(param) {
  switch (param.type) {
    case 'RestElement':
      {
        switch (param.argument.type) {
          case 'Identifier':
            {
              const a = nodeWith(param, {
                typeAnnotation: null,
                argument: nodeWith(param.argument, {
                  typeAnnotation: null
                })
              });
              return [a];
            }

case 'ObjectPattern':
            {
              return param.argument.properties.map(property => {
                return nodeWith(property, {
                  typeAnnotation: null
                });
              });
            }

default:
            {
              throw (0, _createSyntaxError.createSyntaxError)(param, `Unhandled ${param.argument.type} encountered in restParameter`);
            }
        }
      }

case 'ComponentParameter':
      {
        let value;

if (param.local.type === 'AssignmentPattern') {
          value = nodeWith(param.local, {
            left: nodeWith(param.local.left, {
              typeAnnotation: null,
              optional: false
            })
          });
        } else {
          value = nodeWith(param.local, {
            typeAnnotation: null,
            optional: false
          });
        } // Shorthand params

if (param.name.type === 'Identifier' && param.shorthand && (value.type === 'Identifier' || value.type === 'AssignmentPattern')) {
          return [{
            type: 'Property',
            key: param.name,
            kind: 'init',
            value,
            method: false,
            shorthand: true,
            computed: false,
            loc: param.loc,
            range: param.range,
            parent: EMPTY_PARENT
          }];
        } // Complex params

return [{
          type: 'Property',
          key: param.name,
          kind: 'init',
          value,
          method: false,
          shorthand: false,
          computed: false,
          loc: param.loc,
          range: param.range,
          parent: EMPTY_PARENT
        }];
      }

default:
      {
        throw (0, _createSyntaxError.createSyntaxError)(param, `Unknown Component parameter type of "${param.type}"`);
      }
  }
}

function createForwardRefWrapper(originalComponent) {
  const internalCompId = {
    type: 'Identifier',
    name: `${originalComponent.id.name}_withRef`,
    optional: false,
    typeAnnotation: null,
    loc: originalComponent.id.loc,
    range: originalComponent.id.range,
    parent: EMPTY_PARENT
  };
  return {
    forwardRefStatement: {
      type: 'VariableDeclaration',
      kind: 'const',
      declarations: [{
        type: 'VariableDeclarator',
        id: (0, _astNodeMutationHelpers.shallowCloneNode)(originalComponent.id),
        init: {
          type: 'CallExpression',
          callee: {
            type: 'MemberExpression',
            object: {
              type: 'Identifier',
              name: 'React',
              optional: false,
              typeAnnotation: null,
              loc: originalComponent.loc,
              range: originalComponent.range,
              parent: EMPTY_PARENT
            },
            property: {
              type: 'Identifier',
              name: 'forwardRef',
              optional: false,
              typeAnnotation: null,
              loc: originalComponent.loc,
              range: originalComponent.range,
              parent: EMPTY_PARENT
            },
            computed: false,
            optional: false,
            loc: originalComponent.loc,
            range: originalComponent.range,
            parent: EMPTY_PARENT
          },
          arguments: [(0, _astNodeMutationHelpers.shallowCloneNode)(internalCompId)],
          typeArguments: null,
          optional: false,
          loc: originalComponent.loc,
          range: originalComponent.range,
          parent: EMPTY_PARENT
        },
        loc: originalComponent.loc,
        range: originalComponent.range,
        parent: EMPTY_PARENT
      }],
      loc: originalComponent.loc,
      range: originalComponent.range,
      parent: originalComponent.parent
    },
    internalCompId: internalCompId,
    forwardRefCompId: originalComponent.id
  };
}

function mapComponentDeclaration(node, options) {
  // Create empty loc for return type annotation nodes
  const createRendersTypeLoc = () => ({
    loc: {
      start: node.body.loc.end,
      end: node.body.loc.end
    },
    range: [node.body.range[1], node.body.range[1]],
    parent: EMPTY_PARENT
  });

if (ref != null) {
    forwardRefDetails = createForwardRefWrapper(node);
  }

const comp = {
    type: 'FunctionDeclaration',
    id: forwardRefDetails != null ? (0, _astNodeMutationHelpers.shallowCloneNode)(forwardRefDetails.internalCompId) : (0, _astNodeMutationHelpers.shallowCloneNode)(node.id),
    __componentDeclaration: true,
    typeParameters: node.typeParameters,
    params: props == null ? [] : ref == null ? [props] : [props, ref],
    returnType,
    body: node.body,
    async: false,
    generator: false,
    predicate: null,
    loc: node.loc,
    range: node.range,
    parent: node.parent
  };
  return {
    comp,
    forwardRefDetails
  };
}

function mapDeclareHook(node) {
  return {
    type: 'DeclareFunction',
    id: {
      type: 'Identifier',
      name: node.id.name,
      optional: node.id.optional,
      typeAnnotation: {
        type: 'TypeAnnotation',
        typeAnnotation: {
          type: 'FunctionTypeAnnotation',
          this: null,
          params: node.id.typeAnnotation.typeAnnotation.params,
          typeParameters: node.id.typeAnnotation.typeAnnotation.typeParameters,
          rest: node.id.typeAnnotation.typeAnnotation.rest,
          returnType: node.id.typeAnnotation.typeAnnotation.returnType,
          loc: node.id.typeAnnotation.typeAnnotation.loc,
          range: node.id.typeAnnotation.typeAnnotation.range,
          parent: node.id.typeAnnotation.typeAnnotation.parent
        },
        loc: node.id.typeAnnotation.loc,
        range: node.id.typeAnnotation.range,
        parent: node.id.typeAnnotation.parent
      },
      loc: node.id.loc,
      range: node.id.range,
      parent: node.id.parent
    },
    loc: node.loc,
    range: node.range,
    parent: node.parent,
    predicate: null
  };
}

function mapHookDeclaration(node) {
  const comp = {
    type: 'FunctionDeclaration',
    id: node.id && (0, _astNodeMutationHelpers.shallowCloneNode)(node.id),
    __hookDeclaration: true,
    typeParameters: node.typeParameters,
    params: node.params,
    returnType: node.returnType,
    body: node.body,
    async: false,
    generator: false,
    predicate: null,
    loc: node.loc,
    range: node.range,
    parent: node.parent
  };
  return comp;
}
/**
 * Scan a list of statements and return the position of the
 * first statement that contains a reference to a given component
 * or null of no references were found.
 */

function scanForFirstComponentReference(compName, bodyList) {
  for (let i = 0; i < bodyList.length; i++) {
    const bodyNode = bodyList[i];
    let referencePos = null;

_SimpleTraverser.SimpleTraverser.traverse(bodyNode, {
      enter(node) {
        switch (node.type) {
          case 'Identifier':
            {
              if (node.name === compName) {
                // We found a reference, record it and stop.
                referencePos = i;
                throw _SimpleTraverser.SimpleTraverser.Break;
              }
            }
        }
      },

leave(_node) {}

});

if (referencePos != null) {
      return referencePos;
    }
  }

return null;
}

function mapComponentDeclarationIntoList(node, newBody, options, insertExport) {
  const {
    comp,
    forwardRefDetails
  } = mapComponentDeclaration(node, options);

if (forwardRefDetails != null) {
    // Scan for references to our component.
    const referencePos = scanForFirstComponentReference(forwardRefDetails.forwardRefCompId.name, newBody); // If a reference is found insert the forwardRef statement before it (to simulate function hoisting).

if (referencePos != null) {
      newBody.splice(referencePos, 0, forwardRefDetails.forwardRefStatement);
    } else {
      newBody.push(forwardRefDetails.forwardRefStatement);
    }

newBody.push(comp);

if (insertExport != null) {
      newBody.push(insertExport(forwardRefDetails.forwardRefCompId));
    }

return;
  }

newBody.push(insertExport != null ? insertExport(comp) : comp);
}

function mapStatementList(stmts, options) {
  const newBody = [];

for (const node of stmts) {
    switch (node.type) {
      case 'ComponentDeclaration':
        {
          mapComponentDeclarationIntoList(node, newBody, options);
          break;
        }

case 'HookDeclaration':
        {
          const decl = mapHookDeclaration(node);
          newBody.push(decl);
          break;
        }

case 'ExportNamedDeclaration':
        {
          var _node$declaration, _node$declaration2;

if (((_node$declaration = node.declaration) == null ? void 0 : _node$declaration.type) === 'ComponentDeclaration') {
            mapComponentDeclarationIntoList(node.declaration, newBody, options, componentOrRef => {
              switch (componentOrRef.type) {
                case 'FunctionDeclaration':
                  {
                    // No ref, so we can export the component directly.
                    return nodeWith(node, {
                      declaration: componentOrRef
                    });
                  }

case 'Identifier':
                  {
                    // If a ref is inserted, we should just export that id.
                    return {
                      type: 'ExportNamedDeclaration',
                      declaration: null,
                      specifiers: [{
                        type: 'ExportSpecifier',
                        exported: (0, _astNodeMutationHelpers.shallowCloneNode)(componentOrRef),
                        local: (0, _astNodeMutationHelpers.shallowCloneNode)(componentOrRef),
                        loc: node.loc,
                        range: node.range,
                        parent: EMPTY_PARENT
                      }],
                      exportKind: 'value',
                      source: null,
                      loc: node.loc,
                      range: node.range,
                      parent: node.parent
                    };
                  }
              }
            });
            break;
          }

if (((_node$declaration2 = node.declaration) == null ? void 0 : _node$declaration2.type) === 'HookDeclaration') {
            const comp = mapHookDeclaration(node.declaration);
            newBody.push(nodeWith(node, {
              declaration: comp
            }));
            break;
          }

newBody.push(node);
          break;
        }

case 'ExportDefaultDeclaration':
        {
          var _node$declaration3, _node$declaration4;

if (((_node$declaration3 = node.declaration) == null ? void 0 : _node$declaration3.type) === 'ComponentDeclaration') {
            mapComponentDeclarationIntoList(node.declaration, newBody, options, componentOrRef => nodeWith(node, {
              declaration: componentOrRef
            }));
            break;
          }

if (((_node$declaration4 = node.declaration) == null ? void 0 : _node$declaration4.type) === 'HookDeclaration') {
            const comp = mapHookDeclaration(node.declaration);
            newBody.push(nodeWith(node, {
              declaration: comp
            }));
            break;
          }

newBody.push(node);
          break;
        }

default:
        {
          newBody.push(node);
        }
    }
  }

return newBody;
}

function transformProgram(program, options) {
  return _SimpleTransform.SimpleTransform.transformProgram(program, {
    transform(node) {
      switch (node.type) {
        case 'DeclareComponent':
          {
            return mapDeclareComponent(node);
          }

case 'DeclareHook':
          {
            return mapDeclareHook(node);
          }

case 'Program':
        case 'BlockStatement':
          {
            return nodeWith(node, {
              body: mapStatementList(node.body, options)
            });
          }

case 'SwitchCase':
          {
            const consequent = mapStatementList(node.consequent, options);
            return nodeWith(node, {
              /* $FlowExpectedError[incompatible-call] We know `mapStatementList` will
                 not return `ModuleDeclaration` nodes if it is not passed any */
              consequent
            });
          }

case 'ComponentDeclaration':
          {
            var _node$parent;

throw (0, _createSyntaxError.createSyntaxError)(node, `Components must be defined at the top level of a module or within a ` + `BlockStatement, instead got parent of "${(_node$parent = node.parent) == null ? void 0 : _node$parent.type}".`);
          }

case 'HookDeclaration':
          {
            var _node$parent2;

throw (0, _createSyntaxError.createSyntaxError)(node, `Hooks must be defined at the top level of a module or within a ` + `BlockStatement, instead got parent of "${(_node$parent2 = node.parent) == null ? void 0 : _node$parent2.type}".`);
          }

default:
          {
            return node;
          }
      }
    }

});
}

geri dön