Concat .d.ts from multiple files to provide an implicit module declaration for a npm package implemented in TypeScript
JavaScript TypeScript
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


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).

Getting Started

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:


The "typescript_export" task


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.

Release History

v0.1.0 — initial version.