react-native/Libraries/StyleSheet/private/_TransformStyle.js

A framework for building native apps using React

/**
 * 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.
 *
 * @flow strict-local
 * @format
 */

import type AnimatedNode from '../../Animated/nodes/AnimatedNode';

export type ____TransformStyle_Internal = $ReadOnly<{
  /**
   * `transform` accepts an array of transformation objects. Each object specifies
   * the property that will be transformed as the key, and the value to use in the
   * transformation. Objects should not be combined. Use a single key/value pair
   * per object.
   *
   * The rotate transformations require a string so that the transform may be
   * expressed in degrees (deg) or radians (rad). For example:
   *
   * `transform([{ rotateX: '45deg' }, { rotateZ: '0.785398rad' }])`
   *
   * The skew transformations require a string so that the transform may be
   * expressed in degrees (deg). For example:
   *
   * `transform([{ skewX: '45deg' }])`
   */
  transform?:
    | $ReadOnlyArray<
        | {+perspective: number | AnimatedNode}
        | {+rotate: string | AnimatedNode}
        | {+rotateX: string | AnimatedNode}
        | {+rotateY: string | AnimatedNode}
        | {+rotateZ: string | AnimatedNode}
        | {+scale: number | AnimatedNode}
        | {+scaleX: number | AnimatedNode}
        | {+scaleY: number | AnimatedNode}
        | {+translateX: number | AnimatedNode}
        | {+translateY: number | AnimatedNode}
        | {
            +translate:
              | [number | AnimatedNode, number | AnimatedNode]
              | AnimatedNode,
          }
        | {+skewX: string | AnimatedNode}
        | {+skewY: string | AnimatedNode}
        // TODO: what is the actual type it expects?
        | {
            +matrix: $ReadOnlyArray<number | AnimatedNode> | AnimatedNode,
          },
      >
    | string,
  /**
   * `transformOrigin` accepts an array with 3 elements - each element either being
   * a number, or a string of a number ending with `%`. The last element cannot be
   * a percentage, so must be a number.
   *
   * E.g. transformOrigin: ['30%', '80%', 15]
   *
   * Alternatively accepts a string of the CSS syntax. You must use `%` or `px`.
   *
   * E.g. transformOrigin: '30% 80% 15px'
   */
  transformOrigin?:
    | [string | number, string | number, string | number]
    | string,
}>;