treat unknown citation styles as file names to load custom CSL files.

fixes #1

README.md

@@ -33,4 +33,6 @@ See the [manual](docs/manual.pdf) for details.
 
 ## License
 
-Parts of the Rust plugin that interfaces with the [Hayagriva](https://github.com/typst/hayagriva) citation library are based on [`typst-library`'s `bibliography.rs`](https://github.com/typst/typst/blob/26e65bfef5b1da7f6c72e1409237cf03fb5d6069/crates/typst-library/src/model/bibliography.rs). Likewise, the example bibliographies are taken or adapted from [`typst-dev-assets`' `works.bib`](https://github.com/typst/typst-dev-assets/blob/1dba4bea22e5e19597fbf5f321b047ff7626e2d0/files/bib/works.bib).Both are licensed from Typst's authors under the Apache License 2.0.
+Parts of the Rust plugin that interfaces with the [Hayagriva](https://github.com/typst/hayagriva) citation library are based on [typst-library's `bibliography.rs`](https://github.com/typst/typst/blob/26e65bfef5b1da7f6c72e1409237cf03fb5d6069/crates/typst-library/src/model/bibliography.rs). Likewise, the example bibliographies are taken or adapted from [typst-dev-assets' `works.bib`](https://github.com/typst/typst-dev-assets/blob/1dba4bea22e5e19597fbf5f321b047ff7626e2d0/files/bib/works.bib). Both are licensed from Typst's authors under the Apache License 2.0.
+
+The example CSL style [`ieee.csl`](https://github.com/citation-style-language/styles/blob/fd6cb3e81762055d107839c3c288c359985f81c8/ieee.csl) is taken from the [CSL project](https://citationstyles.org/) who provide it under the [Creative Commons Attribution-ShareAlike 3.0 Unported license](https://creativecommons.org/licenses/by-sa/3.0/).

plugin/src/lib.rs

@@ -94,9 +94,13 @@ fn read_libraries(sources: &[Source]) -> Result<IndexMap<String, hayagriva::Entr
 fn read_impl(config: Config) -> Result<Bibliography, String> {
     let entries = read_libraries(&config.sources)?;
 
-    let style =
-        ArchivedStyle::by_name(&config.style).ok_or(format!("Unknown style: {}", config.style))?;
-    let citationberg::Style::Independent(style) = style.get() else {
+    let style = match config.style {
+        Style::BuiltIn(name) => ArchivedStyle::by_name(&name)
+            .ok_or(format!("Unknown style: {}", name))?
+            .get(),
+        Style::Custom(source) => citationberg::Style::from_xml(&source).map_err_to_string()?,
+    };
+    let citationberg::Style::Independent(style) = style else {
         return Err("style is not an IndependentStyle".to_string());
     };
 
@@ -213,7 +217,7 @@ mod tests {
                 content: bib.to_string(),
             }],
             full: true,
-            style: "ieee".to_string(),
+            style: Style::BuiltIn("ieee".to_string()),
             locale: hayagriva::citationberg::LocaleCode::en_us(),
             citations: vec![],
         })

plugin/src/model.rs

@@ -9,7 +9,7 @@ use serde::{
 pub struct Config {
     pub sources: Vec<Source>,
     pub full: bool,
-    pub style: String,
+    pub style: Style,
     pub locale: hayagriva::citationberg::LocaleCode,
     pub citations: Vec<Citation>,
 }
@@ -21,6 +21,13 @@ pub struct Source {
     pub content: String,
 }
 
+#[derive(Deserialize, Debug, Clone, PartialEq)]
+#[serde(rename_all = "kebab-case")]
+pub enum Style {
+    BuiltIn(String),
+    Custom(String),
+}
+
 #[derive(Deserialize, Debug, Clone, PartialEq)]
 #[serde(rename_all = "kebab-case")]
 pub struct Citation {

src/lib.typ

@@ -112,11 +112,18 @@
       assert.ne(prefix, none, message: "when using multiple custom bibliographies, you must specify the prefix for each")
     }
 
+    let style = csl-to-string(style)
+    if style in hayagriva.names {
+      style = (built-in: style)
+    } else {
+      style = (custom: read(style))
+    }
+
     let locale = locale()
     set-bibliography(prefix, citations => hayagriva.read(
       path.map(path => (path: path, content: read(path))),
       full,
-      csl-to-string(style),
+      style,
       locale,
       citations,
     ))

tests/custom-ieee/.gitignore

@@ -0,0 +1,5 @@
+# generated by tytanic, do not edit
+
+diff/**
+out/**
+ref/**

tests/custom-ieee/ref.typ

@@ -0,0 +1,9 @@
+#import "../test-utils.typ": *
+
+#test-citations
+
+#bib(
+  // title: "Bibliography",
+  full: true,
+  style: "../ieee.csl",
+)

tests/custom-ieee/test.typ

@@ -0,0 +1,11 @@
+#import "../test-utils.typ": *
+
+#show: x-alexandria
+
+#x-test-citations
+
+#x-bib(
+  title: "Bibliography",
+  full: true,
+  style: "ieee.csl",
+)