blockst:0.1.0 by Loewe1000 · Pull Request #4389 · typst/packages

Loewe1000 · 2026-03-17T17:33:04Z

I am submitting

a new package
an update for a package

Description: Blockst renders Scratch-style programming blocks directly in Typst documents. It is useful for worksheets, teaching materials, tutorials, and visual explanations of programming concepts.

The package provides:

block rendering for Scratch-like scripts
support for nested control structures, reporters, operators, variables, lists, and custom blocks
localized language APIs for German, English, and French
Scratch-Run helpers for executable turtle-graphics style drawings

I tested the package locally and included documentation, examples, license information, and package metadata required for submission.

I have read and followed the submission guidelines and, in particular, I

selected a name that isn't the most obvious or canonical name for what the package does
added a typst.toml file with all required keys
added a README.md with documentation for my package
have chosen a license and added a LICENSE file or linked one in my README.md
tested my package locally on my system and it worked
excluded PDFs or README images, if any, but not the LICENSE

elegaanz

Thank you for the package. I have left some comments :)

elegaanz · 2026-03-20T08:53:04Z

+
+---
+
+## Project Structure


I'm not sure this section is so relevant to people wanting to use the package, who will be reading this README on Typst Universe.

Good point! The "Project Structure", "Extensibility", "Adding a New Language", and the full function reference sections have been removed from the README. It now focuses purely on usage: quick start, examples, and the block catalog. Internal architecture details are better suited for the repository wiki or source comments.

elegaanz · 2026-03-20T08:56:15Z

+#import "@preview/blockst:0.1.0": blockst, scratch
+
+#blockst[
+  #import scratch.de: *


Some examples use English, some others German. I think it would be best to stick to English and only showcase German and French in a single example, to show people that this alternative API exists and what it looks like.

Fixed! The README has been fully restructured. All examples now use English, with a single dedicated "German & French Localization" section that shows both localised APIs side by side, so readers can see what the alternative looks like without it dominating the examples.

elegaanz · 2026-03-20T08:57:12Z

+
+---
+
+## Available Categories


I think these functions should be document in English if only in one language. Otherwise, having the full reference in the three language could be a possibility.

The per-language function lists (the old "Available Categories" section listing gehe(schritte:) / move(steps:) etc.) have been replaced by a visual block catalog. Each category now has an expandable <details> section with an SVG showing all blocks with their English function signatures. This covers the full English reference visually, without duplicating three language variants in plain text.

elegaanz · 2026-03-20T09:00:40Z

"Definiere" seems to be in German here, I'm not sure why.

Good catch — this was a bug: the define() / definiere() block had the verb hardcoded as German ("Definiere") in the rendering layer instead of going through the translation system. It's now fixed: the label is looked up from the TOML translation files, so French uses "Définir", English uses "Define", and German uses "Definiere".

elegaanz · 2026-03-20T09:02:16Z

+      #avancer(pas: 10)
+      #si-alors-sinon(
+        toucher-objet("bord"),
+        [#tourner-à-droite(degres: 180)],


Is there a reason some calls are wrapped in a content block (i.e [#function()] instead of #function())?

Yes, there was a reason — but it was actually unnecessary and has been cleaned up. The [#function()] content block syntax was used to group multiple statements in branches, but single-statement calls don't need it. The examples and documentation now consistently use #function() directly for single statements, and only [#a() #b()] when multiple statements need to be grouped. A dedicated example ("Content Blocks: When to Use [...]") in the README explains the distinction.

…ock catalog

…ic Sans example

elegaanz

Thank you for taking my remarks into account. I just added a small remark about the example you just added, once it's fixed it should be good to be merged.

elegaanz · 2026-03-24T09:55:58Z

+#set-blockst(font: "Comic Sans MS")
+
+#blockst[
+  #import "../libs/scratch/lang/en.typ": *


This should import scratch.en: * too I think.

elegaanz · 2026-03-24T12:16:06Z

Thank you!

Add blockst 0.1.0

b02ede3

Loewe1000 temporarily deployed to Package Check March 17, 2026 17:33 — with GitHub Actions Inactive

typst-package-check bot changed the title ~~blockst 0.1.0~~ blockst:0.1.0 Mar 17, 2026

typst-package-check bot added the new A new package submission. label Mar 17, 2026

Exclude examples from blockst package

d1c78ef

Loewe1000 temporarily deployed to Package Check March 17, 2026 18:51 — with GitHub Actions Inactive

Use package imports in blockst examples

5495fd5

Loewe1000 temporarily deployed to Package Check March 17, 2026 18:54 — with GitHub Actions Inactive

saecki assigned elegaanz Mar 19, 2026

elegaanz reviewed Mar 20, 2026

View reviewed changes

Address review feedback: restructure README, fix translations, add bl…

1f8c249

…ock catalog

Loewe1000 temporarily deployed to Package Check March 22, 2026 01:05 — with GitHub Actions Inactive

Add font param to set-blockst, fix say-for-secs dropdown bug, add Com…

1b8cd1f

…ic Sans example

Loewe1000 temporarily deployed to Package Check March 22, 2026 01:31 — with GitHub Actions Inactive

Update example-font.typ

3a4a29b

Loewe1000 temporarily deployed to Package Check March 22, 2026 11:22 — with GitHub Actions Inactive

elegaanz reviewed Mar 24, 2026

View reviewed changes

Fix import in example-font.typ to use scratch.en

67a8917

Loewe1000 temporarily deployed to Package Check March 24, 2026 12:01 — with GitHub Actions Inactive

Import scratch in example-font.typ

da24fa7

Loewe1000 temporarily deployed to Package Check March 24, 2026 12:03 — with GitHub Actions Inactive

elegaanz merged commit 719ac26 into typst:main Mar 24, 2026
3 checks passed

Conversation

Loewe1000 commented Mar 17, 2026

Uh oh!

elegaanz left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Loewe1000 Mar 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

elegaanz left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

elegaanz commented Mar 24, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Loewe1000 Mar 22, 2026 •

edited

Loading