@citestyle/bibtex 1.0.0 → 1.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@citestyle/bibtex",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "BibTeX ↔ CSL-JSON parser and serializer",
   "author": "Uniweb",
   "homepage": "https://github.com/uniweb/csl/tree/main/packages/bibtex",
@@ -31,7 +31,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@citestyle/types": "1.0.0"
+    "@citestyle/types": "1.0.1"
   },
   "devDependencies": {
     "vitest": "^3.1.1"

package/src/export.js

@@ -111,6 +111,13 @@ export function exportBibtex(items) {
     const key = generateKey(item)
     const fields = []
 
+    // Preserve `$`-sigil fields verbatim (out-of-band metadata — e.g. `$uuid` for
+    // content-sync identity — not CSL). Emitted first so a pristine entry gains a
+    // stable leading field and a parse↔export cycle is idempotent.
+    for (const k of Object.keys(item)) {
+      if (k.startsWith('$') && item[k] != null) fields.push([k, wrapBraces(String(item[k]))])
+    }
+
     // Names
     if (item.author) {
       const val = serializeNames(item.author)

package/src/parse.js

@@ -570,6 +570,14 @@ function convertToCSL(entry) {
     if (/^https?:\/\//i.test(hp)) item.URL = hp
   }
 
+  // Preserve `$`-sigil fields verbatim — out-of-band metadata (e.g. `$uuid` for
+  // content-sync identity), not CSL. Kept instead of dropped, and passed through
+  // untouched (no LaTeX conversion) so a sync round-trip carries identity in the
+  // file. The raw tokenizer already accepts `$`-prefixed field names.
+  for (const [name, value] of Object.entries(fields)) {
+    if (name.startsWith('$')) item[name] = value
+  }
+
   return item
 }