refactor: backport changes from noatu's fork

feat(style)!: remove reference styling & fix figure numbering for appendices
feat!: swap appending on 'none' being the first position in ..sink
feat: add chapters to pz-lb()
feat: add asserts
fix: better control flow

img() function now requires `none` to be the first position in ..sink,
e.g. `#img("/fig/1.png", "Caption", none)` to get "Caption (рисунок виконано самостійно)" caption.

Use `@some_label[див. рис.]` to get a "див. рис. 42" link.

Signed-off-by: unexplrd <unexplrd@linerds.us>

.gitignore

@@ -1 +1 @@
-template.pdf
+*.pdf

README.md

@@ -1,13 +1,5 @@
 # Typst Template for NURE Works
-
-> [!WARNING]
-> This branch is using the Typst v0.13.0-rc1. To install it use the following command:
-> ```bash
-> cargo install --git https://github.com/typst/typst --branch 0.13 --locked typst-cli
-> ```
-
-## TODO
-- Add more information about the template.
+![pz-lb title page](assets/pz-lb_title_page.png)
 
 ## General Info
 
@@ -15,12 +7,12 @@ This project contains two template functions and some utilities for writing NURE
 
 ### Templates
 
-#### `pz-lb-template` - For Laboratory and Practical Works
+#### `pz-lb` - For Practice and Laboratory Works
 This template:
 - Sets up document styles;
-- Formats the title page according to NURE guidelines.
+- Formats the title page according to NURE/DSTU guidelines.
 
-#### `cw-template` - For Course Works
+#### `coursework` - For Course Works
 This template:
 - Sets up document styles;
 - Formats the title, task, calendar plan, and abstract pages;
@@ -35,34 +27,91 @@ This template:
 
 ## Usage
 
-To use the template, include it in your project and utilize the provided functions:
+### As a local typst package
+1. Clone this repository into ~/.local/share/typst/packages/:
+```bash
+git clone -b 0.1.0 https://gitea.linerds.us/pencelheimer/typst_nure_template.git ~/.local/share/typst/packages/local/nure/0.1.0
+```
+2. Init your project with Typst:
+```bash
+typst init @local/nure:0.1.0 project-name
+```
 
+### As a standalone file
+Copy `lib.typ` to your project's root directory.
+
+### In your project
 ```typst
-// Import the template
-#import "path/to/template.typ": *
+// Import the template either from a local package...
+#import "@local/nure:0.1.0": *
+// ...or by importing a lib.typ directly
+// #import "/lib.typ": *
 
-// Setup the document
-#show: pz-lb-template.with(
-    title: "Some title",
+// 1. Setup the document
+// by setting values directly...
+#show: pz-lb.with(
+  title: "Some title",
+  // etc: "and so on",
+  // ...
 )
+// ...or using a config/doc.yaml file
+#show: pz-lb.with(..yaml("config/doc.yaml"))
+
+// this template automatically inserts a `=title`
 
 // Write your content
-#v(-spacing)
+#v(-spacing) // remove spacing between headings
 == Purpose
 Some text
+
+// ...or include your modules
+#include "src/intro.typ"
+#include "src/chapter1.typ"
+#include "src/chapter2.typ"
+// NOTE: if you want to use variables or utils provided by the package,
+// you have to import the package or a lib.typ inside a module.
+
+
+// If you ever need appendices in pz-lb template use the show rule
+// WARNING: when using coursework template use its own argument,
+// so it can put bibliography before appendices
+#show: appendices-style
+
+= Quote
+#link("https://youtu.be/bJQj1uKtnus")[
+  The art isn't the art, the art is never the art,
+  the art is the thing that happens inside you when you make it and the feeling in the heart of the beholder.
+]
 ```
 
 ### Notes:
 1. Use `#v(-spacing)` to remove vertical spacing between titles (this cannot be automatically handled by the template). Variable `spacing` used here is imported from the template.
+2. When importing `@local/nure:0.1.0` and specifying file paths in functions handled by the package, the path will relative to package's root directory, e.g. setting `#show: coursework.with(bib_path: "bibl.yml")` will evaluate to `~/.local/share/typst/packages/local/nure/0.1.0/bibl.yml`, the same is for `#img` function, which makes it quite annoying and forces one to import `lib.typ` file. Please open an issue or contact us in any other way if you have any advice.
 
 ### Example Project Structure
 ```
-project-folder/
-├── main.typ
-├── template.typ
-├── images/
-│   ├── figure1.png
-│   ├── figure2.png
-│   ├── ...
-├── ...
+project/
+├── main.typ -- for boilerplate code and importing everything 
+├── config/
+│   ├── doc.yaml -- for things that don't change across works, i.e. author and mentor metadata
+│   ├── universities.yaml -- for user-specific configuration, i.e. education programs and disciplines
+│   └── ...
+├── src/
+│   ├── intro.typ
+│   ├── chapter1.typ
+│   ├── chapter2.typ
+│   └── ...
+├── figures/
+│   ├── chapter1/
+│   │   ├── figure1.png
+│   │   ├── figure2.png
+│   │   ├── figure3.png
+│   │   └── ...
+│   ├── chapter2/
+│   │   ├── figure1.png
+│   │   ├── figure2.png
+│   │   ├── figure3.png
+│   │   └── ...
+│   └── ...
+└── ...
 ```

config/universities.yaml

@@ -0,0 +1,58 @@
+ХНУРЕ:
+  name: Харківський національний університет радіоелектроніки
+  edu_programs:
+    ПЗПІ:
+      name_long: Інженерія програмного забезпечення
+      department_gen: Програмної інженерії
+      code: 121  # TODO: change to F2?
+    КУІБ:
+      name_long: Управління інформаційною безпекою
+      department_gen: Інфокомунікаційної інженерії ім. В. В. Поповського
+      code: 125
+    КНТ:
+      name_long: Комп'ютерні науки та технології
+      department_gen: Системотехніки
+      code: 122
+  subjects:
+    ODS: Основи Dаtа Sсіеnсе # NOTE: Eng O here
+    ІМ: Іноземна мова
+    АКтаК: Архітектура комп'ютера та комп'ютерних мереж
+    АТСД: Алгоритми та структури даних
+    БД: Бази даних
+    БЖД: Безпека життєдіяльності
+    ВДІТБ: Введення до ІТ-бізнесу # NOTE: all in UA
+    ВМ: Вища математика
+    ГТГ: Гіпертекст та гіпермедіа
+    ДМ: Дискретна математика
+    КДМА: Комп'ютерна дискретна математика
+    КМ: Комп`ютерні мережі
+    КЗВШ: Креативність з використанням штучного інтелекту
+    ЛМВ: Людино-машинна взаємодія
+    МОТДО: Методи оптимізаціі та дослідження операцій
+    МС: Моделювання систем
+    ОІМ: Основи IP-мереж
+    ООП: Об'єктно-орієнтоване програмування
+    ОП: Основи права
+    ОПІ: Основи програмноі інженеріі
+    ОПНJ: Основи програмування на Java
+    ОПр: Основи програмування
+    ОС: Операційні системи
+    ОТК: Основи теорії кіл
+    ПНП: Програмування на платформі .NЕТ
+    ПП: Проектний практикум
+    ПРОГ: Програмування
+    СМП: Скриптові мови програмування
+    ТЙтаМ: Теорія ймовірностей та математична # TODO: what?
+    ТКП: Технології комп`ютерного проєктування
+    УФМ: Українське фахове мовлення
+    ФІЗ: Фізика
+    ФІЛ: Філософія
+    ФВС: Фізичне виховання та спорт
+    # Oleksii 6th semester
+    ХТ: Хмарні технології
+    ООАПС: Об'єктно-орієнтований аналіз в проектуванні систем
+    СА: Системний аналіз
+    МППС: Методології проектування програмних систем
+    ТЗІ: Технології захисту інформації
+    АДан: Аналітика даних
+    DMT: Decision making theory

lab_example.typ

@@ -1,39 +0,0 @@
-#import "template.typ": *
-#import "@preview/indenta:0.0.3": fix-indent
-
-#show: lab-pz-template.with(
-  doctype: "ЛБ",
-  title: "Інформаційна система «Помічник класного керівника». Керування класом",
-  subject_shorthand: "БД",
-  department_gen: "Програмної інженерії",
-  authors: (
-    (
-      name: "Ситник Є. С.",
-      full_name_gen: "Ситника Єгора Сергійовича",
-      variant: 13,
-      group: "ПЗПІ-23-2",
-      gender: "m",
-    ),
-  ),
-  mentor: (
-    name: "Черепанова Ю. Ю.",
-    gender: "f",
-    degree: "Ст. викл. каф. ПІ",
-  ),
-  worknumber: 1,
-)
-
-#show: fix-indent()
-
-#v(-spacing)
-
-== Мета роботи
-Супер важлива мета
-
-== Висновки
-Супер важливий висновок
-
-== Хід роботи
-
-== Контрольні запитання
-Супер важливі контрольні запитання

lib.typ

@@ -1,9 +1,18 @@
 
+// Academic aliases {{{1
+
+#let universities = yaml("config/universities.yaml")
+
+// Template formatting functions {{{1
+
 /// numberless heading
 #let nheading(title) = heading(depth: 1, numbering: none, title)
 
 /// fill horizontal space with a box and not an empty space
-#let hfill(width) = box(width: width, repeat(" ")) // NOTE: This is a HAIR SPACE (U+200A), not a regular space
+#let hfill(width) = box(
+  width: width,
+  repeat(" "),
+) // NOTE: This is a HAIR SPACE (U+200A), not a regular space
 
 /// make underlined cell with filled value
 #let uline(align: center, content) = underline[
@@ -15,47 +24,7 @@
 /// bold text
 #let bold(content) = text(weight: "bold")[#content]
 
-/// captioned image with label derived from path:
-/// - `image.png` = @image
-/// - `img/image.png` = @image
-/// - `img/foo/image.png` = @foo_image
-/// - `img/foo/foo_image.png` = @foo_image
-/// if source is specified, it will be appended to the caption as " (за даними `source`)"
-/// otherwise " (рисунок виконано самостійно)" will be appended to the caption
-#let img(path, caption, source: none) = {
-  let parts = path.split(".").first().split("/")
-
-  let label_string = if parts.len() <= 2 or parts.at(-1).starts-with(parts.at(-2)) {
-    // ("image",), (_, "image") and (.., "img", "img_image")
-    parts.last()
-  } else {
-    // (.., "img", "image") = "img_image"
-    parts.at(-2) + "_" + parts.at(-1)
-  }.replace(" ", "_")
-
-  caption = [#caption #if source != none [(за даними #source)] else [(рисунок виконано самостійно)]]
-
-  [#figure(image(path), caption: caption) #label(label_string)]
-}
-
-/// subjects list
-#let subjects = (
-  "БД": "Бази даних",
-  "ОПНJ": "Основи програмування на Java",
-  "ОС": "Операційні системи",
-  "ПП": "Проектний практикум",
-  "СПМ": "Скриптові мови програмування",
-  "Ф": "Філософія",
-)
-
-/// education programs list
-#let edu_programs = (
-  "ПЗПІ": (
-    name: "Інженерія програмного забезпечення",
-    number: 121,
-  ),
-)
-
+/// month name from its number
 #let month_gen(month) = (
   "січня",
   "лютого",
@@ -71,49 +40,101 @@
   "грудня",
 ).at(month - 1)
 
-/// spacing between lines
-#let spacing = 0.95em
+// Helper functions {{{1
 
-#let style(it) = {
-  set page(
-    paper: "a4",
-    margin: (top: 20mm, right: 10mm, bottom: 20mm, left: 25mm),
-    number-align: top + right,
-    numbering: (..numbers) => {
-      if numbers.pos().at(0) != 1 {
-        numbering("1", numbers.pos().at(0))
-      }
-    },
-  )
+/// captioned image with label derived from path:
+/// - "image.png" = @image
+/// - "img/image.png" = @image
+/// - "img/foo/image.png" = @foo_image
+/// - "img/foo/foo_image.png" = @foo_image
+/// the caption will be modified based on a conditional positional value:
+/// - `none`: no change
+/// - some value: "`caption` (за даними `value`)"
+/// - no value: "`caption` (рисунок виконано самостійно)"
+/// additional named arguments will be passed to original `image` function
+#let img(path, caption, ..sink) = {
+  let parts = path.split(".").first().split("/")
 
-  set text(font: ("Times New Roman", "Liberation Serif"), size: 14pt, hyphenate: false, lang: "uk")
-  set par(justify: true, first-line-indent: (amount: 1.25cm, all: true))
-  set underline(evade: false)
+  let label_string = if (
+    parts.len() <= 2 or parts.at(-1).starts-with(parts.at(-2))
+  ) {
+    // ("image",), (_, "image") and (.., "img", "img_image")
+    parts.last()
+  } else {
+    // (.., "img", "image") = "img_image"
+    parts.at(-2) + "_" + parts.at(-1)
+  }.replace(" ", "_")
 
-  // set 1.5 line spacing
-  set block(spacing: spacing)
-  set par(spacing: spacing)
-  set par(leading: spacing)
-
-  // enums and lists
-  let ua_alph_numbering() = {
-    // INFO: This alphabet is not full, maybe it should be extended or maybe not.
-    //       I cant remember nor find proper formatting rules.
-    //       "абвгґдеєжзиіїйклмнопрстуфхцчшщьюя" (full alphabet)
-
-    let alphabet = "абвгдежиклмнпрстуфхцшщюя".split("")
-    i => { alphabet.at(i) + ")" }
+  let caption = if sink.pos().len() == 0 {
+    caption
+  } else if sink.pos().first() == none {
+    caption + " (рисунок виконано самостійно)"
+  } else {
+    [#caption (за даними #sink.pos().first())]
   }
 
-  set enum(numbering: ua_alph_numbering(), indent: 1.25cm, body-indent: 0.5cm)
+  [#figure(
+      image(path, ..sink.named()),
+      caption: caption,
+    ) #label(label_string)]
+}
+
+#let spacing = 0.95em // spacing between lines
+#let num-to-alpha = "абвгдежиклмнпрстуфхцшщюя".split("") // 0 = "", 1 = "а"
+
+/// DSTU 3008:2015 Style
+/// -> content
+/// - it (content): Content to apply the style to.
+/// - skip (int): Do not show page number for this number of pages.
+/// - offset (int): Adjust all page numbers by this amount.
+#let dstu-style(
+  it,
+  skip: 0,
+  offset: 0,
+) = {
+  // General Styling {{{1
+  set page(
+    paper: "a4",
+    number-align: top + right,
+    margin: (top: 20mm, right: 10mm, bottom: 20mm, left: 25mm),
+    numbering: (i, ..) => if i > skip { numbering("1", i + offset) },
+  )
+
+  set text(
+    lang: "uk",
+    size: 14pt,
+    hyphenate: false,
+    font: ("Times New Roman", "Liberation Serif"),
+  )
+
+  set par(
+    justify: true,
+    spacing: spacing,
+    leading: spacing,
+    first-line-indent: (amount: 1.25cm, all: true),
+  )
+
+  set block(spacing: spacing)
+  set underline(evade: false)
+
+  // Enums & Lists {{{1
+  // First level
+  set enum(
+    indent: 1.25cm,
+    body-indent: 0.5cm,
+    numbering: i => { num-to-alpha.at(i) + ")" },
+  )
+
+  // Second level and further nesting
   show enum: it => {
     set enum(indent: 0em, numbering: "1)")
     it
   }
 
+  // Lists are not intended for multiple levels, use `enum`
   set list(indent: 1.35cm, body-indent: 0.5cm, marker: [--])
 
-  // figures
+  // Figures {{{1
   show figure: it => {
     v(spacing * 2, weak: true)
     it
@@ -124,76 +145,53 @@
   show figure.where(kind: table): set figure.caption(position: top)
   show figure.caption.where(kind: table): set align(left)
 
-  // figure numbering
+  // Numbering {{{1
   show heading.where(level: 1): it => {
     counter(math.equation).update(0)
+    counter(figure.where(kind: raw)).update(0)
     counter(figure.where(kind: image)).update(0)
     counter(figure.where(kind: table)).update(0)
-    counter(figure.where(kind: raw)).update(0)
     it
   }
-  set math.equation(numbering: (..num) => numbering("(1.1)", counter(heading).get().at(0), num.pos().first()))
-  set figure(numbering: (..num) => numbering("1.1", counter(heading).get().at(0), num.pos().first()))
+  set figure(numbering: i => numbering("1.1", counter(heading).get().at(0), i))
+  set math.equation(numbering: i => numbering(
+    "(1.1)",
+    counter(heading).get().at(0),
+    i,
+  ))
 
-  // appearance of references to images and tables
-  set ref(
-    supplement: it => {
-      if it == none or not it.has("kind") {
-        it
-      } else if it.kind == image {
-        "див. рис."
-      } else if it.kind == table {
-        "див. таблицю"
-      } else {
-        it
-      }
-    },
-  )
-  show ref: it => {
-    let el = it.element
-
-    if el == none or not el.has("kind") {
-      return it
-    }
-    if el.kind != image and el.kind != table {
-      return it
-    }
-
-    [(#it)]
-  }
-
-  // headings
+  // Headings {{{1
   set heading(numbering: "1.1")
 
-  show heading.where(level: 1): it => {
+  show heading: it => if it.level == 1 {
     set align(center)
     set text(size: 14pt, weight: "semibold")
 
     pagebreak(weak: true)
     upper(it)
     v(spacing * 2, weak: true)
-  }
-  show heading.where(level: 2): it => {
+  } else {
     set text(size: 14pt, weight: "regular")
 
     v(spacing * 2, weak: true)
     block(width: 100%, spacing: 0em)[
       #h(1.25cm)
-      #counter(heading).display(it.numbering)
+      #counter(heading).display(auto)
       #it.body
     ]
     v(spacing * 2, weak: true)
   }
 
-  // listings
+  // Listings {{{1
   show raw: it => {
-    let new_spacing = 0.5em
-    set block(spacing: new_spacing)
-    set par(
-      spacing: new_spacing,
-      leading: new_spacing,
+    let raw-spacing = 0.5em
+    set block(spacing: raw-spacing)
+    set par(spacing: raw-spacing, leading: raw-spacing)
+    set text(
+      size: 11pt,
+      weight: "semibold",
+      font: ("Courier New", "Liberation Mono"),
     )
-    set text(size: 11pt, font: "Courier New", weight: "semibold")
 
     v(spacing * 2.5, weak: true)
     pad(it, left: 1.25cm)
@@ -201,39 +199,79 @@
   }
 
   it
+  // }}}
 }
 
+/// DSTU 3008:2015 Appendices Style
+/// -> content
+/// - it (content): Content to apply the style to.
+#let appendices-style(it) = /* {{{ */ {
+  // Numbering
+  counter(heading).update(0)
+  set heading(numbering: (i, ..n) => (
+    upper(num-to-alpha.at(i)) + numbering(".1.1", ..n)
+  ))
+  set figure(numbering: i => [#upper(num-to-alpha.at(counter(heading).get().at(0))).#i])
+  set math.equation(numbering: i => [(#upper(num-to-alpha.at(counter(heading).get().at(0))).#i)])
+
+  // Headings
+  show heading: it => if it.level == 1 {
+    set align(center)
+    set text(size: 14pt, weight: "regular")
+
+    pagebreak(weak: true)
+    text(weight: "bold")[ДОДАТОК #counter(heading).display(auto)]
+    linebreak()
+    it.body
+    v(spacing * 2, weak: true)
+  } else {
+    set text(size: 14pt, weight: "regular")
+
+    v(spacing * 2, weak: true)
+    block(width: 100%, spacing: 0em)[
+      #h(1.25cm)
+      #counter(heading).display(auto)
+      #it.body
+    ]
+    v(spacing * 2, weak: true)
+  }
+
+  it
+} // }}}
+
+
+// Coursework template {{{1
+
 /// DSTU 3008:2015 Template for NURE
 /// -> content
 /// - doc (content): Content to apply the template to.
 /// - title (str): Title of the document.
-/// - subject_shorthand (str): Subject short name.
-/// - department_gen (str): Department name in genitive form.
-/// - authors ((name: str, full_name_gen: str, variant: int, group: str, gender: str),): List of Authors dicts.
-/// - mentors ((name: str, gender: str, degree: str),): List of mentors dicts.
-/// - edu_program_shorthand (str): Education program shorthand.
+/// - subject (str): Subject short name.
+/// - authors ((name: str, full_name_gen: str, variant: int, course: int, semester: int, group: str, gender: str),): List of authors.
+/// - mentors ((name: str, degree: str),): List of mentors.
+/// - edu_program (str): Education program shorthand.
 /// - task_list (done_date: datetime, initial_date: datetime, source: (content | str), content: (content | str), graphics: (content | str)): Task list object.
 /// - calendar_plan ( plan_table: (content | str), approval_date: datetime): Calendar plan object.
 /// - abstract (keywords: (str, ), text: (content | str)): Abstract object.
 /// - bib_path path: Path to the bibliography yaml file.
-/// - appendices ((title: str, content: content, ): List of appendices objects.
-#let cw-template(
+/// - appendices (content): Content with appendices.
+#let coursework(
   doc,
-  title: "NONE",
-  subject_shorthand: "NONE",
-  department_gen: "Програмної інженерії",
+  title: none,
+  subject: none,
+  university: "ХНУРЕ",
   author: (),
   mentors: (),
-  edu_program_shorthand: "ПЗПІ",
+  edu_program: none,
   task_list: (),
   calendar_plan: (),
   abstract: (),
-  bib_path: "bibl.yml",
+  bib_path: none,
   appendices: (),
 ) = {
   set document(title: title, author: author.name)
 
-  show: style
+  show: dstu-style.with(skip: 1)
 
   let bib-count = state("citation-counter", ())
   show cite: it => {
@@ -247,27 +285,24 @@
 
 
   let head_mentor = mentors.at(0)
-  let edu_program = edu_programs.at(edu_program_shorthand)
+  let uni = universities.at(university)
+  let edu_prog = uni.edu_programs.at(edu_program)
 
-  // page 1
+  // page 1 {{{2
   [
     #set align(center)
-    МІНІСТЕРСТВО ОСВІТИ І НАУКИ УКРАЇНИ
-
-    ХАРКІВСЬКИЙ НАЦІОНАЛЬНИЙ УНІВЕРСИТЕТ РАДІОЕЛЕКТРОНІКИ
+    МІНІСТЕРСТВО ОСВІТИ І НАУКИ УКРАЇНИ\
+    #upper(uni.name)
 
     \
 
-    Кафедра Програмної інженерії
+    Кафедра #edu_prog.department_gen
 
     \
 
-    ПОЯСНЮВАЛЬНА ЗАПИСКА
-
-    ДО КУРСОВОЇ РОБОТИ
-
-    з дисципліни: "#subjects.at(subject_shorthand, default: "NONE")"
-
+    ПОЯСНЮВАЛЬНА ЗАПИСКА\
+    ДО КУРСОВОЇ РОБОТИ\
+    з дисципліни: "#uni.subjects.at(subject, default: "NONE")"\
     Тема роботи: "#title"
 
     \ \ \
@@ -275,7 +310,7 @@
     #columns(2, gutter: 4cm)[
       #set align(left)
 
-      #if author.gender == "m" { [Виконав\ ] } else { [Виконала\ ] } ст. гр. #author.group
+      #if author.gender == "m" { [Виконав\ ] } else { [Виконала\ ] } ст. гр. #edu_program\-#author.group
 
       \
       Керівник:\
@@ -316,34 +351,33 @@
 
     #pagebreak()
   ]
-  //
 
-  // page 2
+  // page 2 {{{2
   {
-    uline([Харківський національний університет радіоелектроніки])
+    uline[#uni.name]
 
     linebreak()
     linebreak()
 
     grid(
       columns: (100pt, 1fr),
-      bold([
+      bold[
         Кафедра
         Дисципліна
         Спеціальність
-      ]),
+      ],
       {
-        uline(align: left, department_gen)
+        uline(align: left, edu_prog.department_gen)
         linebreak()
-        uline(align: left, subjects.at(subject_shorthand))
+        uline(align: left, uni.subjects.at(subject))
         linebreak()
-        uline(align: left, [#edu_program.number #edu_program.name])
+        uline(align: left, [#edu_prog.code #edu_prog.name_long])
       },
     )
     grid(
       columns: (1fr, 1fr, 1fr),
       gutter: 0.3fr,
-      [#bold("Курс") #uline(2)], [#bold("Група") #uline(author.group)], [#bold("Семестр") #uline(3)],
+      [#bold[Курс] #uline(author.course)], [#bold[Група] #uline([#edu_program\-#author.group])], [#bold[Семестр] #uline(author.semester)],
     )
 
     linebreak()
@@ -396,9 +430,10 @@
     pagebreak()
   }
 
-  // page 3
+  // page 3 {{{2
   {
     align(center, bold[КАЛЕНДАРНИЙ ПЛАН])
+    set par(first-line-indent: 0pt)
 
     linebreak()
 
@@ -436,23 +471,25 @@
     pagebreak()
   }
 
-  // page 4 {{{
+  // page 4 {{{2
   [
-    #align(center, bold([РЕФЕРАТ])) \
+    #align(center, bold[РЕФЕРАТ]) \
 
     #context [
       #let pages = counter(page).final().at(0)
-      #let tables = counter(figure.where(kind: table)).final().at(0)
-      // alternative: query(figure.where(kind: image)).len()
-      #let images = counter(figure.where(kind: image)).final().at(0)
+      #let images = query(figure.where(kind: image)).len()
+      #let tables = query(figure.where(kind: table)).len()
       #let bibs = bib-count.final().dedup().len()
+      /* TODO: why this stopped working?
+      #let tables = counter(figure.where(kind: table)).final().at(0)
+      #let images = counter(figure.where(kind: image)).final().at(0)*/
 
       #let counters = ()
 
-      #if pages != 0 { counters.push([#pages с.]) }
-      #if tables != 0 { counters.push([#tables табл.]) }
-      #if images != 0 { counters.push([#images рис.]) }
-      #if bibs != 0 { counters.push([#bibs джерел]) }
+      #if pages != 0 { counters.push[#pages с.] }
+      #if tables != 0 { counters.push[#tables табл.] }
+      #if images != 0 { counters.push[#images рис.] }
+      #if bibs != 0 { counters.push[#bibs джерел] }
 
       Пояснювальна записка до курсової роботи: #counters.join(", ").
     ]
@@ -467,12 +504,17 @@
       for i in range(n) {
         for j in range(0, n - i - 1) {
           if (
-            (not is_cyrillic(keywords.at(j)) and is_cyrillic(keywords.at(j + 1)))
+            (
+              not is_cyrillic(keywords.at(j)) and is_cyrillic(keywords.at(j + 1))
+            )
               or (
                 is_cyrillic(keywords.at(j)) == is_cyrillic(keywords.at(j + 1)) and keywords.at(j) > keywords.at(j + 1)
               )
           ) {
-            (keywords.at(j), keywords.at(j + 1)) = (keywords.at(j + 1), keywords.at(j))
+            (keywords.at(j), keywords.at(j + 1)) = (
+              keywords.at(j + 1),
+              keywords.at(j),
+            )
           }
         }
       }
@@ -484,9 +526,8 @@
 
     #abstract.text
   ]
-  // }}}
 
-  // page 5
+  // page 5 {{{2
   outline(
     title: [
       ЗМІСТ
@@ -498,7 +539,7 @@
 
   doc
 
-  // bibliography
+  // bibliography {{{2
   {
     heading(depth: 1, numbering: none)[Перелік джерел посилання]
 
@@ -521,7 +562,7 @@
         )
         [
           #citation.title.
-          _#{citation.author}_. // TODO: remove italic case, issue #7
+          #citation.author.
           URL: #citation.url.value (дата звернення: #date.display("[day].[month].[year]")).
         ]
       } else if citation.type == "Book" [
@@ -536,6 +577,7 @@
     }
 
     show enum.item: it => {
+      set par(first-line-indent: 0pt)
       box(width: 1.25cm)
       box(width: 1em + 0.5cm)[#it.number.]
       it.body
@@ -552,99 +594,115 @@
     }
   }
 
-  // appendices
-  {
-    counter(heading).update(0)
-
-    for (i, appendix) in appendices.enumerate() [
-      #set heading(
-        numbering: i => [
-          Додаток #"АБВГДЕЖИКЛМНПРСТУФХЦШЩЮЯ".split("").at(i)
-        ],
-      )
-
-      #show heading: it => {
-        set align(center)
-        set text(size: 14pt, weight: "regular")
-
-        pagebreak(weak: true)
-        bold(upper(counter(heading).display(it.numbering)))
-        linebreak()
-        it.body
-        v(spacing * 2, weak: true)
-      }
-      #heading(appendix.title)
-      #appendix.content
-    ]
-  }
+  appendices-style(appendices)
 }
 
+// Practice and Laboratory works template {{{1
+
 /// DSTU 3008:2015 Template for NURE
 /// -> content
 /// - doc (content): Content to apply the template to.
-/// - doctype ("ЛБ" | "ПЗ"): Document type.
-/// - title (str): Title of the document.
-/// - subject_shorthand (str): Subject short name.
-/// - department_gen (str): Department name in genitive form.
-/// - worknumber (int): Number of the work, can be omitted.
-/// - authors ((name: str, full_name_gen: str, variant: int, group: str, gender: str),): List of Authors dicts.
-/// - mentor (name: str, gender: str, degree: str): Mentors objects.
-#let lab-pz-template(
+/// - edu_program (str): Education program shorthand.
+/// - doctype ("ЛБ" | "ПЗ" | str): Document type.
+/// - title (str or none): Title of the document. Optional.
+/// - subject (str): Subject shorthand.
+/// - worknumber (int or none): Number of the work. Optional.
+/// - authors ((name: str, full_name_gen: str, group: str, gender: str, variant: int or none),): List of authors.
+/// - mentors ((name: str, degree: str, gender: str or none),): List of mentors. Optional.
+/// - chapters (): List of file names in chapters/ subdirectory. Optional.
+#let pz-lb(
   doc,
-  doctype: "NONE",
-  title: "NONE",
-  subject_shorthand: "NONE",
-  department_gen: "Програмної інженерії",
-  worknumber: 1,
+  university: "ХНУРЕ",
+  edu_program: none,
+  doctype: none,
+  title: none,
+  subject: none,
+  worknumber: none,
   authors: (),
-  mentor: (),
+  mentors: (),
+  chapters: (),
 ) = {
+  assert.ne(edu_program, none, message: "Missing argument: \"edu_program\"")
+  assert.ne(doctype, none, message: "Missing argument: \"doctype\"")
+  assert.ne(subject, none, message: "Missing argument: \"subject\"")
+
   set document(title: title, author: authors.at(0).name)
 
-  show: style
-
-  context counter(heading).update(worknumber - 1)
+  show: dstu-style.with(skip: 1)
 
+  let uni = universities.at(university)
+  let edu_prog = uni.edu_programs.at(edu_program)
+  // page 1 {{{2
   align(center)[
     МІНІСТЕРСТВО ОСВІТИ І НАУКИ УКРАЇНИ \
-    ХАРКІВСЬКИЙ НАЦІОНАЛЬНИЙ УНІВЕРСИТЕТ РАДІОЕЛЕКТРОНІКИ
+    #upper(uni.name)
 
     \ \
-    Кафедра #department_gen
+    Кафедра #edu_prog.department_gen
 
     \ \ \
-    Звіт \
-    з
-    #if doctype == "ЛБ" [лабораторної роботи] else [практичної роботи]
-    #if worknumber != none [№ #worknumber]
+    #if doctype == "ЛБ" [Звіт \ з лабораторної роботи] else if (
+      doctype == "ПЗ"
+    ) [Звіт \ з практичної роботи] else [#doctype]
+    #if worknumber != none {
+      context counter(heading).update(
+        worknumber - if title == none { 0 } else { 1 },
+      )
+      [№#worknumber]
+    } else if title != none and worknumber != none {
+      context counter(heading).update(1)
+    }
 
-    з дисципліни: "#subjects.at(subject_shorthand, default: "UNLNOWN SUBJECT, PLEASE OPEN AN ISSUE")"
+    з дисципліни: "#uni.subjects.at(subject)"
 
-    з теми: "#title"
+    #if title != none [з теми: "#title"]
 
     \ \ \ \
 
     #columns(2)[
       #set align(left)
-
-      #if authors.len() == 1 [
-        #let author = authors.at(0)
-        #if author.gender == "m" { [Виконав:\ ] } else { [Виконала:\ ] }
-        ст. гр. #author.group\
-        #author.name\
-        #if author.variant != none { [Варіант: №#author.variant] }
-      ] else [
+      #set par(first-line-indent: 0pt)
+      #if authors.len() == 1 {
+        let author = authors.at(0)
+        if author.gender == "m" [Виконав:\ ] else [Виконала:\ ]
+        [
+          ст. гр. #edu_program\-#author.group\
+          #author.name\
+        ]
+        if (
+          "variant" in author.keys() and author.variant != none
+        ) [Варіант: №#author.variant]
+      } else if authors.len() > 1 [
         Виконали:\
-        ст. гр. #authors.at(0).group\
-        #authors.map(a => [ #a.name\ ])
+        ст. гр. #edu_program\-#authors.at(0).group\
+        #for author in authors [#author.name\ ]
       ]
 
       #colbreak()
       #set align(right)
 
-      #if mentor.gender == "m" { [Перевірив:\ ] } else { [Перевірила:\ ] }
-      #mentor.degree #if mentor.degree.len() >= 15 [\ ]
-      #mentor.name\
+      #if type(mentors) == array {
+        if mentors.len() == 1 {
+          let mentor = mentors.at(0)
+          if "gender" in mentor.keys() {
+            if mentor.gender == "m" [Перевірив:\ ] else if (
+              mentor.gender == "f"
+            ) [Перевірила:\ ]
+          } else [Перевірили:\ ]
+          if (
+            "degree" in mentor.keys() and mentor.degree != none
+          ) [#mentor.degree\ ]
+          [#mentor.name\ ]
+        } else if mentors.len() > 1 [
+          Перевірили:\
+          #for mentor in mentors {
+            [
+              #mentor.degree\
+              #mentor.name\
+            ]
+          }
+        ]
+      }
     ]
 
     #v(1fr)
@@ -654,8 +712,10 @@
 
   pagebreak(weak: true)
 
-  heading(title)
+  if title != none [#heading(title)]
+
   doc
+  chapters.map(chapter => include "/chapters/" + str(chapter) + ".typ").join()
 }
 
-// vim:sts=2:sw=2
+// vim:sts=2:sw=2:fdl=0:fdm=marker:cms=/*%s*/

template/config/doc.yaml

@@ -0,0 +1,22 @@
+title: Потiк керування та алгоритмічні структури Bash
+subject: СМП
+doctype: ЛБ
+worknumber: 2
+mentors:
+  - name: Шевченко Т. Г.
+    degree: Доцент кафедри ПІ
+    gender: m
+  - name: Франко І. Я.
+    degree: Асистент кафедри ПІ
+    gender: m
+edu_program: &EDU ПЗПІ
+university: ХНУРЕ
+authors:
+  - name: Косач Л. П.
+    full_name_gen: Косач Лариси Петрівни
+    course: 2
+    edu: *EDU
+    gender: f
+    group: 23-2
+    semester: 4
+    variant: 8

template/coursework.typ

@@ -1,29 +1,19 @@
-#import "template.typ": *
+#import "@local/nure:0.1.0": *
 
 #let author = (
   name: "Ситник Є. С.",
   full_name_gen: "Ситника Єгора Сергійовича",
+  course: 2,
+  semester: 3,
   variant: 13,
-  group: "ПЗПІ-23-2",
+  group: "23-2",
   gender: "m",
 )
 
 #let mentors = (
-  (
-    name: "Черепанова Ю. Ю.",
-    gender: "f",
-    degree: "Ст. викл. каф. ПІ",
-  ),
-  (
-    name: "Русакова Н. Є.",
-    gender: "f",
-    degree: "Доц. каф. ПІ",
-  ),
-  (
-    name: "Широкопетлєва М. С.",
-    gender: "f",
-    degree: "Ст. викл. каф. ПІ",
-  ),
+  (name: "Черепанова Ю. Ю.", degree: "Ст. викл. каф. ПІ"),
+  (name: "Русакова Н. Є.", degree: "Доц. каф. ПІ"),
+  (name: "Широкопетлєва М. С.", degree: "Ст. викл. каф. ПІ"),
 )
 
 #let task_list = (
@@ -69,39 +59,66 @@
     "SQL",
   ),
   text: [
-    Мета даної роботи -- проєктування та розробка інформаційної системи «Помічник класного керівника. Керування класом», яка спрямована на автоматизацію процесів управління класом, облік даних про учнів, планування та аналіз навчального процесу. Основна задача інформаційної системи – спростити роботу класного керівника, забезпечити ефективну організацію документації та взаємодію з учасниками освітнього процесу.
+    Мета даної роботи -- проєктування та розробка інформаційної системи «Помічник
+    класного керівника. Керування класом», яка спрямована на автоматизацію процесів
+    управління класом, облік даних про учнів, планування та аналіз навчального
+    процесу. Основна задача інформаційної системи – спростити роботу класного
+    керівника, забезпечити ефективну організацію документації та взаємодію з
+    учасниками освітнього процесу.
 
-    Для реалізації системи було використано сучасний стек технологій, а саме: Go -- як основна мова програмування для створення серверної логіки, HTMX -- для динамічного оновлення інтерфейсу без використання складних фреймворків, MySQL -- як СУБД для зберігання даних про учнів, їх оцінки та розклад, Neovim -- як середовище для швидкої та ефективної розробки коду, Go Echo -- веб-фреймворк для створення REST API, Go SQLx -- бібліотека для роботи з базою даних, що забезпечує зручність і гнучкість.
+    Для реалізації системи було використано сучасний стек технологій, а саме: Go --
+    як основна мова програмування для створення серверної логіки, HTMX -- для
+    динамічного оновлення інтерфейсу без використання складних фреймворків, MySQL --
+    як СУБД для зберігання даних про учнів, їх оцінки та розклад, Neovim -- як
+    середовище для швидкої та ефективної розробки коду, Go Echo -- веб-фреймворк для
+    створення REST API, Go SQLx -- бібліотека для роботи з базою даних, що
+    забезпечує зручність і гнучкість.
 
-    Результат роботи – веб-додаток, який дозволяє обліковувати особисті дані учнів та їхніх опікунів, включаючи інформацію про успішність, відвідуваність та інші показники; планувати розклад занять; генерувати звіти про успішність учнів та переглядати різну статистику. Інтерфейс, створений з використанням HTMX, легко адаптується під потреби користувача.
+    Результат роботи – веб-додаток, який дозволяє обліковувати особисті дані учнів
+    та їхніх опікунів, включаючи інформацію про успішність, відвідуваність та інші
+    показники; планувати розклад занять; генерувати звіти про успішність учнів та
+    переглядати різну статистику. Інтерфейс, створений з використанням HTMX, легко
+    адаптується під потреби користувача.
   ],
 )
 
-#let appendices = (
-  (
-    title: "Приклад звіту 1",
-    content: [test],
-  ),
-  (
-    title: "Приклад звіту 2",
-    content: [test],
-  ),
-  (
-    title: "Приклад звіту 3",
-    content: [test],
-  ),
-)
+#let appendices = [
+  = Приклад звіту 1
+  #v(-spacing)
+  == Частина 1
+  #lorem(100)
+  == Частина2
+  #lorem(200)
 
-#show: cw-template.with(
+  = Приклад звіту 2
+  #lorem(200)
+
+  = Приклад звіту 3
+  #lorem(200)
+]
+
+#show: coursework.with(
   title: "Інформаційна система «Помічник класного керівника». Керування класом",
-  subject_shorthand: "БД",
-  department_gen: "Програмної інженерії",
-  edu_program_shorthand: "ПЗПІ",
+  subject: "БД",
+  edu_program: "ПЗПІ",
   author: author,
   mentors: mentors,
   task_list: task_list,
   calendar_plan: calendar_plan,
   abstract: abstract,
-  bib_path: "bibl.yml",
+  bib_path: bytes("bibl.yml"), // NOTE: use `bytes` as typst looks in template dir when using just filename
   appendices: appendices,
 )
+
+= Моделювання
+#lorem(250)
+
+= Імплементація
+#v(-spacing)
+== Підоготовка
+#lorem(200)
+== Процес
+#lorem(500)
+
+= Тестування
+#lorem(300)

template/lab.typ

@@ -0,0 +1,53 @@
+#import "@local/nure:0.1.0": *
+
+#show: pz-lb.with(..yaml("config/doc.yaml"))
+
+#v(-spacing)
+
+== Мета роботи
+#lorem(100)
+
+== Хід роботи
+#v(-spacing)
+=== Підготовка
+#lorem(150)
+
+=== Виконання дослідження
+#lorem(300)
+
+=== Підрахунок результатів
+#lorem(250)
+
+== Висновки
+#lorem(100)
+
+== Контрольні запитання
+#lorem(100):
+- #lorem(20);
+- #lorem(30);
+- #lorem(15);
+- #lorem(25);
+- #lorem(42);
+- #lorem(27).
+
+#show: appendices-style
+
+= Quote
+#link("https://youtu.be/bJQj1uKtnus")[
+  The art isn't the art, the art is never the art,
+  the art is the thing that happens inside you when you make it and the feeling in the heart of the beholder.
+]
+
+
+= Приклад звіту 1
+#v(-spacing)
+== Частина 1
+#lorem(100)
+== Частина2
+#lorem(200)
+
+= Приклад звіту 2
+#lorem(200)
+
+= Приклад звіту 3
+#lorem(200)

typst.toml

@@ -0,0 +1,11 @@
+[package]
+name = "nure"
+version = "0.1.0"
+entrypoint = "lib.typ"
+authors = ["linerds"]
+license = "GPL-3.0"
+description = "Typst NURE package"
+
+[template]
+path = "template"
+entrypoint = "lab.typ"