auto-bihua 0.2.0 – Typst Universe

Stroke count, stroke order, and stroke-based sorting for Chinese characters in Typst. Wraps a Rust → WASM plugin with compile-time lookup tables for Unihan kTotalStrokes (~103,000 CJK characters), cnchar stroke order (6,939 simplified characters), and the GB13000.1 national stroke-order standard (20,902 characters, digit form).

API	Returns
`bihua-count(chars, split: false)`	total stroke count, or per-character array
`bihua-order(char, style: "digit")`	stroke order in 4 styles
`bihua-sort(items)`	array sorted by stroke count, then stroke order
`version()`	version + data-source info

English

Installation

#import "@preview/auto-bihua:0.2.0": *

`bihua-count`

Stroke count of one or more Chinese characters.

#bihua-count("汉字")                  // → 11
#bihua-count("汉字", split: true)     // → (5, 6)
#bihua-count("龘")                    // → 48
#bihua-count("Hello 世界", split: true)
// → (none, none, none, none, none, none, 5, 9)
#bihua-count("漢字")                  // → 20  (traditional supported)
#bihua-count("")                      // → 0

chars accepts str or content (Typst text content with a .text field).
Non-Chinese characters contribute 0 to the total, and none in split mode.
Counts come from Unihan, so coverage extends to traditional characters and CJK extensions.

`bihua-order`

Stroke order of a single character. Four output styles:

#bihua-order("汉")                       // "44154"          (digit, default)
#bihua-order("汉", style: "name")        // ("点","点","提","横撇","捺")
#bihua-order("汉", style: "shape")       // ("丶","丶","㇀","㇇","㇏")
#bihua-order("汉", style: "letter")      // "kkiel"          (raw cnchar code)

Style	Output	Use case
`digit`	string of `1`–`5`	GB13000 standard: 1=横 2=竖 3=撇 4=点 5=折. Use as a comparable sort key.
`name`	array of strings	Display: 横折钩, 横撇, 竖弯钩, …
`shape`	array of strings	Display Unicode stroke glyphs (`㇏`, `㇇`, `丿`, …).
`letter`	string	The 26-letter cnchar encoding, finer-grained than digit.

Errors and edge cases:

Passing a multi-character string panics. Iterate yourself if needed.
Coverage differs by style. digit spans the full GB13000.1 basic block (20,902 chars — traditional Hanzi and single-stroke radicals like 丿, 丶 included). name / shape / letter cover only the 6,939 simplified chars in cnchar, since GB13000.1 encodes just the 5-class digit, not the fine stroke type.
Characters outside that coverage (CJK extension chars, non-Hanzi) return "" for string styles and () for array styles — a stroke count may still exist (from Unihan) even when the order does not.

`bihua-sort`

Sort an array of strings (or contents) by stroke count, then by stroke order as tiebreaker. Comparison is character-by-character, mirroring the standard Chinese-publishing convention of “first by total strokes, then by stroke type.”

#bihua-sort(("汉","字","人","一","乙","二"))
// → ("一", "乙", "二", "人", "汉", "字")

#bihua-sort(("人民","汉字","一二","北京","上海","天津"))
// → ("一二", "人民", "上海", "天津", "北京", "汉字")

Items with characters outside both data sets sort to the end.
Tiebreaker uses the GB13000 digit sequence (not the raw cnchar letter encoding), so 提 sorts before 竖 as the standard prescribes.

Real-world recipes

Sort Chinese author names by surname strokes (common journal style):

#bihua-sort(("王伟","李娜","张敏","刘洋","陈静","杨磊","黄勇","赵丽","周强","吴芳"))
// → ("王伟","刘洋","李娜","杨磊","吴芳","张敏","陈静","周强","赵丽","黄勇")

Stroke order card for character study:

#let card(c) = block(
  stroke: 0.5pt + gray, inset: 8pt, radius: 4pt,
  [
    *#text(24pt, c)* #h(1em) #bihua-count(c) strokes \
    #bihua-order(c, style: "name")
      .enumerate()
      .map(((i, n)) => [#(i+1).#n])
      .join("  ")
  ]
)
#card("永")

Index a glossary by first-character stroke count:

#let terms = ("汉字","人民","一致","中国","北京","笔画")
#let groups = (:)
#for t in bihua-sort(terms) {
  let n = str(bihua-count(t.first()))
  groups.insert(n, groups.at(n, default: ()) + (t,))
}
#table(columns: 2,
  ..groups.pairs().map(((n, ts)) => (n + " 画", ts.join("、"))).flatten()
)

Data sources

Stroke count: Unicode 17.0 Unihan_IRGSources.txt, field kTotalStrokes (~103k CJK code points, includes traditional and CJK extensions).
Stroke order (name / shape / letter): cnchar package’s stroke-order-jian.json (6,939 simplified characters), MIT license.
Stroke order (digit): additionally the GB13000.1 字符集汉字笔顺规范 (GF 3002-1999) national standard, 20,902 characters, as digitised by yindian/hzbishun. Used as a fallback for the digit style and sort key wherever cnchar has no entry.
Stroke type encoding: cnchar’s 26-letter alphabet, projected to the GB13000 5-type system at lookup time.

Building from source

cd wasm
rustup target add wasm32-unknown-unknown
cargo build --release
cp target/wasm32-unknown-unknown/release/auto_bihua.wasm ../auto-bihua.wasm

Or with just: just build. The data files are processed by build.rs into static phf maps at compile time, so no runtime parsing.

Limitations

The name / shape / letter styles cover only the ~6,939 simplified characters in cnchar. For traditional Hanzi and other basic-block chars outside that set, only the digit style is available.
CJK extension characters (outside U+4E00–U+9FA5) have a stroke count from Unihan but no stroke order in any style.

Acknowledgements

yindian/hzbishun — for digitising the GB13000.1 / GF 3002-1999 national stroke-order standard, which powers the 20,902-character digit coverage.
cnchar — simplified-character stroke order and the stroke-type alphabet behind the name / shape / letter styles.

License

MIT. Data licenses: Unihan (Unicode terms), cnchar (MIT). Digit stroke-order data derives from the GB13000.1 / GF 3002-1999 national standard (factual data; see Acknowledgements).

中文

安装

#import "@preview/auto-bihua:0.2.0": *

`bihua-count` — 笔画数

输入单字或多字，返回总笔画数（默认）或按字拆分的数组。

#bihua-count("汉字")                  // → 11
#bihua-count("汉字", split: true)     // → (5, 6)
#bihua-count("龘")                    // → 48
#bihua-count("Hello 世界", split: true)
// → (none, none, none, none, none, none, 5, 9)
#bihua-count("漢字")                  // → 20  （繁体也支持）
#bihua-count("")                      // → 0

参数 chars 接受字符串或带 .text 字段的 content。
非汉字字符在总和模式贡献 0，在 split 模式返回 none。
数据来源是 Unihan，覆盖繁体字和 CJK 扩展区。

`bihua-order` — 笔顺

输入单个汉字，返回其笔顺。四种输出风格：

#bihua-order("汉")                       // "44154"          （数字, 默认）
#bihua-order("汉", style: "name")        // ("点","点","提","横撇","捺")
#bihua-order("汉", style: "shape")       // ("丶","丶","㇀","㇇","㇏")
#bihua-order("汉", style: "letter")      // "kkiel"          （cnchar 原始字母编码）

风格	输出	用途
`digit`	`1`–`5` 数字串	GB13000 五笔位：1=横 2=竖 3=撇 4=点 5=折，可直接作为排序键。
`name`	字符串数组	显示：横折钩、横撇、竖弯钩 ……
`shape`	字符串数组	显示笔形 Unicode 字符（`㇏`、`㇇`、`丿` ……）。
`letter`	字符串	cnchar 26 字母编码，比数字风格更细。

异常与边界：

传入多字字符串会 panic，请自行逐字遍历。
各风格覆盖范围不同。digit 覆盖 GB13000.1 基本区全部 20902 字（含繁体字、 丿/丶 等单笔部首）；name/shape/letter 仅覆盖 cnchar 的 6939 简体字，因为 GB13000.1 只给五类数字、没有细笔形。
超出该范围的字符（CJK 扩展区、非汉字）：字符串风格返回 ""，数组风格返回 ()——但笔画数（来自 Unihan）可能仍然存在。

`bihua-sort` — 笔画排序

对字符串（或 content）数组按笔画数排序，同笔画数时按笔顺数字序为次要键。逐字比较，与中文出版界"先比总画数，同画数比笔形"的惯例一致。

#bihua-sort(("汉","字","人","一","乙","二"))
// → ("一", "乙", "二", "人", "汉", "字")

#bihua-sort(("人民","汉字","一二","北京","上海","天津"))
// → ("一二", "人民", "上海", "天津", "北京", "汉字")

包含两份数据都不收录字符的项会排到末尾。
次要键使用 GB13000 五笔位数字序（而非 cnchar 字母字典序），所以提排在竖之前，符合国标顺序。

实战用法

中文作者按姓氏笔画排序（中文期刊投稿常用规范）：

#bihua-sort(("王伟","李娜","张敏","刘洋","陈静","杨磊","黄勇","赵丽","周强","吴芳"))
// → ("王伟","刘洋","李娜","杨磊","吴芳","张敏","陈静","周强","赵丽","黄勇")

笔顺展示卡片（适合识字教材）：

#let card(c) = block(
  stroke: 0.5pt + gray, inset: 8pt, radius: 4pt,
  [
    *#text(24pt, c)* #h(1em) 共 #bihua-count(c) 画 \
    #bihua-order(c, style: "name")
      .enumerate()
      .map(((i, n)) => [#(i+1).#n])
      .join("  ")
  ]
)
#card("永")

词条按首字笔画分组建索引：

#let terms = ("汉字","人民","一致","中国","北京","笔画")
#let groups = (:)
#for t in bihua-sort(terms) {
  let n = str(bihua-count(t.first()))
  groups.insert(n, groups.at(n, default: ()) + (t,))
}
#table(columns: 2,
  ..groups.pairs().map(((n, ts)) => (n + " 画", ts.join("、"))).flatten()
)

数据来源

笔画数：Unicode 17.0 Unihan_IRGSources.txt，字段 kTotalStrokes （约 10.3 万 CJK 码位，含繁体与扩展区）。
笔顺（name / shape / letter）：cnchar 项目的 stroke-order-jian.json （6939 简体字），MIT 协议。
笔顺（digit）：另叠加《GB13000.1 字符集汉字笔顺规范》（GF 3002-1999）国标，20902 字，数字化版本取自 yindian/hzbishun；仅在 cnchar 未收录时作为 digit 风格与排序键的兜底。
笔形编码：cnchar 26 字母方案，查询时映射到 GB13000 五类。

从源码构建

cd wasm
rustup target add wasm32-unknown-unknown
cargo build --release
cp target/wasm32-unknown-unknown/release/auto_bihua.wasm ../auto-bihua.wasm

或用 just build。build.rs 在编译期把数据文件转成静态 phf 表，运行时零解析开销。

已知限制

name/shape/letter 三种风格只覆盖 cnchar 的约 6939 个简体字。繁体字及基本区其它字只有 digit 风格可用。
CJK 扩展区字符（U+4E00–U+9FA5 之外）有 Unihan 笔画数，但任何风格都没有笔顺。

致谢

yindian/hzbishun —— 数字化了 GB13000.1 / GF 3002-1999 国标笔顺，本包 20902 字的 digit 覆盖赖此实现。
cnchar —— 简体字笔顺与笔形字母方案，支撑 name / shape / letter 三种风格。

许可

MIT。数据：Unihan（Unicode 协议）、cnchar（MIT）。digit 笔顺数据源自 GB13000.1 / GF 3002-1999 国标（事实性数据，见致谢）。

How to add

Copy this into your project and use the import as auto-bihua

#import "@preview/auto-bihua:0.2.0"

Check the docs for more information on how to import packages.

About

Author:

SchrodingerBlume

License:

MIT

Current version:

0.2.0

Last updated:

August 4, 2026

First released:

May 21, 2026

Minimum Typst version:

0.13.0

Archive size:

654 kB

Categories:

Explore more packages by SchrodingerBlume

Where to report issues?

This package is a project of SchrodingerBlume. You can also try to ask for help with this package on the Forum.

Please report this package to the Typst team using the contact form if you believe it is a safety hazard or infringes upon your rights.

Version history

Version	Release Date
0.2.0	August 4, 2026
0.1.0	May 21, 2026

Typst GmbH did not create this package and cannot guarantee correct functionality of this package or compatibility with any version of the Typst compiler or app.

auto-bihua