➡️ Migrate core package 'welcome' into ./packages

package.json

@@ -163,7 +163,7 @@
     "typescript-simple": "1.0.0",
     "update-package-dependencies": "https://www.atom.io/api/packages/update-package-dependencies/versions/0.13.1/tarball",
     "vscode-ripgrep": "^1.2.5",
-    "welcome": "https://www.atom.io/api/packages/welcome/versions/0.36.9/tarball",
+    "welcome": "file:packages/welcome",
     "whitespace": "https://www.atom.io/api/packages/whitespace/versions/0.37.7/tarball",
     "winreg": "^1.2.1",
     "wrap-guide": "https://www.atom.io/api/packages/wrap-guide/versions/0.41.0/tarball",
@@ -226,7 +226,7 @@
     "timecop": "0.36.2",
     "tree-view": "0.228.0",
     "update-package-dependencies": "0.13.1",
-    "welcome": "0.36.9",
+    "welcome": "file:./packages/welcome",
     "whitespace": "0.37.7",
     "wrap-guide": "0.41.0",
     "language-c": "0.60.18",

packages/README.md

@@ -97,7 +97,7 @@ See [RFC 003](https://github.com/atom/atom/blob/master/docs/rfcs/003-consolidate
 | **timecop** | [`atom/timecop`][timecop] | [#18272](https://github.com/atom/atom/issues/18272) |
 | **tree-view** | [`atom/tree-view`][tree-view] |  |
 | **update-package-dependencies** | [`atom/update-package-dependencies`][update-package-dependencies] | [#18284](https://github.com/atom/atom/issues/18284) |
-| **welcome** | [`atom/welcome`][welcome] | [#18285](https://github.com/atom/atom/issues/18285) |
+| **welcome** | [`./welcome`](./welcome) | [#18285](https://github.com/atom/atom/issues/18285) |
 | **whitespace** | [`atom/whitespace`][whitespace] |  |
 | **wrap-guide** | [`atom/wrap-guide`][wrap-guide] | [#18286](https://github.com/atom/atom/issues/18286) |
 
@@ -166,6 +166,5 @@ See [RFC 003](https://github.com/atom/atom/blob/master/docs/rfcs/003-consolidate
 [timecop]: https://github.com/atom/timecop
 [tree-view]: https://github.com/atom/tree-view
 [update-package-dependencies]: https://github.com/atom/update-package-dependencies
-[welcome]: https://github.com/atom/welcome
 [whitespace]: https://github.com/atom/whitespace
 [wrap-guide]: https://github.com/atom/wrap-guide

packages/welcome/.gitignore

@@ -0,0 +1 @@
+node_modules

packages/welcome/LICENSE.md

@@ -0,0 +1,20 @@
+Copyright (c) 2014 GitHub Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

packages/welcome/README.md

@@ -0,0 +1,3 @@
+## Welcome package
+
+Opens a welcome editor with helpful information the very first time Atom is opened and the usage statistics opt-in.

packages/welcome/docs/events.md

@@ -0,0 +1,36 @@
+# Events specification
+
+This document specifies all the data (along with the format) which gets sent from the Welcome package to the GitHub analytics pipeline. This document follows the same format and nomenclature as the [Atom Core Events spec](https://github.com/atom/metrics/blob/master/docs/events.md).
+
+## Counters
+
+Currently the Welcome package does not log any counter events.
+
+## Timing events
+
+Currently the Welcome package does not log any timing events.
+
+## Standard events
+
+#### Welcome package shown
+
+* **eventType**: `welcome-v1`
+* **metadata**
+
+  | field | value |
+  |-------|-------|
+  | `ea` | `show-on-initial-load`
+
+
+#### Click on links
+
+* **eventType**: `welcome-v1`
+* **metadata**
+
+  | field | value |
+  |-------|-------|
+  | `ea` | link that was clicked
+
+(There are many potential values for the `ea` param, e.g: `clicked-welcome-atom-docs-link`,`clicked-welcome-atom-org-link`, `clicked-project-cta`, `clicked-init-script-cta`, ...).
+
+

packages/welcome/lib/consent-view.js

@@ -0,0 +1,92 @@
+'use babel'
+/** @jsx etch.dom */
+
+import etch from 'etch'
+
+export default class ConsentView {
+  constructor () {
+    etch.initialize(this)
+  }
+
+  render () {
+    return (
+      <div className='welcome'>
+        <div className='welcome-container'>
+          <div className='header'>
+            <a title='atom.io' href='https://atom.io/'>
+              <svg class='welcome-logo' width='330px' height='68px' viewBox='0 0 330 68' version='1.1'>
+                <g stroke='none' stroke-width='1' fill='none' fill-rule='evenodd'>
+                  <g transform='translate(2.000000, 1.000000)'>
+                    <g transform='translate(96.000000, 8.000000)' fill='currentColor'>
+                      <path d='M185.498,3.399 C185.498,2.417 186.34,1.573 187.324,1.573 L187.674,1.573 C188.447,1.573 189.01,1.995 189.5,2.628 L208.676,30.862 L227.852,2.628 C228.272,1.995 228.905,1.573 229.676,1.573 L230.028,1.573 C231.01,1.573 231.854,2.417 231.854,3.399 L231.854,49.403 C231.854,50.387 231.01,51.231 230.028,51.231 C229.044,51.231 228.202,50.387 228.202,49.403 L228.202,8.246 L210.151,34.515 C209.729,35.148 209.237,35.428 208.606,35.428 C207.973,35.428 207.481,35.148 207.061,34.515 L189.01,8.246 L189.01,49.475 C189.01,50.457 188.237,51.231 187.254,51.231 C186.27,51.231 185.498,50.458 185.498,49.475 L185.498,3.399 L185.498,3.399 Z' />
+                      <path d='M113.086,26.507 L113.086,26.367 C113.086,12.952 122.99,0.941 137.881,0.941 C152.77,0.941 162.533,12.811 162.533,26.225 L162.533,26.367 C162.533,39.782 152.629,51.792 137.74,51.792 C122.85,51.792 113.086,39.923 113.086,26.507 M158.74,26.507 L158.74,26.367 C158.74,14.216 149.89,4.242 137.74,4.242 C125.588,4.242 116.879,14.075 116.879,26.225 L116.879,26.367 C116.879,38.518 125.729,48.491 137.881,48.491 C150.031,48.491 158.74,38.658 158.74,26.507' />
+                      <path d='M76.705,5.155 L60.972,5.155 C60.06,5.155 59.287,4.384 59.287,3.469 C59.287,2.556 60.059,1.783 60.972,1.783 L96.092,1.783 C97.004,1.783 97.778,2.555 97.778,3.469 C97.778,4.383 97.005,5.155 96.092,5.155 L80.358,5.155 L80.358,49.405 C80.358,50.387 79.516,51.231 78.532,51.231 C77.55,51.231 76.706,50.387 76.706,49.405 L76.706,5.155 L76.705,5.155 Z' />
+                      <path d='M0.291,48.562 L21.291,3.05 C21.783,1.995 22.485,1.292 23.75,1.292 L23.891,1.292 C25.155,1.292 25.858,1.995 26.348,3.05 L47.279,48.421 C47.49,48.843 47.56,49.194 47.56,49.546 C47.56,50.458 46.788,51.231 45.803,51.231 C44.961,51.231 44.329,50.599 43.978,49.826 L38.219,37.183 L9.21,37.183 L3.45,49.897 C3.099,50.739 2.538,51.231 1.694,51.231 C0.781,51.231 0.008,50.529 0.008,49.685 C0.009,49.404 0.08,48.983 0.291,48.562 L0.291,48.562 Z M36.673,33.882 L23.749,5.437 L10.755,33.882 L36.673,33.882 L36.673,33.882 Z' />
+                    </g>
+                    <g>
+                      <path d='M40.363,32.075 C40.874,34.44 39.371,36.77 37.006,37.282 C34.641,37.793 32.311,36.29 31.799,33.925 C31.289,31.56 32.791,29.23 35.156,28.718 C37.521,28.207 39.851,29.71 40.363,32.075' fill='currentColor' />
+                      <path d='M48.578,28.615 C56.851,45.587 58.558,61.581 52.288,64.778 C45.822,68.076 33.326,56.521 24.375,38.969 C15.424,21.418 13.409,4.518 19.874,1.221 C22.689,-0.216 26.648,1.166 30.959,4.629' stroke='currentColor' stroke-width='3.08' stroke-linecap='round' />
+                      <path d='M7.64,39.45 C2.806,36.94 -0.009,33.915 0.154,30.79 C0.531,23.542 16.787,18.497 36.462,19.52 C56.137,20.544 71.781,27.249 71.404,34.497 C71.241,37.622 68.127,40.338 63.06,42.333' stroke='currentColor' stroke-width='3.08' stroke-linecap='round' />
+                      <path d='M28.828,59.354 C23.545,63.168 18.843,64.561 15.902,62.653 C9.814,58.702 13.572,42.102 24.296,25.575 C35.02,9.048 48.649,-1.149 54.736,2.803 C57.566,4.639 58.269,9.208 57.133,15.232' stroke='currentColor' stroke-width='3.08' stroke-linecap='round' />
+                    </g>
+                  </g>
+                </g>
+              </svg>
+            </a>
+          </div>
+          <div className='welcome-consent'>
+            <p>Help improve Atom by sending your anonymous <strong>usage data</strong> to the Atom team. The resulting data plays a key role in deciding what we focus on next.</p>
+
+            <div className='welcome-consent-choices'>
+              <div>
+                <button className='btn btn-primary' onclick={this.consent.bind(this)}>Yes, send my usage data</button>
+                <p className='welcome-note'>Including exception and crash reports. See the <a onclick={this.openMetricsPackage.bind(this)}>atom/metrics package</a> for more details.</p>
+              </div>
+
+              <div>
+                <button className='btn btn-primary' onclick={this.decline.bind(this)}>No, do not send my usage data</button>
+                <p className='welcome-note'>Note: We only register anonymously that you opted-out.</p>
+              </div>
+            </div>
+          </div>
+
+          <div className='welcome-footer'>
+            <p className='welcome-love'>
+              <span className='icon icon-code' />
+              <span className='inline'> with </span>
+              <span className='icon icon-heart' />
+              <span className='inline'> by </span>
+              <a className='icon icon-logo-github' title='GitHub' href='https://github.com' />
+            </p>
+          </div>
+        </div>
+      </div>
+    )
+  }
+
+  update () {
+    return etch.update(this)
+  }
+
+  consent () {
+    atom.config.set('core.telemetryConsent', 'limited')
+    atom.workspace.closeActivePaneItemOrEmptyPaneOrWindow()
+  }
+
+  decline () {
+    atom.config.set('core.telemetryConsent', 'no')
+    atom.workspace.closeActivePaneItemOrEmptyPaneOrWindow()
+  }
+
+  openMetricsPackage () {
+    atom.workspace.open('atom://config/packages/metrics')
+  }
+
+  getTitle () {
+    return 'Telemetry Consent'
+  }
+
+  async destroy () {
+    await etch.destroy(this)
+  }
+}