@angular/animations/fesm2022/animations.mjs.map

Angular - animations integration with web-animations

{"version":3,"file":"animations.mjs","sources":["../../../../../k8-fastbuild-ST-fdfa778d11ba/bin/packages/animations/src/animation_builder.ts"],"sourcesContent":["/**\n * @license\n * Copyright Google LLC All Rights Reserved.\n *\n * Use of this source code is governed by an MIT-style license that can be\n * found in the LICENSE file at https://angular.dev/license\n */\nimport {\n  ANIMATION_MODULE_TYPE,\n  DOCUMENT,\n  Inject,\n  inject,\n  Injectable,\n  Renderer2,\n  RendererFactory2,\n  RendererType2,\n  ViewEncapsulation,\n  ɵAnimationRendererType as AnimationRendererType,\n  ɵRuntimeError as RuntimeError,\n} from '@angular/core';\n\nimport {AnimationMetadata, AnimationOptions, sequence} from './animation_metadata';\nimport {RuntimeErrorCode} from './errors';\nimport {AnimationPlayer} from './players/animation_player';\n\n/**\n * An injectable service that produces an animation sequence programmatically within an\n * Angular component or directive.\n * Provided by the `BrowserAnimationsModule` or `NoopAnimationsModule`.\n *\n * @usageNotes\n *\n * To use this service, add it to your component or directive as a dependency.\n * The service is instantiated along with your component.\n *\n * Apps do not typically need to create their own animation players, but if you\n * do need to, follow these steps:\n *\n * 1. Use the <code>[AnimationBuilder.build](api/animations/AnimationBuilder#build)()</code> method\n * to create a programmatic animation. The method returns an `AnimationFactory` instance.\n *\n * 2. Use the factory object to create an `AnimationPlayer` and attach it to a DOM element.\n *\n * 3. Use the player object to control the animation programmatically.\n *\n * For example:\n *\n * ```ts\n * // import the service from BrowserAnimationsModule\n * import {AnimationBuilder} from '@angular/animations';\n * // require the service as a dependency\n * class MyCmp {\n *   constructor(private _builder: AnimationBuilder) {}\n *\n *   makeAnimation(element: any) {\n *     // first define a reusable animation\n *     const myAnimation = this._builder.build([\n *       style({ width: 0 }),\n *       animate(1000, style({ width: '100px' }))\n *     ]);\n *\n *     // use the returned factory object to create a player\n *     const player = myAnimation.create(element);\n *\n *     player.play();\n *   }\n * }\n * ```\n *\n * @publicApi\n *\n * @deprecated 20.2 Use `animate.enter` or `animate.leave` instead. Intent to remove in v23\n */\n@Injectable({providedIn: 'root', useFactory: () => inject(BrowserAnimationBuilder)})\nexport abstract class AnimationBuilder {\n  /**\n   * Builds a factory for producing a defined animation.\n   * @param animation A reusable animation definition.\n   * @returns A factory object that can create a player for the defined animation.\n   * @see {@link animate}\n   */\n  abstract build(animation: AnimationMetadata | AnimationMetadata[]): AnimationFactory;\n}\n\n/**\n * A factory object returned from the\n * <code>[AnimationBuilder.build](api/animations/AnimationBuilder#build)()</code>\n * method.\n *\n * @publicApi\n *\n * @deprecated 20.2 Use `animate.enter` or `animate.leave` instead. Intent to remove in v23\n */\nexport abstract class AnimationFactory {\n  /**\n   * Creates an `AnimationPlayer` instance for the reusable animation defined by\n   * the <code>[AnimationBuilder.build](api/animations/AnimationBuilder#build)()</code>\n   * method that created this factory and attaches the new player a DOM element.\n   *\n   * @param element The DOM element to which to attach the player.\n   * @param options A set of options that can include a time delay and\n   * additional developer-defined parameters.\n   */\n  abstract create(element: any, options?: AnimationOptions): AnimationPlayer;\n}\n\n@Injectable({providedIn: 'root'})\nexport class BrowserAnimationBuilder extends AnimationBuilder {\n  private animationModuleType = inject(ANIMATION_MODULE_TYPE, {optional: true});\n  private _nextAnimationId = 0;\n  private _renderer: Renderer2;\n\n  constructor(rootRenderer: RendererFactory2, @Inject(DOCUMENT) doc: Document) {\n    super();\n    const typeData: RendererType2 = {\n      id: '0',\n      encapsulation: ViewEncapsulation.None,\n      styles: [],\n      data: {animation: []},\n    };\n    this._renderer = rootRenderer.createRenderer(doc.body, typeData);\n\n    if (this.animationModuleType === null && !isAnimationRenderer(this._renderer)) {\n      // We only support AnimationRenderer & DynamicDelegationRenderer for this AnimationBuilder\n\n      throw new RuntimeError(\n        RuntimeErrorCode.BROWSER_ANIMATION_BUILDER_INJECTED_WITHOUT_ANIMATIONS,\n        (typeof ngDevMode === 'undefined' || ngDevMode) &&\n          'Angular detected that the `AnimationBuilder` was injected, but animation support was not enabled. ' +\n            'Please make sure that you enable animations in your application by calling `provideAnimations()` or `provideAnimationsAsync()` function.',\n      );\n    }\n  }\n\n  override build(animation: AnimationMetadata | AnimationMetadata[]): AnimationFactory {\n    const id = this._nextAnimationId;\n    this._nextAnimationId++;\n    const entry = Array.isArray(animation) ? sequence(animation) : animation;\n    issueAnimationCommand(this._renderer, null, id, 'register', [entry]);\n    return new BrowserAnimationFactory(id, this._renderer);\n  }\n}\n\nclass BrowserAnimationFactory extends AnimationFactory {\n  constructor(\n    private _id: number,\n    private _renderer: Renderer2,\n  ) {\n    super();\n  }\n\n  override create(element: any, options?: AnimationOptions): AnimationPlayer {\n    return new RendererAnimationPlayer(this._id, element, options || {}, this._renderer);\n  }\n}\n\nclass RendererAnimationPlayer implements AnimationPlayer {\n  public parentPlayer: AnimationPlayer | null = null;\n  private _started = false;\n\n  constructor(\n    public id: number,\n    public element: any,\n    options: AnimationOptions,\n    private _renderer: Renderer2,\n  ) {\n    this._command('create', options);\n  }\n\n  private _listen(eventName: string, callback: (event: any) => any): () => void {\n    return this._renderer.listen(this.element, `@@${this.id}:${eventName}`, callback);\n  }\n\n  private _command(command: string, ...args: any[]): void {\n    issueAnimationCommand(this._renderer, this.element, this.id, command, args);\n  }\n\n  onDone(fn: () => void): void {\n    this._listen('done', fn);\n  }\n\n  onStart(fn: () => void): void {\n    this._listen('start', fn);\n  }\n\n  onDestroy(fn: () => void): void {\n    this._listen('destroy', fn);\n  }\n\n  init(): void {\n    this._command('init');\n  }\n\n  hasStarted(): boolean {\n    return this._started;\n  }\n\n  play(): void {\n    this._command('play');\n    this._started = true;\n  }\n\n  pause(): void {\n    this._command('pause');\n  }\n\n  restart(): void {\n    this._command('restart');\n  }\n\n  finish(): void {\n    this._command('finish');\n  }\n\n  destroy(): void {\n    this._command('destroy');\n  }\n\n  reset(): void {\n    this._command('reset');\n    this._started = false;\n  }\n\n  setPosition(p: number): void {\n    this._command('setPosition', p);\n  }\n\n  getPosition(): number {\n    return unwrapAnimationRenderer(this._renderer)?.engine?.players[this.id]?.getPosition() ?? 0;\n  }\n\n  public totalTime = 0;\n}\n\nfunction issueAnimationCommand(\n  renderer: Renderer2,\n  element: any,\n  id: number,\n  command: string,\n  args: any[],\n): void {\n  renderer.setProperty(element, `@@${id}:${command}`, args);\n}\n\n/**\n * The following 2 methods cannot reference their correct types (AnimationRenderer &\n * DynamicDelegationRenderer) since this would introduce a import cycle.\n */\n\nfunction unwrapAnimationRenderer(\n  renderer: Renderer2,\n): {engine: {players: AnimationPlayer[]}} | null {\n  const type = (renderer as unknown as {ɵtype: AnimationRendererType}).ɵtype;\n  if (type === AnimationRendererType.Regular) {\n    return renderer as any;\n  } else if (type === AnimationRendererType.Delegated) {\n    return (renderer as any).animationRenderer;\n  }\n\n  return null;\n}\n\nfunction isAnimationRenderer(renderer: Renderer2): boolean {\n  const type = (renderer as unknown as {ɵtype: AnimationRendererType}).ɵtype;\n  return type === AnimationRendererType.Regular || type === AnimationRendererType.Delegated;\n}\n"],"names":["AnimationBuilder","deps","target","i0","ɵɵFactoryTarget","Injectable","providedIn","useFactory","inject","BrowserAnimationBuilder","decorators","args","AnimationFactory","animationModuleType","ANIMATION_MODULE_TYPE","optional","_nextAnimationId","_renderer","constructor","rootRenderer","doc","typeData","id","encapsulation","ViewEncapsulation","None","styles","data","animation","createRenderer","body","isAnimationRenderer","RuntimeError","ngDevMode","build","entry","Array","isArray","sequence","issueAnimationCommand","BrowserAnimationFactory","ɵfac","ɵɵngDeclareFactory","minVersion","version","ngImport","type","DOCUMENT","ɵprov","ɵɵngDeclareInjectable","Inject","_id","create","element","options","RendererAnimationPlayer","parentPlayer","_started","_command","_listen","eventName","callback","listen","command","onDone","fn","onStart","onDestroy","init","hasStarted","play","pause","restart","finish","destroy","reset","setPosition","p","getPosition","unwrapAnimationRenderer","engine","players","totalTime","renderer","setProperty","ɵtype","animationRenderer"],"mappings":"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"}