libra:0.1.0 (#2861)

Author: mentonin

packages/preview/libra/0.1.0/LICENSE

@@ -0,0 +1,21 @@
+# The `libra` Package
+<div align="center">Version 0.1.0</div>
+
+Offers a single function, `balance`, which balances the lines of a given text.
+It is most useful for balancing especially laid-out text such as headings or captions.
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="./thumbnail-dark.svg">
+  <img src="./thumbnail-light.svg">
+</picture>
+
+## Getting Started
+
+These instructions will get you a copy of the project up and running on the typst web app.
+For more details, check out the [manual](docs/manual.pdf).
+
+```typst
+#import "@preview/libra:0.1.0": balance
+
+#balance(lorem(20))
+```

packages/preview/libra/0.1.0/README.md

@@ -0,0 +1,55 @@
+/// Balances text, useful for headings, captions, centered text, or others.
+
+/// Balances lines of text while keeping the minimum amount of lines possible.
+/// Works by shrinking the width of the text until it can't be shrunk anymore.
+///
+/// Unbalanced text:
+/// #example(```
+///   #rect(width: 25em, lorem(10))
+/// ```)
+///
+/// Balanced text:
+/// #example(```
+///   #rect(width: 25em, balance(lorem(10)))
+/// ```)
+///
+/// -> content
+#let balance(
+  /// The text to balance. -> content
+  body,
+  /// Maximum number of iterations to perform. -> int
+  max-iterations: 20,
+  /// The precision to which to balance. -> length
+  precision: 0.1em,
+) = context layout(size => {
+  set text(hyphenate: par.justify) if text.hyphenate == auto
+  let lead = par.leading.to-absolute()
+  let line-height = measure(body).height + lead
+  let initial-size = measure(width: size.width, body)
+  let initial-lines = (initial-size.height + lead) / line-height
+
+  let high = initial-size.width
+  let low = high * (1 - (1 / initial-lines)) / 2
+
+  let extra-lines = initial-lines
+  for i in range(0, max-iterations) {
+    let candidate = high - (high - low) / (extra-lines + 1)
+    set par(justify: false)
+    let (height, width) = measure(width: candidate, body)
+    if height > initial-size.height {
+      low = candidate
+      extra-lines = (height - initial-size.height) / line-height
+    } else {
+      high = width
+      if measure(width: width - precision, body).height > initial-size.height {
+        break
+      }
+      high -= precision.to-absolute()
+    }
+    if high - low < precision.to-absolute() {
+      break
+    }
+  }
+
+  box(width: high, body + if par.justify { linebreak(justify: true) })
+})

packages/preview/libra/0.1.0/docs/manual.pdf

@@ -0,0 +1,25 @@
+# for a description of available keys, see https://github.com/typst/packages/?tab=readme-ov-file#package-format
+
+[package]
+name = "libra"
+version = "0.1.0"
+entrypoint = "src/lib.typ"
+authors = [
+  "Luiz Georg <https://github.com/mentonin>",
+]
+license = "GPL-3.0-or-later"
+description = "Balance your lines."
+repository = "https://github.com/mentonin/libra"
+keywords = ["balanced"]
+categories = ["layout"]
+
+exclude = [
+  ".github",
+  "docs",
+  "scripts",
+  "tests",
+  ".typstignore",
+  "Justfile",
+  "thumbnail-dark.svg",
+  "thumbnail-light.svg",
+]