🏷️ Typst enable paragraph referencing (#1745)

.changeset/calm-timers-relate.md

@@ -0,0 +1,5 @@
+---
+"myst-to-typst": patch
+---
+
+Enable labeling of paragraphs

packages/myst-to-typst/src/index.ts

@@ -128,7 +128,9 @@ const handlers: Record<string, Handler> = {
     state.text(node.value);
   },
   paragraph(node, state) {
-    state.renderChildren(node, 2);
+    const { identifier } = node;
+    const after = identifier ? ` <${identifier}>` : undefined;
+    state.renderChildren(node, 2, { after });
   },
   heading(node, state) {
     const { depth, identifier, enumerated } = node;
@@ -561,7 +563,7 @@ class TypstSerializer implements ITypstSerializer {
       this.renderChildren({ children: node }, trailingNewLines, opts);
       return;
     }
-    const { delim = '', trimEnd = true } = opts;
+    const { delim = '', trimEnd = true, after } = opts;
     const numChildren = node.children?.length ?? 0;
     node.children?.forEach((child, index) => {
       if (!child) return;
@@ -577,6 +579,7 @@ class TypstSerializer implements ITypstSerializer {
       if (delim && index + 1 < numChildren) this.write(delim);
     });
     if (trimEnd) this.trimEnd();
+    if (after) this.write(after);
     for (let i = trailingNewLines; i--; ) this.addNewLine();
   }
 

packages/myst-to-typst/src/types.ts

@@ -39,7 +39,7 @@ export type StateData = {
   };
 };
 
-export type RenderChildrenOptions = { delim?: string; trimEnd?: boolean };
+export type RenderChildrenOptions = { delim?: string; trimEnd?: boolean; after?: string };
 
 export interface ITypstSerializer<D extends Record<string, any> = StateData> {
   file: VFile;

packages/myst-to-typst/tests/cross-references.yml

@@ -53,3 +53,28 @@ cases:
               value: 'a for the first part of the figure!'
     typst: |-
       See #link(<fig1>)[Figure 56]a for the first part of the figure!
+  - title: labeled paragraphs
+    mdast:
+      type: root
+      children:
+        - type: paragraph
+          children:
+            - type: text
+              value: This is a paragraph.
+          label: para
+          identifier: para
+        - type: paragraph
+          children:
+            - type: text
+              value: 'With a reference '
+            - type: crossReference
+              children:
+                - type: text
+                  value: Paragraph
+              identifier: para
+              label: para
+              kind: paragraph
+    typst: |-
+      This is a paragraph. <para>
+
+      With a reference #link(<para>)[Paragraph]