What is holding back a version 1.0 release

What are the criteria for reaching a 1.0 version?
Is there an estimated timeline for that milestone?

A 1.0 version doesn’t have to be feature-complete, but guarantees backward compatibility and reasonable deprecation protocol

To my knowledge there are several things that the team definitely wants to ship before 1.0. The most important include the math mode overhaul, custom types and type hints, overhaul of the styling system (including revokable set and show rules as well as some kind of fragment styling/composing (i don’t quite find the correct wording for this; but can recommend the talk about this.)).

You can also have a look at the roadmap which includes some of the points above: Roadmap - Typst Documentation

Iirc at some point there have been thoughts about removing the content type in the future. Some of the serious ideas for type hints would introduce fundamental syntax changes etc. Just as an example to make clear how substantial some of the ideas of the core developers are and that they want to put a good amount of effort into thinking through the future system.

These big chunks are by no means purely additive features but change the foundations for typst, so they should be set before 1.0.

And then there is also the question “What actually is backwards compatible in the sense of typesetting”? Almost every change influences the layout in some way.

On a side note: iirc laurenz mentioned at some point that in his opinion typst does not need to be final with a 1.x version. He likes the idea of semver. But he is inclined to work on a 2.0 version for typst after 1.x eventually iirc.

(I am just a bystander and don’t know anything about typst’s code base. I just picked up some of this information from blog posts, community calls and the discord server and I may well be misremembering some of these things entirely.)

(You may want to edit the post title so that it doesn’t bait people.)

3 Likes

Just for completeness: in this blog post, Laurenz addresses exactly that question. It is, in my eyes, the most authoritative answer you can expect.

Thanks

  • changed the title
  • I am familiar with the roadmap page. the most intriguing topic is “type hints”. Are there any initial proposals, partial specs for review?