Prepare 0.4.2 (#958)

johannes-wolf · web-flow · commit a696e0afc4b1 · 2025-09-07T19:13:59.000+02:00
* tree: Bump version to 0.4.2

* gallery: Update images

* n-star: Panic if the radius type is wrong
diff --git a/CHANGES.md b/CHANGES.md
@@ -6,7 +6,7 @@
 - Added the shortcut `>>` for the `stealth` mark (#941)
 - Fixed a division by zero bug when placing marks on zero-length paths (#936)
 - Added `"near"` and `"far"` directions to the `angle` API (#945)
-- Added missing `register-mark` and `register-coordinate-resolvea` API to the docs (#932)
+- Added missing `register-mark` and `register-coordinate-resolver` API to the docs (#932)
 - Fixed element access inside `compound-path` (#932)
 - The `tangent` coordinate now supports ellipses (#925)
 - Grid lines now correctly connect at the corners (#921)
diff --git a/README.md b/README.md
@@ -78,7 +78,7 @@ For information, see the [online manual](https://cetz-package.github.io/docs).
 To use this package, simply add the following code to your document:
 
 ```typ
-#import "@preview/cetz:0.4.1"
+#import "@preview/cetz:0.4.2"
 
 #cetz.canvas({
   import cetz.draw: *
@@ -102,7 +102,7 @@ just install
 The installed version can be imported by prefixing the package name with `@local`.
 
 ```typ
-#import "@local/cetz:0.4.1"
+#import "@local/cetz:0.4.2"
 
 #cetz.canvas({
   import cetz.draw: *
diff --git a/docs/getting-started.mdx b/docs/getting-started.mdx
@@ -8,7 +8,7 @@ sidebar_position: 1
 This is the minimal starting point in a `.typ` file:
 
 ```typ
-#import "@preview/cetz:0.4.1"
+#import "@preview/cetz:0.4.2"
 #cetz.canvas({
   import cetz.draw: *
   ...
diff --git a/docs/tutorials/karl.mdx b/docs/tutorials/karl.mdx
@@ -20,7 +20,7 @@ In CeTZ, to draw a picture, two imports and a function call is all you need. Kar
 
 ```typ
 #set page(width: auto, height: auto)
-#import "@preview/cetz:0.4.1"
+#import "@preview/cetz:0.4.2"
 
 We are working on
 #cetz.canvas({
diff --git a/gallery/karls-picture.png b/gallery/karls-picture.png
diff --git a/gallery/karls-picture.typ b/gallery/karls-picture.typ
@@ -1,4 +1,4 @@
-#import "@preview/cetz:0.4.1"
+#import "@preview/cetz:0.4.2"
 #set page(width: auto, height: auto, margin: .5cm)
 
 #show math.equation: block.with(fill: white, inset: 1pt)
diff --git a/gallery/paciolis.typ b/gallery/paciolis.typ
@@ -1,5 +1,5 @@
 // Example by @samuelireson
-#import "@preview/cetz:0.4.1": canvas, draw, tree
+#import "@preview/cetz:0.4.2": canvas, draw, tree
 
 #set page(width: auto, height: auto, margin: .5cm)
 
diff --git a/gallery/periodic-table.png b/gallery/periodic-table.png
diff --git a/gallery/periodic-table.typ b/gallery/periodic-table.typ
@@ -1,6 +1,6 @@
 // Copied from https://github.com/janosh/tikz/blob/da1b4582/assets/periodic-table/periodic-table.typ
 
-#import "@preview/cetz:0.4.1": canvas, draw
+#import "@preview/cetz:0.4.2": canvas, draw
 
 #set page(width: auto, height: auto, margin: 15pt)
 
diff --git a/gallery/plate-capacitor.typ b/gallery/plate-capacitor.typ
@@ -1,6 +1,6 @@
 // Copied from https://github.com/janosh/tikz/blob/87754ea/assets/plate-capacitor/plate-capacitor.typ
 
-#import "@preview/cetz:0.4.1": canvas, draw
+#import "@preview/cetz:0.4.2": canvas, draw
 #import draw: line, rect, content, bezier, group, anchor
 
 #set page(width: auto, height: auto, margin: 5pt)
diff --git a/gallery/torus.typ b/gallery/torus.typ
@@ -1,6 +1,6 @@
 // From https://forum.typst.app/t/how-to-best-draw-a-3d-torus/4744/4
 // Note: current settings use about 2 GiB of RAM and 20 s of compilation time.
-#import "@preview/cetz:0.4.1"
+#import "@preview/cetz:0.4.2"
 
 #set page(width: auto, height: auto, margin: 0.6pt)
 
diff --git a/gallery/tree.typ b/gallery/tree.typ
@@ -1,4 +1,4 @@
-#import "@preview/cetz:0.4.1": canvas, draw, tree
+#import "@preview/cetz:0.4.2": canvas, draw, tree
 
 #set page(width: auto, height: auto, margin: .5cm)
 
diff --git a/gallery/waves.png b/gallery/waves.png
diff --git a/gallery/waves.typ b/gallery/waves.typ
@@ -1,4 +1,4 @@
-#import "@preview/cetz:0.4.1": canvas, draw, vector, matrix
+#import "@preview/cetz:0.4.2": canvas, draw, vector, matrix
 
 #set page(width: auto, height: auto, margin: .5cm)
 
diff --git a/src/draw/shapes.typ b/src/draw/shapes.typ
@@ -709,7 +709,7 @@
 /// ## Styling
 /// Root: nstar
 /// - radius (number): The radius of the star's outer points.
-/// - inner-radius (number,ratio): The radius (relative to the outer radius) of the star's inner points(relative to the outer radius) of the star's inner points.
+/// - inner-radius (number,ratio): The radius (if of type ratio, relative to the outer radius) of the star's inner points of the star's inner points.
 /// - show-inner (bool) = false: If true, also draws the inner polygon connecting the star's inner points.
 /// - fill (color, gradient): The fill color for the star.
 /// - stroke (color, thickness, ...): The stroke for the star and the inner polygon.
@@ -722,6 +722,9 @@
     let anchors = ()
 
     let style = styles.resolve(ctx.style, merge: style, root: "n-star")
+    if type(style.radius) == array {
+      panic("n-star: Expected a single radius, got an array. Note: You can pass the inner radius as `inner-radius:` to n-star.")
+    }
 
     let (ctx, origin) = coordinate.resolve(ctx, origin)
     let outer-radius = util.resolve-number(ctx, style.radius)
diff --git a/src/version.typ b/src/version.typ
@@ -1 +1 @@
-#let version = version(0,4,1)
+#let version = version(0,4,2)
diff --git a/typst.toml b/typst.toml
@@ -1,6 +1,6 @@
 [package]
 name = "cetz"
-version = "0.4.1"
+version = "0.4.2"
 compiler = "0.13.1"
 repository = "https://github.com/cetz-package/cetz"
 homepage = "https://cetz-package.github.io/"

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-#import "@preview/cetz:0.4.1"`
	`1`	`+#import "@preview/cetz:0.4.2"`
`2`	`2`	`#set page(width: auto, height: auto, margin: .5cm)`
`3`	`3`
`4`	`4`	`#show math.equation: block.with(fill: white, inset: 1pt)`