MakrellTS
=========

MakrellTS is the JavaScript and TypeScript-hosted track of the Makrell family.

It brings Makrell ideas into:

* browser environments
* Node.js workflows
* JavaScript and TypeScript interop
* frontend and tooling ecosystems

Why use MakrellTS?
------------------

MakrellTS is a good fit when you want:

* a Makrell track that lives naturally in JS or TS environments
* access to browser and Node.js workflows
* a path that aligns with existing JavaScript and TypeScript tooling
* a family track that can be compared directly with the Python and `.NET`
  implementations

Recommended reading path
------------------------

If you are new to MakrellTS, a practical order is:

1. :doc:`quick-start`
2. :doc:`guide`
3. :doc:`cookbook`
4. :doc:`interop`
5. :doc:`metaprogramming`

Relationship to the rest of the family
--------------------------------------

MakrellTS is important both as a JavaScript and TypeScript implementation and
as a reference track for ongoing language evolution in the family.

Current emphasis
----------------

The current MakrellTS section focuses on:

* the JS/TS host environment
* CLI, build, and browser-oriented workflows
* JavaScript and TypeScript interop
* the family macro model as it appears in the TypeScript track

If you are deciding between implementations, MakrellTS is often the most
natural starting point when your surrounding project is already in TypeScript,
Node.js, or the browser.

.. toctree::
   :maxdepth: 2

   install
   quick-start
   guide
   cookbook
   cookbook-cli
   cookbook-browser
   cookbook-macros
   interop
   metaprogramming
   tooling
   status