Merge branch 'release-candidate' into stable

Author: Jeff Verkoeyen

.arcconfig

@@ -13,13 +13,13 @@
   "arc.feature.start.default": "origin/develop",
   "unit.xcode": {
     "build": {
-      "workspace": "MaterialMotionAnimator.xcworkspace",
+      "workspace": "MotionAnimator.xcworkspace",
       "scheme": "UnitTests",
       "configuration": "Debug",
       "destination": "platform=iOS Simulator,name=iPhone 6s"
     },
     "coverage": {
-      "product": "MaterialMotionAnimator.framework/MaterialMotionAnimator"
+      "product": "MotionAnimator.framework/MotionAnimator"
     },
     "pre-build": "pod install"
   }

.travis.yml

@@ -10,6 +10,6 @@ before_install:
 script:
   - set -o pipefail
   - arcanist/bin/arc unit --everything --trace
-  - xcodebuild build -workspace MaterialMotionAnimator.xcworkspace -scheme Catalog -sdk "iphonesimulator10.1" -destination "name=iPhone 6s,OS=10.1" ONLY_ACTIVE_ARCH=YES | xcpretty -c;
+  - xcodebuild build -workspace MotionAnimator.xcworkspace -scheme MotionAnimatorCatalog -sdk "iphonesimulator10.1" -destination "name=iPhone 6s,OS=10.1" ONLY_ACTIVE_ARCH=YES | xcpretty -c;
 after_success:
   - bash <(curl -s https://codecov.io/bash)

CHANGELOG.md

@@ -0,0 +1,19 @@
+# 1.0.0
+
+Initial release.
+
+Includes MDMMotionAnimator and a small set of pre-defined animatable key paths.
+
+## Source changes
+
+* [Add support for iOS 8.](https://github.com/material-motion/motion-animator-objc/commit/f83c8ff02a1b99649396e50c11f2dc1ef4dd408f) (Jeff Verkoeyen)
+* [Initial commit of MotionAnimator code. (#1)](https://github.com/material-motion/motion-animator-objc/commit/4f816553c409357ead3f9eb27a92066152591664) (featherless)
+* [Initial preparation for project.](https://github.com/material-motion/motion-animator-objc/commit/28666dbb46aaebf08e9b284fce7cba280a0736ff) (Jeff Verkoeyen)
+
+## Non-source changes
+
+* [Remove superlatives.](https://github.com/material-motion/motion-animator-objc/commit/5f3367654622c262f4b474be7e1e760814bbff08) (Jeff Verkoeyen)
+* [Add more delay to the chip animation.](https://github.com/material-motion/motion-animator-objc/commit/e1af31a0f72b7489431804ccac0eaa5101ef33b0) (Jeff Verkoeyen)
+* [Update docs.](https://github.com/material-motion/motion-animator-objc/commit/625ffe117d198421bffcf24a0f56c40203d0f614) (Jeff Verkoeyen)
+
+

MaterialMotionAnimator.podspec

@@ -0,0 +1,16 @@
+Pod::Spec.new do |s|
+  s.name         = "MotionAnimator"
+  s.summary      = "A Motion Animator creates performant, interruptible animations from motion specs."
+  s.version      = "1.0.0"
+  s.authors      = "The Material Motion Authors"
+  s.license      = "Apache 2.0"
+  s.homepage     = "https://github.com/material-motion/motion-animator-objc"
+  s.source       = { :git => "https://github.com/material-motion/motion-animator-objc.git", :tag => "v" + s.version.to_s }
+  s.platform     = :ios, "8.0"
+  s.requires_arc = true
+
+  s.public_header_files = "src/*.h"
+  s.source_files = "src/*.{h,m,mm}", "src/private/*.{h,m,mm}"
+
+  s.dependency "MotionInterchange"
+end

MotionAnimator.podspec

@@ -1,15 +1,15 @@
-workspace 'MaterialMotionAnimator.xcworkspace'
+workspace 'MotionAnimator.xcworkspace'
 use_frameworks!
 
-target "Catalog" do
+target "MotionAnimatorCatalog" do
   pod 'CatalogByConvention'
-  pod 'MaterialMotionAnimator/examples', :path => './'
-  project 'examples/apps/Catalog/Catalog.xcodeproj'
+  pod 'MotionAnimator', :path => './'
+  project 'examples/apps/Catalog/MotionAnimatorCatalog.xcodeproj'
 end
 
 target "UnitTests" do
-  project 'examples/apps/Catalog/Catalog.xcodeproj'
-  pod 'MaterialMotionAnimator/tests', :path => './'
+  project 'examples/apps/Catalog/MotionAnimatorCatalog.xcodeproj'
+  pod 'MotionAnimator', :path => './'
 end
 
 post_install do |installer|

Podfile

@@ -0,0 +1,22 @@
+PODS:
+  - CatalogByConvention (2.1.1)
+  - MotionAnimator (1.0.0):
+    - MotionInterchange
+  - MotionInterchange (1.0.1)
+
+DEPENDENCIES:
+  - CatalogByConvention
+  - MotionAnimator (from `./`)
+
+EXTERNAL SOURCES:
+  MotionAnimator:
+    :path: "./"
+
+SPEC CHECKSUMS:
+  CatalogByConvention: c3a5319de04250a7cd4649127fcfca5fe3322a43
+  MotionAnimator: 554b22116cbbcae6bf90fdad0042a87604225d0e
+  MotionInterchange: 7a7c355ba2ed5d36c5cf2ceb76cacd3d3680dbf5
+
+PODFILE CHECKSUM: 634239e7b183e669593b273198da9227ed207777
+
+COCOAPODS: 1.2.1

Podfile.lock

@@ -1,10 +1,59 @@
 # Motion Animator
 
-[![Build Status](https://travis-ci.org/material-motion/motionanimator-objc.svg?branch=develop)](https://travis-ci.org/material-motion/motionanimator-objc)
-[![codecov](https://codecov.io/gh/material-motion/motionanimator-objc/branch/develop/graph/badge.svg)](https://codecov.io/gh/material-motion/motionanimator-objc)
-[![CocoaPods Compatible](https://img.shields.io/cocoapods/v/MaterialMotionAnimator.svg)](https://cocoapods.org/pods/MaterialMotionAnimator)
-[![Platform](https://img.shields.io/cocoapods/p/MaterialMotionAnimator.svg)](http://cocoadocs.org/docsets/MaterialMotionAnimator)
-[![Docs](https://img.shields.io/cocoapods/metrics/doc-percent/MaterialMotionAnimator.svg)](http://cocoadocs.org/docsets/MaterialMotionAnimator)
+> A Motion Animator creates performant, interruptible animations from motion specs.
+
+[![Build Status](https://travis-ci.org/material-motion/motion-animator-objc.svg?branch=develop)](https://travis-ci.org/material-motion/motion-animator-objc)
+[![codecov](https://codecov.io/gh/material-motion/motion-animator-objc/branch/develop/graph/badge.svg)](https://codecov.io/gh/material-motion/motion-animator-objc)
+[![CocoaPods Compatible](https://img.shields.io/cocoapods/v/MotionAnimator.svg)](https://cocoapods.org/pods/MotionAnimator)
+[![Platform](https://img.shields.io/cocoapods/p/MotionAnimator.svg)](http://cocoadocs.org/docsets/MotionAnimator)
+[![Docs](https://img.shields.io/cocoapods/metrics/doc-percent/MotionAnimator.svg)](http://cocoadocs.org/docsets/MotionAnimator)
+
+This library turns [Motion Interchange](https://github.com/material-motion/motion-interchange-objc)
+data structures into performant Core Animation animations using a lightweight animator object.
+
+<img src="assets/chip.gif" />
+
+In the above example we're animating the expansion and collapse of a calendar event using the
+following motion specification:
+
+```objc
+struct CalendarChipTiming {
+  MDMMotionTiming chipWidth;
+  MDMMotionTiming chipHeight;
+  MDMMotionTiming chipY;
+
+  MDMMotionTiming chipContentOpacity;
+  MDMMotionTiming headerContentOpacity;
+
+  MDMMotionTiming navigationBarY;
+};
+typedef struct CalendarChipTiming CalendarChipTiming;
+
+struct CalendarChipMotionSpec {
+  CalendarChipTiming expansion;
+  CalendarChipTiming collapse;
+};
+typedef struct CalendarChipMotionSpec CalendarChipMotionSpec;
+
+FOUNDATION_EXTERN struct CalendarChipMotionSpec CalendarChipSpec;
+```
+
+In our application logic, we first determine which motion timing to use and then we create an
+instance of `MDMMotionAnimator`. The animator allows us to create animations with the given
+motion timing.
+
+```objc
+CalendarChipTiming timing = _expanded ? CalendarChipSpec.expansion : CalendarChipSpec.collapse;
+
+MDMMotionAnimator *animator = [[MDMMotionAnimator alloc] init];
+animator.shouldReverseValues = !_expanded;
+
+[animator animateWithTiming:timing.chipHeight
+                    toLayer:chipView.layer
+                 withValues:@[ @(chipFrame.size.height), @(headerFrame.size.height) ]
+                    keyPath:MDMKeyPathHeight];
+...
+```
 
 ## Installation
 
@@ -17,9 +66,9 @@
 >
 >     gem install cocoapods
 
-Add `MaterialMotionAnimator` to your `Podfile`:
+Add `motion-animator` to your `Podfile`:
 
-    pod 'MaterialMotionAnimator'
+    pod 'MotionAnimator'
 
 Then run the following command:
 
@@ -29,7 +78,7 @@ Then run the following command:
 
 Import the framework:
 
-    @import MaterialMotionAnimator;
+    @import MotionAnimator;
 
 You will now have access to all of the APIs.
 
@@ -38,25 +87,65 @@ You will now have access to all of the APIs.
 Check out a local copy of the repo to access the Catalog application by running the following
 commands:
 
-    git clone https://github.com/material-motion/motionanimator-objc.git
-    cd motionanimator-objc
+    git clone https://github.com/material-motion/motion-animator-objc.git
+    cd motion-animator-objc
     pod install
-    open MaterialMotionAnimator.xcworkspace
+    open MotionAnimator.xcworkspace
 
 ## Guides
 
 1. [Architecture](#architecture)
-2. [How to ...](#how-to-...)
+2. [How to animate a transition](#how-to-animate-a-transition)
+3. [How to animate an interruptible transition](#how-to-animate-an-interruptible-transition)
 
 ### Architecture
 
-### How to ...
+`MDMMotionAnimator` is the primary API provided by this library. You can configure the animations
+that an animator creates by modifying its configuration properties. When you're ready to add an
+animation to a CALayer instance, call one of the `animate` method variants and an animation will
+be added to the layer.
+
+This library depends on [MotionInterchange](https://github.com/material-motion/motion-interchange-objc)
+in order to represent motion timing in a consistent fashion.
+
+### How to animate a transition
+
+> This guide assumes that you are animating a two state bi-directional transition.
+
+Start by creating an `MDMMotionAnimator` instance.
+
+```objc
+MDMMotionAnimator *animator = [[MDMMotionAnimator alloc] init];
+```
+
+When we describe our transition we'll describe it as though we're moving forward and take advantage
+of the `shouldReverseValues` property on our animator to handle the reverse direction.
+
+```objc
+animator.shouldReverseValues = isTransitionReversed;
+```
+
+To animate a property on a view, we invoke the `animate` method. We must provide a timing, values,
+and a key path:
+
+```objc
+[animator animateWithTiming:timing
+                    toLayer:view.layer
+                 withValues:@[ @(collapsedHeight), @(expandedHeight) ]
+                    keyPath:MDMKeyPathHeight];
+```
+
+### How to animate an interruptible transition
+
+`MDMMotionAnimator` is configured by default to generate interruptible animations using Core
+Animation's additive animation APIs. You can simply re-execute the `animate` calls when your
+transition's direction changes and the animator will add new animations for the updated direction.
 
 ## Contributing
 
 We welcome contributions!
 
-Check out our [upcoming milestones](https://github.com/material-motion/motionanimator-objc/milestones).
+Check out our [upcoming milestones](https://github.com/material-motion/motion-animator-objc/milestones).
 
 Learn more about [our team](https://material-motion.github.io/material-motion/team/),
 [our community](https://material-motion.github.io/material-motion/team/community/), and

README.md

@@ -0,0 +1,20 @@
+/*
+ Copyright 2017-present The Material Motion 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 <UIKit/UIKit.h>
+
+@interface CalendarCardExpansionExampleViewController : UIViewController
+@end