@octane-xplat/lottie 0.9.0 → 0.11.0

package/platforms/macos/src/vendor/Lottie/Private/EmbeddedLibraries/EpoxyCore/Model/Internal/AnyEpoxyModelProperty.swift

@@ -0,0 +1,31 @@
+// Created by eric_horacek on 12/1/20.
+// Copyright © 2020 Airbnb Inc. All rights reserved.
+
+// MARK: - AnyEpoxyModelProperty
+
+/// An erased `EpoxyModelProperty`, with the ability to call the `UpdateStrategy` even when the type
+/// has been erased.
+protocol AnyEpoxyModelProperty {
+  /// Returns the updated property from updating from given old to new property.
+  func update(old: Any, new: Any) -> Any
+}
+
+// MARK: - EpoxyModelProperty + AnyEpoxyModelProperty
+
+extension EpoxyModelProperty: AnyEpoxyModelProperty {
+  func update(old: Any, new: Any) -> Any {
+    guard let typedOld = old as? Value else {
+      EpoxyLogger.shared.assertionFailure(
+        "Expected old to be of type \(Value.self), instead found \(old). This is programmer error."
+      )
+      return defaultValue()
+    }
+    guard let typedNew = new as? Value else {
+      EpoxyLogger.shared.assertionFailure(
+        "Expected new to be of type \(Value.self), instead found \(old). This is programmer error."
+      )
+      return defaultValue()
+    }
+    return updateStrategy.update(typedOld, typedNew)
+  }
+}

package/platforms/macos/src/vendor/Lottie/Private/EmbeddedLibraries/EpoxyCore/Model/Internal/ClassReference.swift

@@ -0,0 +1,39 @@
+// Created by Cal Stephens on 10/15/21.
+// Copyright © 2021 Airbnb Inc. All rights reserved.
+
+// MARK: - ClassReference
+
+/// A `Hashable` value wrapper around an `AnyClass` value
+///  - Unlike `ObjectIdentifier(class)`, `ClassReference(class)`
+///    preserves the `AnyClass` value and is more human-readable.
+struct ClassReference {
+  init(_ class: AnyClass) {
+    self.class = `class`
+  }
+
+  let `class`: AnyClass
+}
+
+// MARK: Equatable
+
+extension ClassReference: Equatable {
+  static func ==(_ lhs: Self, _ rhs: Self) -> Bool {
+    ObjectIdentifier(lhs.class) == ObjectIdentifier(rhs.class)
+  }
+}
+
+// MARK: Hashable
+
+extension ClassReference: Hashable {
+  func hash(into hasher: inout Hasher) {
+    hasher.combine(ObjectIdentifier(`class`))
+  }
+}
+
+// MARK: CustomStringConvertible
+
+extension ClassReference: CustomStringConvertible {
+  var description: String {
+    String(describing: `class`)
+  }
+}

package/platforms/macos/src/vendor/Lottie/Private/EmbeddedLibraries/EpoxyCore/Model/Providers/AnimatedProviding.swift

@@ -0,0 +1,10 @@
+// Created by eric_horacek on 12/16/20.
+// Copyright © 2020 Airbnb Inc. All rights reserved.
+
+/// The capability of providing a flag indicating whether an operation should be animated.
+///
+/// Typically conformed to by the `CallbackContext` of a `CallbackContextEpoxyModeled`.
+protocol AnimatedProviding {
+  /// Whether this operation should be animated.
+  var animated: Bool { get }
+}

package/platforms/macos/src/vendor/Lottie/Private/EmbeddedLibraries/EpoxyCore/Model/Providers/DataIDProviding.swift

@@ -0,0 +1,58 @@
+// Created by eric_horacek on 12/1/20.
+// Copyright © 2020 Airbnb Inc. All rights reserved.
+
+// MARK: - DataIDProviding
+
+/// The capability of providing a stable data identifier with an erased type.
+///
+/// While it has similar semantics, this type cannot inherit from `Identifiable` as this would give
+/// it an associated type, which would cause the `keyPath` used in its `EpoxyModelProperty` to not
+/// be stable across types if written as `\Self.dataID` since the `KeyPath` `Root` would be
+/// different for each type.
+///
+/// - SeeAlso: `Identifiable`.
+protocol DataIDProviding {
+  /// A stable identifier that uniquely identifies this instance, with its typed erased.
+  ///
+  /// Defaults to `DefaultDataID.noneProvided` if no data ID is provided.
+  var dataID: AnyHashable { get }
+}
+
+// MARK: - EpoxyModeled
+
+extension EpoxyModeled where Self: DataIDProviding {
+
+  // MARK: Internal
+
+  /// A stable identifier that uniquely identifies this model, with its typed erased.
+  var dataID: AnyHashable {
+    get { self[dataIDProperty] }
+    set { self[dataIDProperty] = newValue }
+  }
+
+  /// Returns a copy of this model with the ID replaced with the provided ID.
+  func dataID(_ value: AnyHashable) -> Self {
+    copy(updating: dataIDProperty, to: value)
+  }
+
+  // MARK: Private
+
+  private var dataIDProperty: EpoxyModelProperty<AnyHashable> {
+    EpoxyModelProperty(
+      keyPath: \DataIDProviding.dataID,
+      defaultValue: DefaultDataID.noneProvided,
+      updateStrategy: .replace
+    )
+  }
+}
+
+// MARK: - DefaultDataID
+
+/// The default data ID when none is provided.
+enum DefaultDataID: Hashable, CustomDebugStringConvertible {
+  case noneProvided
+
+  var debugDescription: String {
+    "DefaultDataID.noneProvided"
+  }
+}

package/platforms/macos/src/vendor/Lottie/Private/EmbeddedLibraries/EpoxyCore/Model/Providers/DidDisplayProviding.swift

@@ -0,0 +1,41 @@
+// Created by eric_horacek on 1/6/21.
+// Copyright © 2021 Airbnb Inc. All rights reserved.
+
+// MARK: - DidDisplayProviding
+
+/// A sentinel protocol for enabling an `CallbackContextEpoxyModeled` to provide a `didDisplay`
+/// closure property.
+///
+/// - SeeAlso: `WillDisplayProviding`
+/// - SeeAlso: `DidEndDisplayingProviding`
+protocol DidDisplayProviding { }
+
+// MARK: - CallbackContextEpoxyModeled
+
+extension CallbackContextEpoxyModeled where Self: DidDisplayProviding {
+
+  // MARK: Internal
+
+  /// A closure that's called after a view has been added to the view hierarchy following any
+  /// appearance animations.
+  typealias DidDisplay = (_ context: CallbackContext) -> Void
+
+  /// A closure that's called after the view has been added to the view hierarchy following any
+  /// appearance animations.
+  var didDisplay: DidDisplay? {
+    get { self[didDisplayProperty] }
+    set { self[didDisplayProperty] = newValue }
+  }
+
+  /// Returns a copy of this model with the given did display closure called after the current did
+  /// display closure of this model, if there is one.
+  func didDisplay(_ value: DidDisplay?) -> Self {
+    copy(updating: didDisplayProperty, to: value)
+  }
+
+  // MARK: Private
+
+  private var didDisplayProperty: EpoxyModelProperty<DidDisplay?> {
+    .init(keyPath: \Self.didDisplay, defaultValue: nil, updateStrategy: .chain())
+  }
+}

package/platforms/macos/src/vendor/Lottie/Private/EmbeddedLibraries/EpoxyCore/Model/Providers/DidEndDisplayingProviding.swift

@@ -0,0 +1,42 @@
+// Created by eric_horacek on 12/15/20.
+// Copyright © 2020 Airbnb Inc. All rights reserved.
+
+// MARK: - DidEndDisplayingProviding
+
+/// A sentinel protocol for enabling an `CallbackContextEpoxyModeled` to provide a
+/// `didEndDisplaying` closure property.
+protocol DidEndDisplayingProviding { }
+
+// MARK: - CallbackContextEpoxyModeled
+
+extension CallbackContextEpoxyModeled where Self: DidEndDisplayingProviding {
+
+  // MARK: Internal
+
+  /// A closure that's called when a view is no longer displayed following any disappearance
+  /// animations and when it has been removed from the view hierarchy.
+  typealias DidEndDisplaying = (_ context: CallbackContext) -> Void
+
+  /// A closure that's called when the view is no longer displayed following any disappearance
+  /// animations and when it has been removed from the view hierarchy.
+  var didEndDisplaying: DidEndDisplaying? {
+    get { self[didEndDisplayingProperty] }
+    set { self[didEndDisplayingProperty] = newValue }
+  }
+
+  /// Returns a copy of this model with the given did end displaying closure called after the
+  /// current did end displaying closure of this model, if there is one.
+  func didEndDisplaying(_ value: DidEndDisplaying?) -> Self {
+    copy(updating: didEndDisplayingProperty, to: value)
+  }
+
+  // MARK: Private
+
+  private var didEndDisplayingProperty: EpoxyModelProperty<DidEndDisplaying?> {
+    .init(
+      keyPath: \Self.didEndDisplaying,
+      defaultValue: nil,
+      updateStrategy: .chain()
+    )
+  }
+}

package/platforms/macos/src/vendor/Lottie/Private/EmbeddedLibraries/EpoxyCore/Model/Providers/DidSelectProviding.swift

@@ -0,0 +1,36 @@
+// Created by eric_horacek on 12/2/20.
+// Copyright © 2020 Airbnb Inc. All rights reserved.
+
+// MARK: - DidSelectProviding
+
+/// A sentinel protocol for enabling an `CallbackContextEpoxyModeled` to provide a `didSelect`
+/// closure property.
+protocol DidSelectProviding { }
+
+// MARK: - CallbackContextEpoxyModeled
+
+extension CallbackContextEpoxyModeled where Self: DidSelectProviding {
+
+  // MARK: Internal
+
+  /// A closure that's called to handle this model's view being selected.
+  typealias DidSelect = (CallbackContext) -> Void
+
+  /// A closure that's called to handle this model's view being selected.
+  var didSelect: DidSelect? {
+    get { self[didSelectProperty] }
+    set { self[didSelectProperty] = newValue }
+  }
+
+  /// Returns a copy of this model with the given did select closure called after the current did
+  /// select closure of this model, if there is one.
+  func didSelect(_ value: DidSelect?) -> Self {
+    copy(updating: didSelectProperty, to: value)
+  }
+
+  // MARK: Private
+
+  private var didSelectProperty: EpoxyModelProperty<DidSelect?> {
+    .init(keyPath: \Self.didSelect, defaultValue: nil, updateStrategy: .chain())
+  }
+}

package/platforms/macos/src/vendor/Lottie/Private/EmbeddedLibraries/EpoxyCore/Model/Providers/ErasedContentProviding.swift

@@ -0,0 +1,49 @@
+// Created by eric_horacek on 12/2/20.
+// Copyright © 2020 Airbnb Inc. All rights reserved.
+
+// MARK: - ErasedContentProviding
+
+/// The capability of providing an type-erased `Equatable` content instance.
+protocol ErasedContentProviding {
+  /// The type-erased content instance of this model, else `nil` if there is no content.
+  ///
+  /// If there was an `AnyEquatable` type, we could store this property using it. Instead we need
+  /// need to store `isErasedContentEqual` to determine equality.
+  var erasedContent: Any? { get }
+
+  /// A closure that can be called to determine whether the given `model`'s `erasedContent` is equal
+  /// to this model's `erasedContent`, else `nil` if there is no content or the content is always
+  /// equal.
+  var isErasedContentEqual: ((ErasedContentProviding) -> Bool)? { get }
+}
+
+// MARK: - EpoxyModeled
+
+extension EpoxyModeled where Self: ErasedContentProviding {
+
+  // MARK: Internal
+
+  /// The type-erased content instance of this model, else `nil` if there is no content.
+  var erasedContent: Any? {
+    get { self[contentProperty] }
+    set { self[contentProperty] = newValue }
+  }
+
+  /// A closure that can be called to determine whether the given `model`'s `erasedContent` is equal
+  /// to this model's `erasedContent`, else `nil` if there is no content or the content is always
+  /// equal.
+  var isErasedContentEqual: ((ErasedContentProviding) -> Bool)? {
+    get { self[isContentEqualProperty] }
+    set { self[isContentEqualProperty] = newValue }
+  }
+
+  // MARK: Private
+
+  private var contentProperty: EpoxyModelProperty<Any?> {
+    .init(keyPath: \ErasedContentProviding.erasedContent, defaultValue: nil, updateStrategy: .replace)
+  }
+
+  private var isContentEqualProperty: EpoxyModelProperty<((ErasedContentProviding) -> Bool)?> {
+    .init(keyPath: \ErasedContentProviding.isErasedContentEqual, defaultValue: nil, updateStrategy: .replace)
+  }
+}

package/platforms/macos/src/vendor/Lottie/Private/EmbeddedLibraries/EpoxyCore/Model/Providers/MakeViewProviding.swift

@@ -0,0 +1,61 @@
+// Created by eric_horacek on 12/1/20.
+// Copyright © 2020 Airbnb Inc. All rights reserved.
+
+// MARK: - MakeViewProviding
+
+/// The capability of constructing a `UIView`.
+protocol MakeViewProviding {
+  /// The view constructed when the `MakeView` closure is called.
+  associatedtype View: ViewType
+
+  /// A closure that's called to construct an instance of `View`.
+  typealias MakeView = () -> View
+
+  /// A closure that's called to construct an instance of `View`.
+  var makeView: MakeView { get }
+}
+
+// MARK: - ViewEpoxyModeled
+
+extension ViewEpoxyModeled where Self: MakeViewProviding {
+
+  // MARK: Internal
+
+  /// A closure that's called to construct an instance of `View` represented by this model.
+  var makeView: MakeView {
+    get { self[makeViewProperty] }
+    set { self[makeViewProperty] = newValue }
+  }
+
+  /// Replaces the default closure to construct the view with the given closure.
+  func makeView(_ value: @escaping MakeView) -> Self {
+    copy(updating: makeViewProperty, to: value)
+  }
+
+  // MARK: Private
+
+  private var makeViewProperty: EpoxyModelProperty<MakeView> {
+    // If you're getting a `EXC_BAD_INSTRUCTION` crash with this property in your stack trace, you
+    // probably either:
+    // - Conformed a view to `EpoxyableView` / `StyledView` with a custom initializer that
+    // takes parameters, or:
+    // - Used the `EpoxyModeled.init(dataID:)` initializer on a view has required initializer
+    //   parameters.
+    // If you have parameters to view initialization, they should either be passed to `init(style:)`
+    // or you should provide a `makeView` closure when constructing your view's corresponding model,
+    // e.g:
+    // ```
+    // MyView.itemModel(…)
+    //   .makeView { MyView(customParameter: …) }
+    //   .styleID(…)
+    // ```
+    // Note that with the above approach that you must supply an `styleID` with the same identity as
+    // your view parameters to ensure that views with different parameters are not reused in place
+    // of one another.
+    .init(
+      keyPath: \Self.makeView,
+      defaultValue: View.init,
+      updateStrategy: .replace
+    )
+  }
+}

package/platforms/macos/src/vendor/Lottie/Private/EmbeddedLibraries/EpoxyCore/Model/Providers/SetBehaviorsProviding.swift

@@ -0,0 +1,38 @@
+// Created by eric_horacek on 12/2/20.
+// Copyright © 2020 Airbnb Inc. All rights reserved.
+
+// MARK: - SetBehaviorsProviding
+
+/// A sentinel protocol for enabling an `CallbackContextEpoxyModeled` to provide a `setBehaviors`
+/// closure property.
+protocol SetBehaviorsProviding { }
+
+// MARK: - CallbackContextEpoxyModeled
+
+extension CallbackContextEpoxyModeled where Self: SetBehaviorsProviding {
+
+  // MARK: Internal
+
+  /// A closure that's called to set the content on this model's view with behaviors (e.g. tap handler
+  /// closures) whenever this model is updated.
+  typealias SetBehaviors = (CallbackContext) -> Void
+
+  /// A closure that's called to set the content on this model's view with behaviors (e.g. tap handler
+  /// closures) whenever this model is updated.
+  var setBehaviors: SetBehaviors? {
+    get { self[setBehaviorsProperty] }
+    set { self[setBehaviorsProperty] = newValue }
+  }
+
+  /// Returns a copy of this model with the set behaviors closure called after the current set
+  /// behaviors closure of this model, if there is one.
+  func setBehaviors(_ value: SetBehaviors?) -> Self {
+    copy(updating: setBehaviorsProperty, to: value)
+  }
+
+  // MARK: Private
+
+  private var setBehaviorsProperty: EpoxyModelProperty<SetBehaviors?> {
+    .init(keyPath: \Self.setBehaviors, defaultValue: nil, updateStrategy: .chain())
+  }
+}

package/platforms/macos/src/vendor/Lottie/Private/EmbeddedLibraries/EpoxyCore/Model/Providers/SetContentProviding.swift

@@ -0,0 +1,38 @@
+// Created by eric_horacek on 12/1/20.
+// Copyright © 2020 Airbnb Inc. All rights reserved.
+
+// MARK: - SetContentProviding
+
+/// A sentinel protocol for enabling an `CallbackContextEpoxyModeled` to provide a `setContent`
+/// closure property.
+protocol SetContentProviding { }
+
+// MARK: - CallbackContextEpoxyModeled
+
+extension CallbackContextEpoxyModeled where Self: SetContentProviding {
+
+  // MARK: Internal
+
+  /// A closure that's called to set the content on this model's view when it is first created and
+  /// subsequently when the content changes.
+  typealias SetContent = (CallbackContext) -> Void
+
+  /// A closure that's called to set the content on this model's view when it is first created and
+  /// subsequently when the content changes.
+  var setContent: SetContent? {
+    get { self[setContentProperty] }
+    set { self[setContentProperty] = newValue }
+  }
+
+  /// Returns a copy of this model with the given setContent view closure called after the current
+  /// setContent view closure of this model, if there is one.
+  func setContent(_ value: SetContent?) -> Self {
+    copy(updating: setContentProperty, to: value)
+  }
+
+  // MARK: Private
+
+  private var setContentProperty: EpoxyModelProperty<SetContent?> {
+    .init(keyPath: \Self.setContent, defaultValue: nil, updateStrategy: .chain())
+  }
+}

package/platforms/macos/src/vendor/Lottie/Private/EmbeddedLibraries/EpoxyCore/Model/Providers/StyleIDProviding.swift

@@ -0,0 +1,38 @@
+// Created by eric_horacek on 12/1/20.
+// Copyright © 2020 Airbnb Inc. All rights reserved.
+
+// MARK: - StyleIDProviding
+
+protocol StyleIDProviding {
+  /// An optional ID for a style type to use for reuse of a view.
+  ///
+  /// Use this to differentiate between different styling configurations.
+  var styleID: AnyHashable? { get }
+}
+
+// MARK: - EpoxyModeled
+
+extension EpoxyModeled where Self: StyleIDProviding {
+
+  // MARK: Internal
+
+  var styleID: AnyHashable? {
+    get { self[styleIDProperty] }
+    set { self[styleIDProperty] = newValue }
+  }
+
+  /// Returns a copy of this model with the `styleID` replaced with the provided `value`.
+  func styleID(_ value: AnyHashable?) -> Self {
+    copy(updating: styleIDProperty, to: value)
+  }
+
+  // MARK: Private
+
+  private var styleIDProperty: EpoxyModelProperty<AnyHashable?> {
+    .init(
+      keyPath: \StyleIDProviding.styleID,
+      defaultValue: nil,
+      updateStrategy: .replace
+    )
+  }
+}

package/platforms/macos/src/vendor/Lottie/Private/EmbeddedLibraries/EpoxyCore/Model/Providers/TraitCollectionProviding.swift

@@ -0,0 +1,14 @@
+// Created by eric_horacek on 12/16/20.
+// Copyright © 2020 Airbnb Inc. All rights reserved.
+
+#if !os(macOS)
+import UIKit
+
+/// The capability of providing a `UITraitCollection` instance.
+///
+/// Typically conformed to by the `CallbackContext` of a `CallbackContextEpoxyModeled`.
+protocol TraitCollectionProviding {
+  /// The `UITraitCollection` instance provided by this type.
+  var traitCollection: UITraitCollection { get }
+}
+#endif

package/platforms/macos/src/vendor/Lottie/Private/EmbeddedLibraries/EpoxyCore/Model/Providers/ViewDifferentiatorProviding.swift

@@ -0,0 +1,34 @@
+// Created by Bryan Keller on 12/17/20.
+// Copyright © 2020 Airbnb Inc. All rights reserved.
+
+// MARK: - ViewDifferentiatorProviding
+
+/// The capability of providing a view differentiator that facilitates generating collection view
+/// cell reuse identifiers.
+protocol ViewDifferentiatorProviding {
+  /// The view differentiator for the item model.
+  var viewDifferentiator: ViewDifferentiator { get }
+}
+
+// MARK: - ViewDifferentiator
+
+/// Facilitates differentiating between two models' views, based on their view type, optional style
+/// identifier, and optional element kind for supplementary view models. If two models have the same
+/// view differentiator, then they're compatible with one another for element reuse. If two models
+/// have different view differentiators, then they're incompatible with one another for element
+/// reuse.
+struct ViewDifferentiator: Hashable {
+
+  // MARK: Lifecycle
+
+  init(viewType: AnyClass, styleID: AnyHashable?) {
+    viewTypeDescription = "\(type(of: viewType.self))"
+    self.styleID = styleID
+  }
+
+  // MARK: Internal
+
+  var viewTypeDescription: String
+  var styleID: AnyHashable?
+
+}

package/platforms/macos/src/vendor/Lottie/Private/EmbeddedLibraries/EpoxyCore/Model/Providers/ViewProviding.swift

@@ -0,0 +1,13 @@
+// Created by eric_horacek on 12/16/20.
+// Copyright © 2020 Airbnb Inc. All rights reserved.
+
+/// The capability of providing an `View` instance
+///
+/// Typically conformed to by the `CallbackContext` of a `CallbackContextEpoxyModeled`.
+protocol ViewProviding {
+  /// The `UIView` view of this type.
+  associatedtype View: ViewType
+
+  /// The `UIView` view instance provided by this type.
+  var view: View { get }
+}

package/platforms/macos/src/vendor/Lottie/Private/EmbeddedLibraries/EpoxyCore/Model/Providers/WillDisplayProviding.swift

@@ -0,0 +1,41 @@
+// Created by eric_horacek on 12/15/20.
+// Copyright © 2020 Airbnb Inc. All rights reserved.
+
+// MARK: - WillDisplayProviding
+
+/// A sentinel protocol for enabling an `CallbackContextEpoxyModeled` to provide a `willDisplay`
+/// closure property.
+///
+/// - SeeAlso: `DidDisplayProviding`
+/// - SeeAlso: `DidEndDisplayingProviding`
+protocol WillDisplayProviding { }
+
+// MARK: - CallbackContextEpoxyModeled
+
+extension CallbackContextEpoxyModeled where Self: WillDisplayProviding {
+
+  // MARK: Internal
+
+  /// A closure that's called when a view is about to be displayed, before it has been added to the
+  /// view hierarchy.
+  typealias WillDisplay = (_ context: CallbackContext) -> Void
+
+  /// A closure that's called when the view is about to be displayed, before it has been added to
+  /// the view hierarchy.
+  var willDisplay: WillDisplay? {
+    get { self[willDisplayProperty] }
+    set { self[willDisplayProperty] = newValue }
+  }
+
+  /// Returns a copy of this model with the given will display closure called after the current will
+  /// display closure of this model, if there is one.
+  func willDisplay(_ value: WillDisplay?) -> Self {
+    copy(updating: willDisplayProperty, to: value)
+  }
+
+  // MARK: Private
+
+  private var willDisplayProperty: EpoxyModelProperty<WillDisplay?> {
+    .init(keyPath: \Self.willDisplay, defaultValue: nil, updateStrategy: .chain())
+  }
+}

package/platforms/macos/src/vendor/Lottie/Private/EmbeddedLibraries/EpoxyCore/Model/ViewEpoxyModeled.swift

@@ -0,0 +1,10 @@
+// Created by eric_horacek on 12/4/20.
+// Copyright © 2020 Airbnb Inc. All rights reserved.
+
+/// An Epoxy model with an associated `UIView` type.
+protocol ViewEpoxyModeled: EpoxyModeled {
+  /// The view type associated with this model.
+  ///
+  /// An instance of this view is typically configured by this model.
+  associatedtype View: ViewType
+}

package/platforms/macos/src/vendor/Lottie/Private/EmbeddedLibraries/EpoxyCore/README.md

@@ -0,0 +1,30 @@
+## EpoxyCore
+
+This directory includes the source code of the EpoxyCore library, from the following release:
+https://github.com/airbnb/epoxy-ios/releases/tag/0.11.0
+
+Lottie is distributed via multiple package managers (SPM, Cocoapods, Carthage, and NPM),
+each with different packaging and compilation requirements.
+
+Due to limitations of these package managers, we can't depend on / import
+a separate EpoxyCore module / library. Instead, we include the source
+directly within the Lottie library and compile everything as a single unit.
+
+### Update instructions
+
+From time to time we may need to update to a more recent version of EpoxyCore.
+When doing this, follow these steps:
+
+ 1. Download the latest release from https://github.com/airbnb/epoxy-ios
+    and replace the source code in this directory with the updated code.
+
+ 2. Update the URL at the top of this file to indicate what release is being used.
+
+ 3. Change all of the `public` symbols defined in this module to instead be `internal`
+    to prevent Lottie from exposing any EpoxyCore APIs.
+
+ 4. Namespace any types that conflict with other existing types.
+    For example, the EpoxyCore `Entry` type conflicts with the ZipFoundation `Entry` type,
+    so the EpoxyCore type has been renamed to `EpoxyEntry`.
+
+ 5. Delete `EpoxySwiftUIHostingController.swift` and `EpoxySwiftUIHostingView.swift`, which are not used by Lottie, and emit deprecation warnings when building for visionOS.