update unexplrd-mise template

note: ПРОГ was renamed to Прог

README.md

@@ -25,37 +25,38 @@ This template:
 - `hfill` - Fills horizontal space with a filled box instead of just empty space; useful for creating underlines.
 - `uline` - Creates underlined fields that need to be filled, such as the name field on the task list.
 - `bold` - Inserts bold text inside functional environments.
-- `img` - Inserts images with a caption, automatically deriving the label from the image file name.
+- `img` - Inserts images with a caption, automatically deriving the label from the image file name (use via `#import "@local/nure:0.1.1": utils` and call `utils.img`).
 
-**Note:** `img()` is provided in `utils.typ` in project's root directory for compatibility, until [path() type](https://github.com/typst/typst/pull/7555) is released.
+**Note:** `img()` is provided in `template/utils.typ` so you can copy it into your project root for compatibility, until [path() type](https://github.com/typst/typst/pull/7555) is released.
 
 ## Usage
 
 ### 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
-Copy `src/` to your project's root directory, optionally renaming `src/` to `lib/`.
+Copy `src/` to your project's root directory, optionally renaming `src/` to `lib/` (then import `src/lib.typ` or `lib/lib.typ` accordingly).
 
 ### 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": *
 
+// NOTE: all template arguments use kebab-case.
+
 // 1. Setup the document
 // by setting values directly...
 #show: pz-lb.with(
   title: "Some title",
-  // etc: "and so on",
   // ...
 )
 // ...or using a yaml/toml file
@@ -73,7 +74,7 @@ Some text
 #include "chapters/chapter1.typ"
 #include "chapters/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.
+// you have to import the package or a lib.typ inside a module (e.g. #import "@local/nure:0.1.1": utils).
 
 
 // If you ever need appendices in pz-lb template use the show rule
@@ -81,6 +82,8 @@ Some text
 // so it can put bibliography before appendices
 #show: style.appendices
 
+// For coursework appendices, pass them via `appendices:` argument instead.
+
 = Quote
 #link("https://youtu.be/bJQj1uKtnus")[
   The art isn't the art, the art is never the art,
@@ -91,7 +94,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 +113,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 be relative to the package root, 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 applies to `utils.img` unless you copy `template/utils.typ` into your project root and import from there.
 
 ### Bibliography Format
 The template uses a custom CSL (Citation Style Language) file located at `src/csl/dstu-3008-2015.csl` to format bibliography entries.

src/config/universities.yaml

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

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>
-    <link href="http://www.zotero.org/styles/dstu-3008-2015" rel="self" />
+    <id>dstu-3008-2015</id>
     <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
-
-/// 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.
+/// Coursework template for NURE
+/// - university (str): University code, default "ХНУРЕ"
+/// - subject (str): Subject short name
+/// - title (str): Work title
+/// - authors (array): List of author dictionaries
+/// - mentors (array): List of mentor dictionaries
+/// - task-list (dict): Task metadata
+/// - calendar-plan (dict): Calendar plan table and approval date
+/// - abstract (dict): Keywords and abstract text
+/// - bib-path (str): Path to bibliography file
+/// - appendices (content): Appendix content
 #let coursework(
   doc,
   university: "ХНУРЕ",
@@ -26,55 +23,49 @@
   title: none,
   authors: (),
   mentors: (),
-  task_list: (),
-  calendar_plan: (),
+  task-list: (),
+  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,
-    calendar_plan,
+    task-list,
+    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
-
-/// DSTU 3008:2015 Template for NURE
-/// -> content
-/// - doc (content): Content to apply the template to.
-/// - layout: ("default" | "simple"): Title page layout variant.
-/// - university: "ХНУРЕ": University metadata. Optional.
-/// - edu-program: (str or none): Education program shortcode. 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.
+/// Practice and Laboratory works template
+/// - layout (str): "default", "minimal", or "complex"
+/// - university (str): University code
+/// - edu-program (str): Education program code
+/// - subject (str): Subject code
+/// - type (str): Work type (ЛБ, ПЗ, КР, РФ, ІДЗ)
+/// - number (int): Work number
+/// - title (str): Work title
+/// - authors (array): List of authors
+/// - mentors (array): List of mentors
 #let pz-lb(
   doc,
   layout: "default",
@@ -86,37 +77,42 @@
   title: none,
   authors: (),
   mentors: (),
+  skip-heading: false,
 ) = {
-  // 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),
+    "ХНУРЕ": () => tp.pz-lb.nure(uni, edu-program, subject, type, number, title, authors, mentors),
+    "default": () => tp.pz-lb.nure(uni, edu-program, subject, type, number, title, authors, mentors),
+  )
 
-  (
-    "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),
-    "default": tp.pz-lb.minimal(uni, edu-program, subject, type, number, title, authors, mentors),
-  ).at(layout)
+  (layouts.at(university, default: layouts.default))()
 
-  pagebreak(weak: true)
+  if not skip-heading {
+    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)
+    // 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)
+      }
+
+      heading(eval(title, mode: "markup"))
     }
-  } 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/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 = "абвгдежиклмнпрстуфхцшщюя".clusters()
 
-/// symbols used for numbering according to DSTU 3008:2015
-#let ukr-enum = "абвгдежиклмнпрстуфхцшщюя".split("") // 0 = "", 1 = "а"
+/// Helper for level 2/3 heading blocks
+#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: 1.25cm,
-    all: true,
-  ))
-
+  set par(justify: true, spacing: spacing, leading: spacing, first-line-indent: (amount: indent-size, 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 => { ukr-enum.at(i) + ")" })
-
-  // Second level and further nesting
+  // Lists
+  set enum(indent: indent-size, body-indent: 0.5cm, numbering: i => ukr-enum.at(i - 1) + ")")
   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`
-  set list(indent: 1.35cm, body-indent: 0.5cm, marker: [--])
-
-  // Figures {{{1
+  // Figures
   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,70 @@
     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))
+  set figure(numbering: i => context 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 => 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: it => {
+    set text(size: 14pt)
+    if it.level == 1 {
+      set align(center)
+      set text(weight: "semibold")
+      pagebreak(weak: true)
+      upper(it)
+      v(double-spacing, weak: true)
+    } else {
+      set text(weight: "regular")
+      heading-block(it, num: if it.level == 3 { it.numbering } else { auto })
+    }
   }
 
-  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
+  // Code listings
   show raw.where(block: true): it => {
-    let new_spacing = 0.5em
-    set block(spacing: new_spacing)
-    set par(spacing: new_spacing, leading: new_spacing)
+    let code-spacing = 0.5em
+    set block(spacing: code-spacing)
+    set par(spacing: code-spacing, leading: code-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)
+    v(double-half-spacing, weak: true)
+    pad(it, left: indent-size)
+    v(double-half-spacing, weak: true)
   }
 
   it
-  // }}}
 }
 
 /// DSTU 3008:2015 Appendices Style
-/// -> content
-/// - it (content): Content to apply the style to.
-#let appendices(it) = /* {{{ */ {
-  // Numbering
+#let appendices(it) = {
   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)
+  set heading(numbering: (i, ..n) => upper(ukr-enum.at(i - 1)) + numbering(".1.1", ..n))
   set heading(supplement: [Додаток])
 
-  // Headings
-  show heading: it => if it.level == 1 {
-    set align(center)
-    set text(size: 14pt, weight: "regular")
+  let app-letter = context upper(ukr-enum.at(counter(heading).get().at(0) - 1))
+  set figure(numbering: i => app-letter + "." + str(i))
+  set math.equation(numbering: i => [(#app-letter.#str(i))])
 
-    pagebreak(weak: true)
-    bold([ДОДАТОК #counter(heading).display(auto)])
-    linebreak()
-    it.body
-    v(spacing * 2, weak: true)
-  } else {
-    set text(size: 14pt, weight: "regular")
+  show heading: h => {
+    set text(size: 14pt)
+    if h.level == 1 {
+      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)
 
-    v(spacing * 2, weak: true)
-    block(width: 100%, spacing: 0em)[
-      #h(1.25cm)
-      #counter(heading).display(auto)
-      #it.body
-    ]
-    v(spacing * 2, weak: true)
+      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)
+    }
   }
 
   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,
-  calendar_plan,
+  task-list,
+  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.name.
+        #head-mentor.degree
+        #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)
-      Кафедра #underline(edu.department_gen) \
+      #let edu = uni.edu-programs.at(edu-program)
+      Кафедра #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)):\
-          студент групи #a.edu_program\-#a.group\ #a.name\ ]
+        [#gender-form("author", dict: a):\
+          студент групи #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
-#let hfill(width) = box(
-  width: width,
-  repeat(" "),
-) // NOTE: This is a HAIR SPACE (U+200A), not a regular space
+/// fill horizontal space with a filled box
+#let hfill(width) = box(width: width, repeat(" "))  // HAIR SPACE (U+200A)
 
-/// 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:
-/// - "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("/")
+/// Extract parent directory name
+#let parent-dir(path) = path.split("/").at(-2, default: "")
 
-  let label_string = if (
-    parts.len() <= 2 or parts.at(-1).starts-with(parts.at(-2))
-  ) {
-    // ("image",), (_, "image") and (.., "img", "img_image")
-    parts.last()
+/// Generate label from image path:
+/// - "image.png" → "image"
+/// - "img/foo/bar.png" → "foo_bar"
+#let img-label(path) = {
+  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"
-    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())]
+    name
   }
 
-  [#figure(
-      image(path, ..sink.named()),
-      caption: caption,
-    ) #label(label_string)]
+  label(base.replace(" ", "_"))
 }
 
+/// 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/default/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: "Ситника Єгора Сергійовича",
-    edu_program: "ПЗПІ",
+    full-name-gen: "Ситника Єгора Сергійовича",
+    edu-program: "ПЗПІ",
     group: "23-2",
     gender: "m",
     course: 2,
@@ -22,16 +22,16 @@
   (name: "Широкопетлєва М. С.", degree: "Ст. викл. каф. ПІ"),
 )
 
-#let task_list = (
-  done_date: datetime(year: 2024, month: 12, day: 27),
-  initial_date: datetime(year: 2024, month: 9, day: 15),
+#let task-list = (
+  done-date: datetime(year: 2024, month: 12, day: 27),
+  initial-date: datetime(year: 2024, month: 9, day: 15),
   source: "методичні вказівки до виконання курсової роботи, вимоги до інформаційної системи, предметна область, що пов’язана з управлінням класом та класним керівництвом.",
   content: "вступ, аналіз предметної області; постановка задачі; проектування бази даних; опис програми; висновки; перелік джерел посилання.",
   graphics: "загальна діаграма класів, ER-діаграма, UML-діаграми, DFD-діаграма, схема БД в 1НФ, 2НФ, 3НФ, копії екранів (“скриншоти”) прикладної програми, приклади звітів прикладної програми.",
 )
 
-#let calendar_plan = (
-  plan_table: table(
+#let calendar-plan = (
+  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,
-  calendar_plan: calendar_plan,
+  task-list: task-list,
+  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/default/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: "Косач Лариси Петрівни",
-      edu_program: "КУІБ",
+      full-name-gen: "Косач Лариси Петрівни",
+      edu-program: "КУІБ",
       group: "23-2",
       gender: "f",
       course: 2,
@@ -68,7 +68,7 @@
 #v(-spacing)
 == Частина 1
 #lorem(100)
-== Частина2
+== Частина 2
 #lorem(200)
 
 = Приклад звіту 2

template/default/utils.typ

@@ -0,0 +1,7 @@
+#import "@local/nure:0.1.1": utils
+/// 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/unexplrd-mise/.mise/config.toml

@@ -0,0 +1,67 @@
+[settings]
+quiet = true
+env_shell_expand = true
+lockfile = true
+
+[tools]
+typst = "latest"
+typstyle = "latest"
+tinymist = "latest"
+yq = "latest"
+
+[vars]
+vendor_dir = "{{config_root}}/vendor"
+package_dir = "{{vars.vendor_dir}}/typst-packages"
+
+work_doc_config  = "src/doc.toml"
+work_input_file  = "src/main.typ"
+work_output_file = "{{config_root}}/main.pdf"
+
+nure_package_repo = "https://gitea.linerds.us/pencelheimer/typst_nure_template.git"
+nure_package_ref  = "0.1.1"
+
+nure_package_rev = "9abbc7c1e161523145c27a098add79886968547c"
+
+nure_package_name = "vendor/nure"
+nure_package_ver  = "{{vars.nure_package_ref}}"
+
+nure_package_path = "{{vars.package_dir}}/{{vars.nure_package_name}}/{{vars.nure_package_ver}}"
+
+[env]
+TYPST_PACKAGE_DIR  = "{{vars.package_dir}}"
+TYPST_PACKAGE_PATH = "$TYPST_PACKAGE_DIR"
+
+[tasks]
+compile.depends = ["fetch-nure-package"]
+watch.depends   = ["fetch-nure-package"]
+compile.run     = "mise exec -- typst compile {{vars.work_input_file}} {{vars.work_output_file}}"
+watch.run       = "mise exec -- typst watch {{vars.work_input_file}} {{vars.work_output_file}}"
+format.run      = "mise exec -- typstyle -l 120 -i $MISE_PROJECT_ROOT/src"
+clean.run       = "rm -rvif *.pdf"
+
+update-package-rev.run = "mise config set vars.nure_package_rev $(git ls-remote {{vars.nure_package_repo}} refs/heads/{{vars.nure_package_ref}} | cut -f1)"
+
+[tasks.fetch-nure-package]
+silent = "stdout"
+run = """
+  #!/usr/bin/env bash
+
+  if [ ! -d {{vars.nure_package_path}}/.git ]; then
+    git clone --depth 1 --revision {{vars.nure_package_rev}} {{vars.nure_package_repo}} {{vars.nure_package_path}}
+  else
+    git -C {{vars.nure_package_path}} fetch --depth 1 origin {{vars.nure_package_rev}}
+    git -C {{vars.nure_package_path}} checkout {{vars.nure_package_rev}}
+  fi
+"""
+
+[tasks.rename]
+depends = ["compile"]
+run = """
+  #!/usr/bin/env bash
+  # Generates the following name from doc.toml: ПЗ1_Прізвище_ПЗПІ-23-2_ПарП.pdf
+  # Assumes authors.at(0).name to be in the following format: "Прізвище І. Б."
+
+  final_name=$(mise exec -- yq '.type + (.number | tostring) + "_" + (.authors[0].name | split(" "))[0] + "_" + (.authors[0].edu-program + "-" + .authors[0].group) + "_" + .subject + ".pdf"' "{{vars.work_doc_config}}");
+
+  cp -v "{{vars.work_output_file}}" "$final_name"
+"""

template/unexplrd-mise/.mise/mise.lock

@@ -0,0 +1,35 @@
+[[tools.tinymist]]
+version = "0.14.14"
+backend = "aqua:Myriad-Dreamin/tinymist"
+"platforms.linux-arm64" = { checksum = "sha256:39eb99d290fd1aa0e4508e5d5bbbf5a49648cf26da8e7bc3ff49f75c5fd0dc6c", url = "https://github.com/Myriad-Dreamin/tinymist/releases/download/v0.14.14/tinymist-linux-arm64"}
+"platforms.linux-x64" = { checksum = "sha256:cda2ba76a455f3577cf2a1bd6340b75491f0c673770f631cf4d3232663860776", url = "https://github.com/Myriad-Dreamin/tinymist/releases/download/v0.14.14/tinymist-linux-x64"}
+"platforms.macos-arm64" = { checksum = "sha256:ea7a22af0d54a71fbd1ee6c8c9f8434b521549926ae0f53a82391adeea741aba", url = "https://github.com/Myriad-Dreamin/tinymist/releases/download/v0.14.14/tinymist-darwin-arm64"}
+"platforms.macos-x64" = { checksum = "sha256:f640889414d5030de1f03b966ccb10a84941bc1176980ff956d66714508ccd85", url = "https://github.com/Myriad-Dreamin/tinymist/releases/download/v0.14.14/tinymist-darwin-x64"}
+"platforms.windows-x64" = { checksum = "sha256:3d39c7b417287d8689c69159b65fbc62427e141b9489500ad81039ee783f2549", url = "https://github.com/Myriad-Dreamin/tinymist/releases/download/v0.14.14/tinymist-win32-x64.exe"}
+
+[[tools.typst]]
+version = "0.14.2"
+backend = "aqua:typst/typst"
+"platforms.linux-arm64" = { checksum = "sha256:491b101aa40a3a7ea82a3f8a6232cabb4e6a7e233810082e5ac812d43fdcd47a", url = "https://github.com/typst/typst/releases/download/v0.14.2/typst-aarch64-unknown-linux-musl.tar.xz"}
+"platforms.linux-x64" = { checksum = "sha256:a6044cbad2a954deb921167e257e120ac0a16b20339ec01121194ff9d394996d", url = "https://github.com/typst/typst/releases/download/v0.14.2/typst-x86_64-unknown-linux-musl.tar.xz"}
+"platforms.macos-arm64" = { checksum = "sha256:470aa49a2298d20b65c119a10e4ff8808550453e0cb4d85625b89caf0cedf048", url = "https://github.com/typst/typst/releases/download/v0.14.2/typst-aarch64-apple-darwin.tar.xz"}
+"platforms.macos-x64" = { checksum = "sha256:4e91d8e1e33ab164f949c5762e01ee3faa585c8615a2a6bd5e3677fa8506b249", url = "https://github.com/typst/typst/releases/download/v0.14.2/typst-x86_64-apple-darwin.tar.xz"}
+"platforms.windows-x64" = { checksum = "sha256:51353994ac83218c3497052e89b2c432c53b9d4439cdc1b361e2ea4798ebfc13", url = "https://github.com/typst/typst/releases/download/v0.14.2/typst-x86_64-pc-windows-msvc.zip"}
+
+[[tools.typstyle]]
+version = "0.14.4"
+backend = "aqua:Enter-tainer/typstyle"
+"platforms.linux-arm64" = { checksum = "sha256:b8c220c0d940d7690fb15ef10415de35fdc115465a7534d8102459c68aeec74d", url = "https://github.com/typstyle-rs/typstyle/releases/download/v0.14.4/typstyle-aarch64-unknown-linux-gnu"}
+"platforms.linux-x64" = { checksum = "sha256:48d9a9a3885855f1b4f6c2b8ea9739623bc458b99c015b77c4f50a1f342ea091", url = "https://github.com/typstyle-rs/typstyle/releases/download/v0.14.4/typstyle-x86_64-unknown-linux-musl"}
+"platforms.macos-arm64" = { checksum = "sha256:dda3a162f2457a40570c3552cc9c01004138b33f2f921112b117d72f48bd6d56", url = "https://github.com/typstyle-rs/typstyle/releases/download/v0.14.4/typstyle-aarch64-apple-darwin"}
+"platforms.macos-x64" = { checksum = "sha256:2343f7a4801d9bbda5d7441e8fea95f98b590d6aa3083da5c4e4ca3de885350f", url = "https://github.com/typstyle-rs/typstyle/releases/download/v0.14.4/typstyle-x86_64-apple-darwin"}
+"platforms.windows-x64" = { checksum = "sha256:b16aebaed0aa296ef3e055d611f1e917f5849d3eb0f953bbcaa6f09f0503fb5b", url = "https://github.com/typstyle-rs/typstyle/releases/download/v0.14.4/typstyle-x86_64-pc-windows-msvc.exe"}
+
+[[tools.yq]]
+version = "4.52.2"
+backend = "aqua:mikefarah/yq"
+"platforms.linux-arm64" = { checksum = "sha256:c82856ac30da522f50dcdd4f53065487b5a2927e9b87ff637956900986f1f7c2", url = "https://github.com/mikefarah/yq/releases/download/v4.52.2/yq_linux_arm64"}
+"platforms.linux-x64" = { checksum = "sha256:a74bd266990339e0c48a2103534aef692abf99f19390d12c2b0ce6830385c459", url = "https://github.com/mikefarah/yq/releases/download/v4.52.2/yq_linux_amd64"}
+"platforms.macos-arm64" = { checksum = "sha256:34613ea97c4c77e1894a8978dbf72588d187a69a6292c10dab396c767a1ecde7", url = "https://github.com/mikefarah/yq/releases/download/v4.52.2/yq_darwin_arm64"}
+"platforms.macos-x64" = { checksum = "sha256:54a63555210e73abed09108097072e28bf82a6bb20439a72b55509c4dd42378d", url = "https://github.com/mikefarah/yq/releases/download/v4.52.2/yq_darwin_amd64"}
+"platforms.windows-x64" = { checksum = "sha256:2b6cd8974004fa0511f6b6b359d2698214fadeb4599f0b00e8d85ae62b3922d4", url = "https://github.com/mikefarah/yq/releases/download/v4.52.2/yq_windows_amd64.exe"}

template/unexplrd-mise/README.md

@@ -0,0 +1,84 @@
+# unexplrd's example setup with mise
+
+This example has the following structure:
+```
+.
+├── .mise/
+│   ├── config.toml
+│   └── mise.lock
+├── vendor/
+│   └── typst-packages/
+│       └── ...
+└── src/
+    ├── assets/
+    │   ├── foo.csv
+    │   ├── bar.c
+    │   └── ...
+    ├── figures/
+    │   ├── clojure-logo.png
+    │   ├── error-log.jpg
+    │   └── ...
+    ├── doc.toml
+    ├── main.typ
+    └── utils.typ
+```
+
+## Advantages
+- Minimal: all you need is `mise`, see https://mise.jdx.dev/
+- Declarative approach: less unexpected behavior like broken versions in flaky setups
+- Fixed dependencies: locked Typst version, `nure` package fetched from a specific commit
+- Customizable: it's just a `.toml` file, modify it according to your needs
+
+## Project structure
+All work contents are stored in `src/` to avoid clutter.
+
+### Files
+- `src/doc.toml`: work-specific settings, could be auto-filled, useful for scripts, see (TODO: add a demo nushell script)
+- `src/utils.typ`: utilities and functions used across the project
+- `src/main.typ`: main entry file
+
+### Directories
+- `src/chapters/`: for breaking up the project into multiple files, if necessary
+- `src/figures/`: for images and pictures
+- `src/assets/`: other non-image, non-typst files
+
+## Mise
+
+### Tasks
+- `compile`: Execute `typst compile` on `src/main.typ`
+- `watch`: Execute `typst watch` on `src/main.typ`
+- `rename`: Copy output `.pdf` file with an auto-generated name from metadata in `doc.toml`
+- `fetch-nure-package`: clone package git repository to a directory specified in `[vars]`
+- `update-package-rev`: updates `vars.nure_package_rev` with the last commit id from the specified branch (`vars.nure_package_ref`)
+
+### Examples
+- A patch to add new subjects to the package:
+  ```diff
+  diff --git a/src/config/universities.yaml b/src/config/universities.yaml
+  index 8855a07..1aefc96 100644
+  --- a/src/config/universities.yaml
+  +++ b/src/config/universities.yaml
+  @@ -60,7 +60,6 @@
+       ПЕСЕ: Психологія екстремальних стосунків та ефективної адаптації
+       ПНП: Програмування на платформі .NЕТ
+       ПП: Проектний практикум
+  -    ПРОГ: Програмування
+       ПарП: Параллельне програмування
+       СА: Системний аналіз
+       СМП: Скриптові мови програмування
+  @@ -76,3 +75,10 @@
+       ФІЛ: Філософія
+       ФВС: Фізичне виховання та спорт
+       ХТ: Хмарні технології
+  +    АКС: Архітектура комп'ютерних систем
+  +    ІКС: Інформаційно-комунікаційні системи
+  +    МБ: Мережна безпека
+  +    МКр: Мережна криміналістика
+  +    ОКЗІ: Основи криптографічного захисту інформації
+  +    Прог: Програмування
+  +    ТІК: Теорія інформації та кодування
+  ```
+  To apply it, add the following command to the end of `fetch_nure_package` task:
+  ```sh
+  git -C {{vars.nure_package_path}} apply --check --apply --quiet $MISE_PROJECT_ROOT/custom-subjects.patch || exit 0
+  ```

template/unexplrd-mise/src/doc.toml

@@ -0,0 +1,19 @@
+university = "ХНУРЕ"
+subject = "АКС"
+type = "ЛБ"
+number = 1
+
+[[mentors]]
+name = ""
+degree = ""
+gender = ""
+
+[[authors]]
+name = ""
+edu-program = "КУІБ"
+group = "24-1"
+gender = "m"
+variant = 6
+full-name-gen = ""
+course = 2
+semester = 4

template/unexplrd-mise/src/main.typ

@@ -0,0 +1,28 @@
+#import "@vendor/nure:0.1.1": *
+#import "utils.typ": *
+
+#import style: spacing
+
+// Apply custom rule from utils.typ
+// #show: correctly-indent-list-and-enum-items
+
+// #show: style.dstu
+#show: pz-lb.with(..toml("doc.toml"), title: "") // set title to none if empty
+
+/// Useful snippets
+
+/// Import a .csv table
+// #figure(
+//   caption: [],
+//   table(
+//     columns: 4,
+//     table.header([], [], [], []),
+//     ..csv("assets/table.csv").flatten(),
+//   ),
+// )
+
+/// Appendices
+// #style.appendices(include "chapters/appendices.typ")
+// or
+// #show: style.appendices
+// = ...

template/unexplrd-mise/src/utils.typ

@@ -0,0 +1,112 @@
+#import "@vendor/nure:0.1.1": utils
+
+/// 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) ]
+}
+
+/// takes in a string of code, e.g. #code(read("foo.c"))
+#let code(content) = raw(block: true, theme: none, content)
+
+/// read path as bytes
+#let b(path) = bytes(read(path, encoding: none))
+
+/// include chapters by file names from /chapters
+#let chapters(ch) = (
+  array(ch).map(chapter => include str(chapter) + ".typ").join()
+)
+
+/// https://forum.typst.app/t/how-to-make-bullet-list-item-bodies-flow-like-paragraphs/3756/3?u=andrew
+/// Spacing doesn't work the same way as native solution if par leading and
+/// spacing are different.
+#let correctly-indent-list-and-enum-items(doc) = {
+  let first-line-indent() = if type(par.first-line-indent) == dictionary {
+    par.first-line-indent.amount
+  } else {
+    par.first-line-indent
+  }
+
+  show list: li => {
+    for (i, it) in li.children.enumerate() {
+      let nesting = state("list-nesting", 0)
+      let indent = context h((nesting.get() + 1) * li.indent)
+      let get-nesting() = calc.div-euclid(nesting.get(), 10)
+      let marker = context {
+        let n = get-nesting()
+        if type(li.marker) == array {
+          li.marker.at(calc.rem-euclid(n, li.marker.len()))
+        } else if type(li.marker) == content {
+          li.marker
+        } else {
+          li.marker(n)
+        }
+      }
+      let parents = state("enum-parents", ()) // Support enum nesting.
+      let body = {
+        parents.update(arr => arr + (-1,))
+        nesting.update(x => x + 10)
+        it.body + parbreak()
+        nesting.update(x => x - 10)
+        parents.update(arr => arr.slice(0, -1))
+      }
+      let content = {
+        marker
+        h(li.body-indent)
+        body
+      }
+      context pad(left: int(nesting.get() != 0) * li.indent, content)
+    }
+  }
+
+  show enum: en => {
+    let start = if en.start == auto {
+      if en.children.first().has("number") {
+        if en.reversed { en.children.first().number } else { 1 }
+      } else {
+        if en.reversed { en.children.len() } else { 1 }
+      }
+    } else {
+      en.start
+    }
+    let number = start
+    for (i, it) in en.children.enumerate() {
+      number = if it.number != auto { it.number } else { number }
+      if en.reversed { number = start - i }
+      let parents = state("enum-parents", ())
+      let get-parents() = parents.get().filter(x => x >= 0)
+      let indent = context h((get-parents().len() + 1) * en.indent)
+      let num = if en.full {
+        context numbering(en.numbering, ..get-parents(), number)
+      } else {
+        numbering(en.numbering, number)
+      }
+      let max-num = if en.full {
+        context numbering(en.numbering, ..get-parents(), en.children.len())
+      } else {
+        numbering(en.numbering, en.children.len())
+      }
+      num = context box(
+        width: measure(max-num).width,
+        align(right, text(overhang: false, num)),
+      )
+      let list-nesting = state("list-nesting", 0) // Support list nesting.
+      let body = {
+        parents.update(arr => arr + (number,))
+        list-nesting.update(x => x + 1)
+        it.body + parbreak()
+        list-nesting.update(x => x - 1)
+        parents.update(arr => arr.slice(0, -1))
+      }
+      if not en.reversed { number += 1 }
+      let content = {
+        num
+        h(en.body-indent)
+        body
+      }
+      context pad(left: int(parents.get().len() != 0) * en.indent, content)
+    }
+  }
+  doc
+}

template/utils.typ

@@ -1,36 +0,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("/")
-
-  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,11 +1,11 @@
 [package]
 name = "nure"
-version = "0.1.0"
+version = "0.1.1"
 entrypoint = "src/lib.typ"
 authors = ["linerds"]
 license = "GPL-3.0"
 description = "Typst NURE package"
 
 [template]
-path = "template"
+path = "template/default"
 entrypoint = "lab.typ"