react-native-reanimated/src/css/utils/props.ts

More powerful alternative to Animated library for React Native.

'use strict';
import type { UnknownRecord } from '../../common';
import { isEmptyObject, isSupportedStyleProp, logger } from '../../common';
import { isSharedValue } from '../../isSharedValue';
import type {
  CSSAnimationCallback,
  CSSAnimationCallbacks,
  CSSAnimationProperties,
  CSSStyle,
  CSSTransitionCallback,
  CSSTransitionCallbacks,
  CSSTransitionProperties,
  ExistingCSSAnimationProperties,
} from '../types';
import {
  ANIMATION_CALLBACK_PROPS,
  isAnimationProp,
  isCSSKeyframesObject,
  isCSSKeyframesRule,
  isPseudoSelectorValue,
  isTransitionProp,
  TRANSITION_CALLBACK_PROPS,
} from './guards';

export type PseudoStylesBySelector = Record<
  string,
  { selectorStyle: UnknownRecord; defaultStyle: UnknownRecord }
>;

export function filterCSSAndStyleProperties<S extends object>(
  style: CSSStyle<S>
): [
  ExistingCSSAnimationProperties | null,
  CSSTransitionProperties | null,
  PseudoStylesBySelector | null,
  UnknownRecord,
] {
  const animationProperties: Partial<CSSAnimationProperties> = {};
  let transitionProperties: Partial<CSSTransitionProperties> = {};
  const filteredStyle: UnknownRecord = {};
  const pseudoStylesBySelector: PseudoStylesBySelector = {};

  const styleObject = style as UnknownRecord;

  // The CSS / transition / animation buckets are strongly typed but at this
  // point we are dynamically splitting an opaque style object by prop name;
  // values are validated downstream by the normalizers.
  for (const prop in styleObject) {
    const value = styleObject[prop];
    if (value === undefined) {
      // If the user explicitly sets a property to undefined (e.g. when they want
      // to remove CSS transition or animation), we treat the property as if it was not
      // present in the style object.
      continue;
    }

    if (isAnimationProp(prop)) {
      // TODO - add support for animation shorthand
      (animationProperties as UnknownRecord)[prop] = value;
    } else if (isTransitionProp(prop)) {
      // If there is a shorthand `transition` property, all properties specified
      // before are ignored and only these specified later are taken into account
      // and override ones from the shorthand
      if (prop === 'transition') {
        transitionProperties = {
          transition: value as CSSTransitionProperties['transition'],
        };
      } else {
        (transitionProperties as UnknownRecord)[prop] = value;
      }
    } else if (isSharedValue(value)) {
      continue;
    } else if (isPseudoSelectorValue(value)) {
      const defaultValue = value.default;
      if (defaultValue !== undefined) {
        filteredStyle[prop] = defaultValue;
      }
      for (const selector in value) {
        if (selector === 'default') {
          continue;
        }
        const branch = (pseudoStylesBySelector[selector] ??= {
          selectorStyle: {},
          defaultStyle: {},
        });
        branch.selectorStyle[prop] = value[selector];
        branch.defaultStyle[prop] = defaultValue;
      }
    } else if (isEmptyObject(value) && isSupportedStyleProp(prop)) {
      throw new Error(
        `[Reanimated] Invalid value for "${prop}": an empty object is not a valid style value.`
      );
    } else {
      filteredStyle[prop] = value;
    }
  }

  // Return animationProperties only if at least one animationName contains
  // valid keyframes
  const animationName = animationProperties.animationName;
  const hasAnimationName =
    !!animationName &&
    (Array.isArray(animationName) ? animationName : [animationName]).every(
      (keyframes) =>
        keyframes === 'none'
          ? false
          : isCSSKeyframesRule(keyframes) || isCSSKeyframesObject(keyframes)
    );
  const finalAnimationConfig = hasAnimationName
    ? ({
        ...animationProperties,
        animationName,
      } as ExistingCSSAnimationProperties)
    : null;

  // Return transitionProperties only if the transitionProperty is present
  const hasTransitionConfig = Object.keys(transitionProperties).length > 0;
  const finalTransitionConfig = hasTransitionConfig
    ? transitionProperties
    : null;

  const hasPseudoStyles = Object.keys(pseudoStylesBySelector).length > 0;
  const finalPseudoStyles = hasPseudoStyles ? pseudoStylesBySelector : null;

  if (__DEV__) {
    validateCSSAnimationProps(animationProperties);
    validateCSSTransitionProps(transitionProperties);
  }

  return [
    finalAnimationConfig,
    finalTransitionConfig,
    finalPseudoStyles,
    filteredStyle,
  ];
}

function validateCSSAnimationProps(props: Partial<CSSAnimationProperties>) {
  // Check if animationDuration is missing when animationName is present
  if (!('animationDuration' in props) && 'animationName' in props) {
    logger.warn(
      'animationDuration was not specified for CSS animation. The default duration is 0s.\n' +
        'Have you forgotten to pass the animationDuration?'
    );
  }
}

function validateCSSTransitionProps(props: Partial<CSSTransitionProperties>) {
  // Check if transitionDuration is missing when transitionProperty is present
  if (!('transitionDuration' in props) && 'transitionProperty' in props) {
    logger.warn(
      'transitionDuration was not specified for CSS transition. The default duration is 0s.\n' +
        'Have you forgotten to pass the transitionDuration?'
    );
  }
}

/** Splits the callback props into their animation and transition halves. */
export function splitCSSCallbacks(
  props: Readonly<UnknownRecord>
): [CSSAnimationCallbacks | null, CSSTransitionCallbacks | null] {
  const animationCallbacks: CSSAnimationCallbacks = {};
  const transitionCallbacks: CSSTransitionCallbacks = {};
  let hasAnimationCallbacks = false;
  let hasTransitionCallbacks = false;

  for (const prop of ANIMATION_CALLBACK_PROPS) {
    const value = props[prop];
    if (value !== undefined) {
      animationCallbacks[prop] = value as CSSAnimationCallback;
      hasAnimationCallbacks = true;
    }
  }

  for (const prop of TRANSITION_CALLBACK_PROPS) {
    const value = props[prop];
    if (value !== undefined) {
      transitionCallbacks[prop] = value as CSSTransitionCallback;
      hasTransitionCallbacks = true;
    }
  }

  return [
    hasAnimationCallbacks ? animationCallbacks : null,
    hasTransitionCallbacks ? transitionCallbacks : null,
  ];
}