Update: Test Translation for Animation APIs

Author: ParallelKim

packages/animations/browser/index.ts

@@ -2,13 +2,10 @@
  * @license
  * Copyright Google LLC All Rights Reserved.
  *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.dev/license
+ * 이 소스 코드는 https://angular.dev/license의 LICENSE 파일에서 찾을 수 있는 MIT 스타일 라이센스에 의해 관리됩니다.
  */
 
-// This file is not used to build this module. It is only used during editing
-// by the TypeScript language service and during build for verification. `ngc`
-// replaces this file with production index.ts when it rewrites private symbol
-// names.
+// 이 파일은 이 모듈을 빌드하는 데 사용되지 않습니다. 이것은 TypeScript 언어 서비스가 편집하는 동안과 빌드 중 검증을 위해서만 사용됩니다. `ngc`
+// 는 개인 심볼 이름을 재작성할 때 이 파일을 프로덕션 index.ts로 대체합니다.
 
 export * from './public_api';

packages/animations/browser/public_api.ts

@@ -2,13 +2,13 @@
  * @license
  * Copyright Google LLC All Rights Reserved.
  *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.dev/license
+ * 이 소스 코드의 사용은 MIT 스타일 라이센스에 따라 관리되며,
+ * https://angular.dev/license 에서 LICENSE 파일에서 찾을 수 있습니다.
  */
 
 /**
  * @module
  * @description
- * Entry point for all public APIs of this package.
+ * 이 패키지의 모든 공개 API에 대한 진입점.
  */
 export * from './src/browser';

packages/animations/browser/src/browser.ts

@@ -2,14 +2,14 @@
  * @license
  * Copyright Google LLC All Rights Reserved.
  *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.dev/license
+ * 이 소스 코드는 https://angular.dev/license에 있는 LICENSE 파일에 따라
+ * MIT 스타일 라이선스의 적용을 받습니다.
  */
 
 /**
  * @module
  * @description
- * Entry point for all animation APIs of the animation browser package.
+ * 애니메이션 브라우저 패키지의 모든 애니메이션 API에 대한 진입점입니다.
  */
 export {AnimationDriver, NoopAnimationDriver} from './render/animation_driver';
 export * from './private_export';

packages/animations/browser/src/dsl/animation_ast_builder.ts

@@ -2,8 +2,7 @@
  * @license
  * Copyright Google LLC All Rights Reserved.
  *
- * Use of this source code is governed by an MIT-style license that can be
- * found in the LICENSE file at https://angular.dev/license
+ * 이 소스 코드의 사용은 https://angular.dev/license의 LICENSE 파일에 기재된 MIT 스타일 라이센스에 의해 관리됩니다.
  */
 import {
   AnimateTimings,
@@ -81,40 +80,39 @@ const SELF_TOKEN = ':self';
 const SELF_TOKEN_REGEX = /* @__PURE__ */ new RegExp(`s*${SELF_TOKEN}s*,?`, 'g');
 
 /*
- * [Validation]
- * The visitor code below will traverse the animation AST generated by the animation verb functions
- * (the output is a tree of objects) and attempt to perform a series of validations on the data. The
- * following corner-cases will be validated:
+ * [유효성 검사]
+ * 아래의 방문자 코드는 애니메이션 동사 함수에 의해 생성된 애니메이션 AST를 탐색하며
+ * (출력은 객체의 트리입니다) 데이터에 대해 일련의 유효성 검사를 수행합니다.
+ * 다음과 같은 가장자리 사례가 유효성이 검사를 받을 것입니다:
  *
- * 1. Overlap of animations
- * Given that a CSS property cannot be animated in more than one place at the same time, it's
- * important that this behavior is detected and validated. The way in which this occurs is that
- * each time a style property is examined, a string-map containing the property will be updated with
- * the start and end times for when the property is used within an animation step.
+ * 1. 애니메이션의 오버랩
+ * CSS 속성은 동시에 여러 장소에서 애니메이션할 수 없으므로,
+ * 이 행동이 감지되고 유효성이 검사가 중요합니다. 이는 스타일 속성이 검사될 때마다
+ * 해당 속성이 애니메이션 단계 내에서 사용될 때의 시작 및 종료 시간을 포함하는 문자열-지도에
+ * 속성이 업데이트되는 방식으로 발생합니다.
  *
- * If there are two or more parallel animations that are currently running (these are invoked by the
- * group()) on the same element then the validator will throw an error. Since the start/end timing
- * values are collected for each property then if the current animation step is animating the same
- * property and its timing values fall anywhere into the window of time that the property is
- * currently being animated within then this is what causes an error.
+ * 만약 현재 실행 중인 두 개 이상의 병렬 애니메이션이(이는 group()에 의해 호출됨)
+ * 동일한 요소에서 실행되고 있다면, 유효성 검사기가 오류를 발생시킵니다. 현재 애니메이션 단게가
+ * 같은 속성을 애니메이션하고 있고 그 타이밍 값이 현재 애니메이션 중인 시간 창에
+ * 해당 속성의 타이밍 값이 포함된다면 오류를 발생시킵니다.
  *
- * 2. Timing values
- * The validator will validate to see if a timing value of `duration delay easing` or
- * `durationNumber` is valid or not.
+ * 2. 타이밍 값
+ * 유효성 검사기는 `duration delay easing` 또는
+ * `durationNumber`의 타이밍 값이 유효한지 확인합니다.
  *
- * (note that upon validation the code below will replace the timing data with an object containing
- * {duration,delay,easing}.
+ * (유효성 검사 시 다음 코드는 타이밍 데이터를 {duration,delay,easing}을 포함하는 객체로
+ * 대체합니다.)
  *
- * 3. Offset Validation
- * Each of the style() calls are allowed to have an offset value when placed inside of keyframes().
- * Offsets within keyframes() are considered valid when:
+ * 3. 오프셋 유효성 검사
+ * style() 호출은 keyframes() 내에 있을 때 오프셋 값을 가질 수 있습니다.
+ * keyframes() 내의 오프셋은 다음과 같은 경우에 유효하다고 간주됩니다:
  *
- *   - No offsets are used at all
- *   - Each style() entry contains an offset value
- *   - Each offset is between 0 and 1
- *   - Each offset is greater to or equal than the previous one
+ *   - 전혀 오프셋을 사용하지 않을 때
+ *   - 각 style() 항목이 오프셋 값을 포함할 때
+ *   - 각 오프셋이 0과 1 사이일 때
+ *   - 각 오프셋이 이전 오프셋보다 크거나 같을 때
  *
- * Otherwise an error will be thrown.
+ * 그렇지 않으면 오류가 발생합니다.
  */
 export function buildAnimationAst(
   driver: AnimationDriver,
@@ -395,8 +393,8 @@ export class AnimationAstBuilderVisitor implements AnimationDslVisitor {
           }
         }
 
-        // This is guaranteed to have a defined Map at this querySelector location making it
-        // safe to add the assertion here. It is set as a default empty map in prior methods.
+        // 이 쿼리 선택자 위치에는 정의된 Map이 있음을 보장하며
+        // 여기서 단언을 추가하는 것이 안전합니다. 이전 메소드에서 기본적으로 빈 맵으로 설정됩니다.
         const collectedStyles = context.collectedStyles.get(context.currentQuerySelector!)!;
         const collectedEntry = collectedStyles.get(prop);
         let updateCollectedStyle = true;
@@ -418,9 +416,8 @@ export class AnimationAstBuilderVisitor implements AnimationDslVisitor {
             updateCollectedStyle = false;
           }
 
-          // we always choose the smaller start time value since we
-          // want to have a record of the entire animation window where
-          // the style property is being animated in between
+          // 우리는 항상 더 작은 시작 시간 값을 선택합니다.
+          // 왜냐하면 우리는 스타일 속성이 애니메이션되는 전체 애니메이션 창을 기록하고 싶기 때문입니다.
           startTime = collectedEntry.startTime;
         }
 
@@ -593,8 +590,8 @@ function normalizeSelector(selector: string): [string, boolean] {
     selector = selector.replace(SELF_TOKEN_REGEX, '');
   }
 
-  // Note: the :enter and :leave aren't normalized here since those
-  // selectors are filled in at runtime during timeline building
+  // 참고: :enter 및 :leave는 여기에서 정규화되지 않으며,
+  // 해당 선택자는 시간표 구축 시 런타임 동안 채워집니다.
   selector = selector
     .replace(/@\*/g, NG_TRIGGER_SELECTOR)
     .replace(/@\w+/g, (match) => NG_TRIGGER_SELECTOR + '-' + match.slice(1))