# Changelog

## Score

- CAI 58 → 61 (+2.4)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.

## Lenses

- Code Health 80 → 77 (-3.5)
- Architecture 89 → 98 (+8.6)
- Maturity 48 → 53 (+5.4)
- Readiness 53 → 53 (+0.0)
- Security 77 → 71 (-6.2)
- Performance 80 → 100 (+20.0)

## Resolved (18)

- Duplicate play methods with different parameter types for the same intent. Both `LottiePlaybackMode` and `PlaybackMode` are exposed as distinct types with identical static factory methods (`toProgress`, `toFrame`, `toMarker`). This forces the user to choose between two nearly identical types for the same logical concept (playback destination), creating confusion and redundant API surface.
- Duplicated block (11 lines × 3) (Sources/Private/Model/ShapeItems/Ellipse.swift)
- Duplicated block (12 lines × 2) (Sources/Public/Controls/LottieButton.swift)
- Duplicated block (13 lines × 2) (Sources/Private/Model/ShapeItems/GradientStroke.swift)
- Duplicated block (17–18 lines × 2) (Sources/Public/Animation/LottieAnimationLayer.swift)
- Duplicated block (19 lines × 2) (Sources/Private/Model/ShapeItems/GradientStroke.swift)
- Duplicated block (5 lines × 2) (Sources/Private/Model/LayerEffects/EffectValues/ColorEffectValue.swift)
- Duplicated block (5 lines × 2) (Sources/Private/Model/LayerEffects/EffectValues/ColorEffectValue.swift)
- Duplicated block (5 lines × 2) (Sources/Private/Model/Layers/ShapeLayerModel.swift)
- Duplicated block (5 lines × 2) (Sources/Public/iOS/BundleImageProvider.swift)
- Duplicated block (5 lines × 4) (Sources/Private/MainThread/NodeRenderSystem/Nodes/PathNodes/EllipseNode.swift)
- Duplicated block (6 lines × 2) (Sources/Private/MainThread/NodeRenderSystem/Nodes/ModifierNodes/RoundedCornersNode.swift)
- Duplicated block (7 lines × 3) (Sources/Private/Model/ShapeItems/ShapeTransform.swift)
- Inconsistent naming conventions for loading animations by source. The `LottieAnimation` class uses static factory methods (`named`, `filepath`, `asset`), while `LottieAnimationView` uses initializers with different parameter names (`name`, `filePath`, `asset`). Furthermore, `LottieAnimation` has a `named` method, but `LottieAnimationView` has a `init(name:)` initializer. This forces developers to learn two different naming schemas for the same logical operations (loading from bundle name, file path, or asset catalog).
- Inconsistent naming for marker-based playback. While `play(marker:toMarker:)` exists, the convenience method for playing a single marker is named `play(marker:)`. In contrast, the `LottieAnimation` class uses `frameTime(forMarker:)` and `progressTime(forMarker:)`. While not a direct duplicate, the verb 'play' vs 'get' is consistent, but the existence of `play(marker:)` alongside `play(fromMarker:toMarker:)` creates a slight asymmetry in the API design compared to the explicit range methods. However, the primary inconsistency is the duplication of the `play(marker:)` signature across both View and Layer without a shared protocol, leading to code duplication rather than interface consistency.
- Medium CVE: [GHSA redacted] (Gemfile.lock)
- Off-boarding risk: anonymized user #1
- Projects may be oversized for their cohesion

## New (16)

- Duplicated block (11 lines × 3) (Sources/Private/Model/ShapeItems/Ellipse.swift)
- Duplicated block (12 lines × 2) (Sources/Public/Controls/LottieButton.swift)
- Duplicated block (19 lines × 2) (Sources/Private/Model/ShapeItems/GradientStroke.swift)
- Duplicated block (5 lines × 2) (Sources/Private/Model/LayerEffects/EffectValues/ColorEffectValue.swift)
- Duplicated block (5 lines × 2) (Sources/Private/Model/LayerEffects/EffectValues/ColorEffectValue.swift)
- Duplicated block (5 lines × 2) (Sources/Private/Model/Layers/ShapeLayerModel.swift)
- Duplicated block (5 lines × 2) (Sources/Public/iOS/BundleImageProvider.swift)
- Duplicated block (5 lines × 4) (Sources/Private/MainThread/NodeRenderSystem/Nodes/PathNodes/EllipseNode.swift)
- Duplicated block (6 lines × 2) (Sources/Private/MainThread/NodeRenderSystem/Nodes/ModifierNodes/RoundedCornersNode.swift)
- Edited copy of a member (10 corresponding lines) (Sources/Private/MainThread/LayerContainers/MainThreadAnimationLayer.swift)
- Edited copy of a member (13 corresponding lines) (Sources/Private/Model/Extensions/KeyedDecodingContainerExtensions.swift)
- Edited copy of a member (13 corresponding lines) (Sources/Private/Model/ShapeItems/Ellipse.swift)
- Edited copy of a member (5 corresponding lines) (Sources/Private/Model/Layers/ShapeLayerModel.swift)
- Edited copy of a member (7 corresponding lines) (Sources/Public/Animation/LottieView.swift)
- High CVE: [GHSA redacted] (Gemfile.lock)
- Off-boarding risk: anonymized user #1
