fletcher (noun) a maker of arrows
A Typst package for drawing diagrams with arrows, built on top of CeTZ. See the manual for documentation.
#import "@preview/fletcher:0.4.4" as fletcher: diagram, node, edge
#diagram(cell-size: 15mm, $
G edge(f, ->) edge("d", pi, ->>) & im(f) \
G slash ker(f) edge("ur", tilde(f), "hook-->")
$)
// https://xkcd.com/1195/
#import fletcher.shapes: diamond
#set text(font: "Comic Neue", weight: 600)
#diagram(
node-stroke: 1pt,
edge-stroke: 1pt,
node((0,0), [Start], corner-radius: 2pt, extrude: (0, 3)),
edge("-|>"),
node((0,1), align(center)[
Hey, wait,\ this flowchart\ is a trap!
], shape: diamond),
edge("d,r,u,l", "-|>", [Yes], label-pos: 0.1)
)
#set text(10pt)
#diagram(
node-stroke: .1em,
node-fill: gradient.radial(blue.lighten(80%), blue, center: (30%, 20%), radius: 80%),
spacing: 4em,
edge((-1,0), "r", "-|>", `open(path)`, label-pos: 0, label-side: center),
node((0,0), `reading`, radius: 2em),
edge(`read()`, "-|>"),
node((1,0), `eof`, radius: 2em),
edge(`close()`, "-|>"),
node((2,0), `closed`, radius: 2em, extrude: (-2.5, 0)),
edge((0,0), (0,0), `read()`, "--|>", bend: 130deg),
edge((0,0), (2,0), `close()`, "-|>", bend: -40deg),
)
#diagram($
e^- edge("rd", "-<|-") & & & edge("ld", "-|>-") e^+ \
& edge(gamma, "wave") \
e^+ edge("ru", "-|>-") & & & edge("lu", "-<|-") e^- \
$)
Pull requests are most welcome!
|
|
|
|
|
- Support fully customisable marks/arrowheads!
- Added new mark styles and tweaked some existing defaults. Note. This may change the micro-typography of diagrams from previous versions.
- Add node groups via the
enclose
option ofnode()
. - Node labels can be aligned inside the node with
align()
. - Node labels wrap naturally when label text is wider than the node. Note: This may change diagram layout from previous versions.
- Add a
layer
option to nodes and edges to control drawing order. - Add node shapes:
ellipse
,octagon
.
- Fixed edge crossing backgrounds being drawn above nodes (#14).
- Added
fletcher.hide()
to hide elements with/without affecting layout, useful for incremental diagrams in slides (#15). - Support
shift
ing edges by coordinate deltas as well as absolute lengths (#13). - Support node names (#8).
- Improve edge-to-node snapping. Edges can terminate anywhere near a node (not just at its center) and will automatically snap to the node outline. Added
snap-to
option toedge()
. - Fixed node
inset
being half the amount specified. If upgrading from previous version, you will need to divide nodeinset
values by two to preserve diagram layout. - Add
decorations
option toedge()
for CeTZ path decorations ("wave"
,"zigzag"
, and"coil"
, also accepted as positional string arguments).
- Support custom node shapes! Edges connect to node outlines automatically.
- New
shapes
submodule, containingdiamond
,pill
,parallelogram
,hexagon
, and other node shapes.
- New
- Allow edges to have multiple segments.
- Add
vertices
ancorner-radius
options toedge()
. - Relative coordinate shorthands may be comma separated to signify multiple segments, e.g.,
"r,u,ll"
.
- Add
- Add
dodge
option toedge()
to adjust end points. - Support
cetz:0.2.0
.
- Add ability to specify diagrams in math-mode, using
&
to separate nodes. - Allow implicit and relative edge coordinates, e.g.,
edge("d")
becomesedge(prev-node, (0, 1))
. - Add ability to place marks anywhere along an edge. Shorthands now accept an optional middle mark, for example
|->-|
andhook-/->>
. - Add “hanging tail” correction to marks on curved edges. Marks now rotate a bit to fit more comfortably along tightly curving arcs.
- Add more arrowheads for the sake of it:
}>
,<{
,/
,\
,x
,X
,*
(solid dot),@
(solid circle). - Add
axes
option todiagram()
to control the direction of each axis in the diagram's coordinate system. - Add
width
,height
andradius
options tonode()
for explicit control over size. - Add
corner-radius
option tonode()
. - Add
stroke
option toedge()
replacingthickness
andpaint
options. - Add
edge-stroke
option todiagram()
replacingedge-thickness
.
- Make round-style arrow heads better approximate the default math font.
- Add solid arrow heads with shorthand
<|-
,-|>
and double-bar||-
,-||
. - Add an
extrude
option tonode()
which duplicates and extrudes the node's stroke, enabling double stroke effects.
- Experimental support for customising arrowheads.
- Add right-angled edges with
edge(..., corner: left/right)
.