Typescript Packaging & Publishing

This page will discuss common topics around publishing your Typescript projects for others to use.

Simple publish

package build

import mill._, javascriptlib._
import ujson._

object foo extends PublishModule {
  def pubBundledOut = "dist"
  def packageJson = PackageJson(
    name = "mill-simple",
    version = "1.0.0",
    description = "A simple Node.js command-line tool",
    files = Seq("README.md"),
    bin = ujson.Obj(
      "greet" -> s"${pubBundledOut()}/src/foo.js"
    )
  )

}

scala

You’ll need to define some metadata in the publishMeta tasks. This metadata is roughly equivalent to what you’d define in a package.json file.

Important package.json info required for publishing are auto-magically generated. main file is by default the file defined in the mainFileName task, it can be modified if needed.

Use the .npmrc file to include authentication tokens for publishing to npm or change the regsitry to publish to a private registry.

The package.json generated for this simple publish:

{
 "name": "mill-simple",
 "version": "1.0.0",
 "description": "A simple Node.js command-line tool",
 "license": "MIT",
 "main": "dist/src/foo.js",
 "types": "declarations/src/foo.d.ts",
 "files": ["README.md", "dist", "declarations"],
 "bin": {
   "greet": "./dist/src/foo.js"
 },
 "exports": {
   ".": "./dist/src/foo.js"
 },
 "typesVersions": {
   "*": {
   "./dist/src/foo": ["declarations/src/foo.d.ts"]
   }
 }
}

json

> mill foo.run "James Bond"
Hello James Bond!

> mill show foo.bundle
Build succeeded!

> node out/foo/bundle.dest/dist/src/foo.js "James Bond"
Hello James Bond!

> npm i -g mill-simple # install the executable file globally
...

> greet "James Bond"
Hello James Bond!

bash

Realistic publish

build.mill (download, browse)

package build

import mill._, javascriptlib._
import ujson._

object foo extends TypeScriptModule {
  object bar extends TypeScriptModule {
    def npmDeps = Seq("immutable@4.3.7")
  }

}

object qux extends PublishModule {
  def moduleDeps = Seq(foo, foo.bar)

  def generatedSources = Task {
    os.write(
      Task.dest / "qux.generated.ts",
      s"""export default class QuxGen {
         |  static value: number = 123
         |}
      """.stripMargin
    )

    Seq(PathRef(Task.dest))
  }

  def pubBundledOut = "dist"

  def pubExports = Map(
    "./qux/generate_user" -> "src/generate_user.js",
    "./foo" -> "foo/src/foo.js",
    "./foo/bar" -> "foo/bar/src/bar.js"
  )

  def packageJson = PackageJson(
    name = "mill-realistic",
    version = "1.0.3",
    description = "A simple Node.js command-line tool",
    files = Seq("README.md"),
    bin = ujson.Obj(
      "qux" -> s"${pubBundledOut()}/src/qux.js"
    )
  )

  object test extends TypeScriptTests with TestModule.Jest
}

scala

In this example, we define multiple exports for our application with the export task The package.json generated for this lib publish:

{
 "name": "mill-realistic",
 "version": "1.0.3",
 "description": "A simple Node.js command-line tool",
 "license": "MIT",
 "main": "dist/src/qux.js",
 "types": "declarations/src/qux.d.ts",
 "files": [
   "README.md",
   "dist",
   "declarations"
 ],
 "bin": {
   "qux": "./dist/src/qux.js"
 },
 "dependencies": {
   "immutable": "4.3.7"
 },
 "devDependencies": {
   "immutable": "4.3.7"
 },
 "exports": {
   ".": "./dist/src/qux.js",
   "./qux/generate_user": "./dist/src/generate_user.js",
   "./foo": "./dist/foo/src/foo.js",
   "./foo/bar": "./dist/foo/bar/src/bar.js"
 },
 "typesVersions": {
   "*": { ... }
 }
}

json

> mill qux.run James Bond prof
{ prof: 'Professor' }
prof
Professor
Hello James Bond Professor

> mill show qux.bundle
Build succeeded!

> node out/qux/bundle.dest/dist/src/qux.js James Bond prof
{ prof: 'Professor' }
prof
Professor
Hello James Bond Professor

> mill qux.test
PASS .../qux.test.ts
...

> npm i -g mill-realistic
...

> qux James Bond prof
{ prof: 'Professor' }
prof
Professor
Hello James Bond Professor

bash