NEW: option: targetLang

src/lines/literal.js

@@ -2,6 +2,8 @@ import addEmphasis from '../utilities/addEmphasis.js'
 
 export default function createLiteral(data, { analysisLang }) {
 
+  if (!data) return ``
+
   if (typeof data === `string`) {
     const lang = analysisLang ? `lang='${ analysisLang }'` : ``
     return `<p class=lit ${ lang }>${ addEmphasis(data) }</p>`

src/lines/phonetic.js

@@ -1,6 +1,8 @@
 import addEmphasis from '../utilities/addEmphasis.js'
 
-export default function createPhonetic(phonetic) {
+export default function createPhonetic(phonetic, { targetLang }) {
   if (!phonetic) return ``
-  return `<p class=phon>${ addEmphasis(phonetic) }</p>`
+  const lang = targetLang ? `lang='${ targetLang }-fonipa'` : ``
+  // NB: Don't add phonetic brackets. These can be added with CSS.
+  return `<p class=phon ${ lang }>${ addEmphasis(phonetic) }</p>`
 }

src/lines/source.js

@@ -1,5 +1,7 @@
 export default function createSource(speaker, source) {
 
+  if (!(speaker ?? source)) return ``
+
   speaker ||= ``
   source    = source ? `(${ source })` : ``
 

src/lines/transcript.js

@@ -1,12 +1,15 @@
 import addEmphasis from '../utilities/addEmphasis.js'
 
-export default function createTranscript(data) {
+export default function createTranscript(data, { targetLang }) {
+
+  if (!data) return ``
 
   let html = ``
 
   for (const ortho in data) {
     const transcript = data[ortho]
-    html += `<p class=trs data-ortho='${ ortho }'>${ addEmphasis(transcript) }</p>`
+    const lang = targetLang ? `lang='${ targetLang }'` : ``
+    html += `<p class=trs data-ortho='${ ortho }' ${ lang }>${ addEmphasis(transcript) }</p>`
   }
 
   return html

src/lines/transcription.js

@@ -1,12 +1,15 @@
 import addEmphasis from '../utilities/addEmphasis.js'
 
-export default function createTranscription(data) {
+export default function createTranscription(data, { targetLang }) {
+
+  if (!data) return ``
 
   let html = ``
 
   for (const ortho in data) {
-    const txn = data[ortho]
-    html += `<p class=txn data-ortho='${ ortho }'>${ addEmphasis(txn) }</p>`
+    const txn  = data[ortho]
+    const lang = targetLang ? `lang='${ targetLang }'` : ``
+    html += `<p class=txn data-ortho='${ ortho }' ${ lang }>${ addEmphasis(txn) }</p>`
   }
 
   return html

src/lines/translation.js

@@ -2,6 +2,8 @@ import addEmphasis from '../utilities/addEmphasis.js'
 
 export default function createTranslation(data, { analysisLang }) {
 
+  if (!data) return ``
+
   if (typeof data === `string`) {
     const lang = analysisLang ? `lang='${ analysisLang }'` : ``
     return `<p class=tln ${ lang }>${ addEmphasis(data) }</p>`

src/options.js

@@ -1,16 +1,24 @@
 export default function validateOptions(opts) {
 
-  if (`analysisLang` in opts) {
-    if (typeof opts.analysisLang !== `string`) throw new TypeError(`The 'analysisLang' option must be a String.`)
+  if (`analysisLang` in opts && typeof opts.analysisLang !== `string`) {
+    throw new TypeError(`The 'analysisLang' option must be a string.`)
   }
 
   if (`classes` in opts) {
     if (!Array.isArray(opts.classes)) throw new TypeError(`The 'classes' option must be an array.`)
     if (!opts.classes.every(cls => typeof cls === `string`)) throw new TypeError(`Each of the values of the 'classes' array must be a string.`)
   }
 
-  if (`scription` in opts && typeof opts.scription !== `object`) throw new TypeError(`The 'scription' option must be an object.`)
+  if (`scription` in opts && typeof opts.scription !== `object`) {
+    throw new TypeError(`The 'scription' option must be an object.`)
+  }
+
+  if (`tag` in opts && typeof opts.tag !== `string`) {
+    throw new TypeError(`The 'tag' option must be a string.`)
+  }
 
-  if (`tag` in opts && typeof opts.tag !== `string`) throw new TypeError(`The 'tag' option must be a string.`)
+  if (`targetLang` in opts && typeof opts.targetLang !== `string`) {
+    throw new TypeError(`The 'targetLang' option must be a string.`)
+  }
 
 }

src/utterance.js

@@ -14,11 +14,11 @@ export default function convertUtterance(u, options) {
   const classString   = classes.join(` `)
   const header        = createHeader(u.metadata, options)
   const literal       = createLiteral(u.literal, options)
-  const phonetic      = createPhonetic(u.phonetic)
+  const phonetic      = createPhonetic(u.phonetic, options)
   const source        = createSource(u.speaker, u.source)
   const timespan      = createTimespan(u.startTime, u.endTime)
-  const transcript    = createTranscript(u.transcript)
-  const transcription = createTranscription(u.transcription)
+  const transcript    = createTranscript(u.transcript, options)
+  const transcription = createTranscription(u.transcription, options)
   const translation   = createTranslation(u.translation, options)
 
   return `<${ tag } class='${ classString }'>

test/index.test.js

@@ -2,12 +2,10 @@ import convert            from '../src/index.js'
 import { expect }         from 'chai'
 import findElementByClass from './utilities/findElementByClass.js'
 import { getAttribute }   from '@web/parse5-utils'
-import { getTextContent } from '../node_modules/@web/parse5-utils/src/index.js'
 import parse              from './utilities/convertAndParse.js'
 import parseClassString   from './utilities/parseClassString.js'
 import { Swahili }        from '../samples/data/data.js'
 
-
 describe(`scription2html`, function() {
 
   it(`no input → empty string`, function() {
@@ -163,8 +161,41 @@ describe(`scription2html`, function() {
   })
 
   it(`option: tag (validates)`, function() {
-    const test = () => convert(Swahili, { tag: 0 })
+    const test = () => parse(Swahili, { tag: 0 })
     expect(test).to.throw(`tag`)
   })
 
+  it(`option: targetLang = undefined`, function() {
+
+    const scription = `
+    \\trs Ninakupenda.↗
+    `
+
+    const { dom } = parse(scription)
+
+    const transcript = findElementByClass(dom, `trs`)
+
+    expect(getAttribute(transcript, `lang`)).to.be.undefined
+
+
+  })
+
+  it(`option: targetLang`, function() {
+
+    const scription = `
+    \\trs Ninakupenda.↗
+    \\txn ninakupenda
+    `
+
+    const targetLang = `swa`
+    const { dom }    = parse(scription, { targetLang })
+    const trs        = findElementByClass(dom, `trs`)
+    const txn        = findElementByClass(dom, `txn`)
+
+    expect(getAttribute(trs, `lang`)).to.equal(targetLang)
+    expect(getAttribute(txn, `lang`)).to.equal(targetLang)
+
+
+  })
+
 })

test/lines.test.js

@@ -166,6 +166,36 @@ describe(`lines`, function() {
 
     })
 
+    it(`option: targetLang = undefined`, function() {
+
+      const scription = `
+      \\phon ɔ́gɔ̀tɛ́ɛ́rɛ̀rà
+      \\m    ó-ko-tɛ́ɛr-er-a
+      \\gl   pp-5-sing-appl-ind
+      `
+
+      const { dom } = parse(scription)
+      const phon = findElementByClass(dom, `phon`)
+
+      expect(getAttribute(phon, `lang`)).to.be.undefined
+
+    })
+
+    it(`option: targetLang`, function() {
+
+      const scription = `
+      \\phon ɔ́gɔ̀tɛ́ɛ́rɛ̀rà
+      \\m    ó-ko-tɛ́ɛr-er-a
+      \\gl   pp-5-sing-appl-ind
+      `
+
+      const { dom } = parse(scription, { targetLang: `guz` })
+      const phon = findElementByClass(dom, `phon`)
+
+      expect(getAttribute(phon, `lang`)).to.equal(`guz-fonipa`)
+
+    })
+
   })
 
   describe(`phonemic transcription`, function() {