fix(local): handle text parameter as optional in local function

Author: kokic

featured-demo/trees/0AFE.typst

@@ -4,7 +4,7 @@
 #show: kodama
 
 // Recommended font
-// #set text(font: "Inria Sans")
+#set text(font: "Inria Sans")
 
 #metadata((
   "title": "Alice, from the Old French name Aalis", //

featured-demo/trees/_lib/kodama.typ

@@ -101,23 +101,26 @@
 /// -> string
 #let tex(raw-tex) = "$" + raw-tex.text + "$"
 
-#let local(slug, text) = with-target-check((export-target) => {
+#let local(slug, text: none) = with-target-check((export-target) => {
   if export-target == "html" {
     html.elem(
       "span", // Make it an inline element. This is automatically removed by kodama.
       {
-        let v = text
+        let v = if text == none { none } else { text }
         let attrs = (slug: slug)
 
-        if type(text) != content {
+        if text != none and type(text) != content {
           v = none
           attrs.insert("value", repri(text))
         }
 
         html.elem("kodama-local", v, attrs: attrs)
       },
     )
-  } else { underline(stroke: dotted-stroke, text) }
+  } else {
+    let label = if text == none { slug } else { text }
+    underline(stroke: dotted-stroke, label)
+  }
 })
 
 #let embed(url, title, numbering: false, open: true, catalog: true, display-options: false) = {

featured-demo/trees/index.typst

@@ -11,16 +11,17 @@
   "taxon": "example", //
   "date": "October 12, 2025", //
   "author": "Anonymous",
+  "0AFE": local("0AFE") // Alice
 ))
 
-#lorem(32) #local("./0AFF")[*Bob being linked*]. 
+#lorem(32) #local("./0AFF", text: [*Bob being linked*]). 
 
 #embed("./0AFE.typst", "Alice when embedded", numbering: true)
 
 #lorem(48)
 
 #subtree(slug: "0AFF", title: "Bob, subtree with slugs", taxon: "exegesis")[
-  - #lorem(64) #local("0AFE", "Alice when being linked").
+  - #lorem(64) #local("0AFE", text: "Alice when being linked").
 ]
 
 #subtree(title: "Christina, anonymous subtree", taxon: "exegesis")[

src/compiler/state.rs

@@ -523,6 +523,60 @@ mod tests {
         assert!(html.contains(r#"><span lang="zh">abc</span></a>"#));
     }
 
+    #[test]
+    fn test_metadata_local_link_without_text_uses_target_title() {
+        let mut shallows = HashMap::new();
+
+        let mut index_metadata = OrderedMap::new();
+        index_metadata.insert(
+            KEY_SLUG.to_string(),
+            HTMLContent::Plain("index".to_string()),
+        );
+        index_metadata.insert(KEY_EXT.to_string(), HTMLContent::Plain("typst".to_string()));
+        index_metadata.insert(
+            "author".to_string(),
+            HTMLContent::Lazy(vec![LazyContent::Local(LocalLink {
+                url: "/kokic".to_string(),
+                text: None,
+            })]),
+        );
+        shallows.insert(
+            Slug::new("index"),
+            UnresolvedSection {
+                metadata: HTMLMetaData(index_metadata),
+                content: HTMLContent::Plain(String::new()),
+            },
+        );
+
+        let mut target_metadata = OrderedMap::new();
+        target_metadata.insert(
+            KEY_SLUG.to_string(),
+            HTMLContent::Plain("kokic".to_string()),
+        );
+        target_metadata.insert(KEY_EXT.to_string(), HTMLContent::Plain("md".to_string()));
+        target_metadata.insert(
+            KEY_TITLE.to_string(),
+            HTMLContent::Plain("Kokic".to_string()),
+        );
+        shallows.insert(
+            Slug::new("kokic"),
+            UnresolvedSection {
+                metadata: HTMLMetaData(target_metadata),
+                content: HTMLContent::Plain(String::new()),
+            },
+        );
+
+        let state = compile_all_without_missing_index_warning(&shallows).unwrap();
+        let author = state
+            .compiled()
+            .get(&Slug::new("index"))
+            .and_then(|section| section.metadata.get_str("author"))
+            .expect("compiled author metadata");
+
+        assert!(author.contains(r#"class="link local""#));
+        assert!(author.contains(">Kokic</a>"));
+    }
+
     #[test]
     fn test_compile_filters_internal_anonymous_sections_from_compiled_graph() {
         let mut shallows = HashMap::new();

src/include/kodama.typ

@@ -101,23 +101,26 @@
 /// -> string
 #let tex(raw-tex) = "$" + raw-tex.text + "$"
 
-#let local(slug, text) = with-target-check((export-target) => {
+#let local(slug, text: none) = with-target-check((export-target) => {
   if export-target == "html" {
     html.elem(
       "span", // Make it an inline element. This is automatically removed by kodama.
       {
-        let v = text
+        let v = if text == none { none } else { text }
         let attrs = (slug: slug)
 
-        if type(text) != content {
+        if text != none and type(text) != content {
           v = none
           attrs.insert("value", repri(text))
         }
 
         html.elem("kodama-local", v, attrs: attrs)
       },
     )
-  } else { underline(stroke: dotted-stroke, text) }
+  } else {
+    let label = if text == none { slug } else { text }
+    underline(stroke: dotted-stroke, label)
+  }
 })
 
 #let embed(url, title, numbering: false, open: true, catalog: true, display-options: false) = {