pretext-tools monorepo

This monorepo contains the PreTeXt Tools VS Code extension and its supporting packages. PreTeXt is an XML-based authoring language for scholarly documents.

Packages

Package	Description
pretext-tools	VS Code extension — language support, CLI front-end, formatter, and more
@pretextbook/completions	Reusable completion/intellisense engine
@pretextbook/format	PreTeXt document formatter library
@pretextbook/latex-pretext	LaTeX-to-PreTeXt conversion
@pretextbook/visual-editor	React/TipTap-based WYSIWYG editor (webview UI)
prettier-plugin-pretext	Prettier plugin for PreTeXt XML
@pretextbook/ptxast	TypeScript types for the PreTeXt AST

Development

This workspace uses npm workspaces. After cloning, install dependencies with:

npm install

Building

# Build the VS Code extension (and all dependencies)
npm run build

# Build in watch/dev mode
npm run build:dev

# Build a specific package
npm run build -w @pretextbook/format

Testing

# Run all tests
npm test

# Test a specific package
npm run test -w @pretextbook/completions

See Testing Guide for detailed instructions on running unit and integration tests for the VS Code extension, understanding the two-layer test architecture, and troubleshooting common issues.

Linting

npm run lint

Refreshing Schemas

npm run refresh:schemas

Contributing

Like this project? Star it on GitHub!

Have an idea or suggestion? Open a feature request.

Found something wrong? File an issue.

Pull requests welcome.