Merge branch 'release-candidate'

Author: Jeff Verkoeyen

.arcconfig

@@ -1,8 +1,8 @@
 {
   "load": [
     "scripts/external/clang-format-linter",
-    "scripts/external/arc-xcode-test-engine"
-
+    "scripts/external/arc-xcode-test-engine",
+    "scripts/external/arc-proselint"
   ],
   "phabricator.uri" : "http://codereview.cc/",
   "repository.callsign" : "MDC",
@@ -17,6 +17,7 @@
     },
     "coverage": {
       "product": "MaterialComponents.framework/MaterialComponents"
-    }
+    },
+    "pre-build": "pod install --project-directory=catalog/ --no-repo-update"
   }
 }

.arclint

@@ -18,6 +18,16 @@
       "type": "chmod",
       "exclude": "(/Pods/)"
     },
+    "prose": {
+      "type": "prose",
+      "include": "(\\.(md)$)",
+      "exclude": "(/Pods/)",
+      "severity": {
+        "typography.symbols.curly_quotes": "disabled",
+        "typography.symbols.ellipsis": "disabled",
+        "leonard.exclamation.30ppm": "disabled"
+      }
+    },
     "spelling": {
       "type": "spelling",
       "include": "(\\.(m|h|mm|md)$)",

.gitmodules

@@ -4,3 +4,6 @@
 [submodule "scripts/external/clang-format-linter"]
 	path = scripts/external/clang-format-linter
 	url = git@github.com:vhbit/clang-format-linter.git
+[submodule "scripts/external/arc-proselint"]
+	path = scripts/external/arc-proselint
+	url = git@github.com:google/arc-proselint.git

CHANGELOG.md

@@ -1,4 +1,4 @@
-Want to contribute? Great! First, read this page (including the small print at the end).
+Want to contribute? Great! First, read this page (including the [small print](#the-small-print)).
 
 ## Pull requests
 

CONTRIBUTING.md

@@ -2,7 +2,7 @@ load 'scripts/generated/icons.rb'
 
 Pod::Spec.new do |s|
   s.name         = "MaterialComponents"
-  s.version      = "3.0.0"
+  s.version      = "3.1.0"
   s.authors      = { 'Apple platform engineering at Google' => 'appleplatforms@google.com' }
   s.summary      = "A collection of stand-alone production-ready UI libraries focused on design details."
   s.homepage     = "https://github.com/google/material-components-ios"
@@ -130,7 +130,7 @@ Pod::Spec.new do |s|
     }
 
     ss.dependency "MaterialComponents/FontDiskLoader"
-    # TODO: Make MDCRobotoFontLoader conform to the <MDCTypographyFontLoading>. This was intended to be a
+    # TODO: https://github.com/google/material-components-ios/issues/74 This was intended to be a
     # strong dependancy but is weak during the deprecation period.
     # ss.dependency "MaterialComponents/Typography"
   end

MaterialComponents.podspec

@@ -1,14 +1,14 @@
 Pod::Spec.new do |s|
   s.name         = "MaterialComponentsCatalog"
-  s.version      = "3.0.0"
+  s.version      = "3.1.0"
   s.authors      = { 'Apple platform engineering at Google' => 'appleplatforms@google.com' }
   s.summary      = "A collection of stand-alone production-ready UI libraries focused on design details."
   s.homepage     = "https://github.com/google/material-components-ios"
   s.license      = 'Apache 2.0'
   s.source       = { :git => "https://github.com/google/material-components-ios.git", :tag => s.version.to_s }
   s.platform     = :ios, '7.0'
   s.requires_arc = true
-  s.source_files = 'components/*/examples/*.{h,m,swift}'
+  s.source_files = 'components/*/examples/*.{h,m,swift}', 'components/*/examples/supplemental/*.{h,m,swift}'
   s.resources = ['components/*/examples/resources/*']
   s.dependency 'MaterialComponents'
 end

MaterialComponentsCatalog.podspec

@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name         = "MaterialComponentsUnitTests"
-  s.version      = "3.0.0"
+  s.version      = "3.1.0"
   s.authors      = { 'Apple platform engineering at Google' => 'appleplatforms@google.com' }
   s.summary      = "A collection of stand-alone production-ready UI libraries focused on design details."
   s.homepage     = "https://github.com/google/material-components-ios"

MaterialComponentsUnitTests.podspec

@@ -0,0 +1,36 @@
+/*
+ Copyright 2016-present Google Inc. 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.
+ */
+
+/**
+ The CBCCatalogExample protocol defines the static methods that classes can implement in order to
+ customize their location and behavior in the Catalog by Convention.
+
+ Examples should not formally conform to this protocol. Examples should simply implement these
+ methods.
+ */
+@protocol CBCCatalogExample <NSObject>
+
+/** Return a list of breadcrumbs defining the navigation path taken to reach this example. */
++ (NSArray<NSString *> *)catalogBreadcrumbs;
+
+@optional
+
+/**
+ Return the name of a UIStoryboard from which the example's view controller should be instantiated.
+ */
+- (NSString *)catalogStoryboardName;
+
+@end

catalog/CatalogByConvention/src/CBCCatalogExample.h

@@ -0,0 +1,69 @@
+/*
+ Copyright 2016-present Google Inc. 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>
+
+@class CBCNode;
+
+/**
+ An instance of CBCNodeListViewController is able to represent a non-example CBCNode instance as a
+ UITableView.
+ */
+@interface CBCNodeListViewController : UITableViewController
+
+/** Initializes a CBCNodeViewController instance with a non-example node. */
+- (nonnull instancetype)initWithNode:(nonnull CBCNode *)node;
+
+/** The node that this view controller must represent. */
+@property(nonatomic, strong, nonnull, readonly) CBCNode *node;
+
+@end
+
+/**
+ Returns the root of a CBCNode tree representing the complete catalog navigation hierarchy.
+
+ Only classes that implement +catalogBreadcrumbs and return at least one breadcrumb will be part of
+ the tree.
+ */
+FOUNDATION_EXTERN CBCNode *__nonnull CBCCreateNavigationTree(void);
+
+/**
+ A node describes a single navigable page in the Catalog by Convention.
+
+ A node either has children or it is an example.
+
+ - If a node has children, then the node should be represented by a list of some sort.
+ - If a node is an example, then the example controller can be instantiated with
+   createExampleViewController.
+ */
+@interface CBCNode : NSObject
+
+/** Nodes cannot be created by clients. */
+- (nullable instancetype)init NS_UNAVAILABLE;
+
+/** The title for this node. */
+@property(nonatomic, copy, nonnull, readonly) NSString *title;
+
+/** The children of this node. */
+@property(nonatomic, strong, nonnull, readonly) NSArray<CBCNode *> *children;
+
+/** Returns YES if this is an example node. */
+- (BOOL)isExample;
+
+/** Returns an instance of a UIViewController for presentation purposes. */
+- (nonnull UIViewController *)createExampleViewController;
+
+@end