initial implementation

Author: ajafff

.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+trim_trailing_whitespace = true
+charset = utf-8
+end_of_line = lf
+indent_size = 4
+indent_style = space
+insert_final_newline = true
+
+[*.{json,yaml,yml,md}]
+indent_size = 2

.gitignore

@@ -0,0 +1,67 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# TypeScript v1 declaration files
+typings/
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variables file
+.env
+
+# next.js build output
+.next
+
+# TypeScript compiler output
+/dist
+
+# test output
+/test/out

.travis.yml

@@ -0,0 +1,9 @@
+language: node_js
+node_js:
+  - '6'
+  - '8'
+  - '10'
+  - '11'
+cache: yarn
+script:
+  - yarn verify

.wotanrc.yaml

@@ -0,0 +1 @@
+extends: wotan:recommended

README.md

@@ -1,2 +1,38 @@
 # ts-transform-readonly-array
-Convert 'readonly T[]' to 'ReadonlyArray<T>' in declaration emit
+
+TypeScript transformer to convert `readonly T[]` to `ReadonlyArray<T>` in declaration files.
+
+## Why
+
+Starting from v3.4.0 (or one of the nightly releases before that) TypeScript emits `readonly T[]` for readonly array types.
+This breaks consumers of declaration files if they use an older version of TypeScript.
+
+This transformer ensures that your declaration files can be used in older TypeScript versions as well.
+
+It does not convert readonly tuple types in the form of `readonly [string, number]` as this is not supported in older versions of TypeScript.
+
+## Usage with `ttypescript`
+
+I wrote this transformer for use with [`ttypescript`](https://github.com/cevek/ttypescript).
+
+You can configure it in your `tsconfig.json`:
+
+```js
+{
+  "compilerOptions": {
+    "declaration": true,
+    "plugins": [
+      { "transform": "ts-transform-readonly-array", "afterDeclarations": true },
+    ]
+  }
+}
+```
+
+Note that you can use any `"type"` for the transformer: the default is `"type": "program"`, but it also works with `"type": "raw"` for example.
+
+Afterwards you run `ttsc` as you would run `tsc`.
+
+## Usage with `ts-loader`, `rollup`, and TypeScript's API
+
+This package exports the necessary factory function to create the transformer. You can use this function to plug this transformer in any major TypeScript compilation pipeline.
+Please refer to the API documentation of the tool you are using. Alternatively you can use [`ttypescript`](https://github.com/cevek/ttypescript) in most tools.