Skip to content

armgit / anime

Public Imported from GitHub
0

JavaScript animation engine

4.0 KB
Raw Blame
/**
 * Anime.js - utils - CJS
 * @version v4.5.0
 * @license MIT
 * @copyright 2026 - Julian Garnier
 */

'use strict';

var globals = require('../core/globals.cjs');
var consts = require('../core/consts.cjs');
var helpers = require('../core/helpers.cjs');
var targets = require('../core/targets.cjs');
var styles = require('../core/styles.cjs');
var values = require('../core/values.cjs');
var units = require('../core/units.cjs');
var composition = require('../waapi/composition.cjs');
var composition$1 = require('../animation/composition.cjs');
var animation = require('../animation/animation.cjs');

/**
 * @import {
 *   Renderable,
 *   DOMTargetSelector,
 *   JSTargetsParam,
 *   DOMTargetsParam,
 *   TargetsParam,
 *   DOMTarget,
 *   AnimationParams,
 *   TargetsArray,
 * } from '../types/index.js'
*/

/**
 * @import {
 *   WAAPIAnimation
 * } from '../waapi/waapi.js'
*/

/**
 * @overload
 * @param  {DOMTargetSelector} targetSelector
 * @param  {String} propName
 * @return {String}
 *
 * @overload
 * @param  {JSTargetsParam} targetSelector
 * @param  {String} propName
 * @return {Number|String}
 *
 * @overload
 * @param  {DOMTargetsParam} targetSelector
 * @param  {String} propName
 * @param  {String} unit
 * @return {String}
 *
 * @overload
 * @param  {TargetsParam} targetSelector
 * @param  {String} propName
 * @param  {Boolean} unit
 * @return {Number}
 *
 * @param  {TargetsParam} targetSelector
 * @param  {String} propName
 * @param  {String|Boolean} [unit]
 */
function get(targetSelector, propName, unit) {
  const targets$1 = targets.registerTargets(targetSelector);
  if (!targets$1.length) return;
  const [ target ] = targets$1;
  const tweenType = values.getTweenType(target, propName);
  const normalizePropName = styles.sanitizePropertyName(propName, target, tweenType);
  let originalValue = values.getOriginalAnimatableValue(target, normalizePropName);
  if (helpers.isUnd(unit)) {
    return originalValue;
  } else {
    values.decomposeRawValue(originalValue, values.decomposedOriginalValue);
    if (values.decomposedOriginalValue.t === consts.valueTypes.NUMBER || values.decomposedOriginalValue.t === consts.valueTypes.UNIT) {
      if (unit === false) {
        return values.decomposedOriginalValue.n;
      } else {
        const convertedValue = units.convertValueUnit(/** @type {DOMTarget} */(target), values.decomposedOriginalValue, /** @type {String} */(unit), false);
        return `${helpers.round(convertedValue.n, globals.globals.precision)}${convertedValue.u}`;
      }
    }
  }
}

/**
 * @param  {TargetsParam} targets
 * @param  {AnimationParams} parameters
 * @return {JSAnimation}
 */
const set = (targets, parameters) => {
  if (helpers.isUnd(parameters)) return;
  if (globals.globals.editor && globals.globals.editor.addSet) {
    return globals.globals.editor.addSet(targets, parameters);
  }
  parameters.duration = consts.minValue;
  // Do not overrides currently active tweens by default
  parameters.composition = values.setValue(parameters.composition, consts.compositionTypes.none);
  // Skip init() and force rendering by playing the animation
  return new animation.JSAnimation(targets, parameters, null, 0, true).resume();
};

/**
 * @param  {TargetsParam} targets
 * @param  {Renderable|WAAPIAnimation} [renderable]
 * @param  {String} [propertyName]
 * @return {TargetsArray}
 */
const remove = (targets$1, renderable, propertyName) => {
  const targetsArray = targets.parseTargets(targets$1);
  for (let i = 0, l = targetsArray.length; i < l; i++) {
    composition.removeWAAPIAnimation(
      /** @type {DOMTarget}  */(targetsArray[i]),
      propertyName,
      renderable && /** @type {WAAPIAnimation} */(renderable).controlAnimation && /** @type {WAAPIAnimation} */(renderable),
    );
  }
  composition$1.removeTargetsFromRenderable(
    targetsArray,
    /** @type {Renderable} */(renderable),
    propertyName
  );
  return targetsArray;
};

exports.$ = targets.registerTargets;
exports.cleanInlineStyles = styles.cleanInlineStyles;
exports.get = get;
exports.remove = remove;
exports.set = set;