Concat .d.ts from multiple files to provide an implicit module declaration for a npm package.


Generates a single index.d.ts file for your NPM package implemented in TypeScript by concatenating per-file d.ts files, wrapping them all into an implicit module declaration and rewriting/moving some lines.

Produces something like this:

/// <reference path="./d.ts/DefinitelyTyped/node/node.d.ts" />
declare module "livereload-soa" {
import events = require('events');
import api = require('./api');
// lib/api.d.ts
export interface Service {
    onmessage(message: Message): void;
    ondisconnect(): void;
// lib/carrier-node-stream.d.ts
export class NodeStreamCarrier extends events.EventEmitter {
    constructor(input, output);
    public send(message): void;

Rewrites applied:

  1. All references are de-duplicated and moved to the top of the file (they don't work inside the module declaration).

  2. All imports de-deduplicaed and moved to the top of the module declaration (they don't work at the top level).

  3. Referenced paths that start with ../ are modified to start with ./ (because presumably you are generating /index.d.ts from /lib/*.d.ts), this part should be made smarter.

  4. declare is dropped from all internal declaration (nested declares are invalid).

  5. All local imports (import foo = require('./something')) are removed, and the corresponding references are rewritten to use the bare name (foo.Bar is replaced with Bar).

This plugin requires Grunt ~0.4.1

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-typescript-export --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:


In your project's Gruntfile, add a section named typescript_export to the data object passed into grunt.initConfig(), and also make sure you set

  pkg: grunt.file.readJSON('package.json'),
  typescript_export: {
    your_target: {
      src: ['lib/*.d.ts'],
      dest: 'index.d.ts'

None so far.

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Test your code using Grunt.

v0.1.0 — initial version.