text: // Copyright 2017-present the Material Components for iOS authors. All Rights Reserved.
  //
  // Licensed under the Apache License, Version 2.0 (the "License");
  // you may not use this file except in compliance with the License.
  // You may obtain a copy of the License at
  //
  // http://www.apache.org/licenses/LICENSE-2.0
  //
  // Unless required by applicable law or agreed to in writing, software
  // distributed under the License is distributed on an "AS IS" BASIS,
  // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  // See the License for the specific language governing permissions and
  // limitations under the License.
  
  #import "MaterialAppBar.h"
  #import "MaterialColorScheme.h"
  
  /**
   The Material Design color system's themer for instances of MDCAppBar.
  
   @warning This API will eventually be deprecated. Learn more at
   docs/theming.md#migration-guide-themers-to-theming-extensions
   */
  @interface MDCAppBarColorThemer : NSObject
  
  /**
   Applies a color scheme's properties to an MDCAppBarViewController instance using the primary
   mapping.
  
   Uses the primary color as the most important color for the component.
  
   @param colorScheme The color scheme to apply to the component instance.
   @param appBarViewController A component instance to which the color scheme should be applied.
  
   @warning This API will eventually be deprecated. The replacement API is:
   `MDCAppBarViewController`'s `-applyPrimaryThemeWithScheme:`
   Learn more at docs/theming.md#migration-guide-themers-to-theming-extensions
   */
  + (void)applyColorScheme:(nonnull id<MDCColorScheming>)colorScheme
      toAppBarViewController:(nonnull MDCAppBarViewController *)appBarViewController;
  
  /**
   Applies a color scheme's properties to an MDCAppBar using the primary mapping.
  
   Uses the primary color as the most important color for the component.
  
   @param colorScheme The color scheme to apply to the component instance.
   @param appBar A component instance to which the color scheme should be applied.
  
   @warning This API will eventually be deprecated. The replacement API is:
   `MDCAppBarViewController`'s `-applyPrimaryThemeWithScheme:`
   Learn more at docs/theming.md#migration-guide-themers-to-theming-extensions
   */
  + (void)applySemanticColorScheme:(nonnull id<MDCColorScheming>)colorScheme
                          toAppBar:(nonnull MDCAppBar *)appBar;
  
  @end
  
  @interface MDCAppBarColorThemer (Deprecated)
  
  /**
   Applies a color scheme's properties to an MDCAppBar.
  
   @param colorScheme The color scheme to apply to the component instance.
   @param appBar A component instance to which the color scheme should be applied.
  
   @warning This API will eventually be deprecated. The replacement API is:
   `MDCAppBarViewController`'s `-applyPrimaryThemeWithScheme:`
   Learn more at docs/theming.md#migration-guide-themers-to-theming-extensions
   */
  + (void)applyColorScheme:(nonnull id<MDCColorScheme>)colorScheme
                  toAppBar:(nonnull MDCAppBar *)appBar
      __deprecated_msg("Use MDCAppBarViewController's applyPrimaryThemeWithScheme");
  
  /**
   Applies a color scheme's properties to an MDCAppBar using the surface mapping.
  
   Uses the surface color as the most important color for the component.
  
   @param colorScheme The color scheme to apply to the component instance.
   @param appBar A component instance to which the color scheme should be applied.
  
   @warning This API will eventually be deprecated. The replacement API is:
   `MDCAppBarViewController`'s `-applySurfaceThemeWithScheme:`
   Learn more at docs/theming.md#migration-guide-themers-to-theming-extensions
   */
  + (void)applySurfaceVariantWithColorScheme:(nonnull id<MDCColorScheming>)colorScheme
                                    toAppBar:(nonnull MDCAppBar *)appBar
      __deprecated_msg("Use MDCAppBarViewController's applySurfaceThemeWithScheme");
  
  /**
   Applies a color scheme's properties to an MDCAppBarViewController instance using the surface
   mapping.
  
   Uses the surface color as the most important color for the component.
  
   @param colorScheme The color scheme to apply to the component instance.
   @param appBarViewController A component instance to which the color scheme should be applied.
  
   @warning This API will eventually be deprecated. The replacement API is:
   `MDCAppBarViewController`'s `-applySurfaceThemeWithScheme:`
   Learn more at docs/theming.md#migration-guide-themers-to-theming-extensions
   */
  + (void)applySurfaceVariantWithColorScheme:(nonnull id<MDCColorScheming>)colorScheme
                      toAppBarViewController:(nonnull MDCAppBarViewController *)appBarViewController
      __deprecated_msg("Use MDCAppBarViewController's applySurfaceThemeWithScheme");
  
  @end
  