Typescriptify - Conversion to TypeScript.

.editorconfig

@@ -10,10 +10,10 @@ end_of_line = lf
 insert_final_newline = true
 trim_trailing_whitespaces = true
 
-# JavaScript
+# JavaScript - and the like
 #
 # Two spaces seems to be the standard most common style, at least in
 # Node.js (http://nodeguide.com/style.html#tabs-vs-spaces).
-[*.js]
+[*.{js,json,ts}]
 indent_size = 2
 indent_style = space

.eslintignore

@@ -0,0 +1,4 @@
+lib/**/*.js
+esm/**/*.js
+test/babel/**/*.js
+test/typescript/**/*.js

.eslintrc.json

@@ -0,0 +1,24 @@
+{
+  "extends": "eslint:recommended",
+  "env": {
+    "commonjs": true,
+    "es6": true,
+    "node": true,
+    "mocha": true
+  },
+  "parser": "babel-eslint",
+  "parserOptions": {
+    "sourceType": "module"
+  },
+  "rules": {
+    "camelcase": "off",
+    "no-unreachable": "warn",
+    "no-unused-vars": "warn",
+    "no-throw-literal": "warn",
+    "no-unused-expressions": "off",
+    "no-console": "off",
+    "indent": ["error", 2],
+    "semi": ["error", "always"],
+    "space-before-function-paren": ["error", "never"]
+  }
+}

.gitignore

@@ -1,5 +1,7 @@
+node_modules
 /lib/
 /es/
-/node_modules/
-/built/
+/esm/
+/test/babel/
+/test/typescript/
 *.log

.vscode/launch.json

@@ -1,20 +1,18 @@
 {
-    // Use IntelliSense to learn about possible Node.js debug attributes.
-    // Hover to view descriptions of existing attributes.
-    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
-    "version": "0.2.0",
-    "configurations": [
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "Mocha Tests",
-            "program": "${workspaceRoot}/node_modules/mocha/bin/_mocha",
-            "args": [
-                "--compilers", "js:babel-core/register",
-                "--require", "babel-polyfill",
-                "${workspaceRoot}/test/**/*.spec.js",
-                "--debug"
-            ]
-        }
-    ]
+  // Use IntelliSense to learn about possible Node.js debug attributes.
+  // Hover to view descriptions of existing attributes.
+  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "type": "node",
+      "request": "launch",
+      "name": "Mocha Tests",
+      "program": "${workspaceRoot}/node_modules/mocha/bin/_mocha",
+      "args": [
+        "--no-timeouts",
+        "--debug"
+      ]
+    }
+  ]
 }

.vscode/settings.json

@@ -0,0 +1,27 @@
+// Place your settings in this file to overwrite default and user settings.
+{
+  // Mocha: Options to run Mocha
+  "mocha.options": {
+    "opts": "test/mocha.opts"
+  },
+  // Mocha: Glob to search for test files
+  "mocha.files.glob": "test/babel/*.spec.js",
+  // Mocha: Globs to ignore when searching for test files
+  "mocha.files.ignore": [
+    "**/.git/**/*",
+    "**/node_modules/**/*",
+  "**/unit/*.spec.js"
+  ],
+  // Mocha: Environment variables to run your tests
+  "mocha.env": {},
+  // Mocha: Options to pass to node executable
+  "mocha.node_options": [],
+  // Mocha: Subdirectory in the Workspace where run mocha from
+  "mocha.subfolder": "",
+  // Mocha: List of files to require before running mocha
+  "mocha.requires": [
+    "babel-register",
+    "source-map-support/register"
+  ]
+
+}

.vscode/tasks.json

@@ -1,11 +1,21 @@
 {
     // See https://go.microsoft.com/fwlink/?LinkId=733558
     // for the documentation about the tasks.json format
-    "version": "0.1.0",
-    "command": "tsc",
-    "isShellCommand": true,
-    "args": ["-w", "-p", "."],
-    "showOutput": "silent",
-    "isBackground": true,
-    "problemMatcher": "$tsc-watch"
+    "version": "2.0.0",
+    "tasks": [
+        {
+            "type": "gulp",
+            "task": "watch",
+            "isBackground": true,
+            "problemMatcher": [
+                "$gulp-tsc",
+                "$eslint-stylish"
+            ],
+            "group": {
+                "kind": "build",
+                "isDefault": true
+            }
+        }
+
+    ]
 }

README.md

@@ -1,5 +1,5 @@
 # core-decorators.js [![Build Status](https://travis-ci.org/jayphelps/core-decorators.js.svg?branch=master)](https://travis-ci.org/jayphelps/core-decorators.js)
-Library of [JavaScript stage-0 decorators](https://github.com/wycats/javascript-decorators) (aka ES2016/ES7 decorators [but that's not accurate](https://medium.com/@jayphelps/please-stop-referring-to-proposed-javascript-features-as-es7-cad29f9dcc4b)) inspired by languages that come with built-ins like @​override, @​deprecate, @​autobind, @​mixin and more. Popular with React/Angular, but is framework agnostic. Similar to [Annotations in Java](https://docs.oracle.com/javase/tutorial/java/annotations/predefined.html) but unlike Java annotations, decorators are functions which are applied at runtime.
+Library of [JavaScript stage-0 decorators](https://github.com/wycats/javascript-decorators) (aka ES2016/ES7 decorators [but that's not accurate](https://medium.com/@jayphelps/please-stop-referring-to-proposed-javascript-features-as-es7-cad29f9dcc4b)) inspired by languages that come with built-ins like @​override, @​deprecate, @​autobind and more. Popular with React/Angular, but is framework agnostic. Similar to [Annotations in Java](https://docs.oracle.com/javase/tutorial/java/annotations/predefined.html) but unlike Java annotations, decorators are functions which are applied at runtime.
 
 These are stage-0 decorators because while [the decorators spec has changed](http://tc39.github.io/proposal-decorators/) and is now stage-2, no transpiler has yet to implement these changes and until they do, this library won't either. Although the [TypeScript documentation](http://www.typescriptlang.org/docs/handbook/decorators.html) uses the phrase "Decorators are a stage 2 proposal for JavaScript" this is misleading because TypeScript still only implements the **stage-0** version of the spec, which is very incompatible with stage-2 (as of this writing). If you concretely find that a compiler (babel, TS, etc) implement stage-2+, please do link me to the appropriate release notes! :balloon:
 
@@ -14,7 +14,16 @@ npm install core-decorators --save
 
 This can be consumed by any transpiler that supports stage-0 of the decorators spec, like [babel.js](https://babeljs.io/) version 5. *Babel 6 [does not yet support decorators natively](https://phabricator.babeljs.io/T2645), but you can include [babel-plugin-transform-decorators-legacy](https://github.com/loganfsmyth/babel-plugin-transform-decorators-legacy) or use the [`applyDecorators()` helper](#applydecorators-helper).*
 
-core-decorators does not officially support TypeScript. There are known incompatibilities with the way it transpiles the output. PRs certainly welcome to fix that!
+# Typescript Compatability
+This release includes enhanced support for and testing of the decorators from TypeScript. Of course for this to work the `tsc` command options must include `--experimentalDecorators` to enable support in Typescript files.  
+
+Caution: At this time, due to limitations of the experimental TypeScript property decorator support, __the following decorators do not work__ as intended when invoked from TypeScript:
+
+ - `@lazyIntialize`
+ - `@readonly`
+ - `@nonenmerable` (and probably `@enumerable`)
+
+In addition, testing of the `@autobind` method decorator is only partially complete in Typescript.       
 
 ##### Bower/globals
 
@@ -44,14 +53,11 @@ core-decorators aims to provide decorators that are fundamental to JavaScript it
 * [@suppressWarnings](#suppresswarnings)
 * [@enumerable](#enumerable)
 * [@override](#override)
-* [@debounce](#debounce) :no_entry_sign: DEPRECATED
-* [@throttle](#throttle) :no_entry_sign: DEPRECATED
 * [@time](#time)
 * [@profile](#profile)
 
 ##### For Classes
 * [@autobind](#autobind)
-* [@mixin](#mixin-alias-mixins) :no_entry_sign: DEPRECATED
 
 ## Helpers
 
@@ -189,52 +195,6 @@ person.facepalmHarder();
 //     See http://knowyourmeme.com/memes/facepalm for more details.
 //
 ```
-
-### @debounce :no_entry_sign: DEPRECATED
-
-Creates a new debounced function which will be invoked after `wait` milliseconds since the time it was invoked. Default timeout is 300 ms.
-
-Optional boolean second argument allows to trigger function on the leading instead of the trailing edge of the wait interval. Implementation is inspired by similar method from [UnderscoreJS](http://underscorejs.org/#debounce).
-
-```js
-import { debounce } from 'core-decorators';
-
-class Editor {
-
-  content = '';
-
-  @debounce(500)
-  updateContent(content) {
-    this.content = content;
-  }
-}
-```
-
-### @throttle :no_entry_sign: DEPRECATED
-
-Creates a new throttled function which will be invoked in every `wait` milliseconds. Default timeout is 300 ms.
-
-Second argument is optional options:
-
-- `leading`: default to `true`, allows to trigger function on the leading.
-- `trailing`: default to `true`, allows to trigger function on the trailing edge of the wait interval.
-
-Implementation is inspired by similar method from [UnderscoreJS](http://underscorejs.org/#throttle).
-
-```js
-import { throttle } from 'core-decorators';
-
-class Editor {
-
-  content = '';
-
-  @throttle(500, {leading: false})
-  updateContent(content) {
-    this.content = content;
-  }
-}
-```
-
 ### @suppressWarnings
 
 Suppresses any JavaScript `console.warn()` call while the decorated function is called. (i.e. on the stack)
@@ -384,39 +344,6 @@ editor.hugeBuffer;
 // createHugeBuffer() is not called again
 ```
 
-### @mixin (alias: @mixins) :no_entry_sign: DEPRECATED
-
-Mixes in all property descriptors from the provided Plain Old JavaScript Objects (aka POJOs) as arguments. Mixins are applied in the order they are passed, but do **not** override descriptors already on the class, including those inherited traditionally.
-
-```js
-import { mixin } from 'core-decorators';
-
-const SingerMixin = {
-  sing(sound) {
-    alert(sound);
-  }
-};
-
-const FlyMixin = {
-  // All types of property descriptors are supported
-  get speed() {},
-  fly() {},
-  land() {}
-};
-
-@mixin(SingerMixin, FlyMixin)
-class Bird {
-  singMatingCall() {
-    this.sing('tweet tweet');
-  }
-}
-
-var bird = new Bird();
-bird.singMatingCall();
-// alerts "tweet tweet"
-
-```
-
 ### @time
 
 Uses `console.time` and `console.timeEnd` to provide function timings with a unique label whose default prefix is `ClassName.method`.  Supply a first argument to override the prefix:
@@ -581,3 +508,5 @@ When using multiple decorators on a class, method, or property the order of the
 @autobind
 class Foo extends Component {}
 ```
+# Development notes
+- If you are having trouble getting `npm install` run successfully, there are a series of open issues tracking the problem.   It seems to be an interaction between npm, vsCode, and the TypeScript language service.   As a workaround, consider using [Yarn](https://yarnpkg.com/en/) instead of npm, it seems to side the issue, and seems substantially faster as a bonus.

bower.json

@@ -1,6 +1,6 @@
 {
   "name": "core-decorators.js",
-  "description": "Library of ES2016 (ES7) JavaScript decorators inspired by languages that come with built-ins like @​override, @​deprecate, @​autobind, @​mixin and more! Works great with React/Angular/more!",
+  "description": "Library of ES2016 (ES7) JavaScript decorators inspired by languages that come with built-ins like @​override, @​deprecate, @​autobind and more! Works great with React/Angular/more!",
   "version": "0.11.2",
   "homepage": "https://github.com/jayphelps/core-decorators.js",
   "authors": [
@@ -27,14 +27,12 @@
     "autobind",
     "react",
     "angular",
-    "lodash",
-    "mixin",
-    "mixins"
+    "lodash"
   ],
   "ignore": [
     "**/.*",
     "node_modules",
     "test",
-    "scripts",
+    "scripts"
   ]
 }