Typst.js

📦 Typst for JavaScript

Docs
| GitHub
| Typst

👨‍💻 Includes the Typst CLI so you can npx typst \
💻 Provides a typed JavaScript API so you can typst.compile() \
📑 Install it locally with npm install --save as a project-level dependency \
🌎 Or install it globally with npm install --global

📑 Make sure you check out the official Typst website!

Installation

`sh
npm install typst
`

`js
import * as typst from "npm:typst";
`

🛑 Typst does not yet work in the browser. WASM support is planned.

Usage

This package provides both the Typst CLI as well as a JavaScript API. To use the
CLI, just run npx typst --help.

`
The Typst compiler

Usage: typst [OPTIONS]

Commands:
compile Compiles an input file into a supported output format [aliases: c]
watch Watches an input file and recompiles on changes [aliases: w]
query Processes an input file to extract provided metadata
fonts Lists all discovered fonts in system and custom font paths
update Self update the Typst CLI
help Print this message or the help of the given subcommand(s)

Options:
-v, --verbosity... Sets the level of logging verbosity: -v = warning & error, -vv = info, -vvv = debug, -vvvv = trace
--cert Path to a custom CA certificate to use when making network requests [env: TYPST_CERT=]
-h, --help Print help
-V, --version Print version
`

ℹ The typst update command will fail. Use npm install typst@latest to update it through npm.

All of the major Typst CLI commands are also exposed for use in JavaScript:

`js
import * as typst from "typst";
await typst.query("example.typ", ""); //=> object[]
await typst.compile("example.typ", "example.pdf");
await typst.watch("example.typ", "example.pdf");
await typst.fonts(); //=> string[]
await typst.help(); //=> string
await typst.version(); //=> string
`

📚 Check out the Typst.js documentation website for more details!

$3

`typst
#set page(width: 10cm, height: auto)
#set heading(numbering: "1.")

= Fibonacci sequence
The Fibonacci sequence is defined through
the recurrence relation $F_n = F_(n-1) + F_(n-2)$.
It can also be expressed in _closed form:_

$ F_n = round(1 / sqrt(5) phi.alt^n), quad
phi.alt = (l + sqrt(5)) / 2 $

#let count = 8
#let nums = range(1, count + 1)
#let fib(n) = (
if n <= 2 { 1 }
else { fib(n - 1) + fib(n - 2) }
)

The first #count numbers of the sequence are:

#align(center, table(
columns: count,
..nums.map(n => $F_#n$),
..nums.map(n => str(fib(n))),
))
`

`sh
typst compile example.typ
$BROWSER example.pdf
`

Development

This package contains two primary parts: a binary redistribution setup using a
bunch of optionalDependencies and a bunch of pretty typst ... CLI wrapper
functions.

When you clone this repository and run npm install, it auto runs the
tools/generate-dist-package script with your current $OS-$ARCH tuple and
uses npm link to link that to the current workspace. This is for debugging.

To bump the version, use npm version --no-git-tag-version $NEW_VERSION so that
the tools/postversion.js script gets run to realign the optionalDependencies
with the new version field. You can do this manually if you prefer. 🤷‍♂️

Then, when you want to create a new release, remember to run npm run build
_after_ the version field has been updated (it gets used in the build step). This will generate a bunch of out/$OS-$ARCH/ folders, each of which is a targeted distribution of a native binary that only works on that platform.

Then finally when you run npm publish, there's a hook to publish all the out/$OS-$ARCH/ packages (@typst-community/typst-$OS-$ARCH) _before_ finally publishing the root typst` package.