Add a 'sourced from mdn docs' line to the MDN sourced dartdoc (#198)

* add a 'docs from mdn' line to the interface type docs

* re-generate package files

* update the changelog; link to specific types

* review feedback

Author: devoncarew

CHANGELOG.md

@@ -4,6 +4,8 @@
   allowed to contain those fields.
 - Empty dictionary constructors now create an empty object instead of being
   treated like non-object literal `external` constructors.
+- Update the docs for generated interface types to reference the MDN Web Docs
+  project.
 
 ## 0.5.1
 

lib/src/dom/angle_instanced_arrays.dart

@@ -35,6 +35,11 @@ import 'webgl1.dart';
 /// > hardware supports it and not just on Windows when using the ANGLE library.
 /// > "ANGLE" just indicates that this extension has been written by the ANGLE
 /// > library authors.
+///
+/// ---
+///
+/// API documentation sourced from
+/// [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/API/ANGLE_instanced_arrays).
 extension type ANGLE_instanced_arrays._(JSObject _) implements JSObject {
   external static GLenum get VERTEX_ATTRIB_ARRAY_DIVISOR_ANGLE;
 

lib/src/dom/clipboard_apis.dart

@@ -38,6 +38,11 @@ extension type ClipboardEventInit._(JSObject _) implements EventInit, JSObject {
 /// represents events providing information related to modification of the
 /// clipboard, that is [Element/cut_event], [Element/copy_event], and
 /// [Element/paste_event] events.
+///
+/// ---
+///
+/// API documentation sourced from
+/// [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/API/ClipboardEvent).
 extension type ClipboardEvent._(JSObject _) implements Event, JSObject {
   external factory ClipboardEvent(
     String type, [
@@ -58,6 +63,11 @@ extension type ClipboardEvent._(JSObject _) implements Event, JSObject {
 ///
 /// > **Note:** To work with text see the [Clipboard.readText] and
 /// > [Clipboard.writeText] methods of the [Clipboard] interface.
+///
+/// ---
+///
+/// API documentation sourced from
+/// [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/API/ClipboardItem).
 extension type ClipboardItem._(JSObject _) implements JSObject {
   external factory ClipboardItem(
     JSObject items, [
@@ -97,6 +107,11 @@ extension type ClipboardItemOptions._(JSObject _) implements JSObject {
 /// Additional requirements for using the API are discussed in the
 /// [Security consideration](https://developer.mozilla.org/en-US/docs/Web/API/Clipboard_API#security_considerations)
 /// section of the API overview topic.
+///
+/// ---
+///
+/// API documentation sourced from
+/// [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/API/Clipboard).
 extension type Clipboard._(JSObject _) implements EventTarget, JSObject {
   /// The **`read()`** method of the [Clipboard] interface requests a copy of
   /// the clipboard's contents, fulfilling the returned `Promise` with the data.

lib/src/dom/compression.dart

@@ -19,6 +19,11 @@ typedef CompressionFormat = String;
 
 /// The **`CompressionStream`** interface of the [Compression Streams API] is an
 /// API for compressing a stream of data.
+///
+/// ---
+///
+/// API documentation sourced from
+/// [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/API/CompressionStream).
 extension type CompressionStream._(JSObject _) implements JSObject {
   external factory CompressionStream(CompressionFormat format);
 
@@ -28,6 +33,11 @@ extension type CompressionStream._(JSObject _) implements JSObject {
 
 /// The **`DecompressionStream`** interface of the [Compression Streams API] is
 /// an API for decompressing a stream of data.
+///
+/// ---
+///
+/// API documentation sourced from
+/// [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/API/DecompressionStream).
 extension type DecompressionStream._(JSObject _) implements JSObject {
   external factory DecompressionStream(CompressionFormat format);
 

lib/src/dom/console.dart

@@ -39,6 +39,11 @@ external $Console get console;
 /// > console API, such as the timer methods, may not be outputted in the
 /// > console of online IDEs or editors. Always open your browser's DevTools
 /// > console to see the logs as shown in this documentation.
+///
+/// ---
+///
+/// API documentation sourced from
+/// [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/API/console).
 @JS('console')
 extension type $Console._(JSObject _) implements JSObject {
   @JS('assert')

lib/src/dom/credential_management.dart

@@ -31,6 +31,11 @@ typedef CredentialMediationRequirement = String;
 /// - [PasswordCredential]
 /// - [PublicKeyCredential]
 /// - [OTPCredential]
+///
+/// ---
+///
+/// API documentation sourced from
+/// [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/API/Credential).
 extension type Credential._(JSObject _) implements JSObject {
   external static JSPromise<JSBoolean> isConditionalMediationAvailable();
   external String get id;
@@ -42,6 +47,11 @@ extension type Credential._(JSObject _) implements JSObject {
 /// exposes methods to request credentials and notify the user agent when events
 /// such as successful sign in or sign out happen. This interface is accessible
 /// from [Navigator.credentials].
+///
+/// ---
+///
+/// API documentation sourced from
+/// [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/API/CredentialsContainer).
 extension type CredentialsContainer._(JSObject _) implements JSObject {
   /// The **`get()`** method of the [CredentialsContainer] interface returns a
   /// `Promise` that fulfills with a single credential instance that matches the
@@ -177,6 +187,11 @@ extension type CredentialCreationOptions._(JSObject _) implements JSObject {
 ///
 /// > **Note:** This interface is restricted to top-level contexts and cannot be
 /// > used from an `iframe`.
+///
+/// ---
+///
+/// API documentation sourced from
+/// [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/API/PasswordCredential).
 extension type PasswordCredential._(JSObject _)
     implements Credential, JSObject {
   external factory PasswordCredential(JSObject dataOrForm);
@@ -220,6 +235,11 @@ extension type PasswordCredentialData._(JSObject _)
 ///
 /// In browsers that support it, an instance of this interface may be passed in
 /// the `credential` member of the `init` object for global [fetch].
+///
+/// ---
+///
+/// API documentation sourced from
+/// [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/API/FederatedCredential).
 extension type FederatedCredential._(JSObject _)
     implements Credential, JSObject {
   external factory FederatedCredential(FederatedCredentialInit data);

lib/src/dom/csp.dart

@@ -30,6 +30,11 @@ typedef SecurityPolicyViolationEventDisposition = String;
 /// > or
 /// > [`report-to`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/report-to)
 /// > policy directive of the  header.
+///
+/// ---
+///
+/// API documentation sourced from
+/// [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/API/CSPViolationReportBody).
 extension type CSPViolationReportBody._(JSObject _)
     implements ReportBody, JSObject {
   external JSObject toJSON();
@@ -49,6 +54,11 @@ extension type CSPViolationReportBody._(JSObject _)
 /// The **`SecurityPolicyViolationEvent`** interface inherits from [Event], and
 /// represents the event object of an event sent on a document or worker when
 /// its content security policy is violated.
+///
+/// ---
+///
+/// API documentation sourced from
+/// [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/API/SecurityPolicyViolationEvent).
 extension type SecurityPolicyViolationEvent._(JSObject _)
     implements Event, JSObject {
   external factory SecurityPolicyViolationEvent(

lib/src/dom/css_animations.dart

@@ -19,6 +19,11 @@ import 'dom.dart';
 /// The **`AnimationEvent`** interface represents events providing information
 /// related to
 /// [animations](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_animations/Using_CSS_animations).
+///
+/// ---
+///
+/// API documentation sourced from
+/// [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/API/AnimationEvent).
 extension type AnimationEvent._(JSObject _) implements Event, JSObject {
   external factory AnimationEvent(
     String type, [
@@ -51,6 +56,11 @@ extension type AnimationEventInit._(JSObject _) implements EventInit, JSObject {
 /// of styles for a given keyframe. It corresponds to the contents of a single
 /// keyframe of a
 /// [at-rule](https://developer.mozilla.org/en-US/docs/Web/CSS/At-rule).
+///
+/// ---
+///
+/// API documentation sourced from
+/// [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/API/CSSKeyframeRule).
 extension type CSSKeyframeRule._(JSObject _) implements CSSRule, JSObject {
   external set keyText(String value);
   external String get keyText;
@@ -61,6 +71,11 @@ extension type CSSKeyframeRule._(JSObject _) implements CSSRule, JSObject {
 /// complete set of keyframes for a CSS animation. It corresponds to the
 /// contents of a whole
 /// [at-rule](https://developer.mozilla.org/en-US/docs/Web/CSS/At-rule).
+///
+/// ---
+///
+/// API documentation sourced from
+/// [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/API/CSSKeyframesRule).
 extension type CSSKeyframesRule._(JSObject _) implements CSSRule, JSObject {
   /// The **`appendRule()`** method of the [CSSKeyframeRule] interface appends a
   /// [CSSKeyFrameRule] to the end of the rules.

lib/src/dom/css_animations_2.dart

@@ -17,6 +17,11 @@ import 'web_animations.dart';
 
 /// The **`CSSAnimation`** interface of the [Web Animations API] represents an
 /// [Animation] object.
+///
+/// ---
+///
+/// API documentation sourced from
+/// [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/API/CSSAnimation).
 extension type CSSAnimation._(JSObject _) implements Animation, JSObject {
   external String get animationName;
 }

lib/src/dom/css_cascade.dart

@@ -18,6 +18,11 @@ import 'cssom.dart';
 /// The **`CSSLayerBlockRule`** represents a  block rule. It is a grouping
 /// at-rule meaning that it can contain other rules, and is associated to a
 /// given cascade layer, identified by its _name_.
+///
+/// ---
+///
+/// API documentation sourced from
+/// [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/API/CSSLayerBlockRule).
 extension type CSSLayerBlockRule._(JSObject _)
     implements CSSGroupingRule, JSObject {
   external String get name;
@@ -33,6 +38,11 @@ extension type CSSLayerBlockRule._(JSObject _)
 /// statement allows the reader to understand the layer order. It also allows
 /// inline and imported layers to be interleaved, which is not possible when
 /// using the `CSSLayerBlockRule` syntax.
+///
+/// ---
+///
+/// API documentation sourced from
+/// [MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/API/CSSLayerStatementRule).
 extension type CSSLayerStatementRule._(JSObject _)
     implements CSSRule, JSObject {
   external JSArray<JSString> get nameList;