biblatex-csl-converter
Version:
Bibliography format converter: BibLaTeX, BibTeX, CSL-JSON, RIS, ENW, EndNote XML, Citavi, DOCX citations, ODT citations — parse, convert, and export with round-trip fidelity
200 lines (186 loc) • 7.26 kB
text/typescript
import type { NameDictObject, NodeObject } from "../const"
import type { ConfigObject } from "./biblatex"
import { BibLatexLiteralParser } from "./literal-parser"
export class BibLatexNameParser {
nameString: string
config: ConfigObject
nameDict: NameDictObject
_particle: string[]
_suffix: string[]
constructor(nameString: string, config: ConfigObject) {
this.nameString = nameString.trim()
this.config = config
this.nameDict = {}
this._particle = []
this._suffix = []
}
parseName(): void {
let parts = this.splitTexString(this.nameString, ",")
if (parts.length > 1 && this.nameString.includes("=")) {
// extended name detected.
this.parseExtendedName(parts)
} else if (parts.length === 3) {
// von Last, Jr, First
this.processVonLast(
this.splitTexString(parts[0].replace(/[{}]/g, "")),
this.splitTexString(parts[1]),
)
this.processFirstMiddle(this.splitTexString(parts[2]))
} else if (parts.length === 2) {
// von Last, First
this.processVonLast(
this.splitTexString(parts[0].replace(/[{}]/g, "")),
)
this.processFirstMiddle(this.splitTexString(parts[1]))
} else if (parts.length === 1) {
// First von Last
const spacedParts = this.splitTexString(this.nameString)
if (spacedParts.length === 1) {
if (
this.nameString[0] === "{" &&
this.nameString[this.nameString.length - 1] === "}" &&
this.nameString.includes("=") &&
this.nameString.includes(",") &&
this.nameString.includes(" ") &&
(this.nameString.includes("given") ||
this.nameString.includes("family"))
) {
parts = this.splitTexString(
this.nameString.slice(1, this.nameString.length - 1),
",",
)
// extended name detected.
this.parseExtendedName(parts)
} else {
const literal = this._reformLiteral(spacedParts[0])
if (literal.length) {
this.nameDict.literal = literal
}
}
} else {
const split = this.splitAt(spacedParts)
const firstMiddle = split[0]
const vonLast = split[1]
if (vonLast.length === 0 && firstMiddle.length > 1) {
const last = firstMiddle.pop()!
vonLast.push(last)
}
this.processFirstMiddle(firstMiddle)
this.processVonLast(vonLast)
}
} else {
this.nameDict.literal = this._reformLiteral(this.nameString.trim())
}
}
parseExtendedName(parts: string[]): void {
parts.forEach((part) => {
const attrParts = part.trim().replace(/^"|"$/g, "").split("=")
const attrName = attrParts.shift()?.trim().toLowerCase()
if (["family", "given", "prefix", "suffix"].includes(attrName)) {
this.nameDict[
attrName as "family" | "given" | "prefix" | "suffix"
] = this._reformLiteral(attrParts.join("=").trim())
} else if (attrName === "useprefix") {
if (attrParts.join("").trim().toLowerCase() === "true") {
this.nameDict.useprefix = true
} else {
this.nameDict.useprefix = false
}
}
})
}
get output(): false | NameDictObject {
this.parseName()
if (Object.keys(this.nameDict).length) {
return this.nameDict
} else {
return false
}
}
splitTexString(string: string, sep = "[\\s~]+"): string[] {
let braceLevel = 0
let inQuotes = false
let nameStart = 0
const result = []
const stringLen = string.length
let pos = 0
while (pos < stringLen) {
const char = string.charAt(pos)
switch (char) {
case "{":
braceLevel += 1
break
case "}":
braceLevel -= 1
break
case '"':
inQuotes = !inQuotes
break
case "\\":
// skip next
pos++
break
default:
if (braceLevel === 0 && inQuotes === false && pos > 0) {
const match = string.slice(pos).match(RegExp(`^${sep}`))
if (match) {
const sepLen = match[0].length
if (pos + sepLen < stringLen) {
result.push(string.slice(nameStart, pos))
nameStart = pos + sepLen
}
}
}
}
pos++
}
if (nameStart < stringLen) {
result.push(string.slice(nameStart))
}
return result
}
processFirstMiddle(parts: string[]): void {
this.nameDict.given = this._reformLiteral(parts.join(" ").trim())
}
processVonLast(parts: string[], lineage: string[] = []): void {
const rSplit = this.rsplitAt(parts)
const von = rSplit[0]
const last = rSplit[1]
if (von.length > 0 && last.length === 0) {
last.push(von.pop()!)
}
if (von.length) {
this.nameDict.prefix = this._reformLiteral(von.join(" ").trim())
this.nameDict.useprefix = true // The info at hand is not clear, so we guess.
}
if (lineage.length) {
this.nameDict.suffix = this._reformLiteral(lineage.join(" ").trim())
}
this.nameDict.family = this._reformLiteral(last.join(" ").trim())
}
findFirstLowerCaseWord(lst: string[]): number {
// return index of first lowercase word in lst. Else return length of lst.
for (let i = 0; i < lst.length; i++) {
const word = lst[i]
if (word === word.toLowerCase()) {
return i
}
}
return lst.length
}
splitAt(lst: string[]): [string[], string[]] {
// Split the given list into two parts.
// The second part starts with the first lowercase word.
const pos = this.findFirstLowerCaseWord(lst)
return [lst.slice(0, pos), lst.slice(pos)]
}
rsplitAt(lst: string[]): [string[], string[]] {
const rpos = this.findFirstLowerCaseWord(lst.slice().reverse())
const pos = lst.length - rpos
return [lst.slice(0, pos), lst.slice(pos)]
}
_reformLiteral(litString: string): NodeObject[] {
const parser = new BibLatexLiteralParser(litString, this.config)
return parser.output
}
}