A simple referenceable list library for Typst. If you ever wanted to reference elements in a list by a key, this library is for you. The name comes from “reflist” but sorted alphabetically because we are not allowed to use descriptive names for packages in Typst 🤷🏻♂️.
Example
#import "@preview/efilrst:0.4.0" as efilrst
#show ref: efilrst.show-rule
#let constraint = efilrst.reflist.with(
name: "Constraint",
list-style: "C1.1.1)",
ref-style: "C1.1.1")
#constraint(
counter-name: "continuable",
[My cool constraint A],<c:a>,
[My also cool constraint B],<c:b>,
[My non-referenceable constraint C],
)
See how my @c:a is better than @c:b but not as cool as @c:e.
#constraint(
counter-name: "continuable",
[We continue the list with D],<c:d>,
[And then add constraint E],<c:e>,
)
#constraint(
[This is a new list!],<c:f>,
(
[And it has a sublist!],<c:g>,
[With a constraint H],<c:h>,
)
)
#constraint(
[This is another list!],<c:i>,
)
This generates the following output:

To reference several elements at once, use refs. Like LaTeX’s cleveref, it shows the plural name once and joins the numbers:
#efilrst.refs(<c:a>, <c:b>, <c:e>) // Constraints C1, C2 and C5
Reference
reflist(
..children,
name: "",
name-plural: auto,
list-style: "1.1.1)",
ref-style: "1.1.1",
counter-name: auto,
start: 1,
full: true,
ref-joiner: sym.space.nobreak,
)
children: Elements that will be part of the list. They can be given as acontentfollowed by alabelto reference them. If thelabelis not provided, it cannot be referenced. If an array is provided (e.g.,([Content], <label1>, [Content], <label2>)), the elements will be part of a sublist. Sublists can be nested but they will always require at least one parent element where the sublist will be attached to.name: Name of the list. This will be used to reference the list.list-style: Style of the list. It will be used to generate the list numbers.ref-style: Style of the references. It will be used to generate the numbers of the references.counter-name: Name of the counter that will be used to generate the numbers. Ifautois provided,efilrstwill choose a non-colliding name. If a name is provided and is the same as the name of a previous list, the counter will continue from the last number of the previous list.start: Number from which the list will start.full: Iftrue, the full reference will be shown. Iffalse, only the number will be shown.ref-joiner: Symbol used to join the name of the reference and the reference itself. By default, a non-breaking space is added to mimic the default behaviour of typst for references. E.g., for a reference namedConstraintand a referenceC1it generates[Constraint~C1]. To disable it, passnone.name-plural: Plural ofname, used byrefs. Ifauto, ansis appended toname(e.g.,ConstraintbecomesConstraints); an empty ornonename stays as is.
refs(..labels, separator: ", ", last: " and ")
labels: Labels of the elements to reference. If they all share the samename-plural, it is shown once followed by the numbers (e.g.,Constraints C1, C2 and C4), each linked to its element. Otherwise, or with a single label, the individual references are joined (e.g.,Constraint C1 and Property P2). Repeated labels are shown once. The grouped reference uses theref-joinerof the first element. Astrplural and acontentplural are never grouped together.separator: Separator between the references.last: Separator between the last two references. E.g., pass", and "for a serial comma.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Changelog
0.4.0
- Add
refsto reference several elements at once (e.g.,Constraints C1, C2 and C4) and thename-pluraloption ofreflist.
0.3.3
- Do not add a space when no name is given.
- Fix resuming the counter not working properly when the previous list has a sublist.
0.3.2
- Fix package not working due to using the wrong variable name
0.3.1
- Fix bad numbering #1
- Add option to have a non-breaking space between the name of the reference and the reference itself #2
0.3.0
- Add support for nested lists
0.2.0
- Add continuation of lists through the
counterfunction
0.1.0
- Initial release