chore!: bump to 0.1.1

refactor: break up into multiple files
feat: csl style
refactor!: rename variables
Update template, readme, and more

README.md

@@ -34,11 +34,11 @@ This template:
 ### 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
+git clone -b 0.1.1 https://gitea.linerds.us/pencelheimer/typst_nure_template.git ~/.local/share/typst/packages/local/nure/0.1.1
 ```
 2. Init your project with Typst:
 ```bash
-typst init @local/nure:0.1.0 project-name
+typst init @local/nure:0.1.1 project-name
 ```
 
 ### As a standalone file
@@ -47,7 +47,7 @@ Copy `src/` to your project's root directory, optionally renaming `src/` to `lib
 ### In your project
 ```typst
 // Import the template either from a local package...
-#import "@local/nure:0.1.0": *
+#import "@local/nure:0.1.1": *
 // ...or by importing a lib.typ directly
 // #import "/lib/lib.typ": *
 
@@ -91,7 +91,7 @@ Some text
 And a TOML file would look like this:
 ```toml
 # university = "ХНУРЕ" # "ХНУРЕ" is the default
-# edu_program = "ПЗПІ" # can be null, sourced from authors.first() by default
+# edu-program = "ПЗПІ" # can be null, sourced from authors.first() by default
 
 subject = "СМП"
 doctype = "ЛБ"
@@ -110,19 +110,19 @@ gender = "m"
 
 [[authors]]
 name = "Косач Л. П."
-edu_program = "ПЗПІ"
+edu-program = "ПЗПІ"
 group = "23-2"
 gender = "f"
 variant = 8
 # For coursework
-full_name_gen = "Косач Лариси Петрівни"
+full-name-gen = "Косач Лариси Петрівни"
 course = 2
 semester = 4
 ```
 
 ### 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.
+2. When importing `@local/nure:0.1.1` 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.1/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.
 
 ### Bibliography Format
 The template uses a custom CSL (Citation Style Language) file located at `src/csl/dstu-3008-2015.csl` to format bibliography entries.

config/universities.yaml

@@ -0,0 +1,77 @@
+ХНУРЕ:
+  name: Харківський національний університет радіоелектроніки
+  name_en: Kharkiv National University of Radioelectronics
+  edu_programs:
+    ПЗПІ:
+      name_long: Інженерія програмного забезпечення
+      department_gen: Програмної інженерії
+      code: 121 # TODO: change to F2?
+    КУІБ:
+      name_long: Управління інформаційною безпекою
+      department_gen: Інфокомунікаційної інженерії ім. В. В. Поповського
+      code: 125 # TODO: change to F5?
+    КНТ:
+      name_en: CST # computer sciences and technologies
+      name_long: Комп'ютерні науки та технології
+      department_gen: Системотехніки
+      department_en: ST
+      code: 122
+  subjects:
+    DMT: Decision making theory
+    ODS: Основи Dаtа Sсіеnсе # NOTE: Eng O here
+    ІМ: Іноземна мова
+    ІТР: Information Technologies of Reengineering
+    ІТРОІ: Інтернет-технології Розподіленої Обробки Інформації
+    АВпЗ: Аналіз вимог до програмного забезпечення
+    АДан: Аналітика даних
+    АКтаК: Архітектура комп'ютера та комп'ютерних мереж
+    АТСД: Алгоритми та структури даних
+    АтаРК: Аналіз та рефакторинг коду
+    БД: Бази даних
+    БЖД: Безпека життєдіяльності
+    ВДІТБ: Введення до ІТ-бізнесу # NOTE: all in UA
+    ВМ: Вища математика
+    ГТГ: Гіпертекст та гіпермедіа
+    ДМ: Дискретна математика
+    ДПК: Динаміка Проектних Команд
+    ЕРВ: Електрорадіовимірювання
+    КДМА: Комп'ютерна дискретна математика
+    КЗВШ: Креативність з використанням штучного інтелекту
+    КМ: Комп`ютерні мережі
+    ЛМВ: Людино-машинна взаємодія
+    ЛМтБ: Локальні мережі та їх безпека # бидло не знає що українською "їхня"
+    МОКр: Математичні основи криптології
+    МОТДО: Методи оптимізаціі та дослідження операцій
+    МППС: Methodologies of designing software systems
+    МС: Моделювання систем
+    ОІМ: Основи IP-мереж
+    ООАПС: Об'єктно-орієнтований аналіз в проектуванні систем
+    ООП: Об'єктно-орієнтоване програмування
+    ОП: Основи права
+    ОПІ: Основи програмноі інженеріі
+    ОПНJ: Основи програмування на Java
+    ОПр: Основи програмування
+    ОРвІТ: Оцінка Ризиків в IT-проектах
+    ОС: Операційні системи
+    ОТК: Основи теорії кіл
+    ПБІП: Проектування та балансування ігрового процесу
+    ПВJ: Поглиблене вивчення Java
+    ПЕСЕ: Психологія екстремальних стосунків та ефективної адаптації
+    ПНП: Програмування на платформі .NЕТ
+    ПП: Проектний практикум
+    ПРОГ: Програмування
+    ПарП: Параллельне програмування
+    СА: Системний аналіз
+    СМП: Скриптові мови програмування
+    СОАПЗ: Сервіс-Орієнтована Архітектура Програмного Забезпечення
+    СРБД: Серверні рішення баз даних
+    СхТ: Схемотехніка
+    ТВО: Технології Високопродуктивних Обчислень
+    ТЗІ: Технології захисту інформації
+    ТЙтаМ: Теорія ймовірностей та математична # TODO: what?
+    ТКП: Технології комп`ютерного проєктування
+    УФМ: Українське фахове мовлення
+    ФІЗ: Фізика
+    ФІЛ: Філософія
+    ФВС: Фізичне виховання та спорт
+    ХТ: Хмарні технології

lib.typ

@@ -0,0 +1,701 @@
+
+// Academic aliases {{{1
+
+#let universities = yaml("config/universities.yaml")
+
+// Template formatting functions {{{1
+
+/// bold text
+#let bold(content) = text(weight: "bold")[#content]
+
+/// 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
+
+/// make underlined cell with filled value
+#let uline(align: center, content) = underline[
+  #if align != left { hfill(1fr) }
+  #content
+  #if align != right { hfill(1fr) }
+]
+
+/// month name from its number
+#let month_gen(month) = (
+  "січня",
+  "лютого",
+  "березня",
+  "квітня",
+  "травня",
+  "червня",
+  "липня",
+  "серпня",
+  "вересня",
+  "жовтня",
+  "листопада",
+  "грудня",
+).at(month - 1)
+
+#let is-cyr(c) = regex("[\p{Cyrillic}]") in c
+
+#let gender-form(verb, gender: "p") = {
+  (
+    "author": ("m": "Виконав", "f": "Виконала", "p": "Виконали"),
+    "mentor": ("m": "Перевірив", "f": "Перевірила", "p": "Перевірили"),
+  )
+    .at(verb)
+    .at(if gender == "m" or gender == "f" { gender } else { "p" }, default: "p")
+}
+
+#let pz-lb-title(type, number: none) = {
+  let type-title = (
+    "ЛБ": [Звіт \ з лабораторної роботи],
+    "ПЗ": [Звіт \ з практичної роботи],
+    "КР": [Контрольна робота],
+    "РФ": [Реферат], // зрада
+  ).at(type, default: type)
+  if number != none { [#type-title №#number] } else { [#type-title] }
+}
+
+// Helper functions {{{1
+
+/// 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("/")
+
+  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(" ", "_")
+
+  let caption = if sink.pos().len() == 0 {
+    caption
+  } else if sink.pos().first() == none {
+    caption + " (рисунок виконано самостійно)"
+  } else {
+    [#caption (за даними #sink.pos().first())]
+  }
+
+  [#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 {{{1
+  show figure: it => {
+    v(spacing * 2, weak: true)
+    it
+    v(spacing * 2, weak: true)
+  }
+
+  set figure.caption(separator: [ -- ])
+  show figure.where(kind: table): set figure.caption(position: top)
+  show figure.caption.where(kind: table): set align(left)
+  show figure.where(kind: raw): set figure.caption(position: top)
+  show figure.where(kind: raw): set align(left)
+
+  // 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)
+    it
+  }
+  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))
+
+  // Headings {{{1
+  set heading(numbering: "1.1")
+
+  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)
+  } 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)
+  }
+
+  show heading.where(level: 3): it => {
+    set text(size: 14pt, weight: "regular")
+
+    v(spacing * 2, weak: true)
+    block(width: 100%, spacing: 0em)[
+      #h(1.25cm)
+      #counter(heading).display(it.numbering)
+      #it.body
+    ]
+    v(spacing * 2, weak: true)
+  }
+
+  // listings {{{3
+  show raw.where(block: true): it => {
+    let new_spacing = 0.5em
+    set block(spacing: new_spacing)
+    set par(spacing: new_spacing, leading: new_spacing)
+    set text(
+      size: 11pt,
+      weight: "semibold",
+      font: ("Courier New", "Liberation Mono"),
+    )
+
+    v(spacing * 2.5, weak: true)
+    pad(it, left: 1.25cm)
+    v(spacing * 2.5, weak: true)
+  }
+
+  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)
+
+  // Heading supplement (Heading name shown when citing with @ref)
+  set heading(supplement: [Додаток])
+
+  // Headings
+  show heading: it => if it.level == 1 {
+    set align(center)
+    set text(size: 14pt, weight: "regular")
+
+    pagebreak(weak: true)
+    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 (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.
+/// - 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 (content): Content with appendices.
+#let coursework(
+  doc,
+  university: "ХНУРЕ",
+  subject: none,
+  title: none,
+  authors: (),
+  mentors: (),
+  task_list: (),
+  calendar_plan: (),
+  abstract: (),
+  bib_path: none,
+  appendices: (),
+) = {
+  set document(title: title, author: authors.map(c => c.name))
+
+  show: dstu-style.with(skip: 1)
+
+  let bib-count = state("citation-counter", ())
+  show cite: it => {
+    it
+    bib-count.update(((..c)) => (..c, it.key))
+  }
+  show bibliography: it => {
+    set text(size: 0pt)
+    it
+  }
+
+  let author = authors.first()
+  let head_mentor = mentors.first()
+  let uni = universities.at(university)
+  let edu_prog = uni.edu_programs.at(author.edu_program)
+
+  // page 1 {{{2
+  [
+    #set align(center)
+    МІНІСТЕРСТВО ОСВІТИ І НАУКИ УКРАЇНИ\
+    #upper(uni.name)
+
+    \
+
+    Кафедра #edu_prog.department_gen
+
+    \
+
+    ПОЯСНЮВАЛЬНА ЗАПИСКА\
+    ДО КУРСОВОЇ РОБОТИ\
+    з дисципліни: "#uni.subjects.at(subject, default: subject)"\
+    Тема роботи: "#title"
+
+    \ \ \
+
+    #columns(2, gutter: 4cm)[
+      #set align(left)
+      #set par(first-line-indent: 0pt)
+
+      #gender-form("author", gender: author.gender) ст. гр. #author.edu_program\-#author.group
+
+      \
+      Керівник:\
+      #head_mentor.degree
+
+      \
+      Робота захищена на оцінку
+
+      \
+      Комісія:\
+      #for m in mentors { [#m.degree\ ] }
+
+      #colbreak()
+      #set align(left)
+
+
+      #author.name
+
+      \ \
+      #head_mentor.name
+
+      \
+      #underline(" " * 35)
+
+      \ \
+      #for m in mentors { [#m.name\ ] }
+    ]
+
+    #v(1fr)
+
+    Харків -- #task_list.done_date.display("[year]")
+
+    #pagebreak()
+  ]
+
+  // page 2 {{{2
+  {
+    uline[#uni.name]
+
+    linebreak()
+    linebreak()
+
+    grid(
+      columns: (100pt, 1fr),
+      bold[
+        Кафедра
+        Дисципліна
+        Спеціальність
+      ],
+      {
+        uline(align: left, edu_prog.department_gen)
+        linebreak()
+        uline(align: left, uni.subjects.at(subject, default: subject))
+        linebreak()
+        uline(align: left, [#edu_prog.code #edu_prog.name_long])
+      },
+    )
+    grid(
+      columns: (1fr, 1fr, 1fr),
+      gutter: 0.3fr,
+      [#bold[Курс] #uline(author.course)],
+      [#bold[Група] #uline([#author.edu_program\-#author.group])],
+      [#bold[Семестр] #uline(author.semester)],
+    )
+
+    linebreak()
+    linebreak()
+    linebreak()
+
+    align(center, bold[ЗАВДАННЯ \ на курсову роботу студента])
+
+    linebreak()
+
+    uline(align: left)[_#author.full_name_gen _]
+
+    linebreak()
+    linebreak()
+
+    bold[\1. Тема роботи:]
+    uline[#title.]
+
+    linebreak()
+
+    {
+      bold[\2. Строк здачі закінченої роботи:]
+      uline(task_list.done_date.display("[day].[month].[year]"))
+      hfill(10fr)
+    }
+
+    linebreak()
+
+    bold[\3. Вихідні дані для роботи:]
+    uline(task_list.source)
+
+    linebreak()
+
+    bold[\4. Зміст розрахунково-пояснювальної записки:]
+    uline(task_list.content)
+
+    linebreak()
+
+    bold[\5. Перелік графічного матеріалу:]
+    uline(task_list.graphics)
+
+    linebreak()
+
+    {
+      bold[\6. Дата видачі завдання:]
+      uline(task_list.initial_date.display("[day].[month].[year]"))
+      hfill(10fr)
+    }
+
+    pagebreak()
+  }
+
+  // page 3 {{{2
+  {
+    align(center, bold[КАЛЕНДАРНИЙ ПЛАН])
+    set par(first-line-indent: 0pt)
+
+    linebreak()
+
+    calendar_plan.plan_table
+
+    linebreak()
+
+    grid(
+      columns: (5fr, 5fr),
+      grid(
+        columns: (1fr, 2fr, 1fr),
+        gutter: 0.2fr,
+        [
+          Студент \
+          Керівник \
+          #align(center)["#underline[#calendar_plan.approval_date.day()]"]
+        ],
+        [
+          #uline(align: center, []) \
+          #uline(align: center, []) \
+          #uline(align: center, month_gen(calendar_plan.approval_date.month()))
+        ],
+        [
+          \ \
+          #underline[#calendar_plan.approval_date.year()] р.
+        ],
+      ),
+      [
+        #author.name, \
+        #head_mentor.degree
+        #head_mentor.name.
+      ],
+    )
+
+    pagebreak()
+  }
+
+  // page 4 {{{2
+  [
+    #align(center, bold[РЕФЕРАТ]) \
+
+    #context [
+      #let pages = counter(page).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 джерел] }
+
+      Пояснювальна записка до курсової роботи: #counters.join(", ").
+    ]
+
+    \
+
+    #(
+      abstract
+        .keywords
+        .map(upper)
+        .sorted(by: (a, b) => {
+          if is-cyr(a) != is-cyr(b) { true } else { a < b }
+        })
+        .join(", ")
+    )
+
+
+    \
+
+    #abstract.text
+  ]
+
+  // page 5 {{{2
+  outline(
+    title: [
+      ЗМІСТ
+      #v(spacing * 2, weak: true)
+    ],
+    depth: 2,
+    indent: auto,
+  )
+
+  doc
+
+  // bibliography {{{2
+  {
+    heading(depth: 1, numbering: none)[Перелік джерел посилання]
+
+    bibliography(
+      bib_path,
+      style: "ieee",
+      full: true,
+      title: none,
+    )
+
+    let bib_data = yaml(bib_path)
+
+    let format-entry(c) = {
+      if (c.type == "Web") {
+        let date_array = c.url.date.split("-")
+        let date = datetime(
+          year: int(date_array.at(0)),
+          month: int(date_array.at(1)),
+          day: int(date_array.at(2)),
+        )
+        [#c.title. #c.author. URL: #c.url.value (дата звернення: #date.display("[day].[month].[year]")).]
+      } else if (
+        c.type == "Book"
+      ) [#c.author #c.title. #c.publisher, #c.date. #c.page-total c. ] else [
+        UNSUPPORTED BIBLIOGRAPHY ENTRY TYPE, PLEASE OPEN AN ISSUE
+      ]
+    }
+
+    show enum.item: it => {
+      set par(first-line-indent: 0pt)
+      box(width: 1.25cm)
+      box(width: 1em + 0.5cm)[#it.number.]
+      it.body
+      linebreak()
+    }
+
+    context {
+      for (i, citation) in query(ref.where(element: none))
+        .map(r => str(r.target))
+        .dedup()
+        .enumerate() {
+        enum.item(
+          i + 1,
+          format-entry(bib_data.at(citation)),
+        )
+      }
+    }
+  }
+
+  appendices-style(appendices)
+}
+
+// Practice and Laboratory works template {{{1
+
+/// DSTU 3008:2015 Template for NURE
+/// -> content
+/// - doc (content): Content to apply the template to.
+/// - university: "ХНУРЕ": University metadata. Optional.
+/// - subject: str: Subject shortcode.
+/// - type: ("ЛБ" | "ПЗ" | "КР" | "РФ" | str): Work type.
+/// - number: int or none: Work number. Optional.
+/// - title: str or none: Work title. Optional.
+/// - authors ((name: str, full_name_gen: str or none, edu_program: str, group: str, gender: str, variant: int or none),): List of authors.
+/// - mentors ((name: str, degree: str, gender: ("m" | "f" | "p" | none)),): List of mentors. Optional.
+#let pz-lb(
+  doc,
+  university: "ХНУРЕ",
+  subject: none,
+  type: none,
+  number: none,
+  title: none,
+  authors: (),
+  mentors: (),
+) = {
+  // TODO: add actually relevant asserts
+
+  let edu_program = authors.first().edu_program
+  let uni = universities.at(university)
+
+  set document(title: title, author: authors.map(c => c.name))
+
+  show: dstu-style.with(skip: 1)
+
+  // page 1 {{{2
+
+  align(center)[
+    МІНІСТЕРСТВО ОСВІТИ І НАУКИ УКРАЇНИ \
+    #upper(uni.name)
+
+    \ \
+    Кафедра #uni.edu_programs.at(edu_program).department_gen
+
+    \ \ \
+    #pz-lb-title(type, number: number)
+
+    з дисципліни: "#uni.subjects.at(subject, default: subject)"
+    #if title != none [\ з теми: "#eval(title, mode: "markup")"]
+
+
+    \ \ \ \
+    #columns(2)[
+      #set align(left)
+      #set par(first-line-indent: 0pt)
+
+      #if authors.len() == 1 {
+        [#gender-form("author", gender: if "gender" in a.keys() { a.gender } else { none }):\ ]
+        let a = authors.first()
+        [ст. гр. #a.edu_program\-#a.group\ #a.name\ ]
+        if a.variant != none [Варіант: №#a.variant]
+      } else if authors.len() > 1 [
+        #gender-form("author"):\
+        #for a in authors [ст. гр. #a.edu_program\-#a.group\ #a.name\ ]
+      ]
+
+      #colbreak()
+      #set align(right)
+
+      #if mentors.len() == 1 {
+        [#gender-form("mentor", gender: if "gender" in m.keys() { m.gender } else { none }):\ ]
+        let m = mentors.first()
+        if "degree" in m.keys() and m.degree != none [#m.degree\ ]
+        [#m.name\ ]
+      } else if mentors.len() > 1 [
+        #gender-form("mentor"):\
+        #for mentor in mentors { [#mentor.degree\ #mentor.name\ ] }]
+    ]
+
+    #v(1fr)
+
+    Харків -- #datetime.today().display("[year]")
+  ]
+
+  pagebreak(weak: true)
+
+  // TODO(unexplrd): wrap my head around the old way
+  if title == none {
+    if number == none { context counter(heading).update(1) } else {
+      context counter(heading).update(number)
+    }
+  } else {
+    if number != none { context counter(heading).update(number - 1) }
+    heading(eval(title, mode: "markup"))
+  }
+
+  doc
+}
+
+// vim:sts=2:sw=2:fdm=marker:cms=/*%s*/

src/config/universities.yaml

@@ -1,21 +1,21 @@
 ХНУРЕ:
   name: Харківський національний університет радіоелектроніки
-  name_en: Kharkiv National University of Radioelectronics
+  name-en: Kharkiv National University of Radioelectronics
-  edu_programs:
+  edu-programs:
     ПЗПІ:
-      name_long: Інженерія програмного забезпечення
+      name-long: Інженерія програмного забезпечення
-      department_gen: Програмної інженерії
+      department-gen: Програмної інженерії
       code: 121 # TODO: change to F2?
     КУІБ:
-      name_long: Управління інформаційною безпекою
+      name-long: Управління інформаційною безпекою
-      department_gen: Інфокомунікаційної інженерії ім. В. В. Поповського
+      department-gen: Інфокомунікаційної інженерії ім. В. В. Поповського
       code: 125 # TODO: change to F5?
       description: Кібербезпека та захист інформації
     КНТ:
-      name_en: CST # computer sciences and technologies
+      name-en: CST # computer sciences and technologies
-      name_long: Комп'ютерні науки та технології
+      name-long: Комп'ютерні науки та технології
-      department_gen: Системотехніки
+      department-gen: Системотехніки
-      department_en: ST
+      department-en: ST
       code: 122
   subjects:
     DMT: Decision making theory

src/csl/dstu-3008-2015.csl

@@ -9,14 +9,13 @@
   <info>
     <title>ДСТУ 3008:2015 (DSTU 3008:2015)</title>
     <title-short>ДСТУ 3008:2015</title-short>
-    <id>http://www.zotero.org/styles/dstu-3008-2015</id>
+    <id>dstu-3008-2015</id>
-    <link href="http://www.zotero.org/styles/dstu-3008-2015" rel="self" />
     <link
             href="https://uk.wikipedia.org/wiki/ДСТУ_3008:2015"
             rel="documentation"
         />
     <author>
-      <name>Automated</name>
+      <name>Linerds</name>
     </author>
     <category citation-format="numeric" />
     <category field="generic-base" />

src/helpers.typ

@@ -15,28 +15,37 @@
 ).at(month - 1)
 
 #let is-cyr(c) = regex("[\p{Cyrillic}]") in c
-#let is-empty(val) = val == none or str(val).len() == 0 or val == []
-#let in-keys(key, dict) = str(key) in dict.keys()
 
-#let degree-get(m) = if in-keys("degree", m) and not is-empty(m.degree) { [#m.degree\ ] }
+/// type-safe emptiness check
+#let is-empty(val) = {
+  if val == none { return true }
+  if type(val) == str { val.len() == 0 } else if type(val) == array { val == [] } else { false }
+}
 
+#let degree-get(m) = if "degree" in m and not is-empty(m.degree) { [#m.degree\ ] }
+
+/// returns verb form based on gender ("m", "f", or "p" for plural)
 #let gender-verb(verb, gender: "p") = {
   (
     "author": ("m": "Виконав", "f": "Виконала", "p": "Виконали"),
     "mentor": ("m": "Перевірив", "f": "Перевірила", "p": "Перевірили"),
   )
     .at(verb)
-    .at(if gender == "m" or gender == "f" { gender } else { "p" }, default: "p")
+    .at(if gender == "m" or gender == "f" { gender } else { "p" })
+}
+
+/// returns verb form for dictionary containing gender field
+#let gender-form(verb, dict: none) = {
+  let g = if type(dict) == dictionary and "gender" in dict { dict.gender } else { "p" }
+  gender-verb(verb, gender: g)
 }
-#let gender-get(dict) = if type(dict) == dictionary and in-keys("gender", dict) { dict.gender }
-#let gender-form(verb, dict: none) = gender-verb(verb, gender: gender-get(dict))
 
 #let pz-lb-title(type, number: none) = {
   let type-title = (
     "ЛБ": [Звіт \ з лабораторної роботи],
     "ПЗ": [Звіт \ з практичної роботи],
     "КР": [Контрольна робота],
-    "РФ": [Реферат], // зрада
+    "РФ": [Реферат],
     "ІДЗ": [Індивідуальне домашнє завдання],
   ).at(type, default: type)
   if not is-empty(number) { [#type-title №#number] } else { [#type-title] }

src/lib.typ

@@ -5,20 +5,17 @@
 #import "./style.typ"
 #import "./utils.typ"
 
-// Coursework template {{{1
+/// Coursework template for NURE
-
+/// - university (str): University code, default "ХНУРЕ"
-/// DSTU 3008:2015 Template for NURE
+/// - subject (str): Subject short name
-/// -> content
+/// - title (str): Work title
-/// - doc (content): Content to apply the template to.
+/// - authors (array): List of author dictionaries
-/// - title (str): Title of the document.
+/// - mentors (array): List of mentor dictionaries
-/// - subject (str): Subject short name.
+/// - task-list (dict): Task metadata
-/// - authors ((name: str, full_name_gen: str, variant: int, course: int, semester: int, group: str, gender: str),): List of authors.
+/// - calendar-plan (dict): Calendar plan table and approval date
-/// - mentors ((name: str, degree: str),): List of mentors.
+/// - abstract (dict): Keywords and abstract text
-/// - task_list (done_date: datetime, initial_date: datetime, source: (content | str), content: (content | str), graphics: (content | str)): Task list object.
+/// - bib-path (str): Path to bibliography file
-/// - calendar_plan ( plan_table: (content | str), approval_date: datetime): Calendar plan object.
+/// - appendices (content): Appendix content
-/// - abstract (keywords: (str, ), text: (content | str)): Abstract object.
-/// - bib_path path: Path to the bibliography yaml file.
-/// - appendices (content): Content with appendices.
 #let coursework(
   doc,
   university: "ХНУРЕ",
@@ -26,55 +23,49 @@
   title: none,
   authors: (),
   mentors: (),
-  task_list: (),
+  task-list: (),
-  calendar_plan: (),
+  calendar-plan: (),
   abstract: (),
-  bib_path: none,
+  bib-path: none,
   appendices: (),
 ) = {
   set document(title: title, author: authors.map(c => c.name))
 
   show: style.dstu.with(skip: 1)
 
-  tp.cw.coursework(
+  tp.cw.nure(
     university,
     subject,
-    type,
     title,
     authors,
     mentors,
-    task_list,
+    task-list,
-    calendar_plan,
+    calendar-plan,
     abstract,
   )
 
   doc
 
-  // bibliography {{{2
+  // Bibliography with DSTU formatting
   {
-    // shall CSL descend to hell for it's a horrid standard
     show regex("^\\d+\\."): it => [#it#h(0.5cm)]
     show block: it => [#it.body#parbreak()]
-    bibliography(bib_path, title: [Перелік джерел посилання], style: "csl/dstu-3008-2015.csl", full: true)
+    bibliography(bib-path, title: [Перелік джерел посилання], style: "csl/dstu-3008-2015.csl", full: true)
   }
 
   style.appendices(appendices)
 }
 
-// Practice and Laboratory works template {{{1
+/// Practice and Laboratory works template
-
+/// - layout (str): "default", "minimal", or "complex"
-/// DSTU 3008:2015 Template for NURE
+/// - university (str): University code
-/// -> content
+/// - edu-program (str): Education program code
-/// - doc (content): Content to apply the template to.
+/// - subject (str): Subject code
-/// - layout: ("default" | "simple"): Title page layout variant.
+/// - type (str): Work type (ЛБ, ПЗ, КР, РФ, ІДЗ)
-/// - university: "ХНУРЕ": University metadata. Optional.
+/// - number (int): Work number
-/// - edu-program: (str or none): Education program shortcode. Optional.
+/// - title (str): Work title
-/// - subject: str: Subject shortcode.
+/// - authors (array): List of authors
-/// - type: ("ЛБ" | "ПЗ" | "КР" | "РФ" | str): Work type.
+/// - mentors (array): List of mentors
-/// - number: int or none: Work number. Optional.
-/// - title: str or none: Work title. Optional.
-/// - authors ((name: str, full_name_gen: str or none, edu-program: str, group: str, gender: str, variant: int or none),): List of authors.
-/// - mentors ((name: str, degree: str, gender: ("m" | "f" | "p" | none)),): List of mentors. Optional.
 #let pz-lb(
   doc,
   layout: "default",
@@ -87,36 +78,37 @@
   authors: (),
   mentors: (),
 ) = {
-  // TODO: add actually relevant asserts
+  assert(authors.len() > 0, message: "At least one author required")
 
-  let edu-program = if edu-program != none { edu-program } else { authors.first().edu_program }
+  let edu-program = if edu-program != none { edu-program } else { authors.first().edu-program }
   let uni = universities.at(university)
 
   set document(title: title, author: authors.map(c => c.name))
 
   show: style.dstu.with(skip: 1)
 
-  // page 1 {{{2
+  // Select layout variant
-
+  let layouts = (
-  (
     "complex": tp.pz-lb.complex(uni, edu-program, subject, type, number, title, authors, mentors),
-    "minimal": tp.pz-lb.minimal(uni, edu-program, subject, type, number, title, authors, mentors),
+    "ХНУРЕ": tp.pz-lb.nure(uni, edu-program, subject, type, number, title, authors, mentors),
-    "default": tp.pz-lb.minimal(uni, edu-program, subject, type, number, title, authors, mentors),
+    "default": tp.pz-lb.nure(uni, edu-program, subject, type, number, title, authors, mentors),
-  ).at(layout)
+  )
+
+  layouts.at(university, default: layouts.default)
 
   pagebreak(weak: true)
 
-  // TODO(unexplrd): wrap my head around the old way
+  // Set heading counter based on title/number
   if title == none {
     if number == none { context counter(heading).update(1) } else {
       context counter(heading).update(number)
     }
   } else {
-    if number != none { context counter(heading).update(number - 1) }
+    if number != none {
+      context counter(heading).update(number - 1)
+    }
     heading(eval(title, mode: "markup"))
   }
 
   doc
 }
-
-// vim:sts=2:sw=2:fdm=marker:cms=/*%s*/

src/style.typ

@@ -1,22 +1,31 @@
-#import "./utils.typ": bold
+#import "utils.typ": bold
+/// Constants for consistent styling
+#let spacing = 0.95em
+#let indent-size = 1.25cm
+#let double-spacing = spacing * 2
+#let double-half-spacing = spacing * 2.5
 
-#let spacing = 0.95em // spacing between lines
+/// Ukrainian alphabet for DSTU 3008:2015 numbering
+#let ukr-enum = "абвгдежиклмнпрстуфхцшщюя".split("")
 
-/// symbols used for numbering according to DSTU 3008:2015
+/// Helper for level 2/3 heading blocks
-#let ukr-enum = "абвгдежиклмнпрстуфхцшщюя".split("") // 0 = "", 1 = "а"
+#let heading-block(it, num: auto) = {
+  v(double-spacing, weak: true)
+  block(width: 100%, spacing: 0em)[
+    #h(indent-size)
+    #counter(heading).display(num)
+    #it.body
+  ]
+  v(double-spacing, weak: true)
+}
 
 /// 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(
   it,
   skip: 0,
   offset: 0,
 ) = {
-  // General Styling {{{1
+  // Page setup
   set page(
     paper: "a4",
     number-align: top + right,
@@ -24,43 +33,33 @@
     numbering: (i, ..) => if i > skip { numbering("1", i + offset) },
   )
 
+  // Text and paragraph
   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: indent-size, all: true))
-  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
+  // Lists
-  // First level
+  set enum(indent: indent-size, body-indent: 0.5cm, numbering: i => ukr-enum.at(i) + ")")
-  set enum(indent: 1.25cm, body-indent: 0.5cm, numbering: i => { ukr-enum.at(i) + ")" })
-
-  // Second level and further nesting
   show enum: it => {
     set enum(indent: 0em, numbering: "1)")
     it
   }
+  set list(indent: indent-size + 0.1cm, body-indent: 0.5cm, marker: [--])
 
-  // Lists are not intended for multiple levels, use `enum`
+  // Figures
-  set list(indent: 1.35cm, body-indent: 0.5cm, marker: [--])
-
-  // Figures {{{1
   show figure: it => {
-    v(spacing * 2, weak: true)
+    v(double-spacing, weak: true)
     it
-    v(spacing * 2, weak: true)
+    v(double-spacing, weak: true)
   }
-
   set figure.caption(separator: [ -- ])
   show figure.where(kind: table): set figure.caption(position: top)
   show figure.caption.where(kind: table): set align(left)
   show figure.where(kind: raw): set figure.caption(position: top)
   show figure.where(kind: raw): set align(left)
 
-  // Numbering {{{1
+  // Numbering reset on level 1 headings
   show heading.where(level: 1): it => {
     counter(math.equation).update(0)
     counter(figure.where(kind: raw)).update(0)
@@ -68,95 +67,66 @@
     counter(figure.where(kind: table)).update(0)
     it
   }
-  set figure(numbering: i => numbering("1.1", counter(heading).get().at(0), i))
+  set figure(numbering: i => context numbering("1.1", counter(heading).get().at(0), i))
-  set math.equation(numbering: i => numbering("(1.1)", counter(heading).get().at(0), i))
+  set math.equation(numbering: i => context numbering("(1.1)", counter(heading).get().at(0), i))
 
-  // Headings {{{1
+  // Headings
   set heading(numbering: "1.1")
-
+  show heading: it => {
-  show heading: it => if it.level == 1 {
+    set text(size: 14pt)
-    set align(center)
+    if it.level == 1 {
-    set text(size: 14pt, weight: "semibold")
+      set align(center)
-
+      set text(weight: "semibold")
-    pagebreak(weak: true)
+      pagebreak(weak: true)
-    upper(it)
+      upper(it)
-    v(spacing * 2, weak: true)
+      v(double-spacing, weak: true)
-  } else {
+    } else {
-    set text(size: 14pt, weight: "regular")
+      set text(weight: "regular")
-
+      heading-block(it, num: if it.level == 3 { it.numbering } else { auto })
-    v(spacing * 2, weak: true)
+    }
-    block(width: 100%, spacing: 0em)[
-      #h(1.25cm)
-      #counter(heading).display(auto)
-      #it.body
-    ]
-    v(spacing * 2, weak: true)
   }
 
-  show heading.where(level: 3): it => {
+  // Code listings
-    set text(size: 14pt, weight: "regular")
-
-    v(spacing * 2, weak: true)
-    block(width: 100%, spacing: 0em)[
-      #h(1.25cm)
-      #counter(heading).display(it.numbering)
-      #it.body
-    ]
-    v(spacing * 2, weak: true)
-  }
-
-  // listings {{{3
   show raw.where(block: true): it => {
-    let new_spacing = 0.5em
+    let code-spacing = 0.5em
-    set block(spacing: new_spacing)
+    set block(spacing: code-spacing)
-    set par(spacing: new_spacing, leading: new_spacing)
+    set par(spacing: code-spacing, leading: code-spacing)
     set text(size: 11pt, weight: "semibold", font: ("Courier New", "Liberation Mono"))
-
+    v(double-half-spacing, weak: true)
-    v(spacing * 2.5, weak: true)
+    pad(it, left: indent-size)
-    pad(it, left: 1.25cm)
+    v(double-half-spacing, weak: true)
-    v(spacing * 2.5, weak: true)
   }
 
   it
-  // }}}
 }
 
 /// DSTU 3008:2015 Appendices Style
-/// -> content
+#let appendices(it) = {
-/// - it (content): Content to apply the style to.
-#let appendices(it) = /* {{{ */ {
-  // Numbering
   counter(heading).update(0)
-  set heading(numbering: (i, ..n) => upper(ukr-enum.at(i)) + numbering(".1.1", ..n))
-  set figure(numbering: i => upper(ukr-enum.at(counter(heading).get().at(0))).i)
-  set math.equation(numbering: i => upper(ukr-enum.at(counter(heading).get().at(0))).i)
 
-  // Heading supplement (Heading name shown when citing with @ref)
+  context {
-  set heading(supplement: [Додаток])
+    let app-letter = upper(ukr-enum.at(counter(heading).get().at(0)))
+    set heading(numbering: (i, ..n) => upper(ukr-enum.at(i)) + numbering(".1.1", ..n))
+    set figure(numbering: i => app-letter + "." + str(i))
+    set math.equation(numbering: i => app-letter + "." + str(i))
+    set heading(supplement: [Додаток])
 
-  // Headings
+    show heading: h => {
-  show heading: it => if it.level == 1 {
+      set text(size: 14pt)
-    set align(center)
+      if h.level == 1 {
-    set text(size: 14pt, weight: "regular")
+        set align(center)
+        set text(weight: "regular")
+        pagebreak(weak: true)
+        bold([ДОДАТОК #counter(heading).display(auto)])
+        linebreak()
+        h.body
+        v(double-spacing, weak: true)
+      } else {
+        set text(weight: "regular")
+        heading-block(h)
+      }
+    }
 
-    pagebreak(weak: true)
+    it
-    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
 }
-
-// vim:sts=2:sw=2:fdm=marker:cms=/*%s*/

src/title-pages/coursework/main.typ

@@ -1 +1 @@
-#import "coursework.typ": *
+#import "nure.typ": *

src/title-pages/coursework/nure.typ

@@ -3,15 +3,14 @@
 #import "../../style.typ": *
 #import "../../utils.typ": bold, hfill, uline
 
-#let coursework(
+#let nure(
   university,
   subject,
-  type,
   title,
   authors,
   mentors,
-  task_list,
+  task-list,
-  calendar_plan,
+  calendar-plan,
   abstract,
 ) = {
   let bib-count = state("citation-counter", ())
@@ -21,10 +20,10 @@
   }
 
   let author = authors.first()
-  let head_mentor = mentors.first()
+  let head-mentor = mentors.first()
 
   let uni = universities.at(university)
-  let edu_prog = uni.edu_programs.at(author.edu_program)
+  let edu-prog = uni.edu-programs.at(author.edu-program)
 
   // page 1 {{{2
   [
@@ -34,7 +33,7 @@
 
     \
 
-    Кафедра #edu_prog.department_gen
+    Кафедра #edu-prog.department-gen
 
     \
 
@@ -49,10 +48,10 @@
       #set align(left)
       #set par(first-line-indent: 0pt)
 
-      #gender-form("author", dict: author) ст. гр. #author.edu_program\-#author.group
+      #gender-form("author", dict: author) ст. гр. #author.edu-program\-#author.group
 
       \
-      Керівник:\ #head_mentor.degree
+      Керівник:\ #head-mentor.degree
 
       \
       Робота захищена на оцінку
@@ -67,7 +66,7 @@
       #author.name
 
       \ \
-      #head_mentor.name
+      #head-mentor.name
 
       \
       #underline(" " * 35)
@@ -78,7 +77,7 @@
 
     #v(1fr)
 
-    Харків -- #task_list.done_date.display("[year]")
+    Харків -- #task-list.done-date.display("[year]")
 
     #pagebreak()
   ]
@@ -98,18 +97,18 @@
         Спеціальність
       ],
       {
-        uline(align: left, edu_prog.department_gen)
+        uline(align: left, edu-prog.department-gen)
         linebreak()
         uline(align: left, uni.subjects.at(subject, default: subject))
         linebreak()
-        uline(align: left, [#edu_prog.code #edu_prog.name_long])
+        uline(align: left, [#edu-prog.code #edu-prog.name-long])
       },
     )
     grid(
       columns: (1fr, 1fr, 1fr),
       gutter: 0.3fr,
       [#bold[Курс] #uline(author.course)],
-      [#bold[Група] #uline([#author.edu_program\-#author.group])],
+      [#bold[Група] #uline([#author.edu-program\-#author.group])],
       [#bold[Семестр] #uline(author.semester)],
     )
 
@@ -121,7 +120,7 @@
 
     linebreak()
 
-    uline(align: left)[_#author.full_name_gen _]
+    uline(align: left)[_#author.full-name-gen _]
 
     linebreak()
     linebreak()
@@ -133,30 +132,30 @@
 
     {
       bold[\2. Строк здачі закінченої роботи:]
-      uline(task_list.done_date.display("[day].[month].[year]"))
+      uline(task-list.done-date.display("[day].[month].[year]"))
       hfill(10fr)
     }
 
     linebreak()
 
     bold[\3. Вихідні дані для роботи:]
-    uline(task_list.source)
+    uline(task-list.source)
 
     linebreak()
 
     bold[\4. Зміст розрахунково-пояснювальної записки:]
-    uline(task_list.content)
+    uline(task-list.content)
 
     linebreak()
 
     bold[\5. Перелік графічного матеріалу:]
-    uline(task_list.graphics)
+    uline(task-list.graphics)
 
     linebreak()
 
     {
       bold[\6. Дата видачі завдання:]
-      uline(task_list.initial_date.display("[day].[month].[year]"))
+      uline(task-list.initial-date.display("[day].[month].[year]"))
       hfill(10fr)
     }
 
@@ -170,7 +169,7 @@
 
     linebreak()
 
-    calendar_plan.plan_table
+    calendar-plan.plan-table
 
     linebreak()
 
@@ -182,22 +181,22 @@
         [
           Студент \
           Керівник \
-          #align(center)["#underline[#calendar_plan.approval_date.day()]"]
+          #align(center)["#underline[#calendar-plan.approval-date.day()]"]
         ],
         [
           #uline(align: center, []) \
           #uline(align: center, []) \
-          #uline(align: center, month-gen(calendar_plan.approval_date.month()))
+          #uline(align: center, month-gen(calendar-plan.approval-date.month()))
         ],
         [
           \ \
-          #underline[#calendar_plan.approval_date.year()] р.
+          #underline[#calendar-plan.approval-date.year()] р.
         ],
       ),
       [
         #author.name, \
-        #head_mentor.degree
+        #head-mentor.degree
-        #head_mentor.name.
+        #head-mentor.name.
       ],
     )
 

src/title-pages/pz-lb/complex.typ

@@ -1,5 +1,5 @@
 #import "../../helpers.typ": *
-#let complex(uni, edu_program, subject, type, number, title, authors, mentors) = {
+#let complex(uni, edu-program, subject, type, number, title, authors, mentors) = {
   align(center)[
     Міністерство освіти і науки України \
     #uni.name
@@ -7,10 +7,10 @@
     \
     #set par(first-line-indent: 0pt)
     #align(left)[
-      #let edu = uni.edu_programs.at(edu_program)
+      #let edu = uni.edu-programs.at(edu-program)
-      Кафедра #underline(edu.department_gen) \
+      Кафедра #underline(edu.department-gen) \
       Спеціальність #underline([#edu.code #edu.description]) \
-      Освітня програма #underline(edu.name_long)
+      Освітня програма #underline(edu.name-long)
     ]
 
     \ \
@@ -26,12 +26,12 @@
     #align(right)[
       #if authors.len() == 1 {
         let a = authors.first()
-        [#gender-verb("author", gender: gender-get(a)):\
+        [#gender-form("author", dict: a):\
-          студент групи #a.edu_program\-#a.group\ #a.name\ ]
+          студент групи #a.edu-program\-#a.group\ #a.name\ ]
         text(size: 8pt, [(прізвище та ініціали)\ ])
       } else if authors.len() > 1 [
         #gender-verb("author"):\
-        #for a in authors [студент групи #a.edu_program\-#a.group\ #a.name\ ]
+        #for a in authors [студент групи #a.edu-program\-#a.group\ #a.name\ ]
         #text(size: 8pt, [(прізвище та ініціали)\ ])
       ]
 
@@ -39,7 +39,7 @@
 
       #if mentors.len() == 1 {
         let m = mentors.first()
-        [#gender-verb("mentor", gender: gender-get(m)):\ ]
+        [#gender-form("mentor", dict: m):\ ]
         degree-get(m)
         [#m.name\ ]
         text(size: 8pt, [(прізвище та ініціали)\ ])
@@ -58,4 +58,3 @@
     #datetime.today().display("[year]")
   ]
 }
-

src/title-pages/pz-lb/main.typ

@@ -1,2 +1,2 @@
 #import "complex.typ": *
-#import "minimal.typ": *
+#import "nure.typ": *

src/title-pages/pz-lb/nure.typ

@@ -1,10 +1,10 @@
 #import "../../helpers.typ": *
-#let minimal(uni, edu-program, subject, type, number, title, authors, mentors) = {
+#let nure(uni, edu-program, subject, type, number, title, authors, mentors) = {
   align(center)[
     #upper([Міністерство освіти і науки України\ #uni.name])
 
     \ \
-    Кафедра #uni.edu_programs.at(edu-program).department_gen
+    Кафедра #uni.edu-programs.at(edu-program).department-gen
 
     \ \ \
     #pz-lb-title(type, number: number)
@@ -20,12 +20,12 @@
       #if authors.len() == 1 {
         let a = authors.first()
         [#gender-form("author", dict: a):\ ]
-        [ст. гр. #a.edu_program\-#a.group\ ]
+        [ст. гр. #a.edu-program\-#a.group\ ]
         [#a.name\ ]
         if not is-empty(a.variant) [Варіант: №#a.variant]
       } else if authors.len() > 1 [
         #gender-form("author"):\
-        #for a in authors [ст. гр. #a.edu_program\-#a.group\ #a.name\ ]
+        #for a in authors [ст. гр. #a.edu-program\-#a.group\ #a.name\ ]
       ]
 
       #colbreak()
@@ -50,4 +50,3 @@
     Харків -- #datetime.today().display("[year]")
   ]
 }
-

src/utils.typ

@@ -1,61 +1,56 @@
-// Template formatting functions {{{1
-
 /// bold text
 #let bold(content) = text(weight: "bold")[#content]
 
 /// numberless heading
 #let nheading(title) = heading(depth: 1, numbering: none, title)
 
-/// fill horizontal space with a box and not an empty space
+/// fill horizontal space with a filled box
-#let hfill(width) = box(
+#let hfill(width) = box(width: width, repeat(" "))  // HAIR SPACE (U+200A)
-  width: width,
-  repeat(" "),
-) // NOTE: This is a HAIR SPACE (U+200A), not a regular space
 
-/// make underlined cell with filled value
+/// underlined cell with centered content by default
 #let uline(align: center, content) = underline[
   #if align != left { hfill(1fr) }
   #content
   #if align != right { hfill(1fr) }
 ]
 
-// Helper functions {{{1
+/// Extract filename stem without extension
+#let stem(path) = path.split("/").last().split(".").first()
 
-/// captioned image with label derived from path:
+/// Extract parent directory name
-/// - "image.png" = @image
+#let parent-dir(path) = path.split("/").at(-2, default: "")
-/// - "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("/")
 
-  let label_string = if (
+/// Generate label from image path:
-    parts.len() <= 2 or parts.at(-1).starts-with(parts.at(-2))
+/// - "image.png" → "image"
-  ) {
+/// - "img/foo/bar.png" → "foo_bar"
-    // ("image",), (_, "image") and (.., "img", "img_image")
+#let img-label(path) = {
-    parts.last()
+  let name = stem(path)
+  let parent = parent-dir(path)
+
+  // If parent exists and name doesn't start with parent name, combine them
+  let base = if parent != "" and not name.starts-with(parent) {
+    parent + "_" + name
   } else {
-    // (.., "img", "image") = "img_image"
+    name
-    parts.at(-2) + "_" + parts.at(-1)
-  }.replace(" ", "_")
-
-  let caption = if sink.pos().len() == 0 {
-    caption
-  } else if sink.pos().first() == none {
-    caption + " (рисунок виконано самостійно)"
-  } else {
-    [#caption (за даними #sink.pos().first())]
   }
 
-  [#figure(
+  label(base.replace(" ", "_"))
-      image(path, ..sink.named()),
-      caption: caption,
-    ) #label(label_string)]
 }
 
+/// Format image caption based on optional source
+#let img-caption(base-caption, source) = {
+  if source == none {
+    base-caption + " (рисунок виконано самостійно)"
+  } else if source == () or source == "" {
+    base-caption
+  } else {
+    base-caption + " (за даними " + source + ")"
+  }
+}
 
+/// captioned image with auto-generated label from path
+/// Usage: img("path/to/image.png", "Caption")(optional: "source")
+#let img(path, caption, ..sink) = {
+  let source = sink.pos().at(0, default: ())
+  [ #figure(image(path, ..sink.named()), caption: utils.img-caption(caption, source)) #utils.img-label(path) ]
+}

template/coursework.typ

@@ -1,4 +1,4 @@
-#import "@local/nure:0.1.0": *
+#import "@local/nure:0.1.1": *
 #import style: spacing
 
 #import "utils.typ": img
@@ -6,8 +6,8 @@
 #let authors = (
   (
     name: "Ситник Є. С.",
-    full_name_gen: "Ситника Єгора Сергійовича",
+    full-name-gen: "Ситника Єгора Сергійовича",
-    edu_program: "ПЗПІ",
+    edu-program: "ПЗПІ",
     group: "23-2",
     gender: "m",
     course: 2,
@@ -22,16 +22,16 @@
   (name: "Широкопетлєва М. С.", degree: "Ст. викл. каф. ПІ"),
 )
 
-#let task_list = (
+#let task-list = (
-  done_date: datetime(year: 2024, month: 12, day: 27),
+  done-date: datetime(year: 2024, month: 12, day: 27),
-  initial_date: datetime(year: 2024, month: 9, day: 15),
+  initial-date: datetime(year: 2024, month: 9, day: 15),
   source: "методичні вказівки до виконання курсової роботи, вимоги до інформаційної системи, предметна область, що пов’язана з управлінням класом та класним керівництвом.",
   content: "вступ, аналіз предметної області; постановка задачі; проектування бази даних; опис програми; висновки; перелік джерел посилання.",
   graphics: "загальна діаграма класів, ER-діаграма, UML-діаграми, DFD-діаграма, схема БД в 1НФ, 2НФ, 3НФ, копії екранів (“скриншоти”) прикладної програми, приклади звітів прикладної програми.",
 )
 
-#let calendar_plan = (
+#let calendar-plan = (
-  plan_table: table(
+  plan-table: table(
     columns: 4,
     align: (center, left, center, center),
     [Номер], [Назва етапів курсової роботи], [Строк виконання етапів роботи], [Примітки],
@@ -54,7 +54,7 @@
 
     [12], [Третя контрольна точка з курсової роботи], [27.12.24], [Виконано],
   ),
-  approval_date: datetime(year: 2024, month: 12, day: 27),
+  approval-date: datetime(year: 2024, month: 12, day: 27),
 )
 
 #let abstract = (
@@ -113,10 +113,10 @@
   subject: "БД",
   authors: authors,
   mentors: mentors,
-  task_list: task_list,
+  task-list: task-list,
-  calendar_plan: calendar_plan,
+  calendar-plan: calendar-plan,
   abstract: abstract,
-  bib_path: bytes(read("bibl.yml")), // NOTE: use `bytes("bibl.yml")` as typst looks in template dir when using just filename
+  bib-path: bytes(read("bibl.yml")), // NOTE: use `bytes("bibl.yml")` as typst looks in template dir when using just filename
   appendices: appendices,
 )
 

template/lab.typ

@@ -1,4 +1,4 @@
-#import "@local/nure:0.1.0": *
+#import "@local/nure:0.1.1": *
 #import "utils.typ": img
 
 #import style: spacing
@@ -16,8 +16,8 @@
   authors: (
     (
       name: "Косач Л. П.",
-      full_name_gen: "Косач Лариси Петрівни",
+      full-name-gen: "Косач Лариси Петрівни",
-      edu_program: "КУІБ",
+      edu-program: "КУІБ",
       group: "23-2",
       gender: "f",
       course: 2,
@@ -68,7 +68,7 @@
 #v(-spacing)
 == Частина 1
 #lorem(100)
-== Частина2
+== Частина 2
 #lorem(200)
 
 = Приклад звіту 2

template/utils.typ

@@ -1,36 +1,7 @@
-/// captioned image with label derived from path:
+#import "@local/nure:0.1.1": utils
-/// - "image.png" = @image
+/// captioned image with auto-generated label from path
-/// - "img/image.png" = @image
+/// Usage: img("path/to/image.png", "Caption")(optional: "source")
-/// - "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("/")
+  let source = sink.pos().at(0, default: ())
-
+  [ #figure(image(path, ..sink.named()), caption: utils.img-caption(caption, source)) #utils.img-label(path) ]
-  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(" ", "_")
-
-  let caption = if sink.pos().len() == 0 {
-    caption
-  } else if sink.pos().first() == none {
-    caption + " (рисунок виконано самостійно)"
-  } else {
-    [#caption (за даними #sink.pos().first())]
-  }
-
-  [#figure(
-      image(path, ..sink.named()),
-      caption: caption,
-    ) #label(label_string)]
 }

test-layouts.typ

@@ -1,51 +0,0 @@
-#import "@local/test-multifile:0.1.0" as nure
-
-#import nure.utils: *
-#import nure.style
-
-// #set document(title: "Тест лейаутів", author: "Іванов І.І.")
-
-#let authors = (
-  (
-    name: "Іванов І.І.",
-    full_name_gen: "Іванова Івана Івановича",
-    edu_program: "КУІБ",
-    group: "23-1",
-    gender: "m",
-    variant: 5,
-  ),
-)
-
-#let mentors = (
-  (name: "Петров П.П.", degree: "доцент кафедри ІКІ", gender: "m"),
-)
-
-// Тест default лейауту
-#show: nure.pz-lb.with(
-  layout: "complex",
-  subject: "БД",
-  edu-program: "КУІБ",
-  type: "ЛБ",
-  number: 2,
-  title: "SQL запити",
-  authors: authors,
-  mentors: mentors,
-)
-
-#bold(lorem(10))
-#pagebreak()
-
-// Тест simple лейауту
-// #show: pz-lb.with(
-//   layout: "minimal",
-//   subject: "БД",
-//   type: "ЛБ",
-//   number: 2,
-//   title: "SQL запити",
-//   authors: authors,
-//   mentors: mentors,
-// )
-
-#show: style.appendices
-= #lorem(5)
-

typst.toml

@@ -1,6 +1,6 @@
 [package]
 name = "nure"
-version = "0.1.0"
+version = "0.1.1"
 entrypoint = "src/lib.typ"
 authors = ["linerds"]
 license = "GPL-3.0"