TransTex (TypeScript)

TypeScript/Node bindings for TransTex: BibTeX parsing/serialization and citation formatting for APA 6th/7th, IEEE, MLA 9th, Chicago (author-date), and Vancouver. Includes reverse parsing from citations back to BibTeX.

Install

yarn add transtex

Usage

Format a reference in multiple styles:

import {
    Reference,
    formatApa,
    formatApa7,
    formatIeee,
    formatMla,
    formatChicago,
    formatVancouver,
    referenceToBibtex,
} from "transtex";

const ref = new Reference({
    entryType: "article",
    citeKey: "doe2020deep",
    title: "Deep Learning for Everything",
    authors: ["John Doe", "Jane Smith"],
    journal: "Journal of Omniscience",
    year: "2020",
    volume: "42",
    issue: "7",
    pages: "1-10",
    doi: "10.1000/j.jo.2020.01.001",
});

console.log(formatApa(ref));
console.log(formatApa7(ref));
console.log(formatIeee(ref));
console.log(formatMla(ref));
console.log(formatChicago(ref));
console.log(formatVancouver(ref));

console.log(referenceToBibtex(ref));

Parse a citation back to BibTeX:

import { citationToBibtex, convertCitation } from "transtex";

const ieeeCitation =
    'J. Doe and J. Smith, "Deep Learning for Everything," Journal of Omniscience, vol. 42, no. 7, pp. 1–10, 2020, doi: 10.1000/j.jo.2020.01.001.';
const bibtex = citationToBibtex("ieee", ieeeCitation);
console.log(bibtex);

const apaCitation = convertCitation("ieee", "apa7", ieeeCitation);
console.log(apaCitation);

Book / conference / web examples (see examples/bookAndWebExamples.ts):

const bookRef = new Reference({
    entryType: "book",
    citeKey: "turing1950",
    title: "Computing Machinery and Intelligence",
    authors: ["Alan M. Turing"],
    publisher: "Oxford University Press",
    place: "Oxford, UK",
    year: "1950",
    edition: "2nd ed.",
    pages: "1-120",
    doi: "10.1000/book.1950.01",
});

const confRef = new Reference({
    entryType: "inproceedings",
    citeKey: "doe2023conf",
    title: "Neural Widgets for Everything",
    authors: ["John Doe", "Jane Smith"],
    eventTitle: "Proceedings of the 40th International Neural Conference",
    eventLocation: "Berlin, Germany",
    publisher: "Neural Press",
    year: "2023",
    pages: "101-110",
    doi: "10.1000/conf.2023.101",
});

console.log(formatApa(bookRef));
console.log(formatIeee(confRef));

Scripts

• yarn build — compile to dist/
• yarn test — run vitest unit tests
• yarn example:format — format a sample BibTeX entry into all styles
• yarn example:citations — parse APA/IEEE citations back to BibTeX
• run other examples via yarn ts-node examples/bookAndWebExamples.ts
• convert between styles via yarn ts-node examples/convertCitationStyles.ts

Files published

Only dist/, README.md, and LICENSE are shipped in the npm package.