Decoupling Material and Cupertino (with dart fixes)

packages/cupertino_ui/analysis_options.yaml

@@ -0,0 +1,4 @@
+include: ../../analysis_options.yaml
+
+formatter:
+  page_width: 100

packages/cupertino_ui/example/.gitignore

@@ -0,0 +1,3 @@
+# Unused platform specific files
+android/
+ios/

packages/cupertino_ui/example/.metadata

@@ -0,0 +1,10 @@
+# This file tracks properties of this Flutter project.
+# Used by Flutter tool to assess capabilities and perform upgrades etc.
+#
+# This file should be version controlled and should not be manually edited.
+
+version:
+  revision: "89172fc6152056af222e0afcf6e2d6ee4e9f6f8f"
+  channel: "master"
+
+project_type: package

packages/cupertino_ui/example/README.md

@@ -0,0 +1,166 @@
+# cupertino_ui API Example Code
+This directory contains the example code that is referenced in the documentation
+in cupertino_ui's source code.
+
+These examples were originally located [in
+flutter/flutter](https://github.com/flutter/flutter/tree/master/examples/api)
+before the Cupertino library was decoupled and moved into its current home in
+flutter/packages.
+
+The examples can be run individually by just specifying the path to the example
+on the command line (or in the run configuration of an IDE).
+
+For example (no pun intended!), to run the first example from the
+`CupertinoActivityIndicator` class in Chrome, you would run it like so from the
+[api](.)
+directory:
+
+```
+% flutter run -d chrome lib/activity_indicator/cupertino_activity_indicator.0.dart
+```
+
+All of these same examples are available on the API docs site.
+
+<!-- TODO(justinmc): Include a link to the docs page with the example above like this: For instance, the example above is available on [this page](https://api.flutter.dev/flutter/animation/Curve2D-class.html#animation.Curve2D.1).
+-->
+
+<!-- TODO(justinmc): Uncomment when Dartpads work again.
+Most of the samples are available as interactive examples in
+[Dartpad](https://dartpad.dev), but some (the ones marked with `{@tool sample}`
+in the framework source code), just don't make sense on the web, and so are
+available as standalone examples that can be run here. For instance, setting the
+system overlay style doesn't make sense on the web (it only changes the
+notification area background color on Android), so you can run the example for
+that on an Android device like so:
+
+```
+% flutter run -d MyAndroidDevice lib/services/system_chrome/system_chrome.set_system_u_i_overlay_style.1.dart
+```
+-->
+
+## Naming
+
+> `lib/file/class_name.n.dart`
+>
+> `lib/file/class_name.member_name.n.dart`
+
+The naming scheme corresponds to the files under [lib/src](../lib/src) where
+each file is represented as a directory (without the `.dart` suffix), and each
+sample in the file is a separate file in that directory. So, for the example
+above, where the examples are from the
+[lib/src/activity_indicator.dart](../lib/src/activity_indicator.dart) file, the
+`CupertinoActivityIndicator` class, the first sample (hence the index "0") for
+that symbol resides in the file named
+[lib/activity_indicator/cupertino_activity_indicator.0.dart](lib/activity_indicator/cupertino_activity_indicator.0.dart).
+
+Symbol names are converted from "CamelCase" to "snake_case". Dots are left
+between symbol names, so the first example for symbol
+`InputDecoration.prefixIconConstraints` would be converted to
+`input_decoration.prefix_icon_constraints.0.dart`.
+
+If the same example is linked to from multiple symbols, the source will be in
+the canonical location for one of the symbols, and the link in the API docs
+block for the other symbols will point to the first symbol's example location.
+
+## Authoring
+
+> For more detailed information about authoring examples, see
+> [the snippets package](https://pub.dev/packages/snippets).
+
+When authoring examples, first place a block in the Dartdoc documentation for
+the symbol you would like to attach it to. Here's what it might look like if you
+wanted to add a new example to the `CupertinoActivityIndicator` class:
+
+```dart
+/// {@tool dartpad}
+/// Write a description of the example here. This description will appear in the
+/// API web documentation to introduce the example.
+///
+/// ** See code in cupertino_ui_examples/lib/activity_indicator/cupertino_activity_indicator.0.dart **
+/// {@end-tool}
+```
+
+The "See code in" line needs to be formatted exactly as above, with no wrapping
+or newlines, one space after the "`**`" at the beginning, and one space before
+the "`**`" at the end, and the words "See code in" at the beginning of the line.
+This is what the snippets tool use when finding the example source code that you
+are creating.
+
+<!-- TODO(justinmc): Uncomment when Dartpad works again.
+Use `{@tool dartpad}` for Dartpad examples, and use `{@tool sample}` for
+examples that shouldn't be run/shown in Dartpad.
+
+Once that comment block is inserted in the source code, create a new file at the
+appropriate path under [`examples/api`](.). See the
+[sample_templates](./lib/sample_templates/) directory for examples of different
+types of samples with some best practices applied.
+
+The filename should match the location of the source file it is linked from, and
+is named for the symbol it is attached to, in lower_snake_case, with an index
+relating to their order within the doc comment. So, for the `Curve2D` example
+above, since it's in the `animation` library, in a file called `curves.dart`,
+and it's the first example, it should have the name
+`examples/api/lib/animation/curves/curve2_d.0.dart`.
+-->
+
+You should also add tests for your sample code under
+[`cupertino_ui_examples/test`](./test), that matches their location under [lib](./lib),
+ending in `_test.dart`. See the section on [writing tests](#writing-tests) for
+more information on what kinds of tests to write.
+
+The entire example should be in a single file, so that Dartpad can load it.
+
+Only packages that can be loaded by Dartpad may be imported. If you use one that
+hasn't been used in an example before, you may have to add it to the
+[pubspec.yaml](pubspec.yaml) in the [cupertino_ui_examples](./) directory.
+
+## Snippets
+
+There is another type of example that can also be authored, using `{@tool
+snippet}`. Snippet examples are just written inline in the source, like so:
+
+```dart
+/// {@tool dartpad}
+/// Write a description of the example here. This description will appear in the
+/// API web documentation to introduce the example.
+///
+/// ```dart
+/// // Sample code goes here, e.g.:
+/// const Widget emptyBox = SizedBox();
+/// ```
+/// {@end-tool}
+```
+
+The source for these snippets isn't stored under the [`cupertino_ui_examples`](.)
+directory, or available in Dartpad in the API docs, since they're not intended
+to be runnable, they just show some incomplete snippet of example code. It must
+compile (in the context of the sample analyzer), but doesn't need to do
+anything. See [the snippets documentation](
+https://pub.dev/packages/snippets#snippet-tool) for more information about the
+context that the analyzer uses.
+
+## Writing Tests
+
+Examples are required to have tests. There is already a "smoke test" that simply
+builds and runs all the API examples, just to make sure that they start up
+without crashing. Functionality tests are required the examples, and generally
+just do what is normally done for writing tests. The one thing that makes it
+more challenging to do for examples is that they can't really be written for
+testability in any obvious way, since that would complicate the examples and
+make them harder to explain.
+
+As an example, in regular framework code, you might include a parameter for a
+`Platform` object that can be overridden by a test to supply a dummy platform,
+but in the example. This would be unnecessarily complex for the example. In all
+other ways, these are just normal tests. You don't need to re-test the
+functionality of the widget being used in the example, but you should test the
+functionality and integrity of the example itself.
+
+Tests go into a directory under [test](./test) that matches their location under
+[lib](./lib). They are named the same as the example they are testing, with
+`_test.dart` at the end, like other tests. For instance, an
+`CupertinoActivityIndicator` example that resides in
+[`lib/activity_indicator/cupertino_activity_indicator.0.dart`]( ./lib/activity_indicator/cupertino_activity_indicator.0.dart) would
+have its tests in a file named
+[`test/activity_indicator/cupertino_activity_indicator.0_test.dart`](
+./test/activity_indicator/cupertino_activity_indicator.0_test.dart)

packages/cupertino_ui/example/analysis_options.yaml

@@ -0,0 +1,12 @@
+# This file is also used by dev/bots/analyze_snippet_code.dart to analyze code snippets (`{@tool snippet}` sections).
+
+# The following line activates a set of recommended lints for Flutter apps,
+# packages, and plugins designed to encourage good coding practices.
+include: package:flutter_lints/flutter.yaml
+
+linter:
+  rules:
+    # Samples want to print things pretty often.
+    avoid_print: false
+    # Samples are sometimes incomplete and don't show usage of everything.
+    unreachable_from_main: false

packages/cupertino_ui/example/lib/activity_indicator/cupertino_activity_indicator.0.dart

@@ -0,0 +1,75 @@
+// Copyright 2014 The Flutter Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+import 'package:cupertino_ui/cupertino_ui.dart';
+
+/// Flutter code sample for [CupertinoActivityIndicator].
+
+void main() => runApp(const CupertinoIndicatorApp());
+
+class CupertinoIndicatorApp extends StatelessWidget {
+  const CupertinoIndicatorApp({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    return const CupertinoApp(
+      theme: CupertinoThemeData(brightness: .light),
+      home: CupertinoIndicatorExample(),
+    );
+  }
+}
+
+class CupertinoIndicatorExample extends StatelessWidget {
+  const CupertinoIndicatorExample({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    return const CupertinoPageScaffold(
+      navigationBar: CupertinoNavigationBar(
+        middle: Text('CupertinoActivityIndicator Sample'),
+      ),
+      child: Center(
+        child: Column(
+          mainAxisAlignment: .spaceEvenly,
+          children: <Widget>[
+            Column(
+              mainAxisAlignment: .center,
+              children: <Widget>[
+                // Cupertino activity indicator with default properties.
+                CupertinoActivityIndicator(),
+                SizedBox(height: 10),
+                Text('Default'),
+              ],
+            ),
+            Column(
+              mainAxisAlignment: .center,
+              children: <Widget>[
+                // Cupertino activity indicator with custom radius and color.
+                CupertinoActivityIndicator(
+                  radius: 20.0,
+                  color: CupertinoColors.activeBlue,
+                ),
+                SizedBox(height: 10),
+                Text(
+                  'radius: 20.0\ncolor: CupertinoColors.activeBlue',
+                  textAlign: .center,
+                ),
+              ],
+            ),
+            Column(
+              mainAxisAlignment: .center,
+              children: <Widget>[
+                // Cupertino activity indicator with custom radius and disabled
+                // animation.
+                CupertinoActivityIndicator(radius: 20.0, animating: false),
+                SizedBox(height: 10),
+                Text('radius: 20.0\nanimating: false', textAlign: .center),
+              ],
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+}

packages/cupertino_ui/example/lib/activity_indicator/cupertino_linear_activity_indicator.0.dart

@@ -0,0 +1,77 @@
+// Copyright 2014 The Flutter Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+import 'package:cupertino_ui/cupertino_ui.dart';
+
+/// Flutter code sample for [CupertinoLinearActivityIndicator].
+
+void main() => runApp(const CupertinoLinearActivityIndicatorApp());
+
+class CupertinoLinearActivityIndicatorApp extends StatelessWidget {
+  const CupertinoLinearActivityIndicatorApp({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    return const CupertinoApp(
+      theme: CupertinoThemeData(brightness: .light),
+      home: CupertinoIndicatorExample(),
+    );
+  }
+}
+
+class CupertinoIndicatorExample extends StatelessWidget {
+  const CupertinoIndicatorExample({super.key});
+
+  @override
+  Widget build(BuildContext context) {
+    return const CupertinoPageScaffold(
+      navigationBar: CupertinoNavigationBar(
+        middle: Text('CupertinoLinearActivityIndicator Sample'),
+      ),
+      child: Padding(
+        padding: .all(8.0),
+        child: Column(
+          mainAxisAlignment: .spaceEvenly,
+          children: <Widget>[
+            Column(
+              mainAxisAlignment: .center,
+              children: <Widget>[
+                CupertinoLinearActivityIndicator(progress: 0),
+                SizedBox(height: 10),
+                Text('Progress: 0'),
+              ],
+            ),
+            Column(
+              mainAxisAlignment: .center,
+              children: <Widget>[
+                CupertinoLinearActivityIndicator(progress: 0.2),
+                SizedBox(height: 10),
+                Text('Progress: 0.2', textAlign: .center),
+              ],
+            ),
+            Column(
+              mainAxisAlignment: .center,
+              children: <Widget>[
+                CupertinoLinearActivityIndicator(progress: 0.4, height: 10),
+                SizedBox(height: 10),
+                Text('Height: 10', textAlign: .center),
+              ],
+            ),
+            Column(
+              mainAxisAlignment: .center,
+              children: <Widget>[
+                CupertinoLinearActivityIndicator(
+                  progress: 0.6,
+                  color: CupertinoColors.activeGreen,
+                ),
+                SizedBox(height: 10),
+                Text('Color: green', textAlign: .center),
+              ],
+            ),
+          ],
+        ),
+      ),
+    );
+  }
+}