@glossarist/concept-browser 0.2.13 → 0.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glossarist/concept-browser",
-  "version": "0.2.13",
+  "version": "0.3.1",
   "description": "Vue SPA for browsing Glossarist terminology datasets with cross-reference resolution, graph visualization, and multi-language support",
   "type": "module",
   "bin": {
@@ -19,12 +19,12 @@
     "test:watch": "vitest"
   },
   "dependencies": {
+    "@plurimath/plurimath": "^0.2.2",
     "@vitejs/plugin-vue": "^5.2.3",
     "autoprefixer": "^10.4.21",
     "d3": "^7.9.0",
     "glossarist": "^0.2.0",
     "js-yaml": "^4.1.0",
-    "katex": "^0.16.45",
     "pinia": "^2.3.1",
     "postcss": "^8.5.3",
     "tailwindcss": "^3.4.17",

package/scripts/generate-data.mjs

@@ -3,6 +3,7 @@ import path from 'path';
 import yaml from 'js-yaml';
 import { naturalSort } from 'glossarist';
 import { loadSiteConfig } from './load-site-config.mjs';
+import { preRenderMath } from './math-prerender.mjs';
 
 const __dirname = path.dirname(new URL(import.meta.url).pathname);
 const ROOT = process.cwd();
@@ -55,7 +56,7 @@ function termToDesignation(term) {
       : term.type === 'abbreviation' ? 'gl:Abbreviation'
       : 'gl:Designation',
     'gl:normativeStatus': term.normative_status || 'preferred',
-    'gl:term': term.designation,
+    'gl:term': preRenderMath(term.designation),
   };
   if (term.gender) doc['gl:gender'] = term.gender;
   if (term.plurality) doc['gl:plurality'] = term.plurality;
@@ -68,7 +69,7 @@ function defsToJsonLd(defs) {
   return defs
     .map(d => ({
       '@type': 'gl:DetailedDefinition',
-      'gl:content': d.content || '',
+      'gl:content': preRenderMath(d.content || ''),
     }))
     .filter(d => d['gl:content']);
 }
@@ -255,7 +256,7 @@ function getPrimaryDesignation(conceptYaml) {
     if (lc && lc.terms && lc.terms.length > 0) {
       const preferredExpr = lc.terms.find(t => t.normative_status === 'preferred' && t.type === 'expression');
       const preferred = preferredExpr || lc.terms.find(t => t.normative_status === 'preferred') || lc.terms[0];
-      descs[lang] = preferred.designation;
+      descs[lang] = preRenderMath(preferred.designation);
     }
   }
   return descs;
@@ -531,11 +532,17 @@ function processDataset(dir, register, opts) {
     status: c.status,
   }));
 
+  // Strip HTML from index summary for text display
+  const plainSummary = summary.map(c => ({
+    ...c,
+    eng: c.eng.replace(/<[^>]+>/g, '').replace(/\s+/g, ' ').trim(),
+  }));
+
   const graphNodeEntries = concepts.map(c => {
     let term = '', lang = '';
     if (c.designations.eng) { term = c.designations.eng; lang = 'eng'; }
     else { for (const [l, t] of Object.entries(c.designations)) { if (t) { term = t; lang = l; break; } } }
-    return [c.id, term, lang, c.status];
+    return [c.id, term.replace(/<[^>]+>/g, '').replace(/\s+/g, ' ').trim(), lang, c.status];
   });
   fs.mkdirSync(path.join(DATA, register), { recursive: true });
   fs.writeFileSync(
@@ -553,7 +560,7 @@ function processDataset(dir, register, opts) {
     conceptCount: concepts.length,
     chunkSize: CHUNK_SIZE,
     chunks,
-    concepts: summary,
+    concepts: plainSummary,
   });
 
   writeJson(path.join(DATA, register, 'index-meta.json'), {

package/scripts/math-prerender.mjs

@@ -0,0 +1,80 @@
+import Plurimath from '@plurimath/plurimath';
+
+function renderToMathML(math, format) {
+  try {
+    const p = new Plurimath(math, format);
+    return p.toMathml().replace('display="block"', 'display="inline"').trim();
+  } catch {
+    return null;
+  }
+}
+
+function escapeHtml(text) {
+  return text
+    .replace(/&/g, '&')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;');
+}
+
+function replaceBracketed(text, prefix, render) {
+  let result = '';
+  let i = 0;
+  const boldPrefix = '*' + prefix;
+  while (i < text.length) {
+    if (text.startsWith(boldPrefix + '[', i)) {
+      i += boldPrefix.length + 1;
+      let j = i;
+      let d = 1;
+      while (j < text.length && d > 0) {
+        if (text[j] === '[') d++;
+        else if (text[j] === ']') d--;
+        j++;
+      }
+      const content = text.slice(i, j - 1);
+      let end = j;
+      if (end < text.length && text[end] === '*') end++;
+      result += render(content, true);
+      i = end;
+    } else if (text.startsWith(prefix + '[', i)) {
+      i += prefix.length + 1;
+      let j = i;
+      let d = 1;
+      while (j < text.length && d > 0) {
+        if (text[j] === '[') d++;
+        else if (text[j] === ']') d--;
+        j++;
+      }
+      const content = text.slice(i, j - 1);
+      result += render(content, false);
+      i = j;
+    } else {
+      result += text[i];
+      i++;
+    }
+  }
+  return result;
+}
+
+function renderStem(math, bold) {
+  const mathml = renderToMathML(math, 'asciimath');
+  if (mathml) {
+    return `<span class="math-inline${bold ? ' math-bold' : ''}">${mathml}</span>`;
+  }
+  return `<code class="math-fallback">${escapeHtml(math)}</code>`;
+}
+
+function renderLatexmath(math, bold) {
+  const mathml = renderToMathML(math, 'latex');
+  if (mathml) {
+    return `<span class="math-inline${bold ? ' math-bold' : ''}">${mathml}</span>`;
+  }
+  return `<code class="math-fallback">${escapeHtml(math)}</code>`;
+}
+
+export function preRenderMath(text) {
+  if (!text) return '';
+  let result = text;
+  result = replaceBracketed(result, 'stem:', renderStem);
+  result = replaceBracketed(result, 'latexmath:', renderLatexmath);
+  return result;
+}

package/src/__tests__/math.test.ts

@@ -6,24 +6,24 @@ describe('renderMath', () => {
     expect(renderMath('hello world')).toBe('hello world');
   });
 
-  it('renders stem:[x^2] to KaTeX span', () => {
-    const result = renderMath('the value stem:[x^2]');
-    expect(result).toContain('math-inline');
-    expect(result).toContain('katex');
-    expect(result).not.toContain('math-bold');
+  it('passes through pre-rendered MathML unchanged', () => {
+    const preRendered = 'value <span class="math-inline"><math><mi>x</mi></math></span> here';
+    expect(renderMath(preRendered)).toBe(preRendered);
   });
 
-  it('renders *stem:[x]* (bold math) with math-bold class', () => {
-    const result = renderMath('the value *stem:[x]*');
-    expect(result).toContain('math-inline');
-    expect(result).toContain('math-bold');
+  it('still converts italic in mixed pre-rendered MathML content', () => {
+    const preRendered = '<span class="math-inline"><math><mi>x</mi></math></span> and *italic*';
+    expect(renderMath(preRendered)).toBe(
+      '<span class="math-inline"><math><mi>x</mi></math></span> and <em>italic</em>',
+    );
+  });
+
+  it('converts *text* to <em> (italic) for non-pre-rendered content', () => {
+    expect(renderMath('some *italic* text')).toBe('some <em>italic</em> text');
   });
 
-  it('renders latexmath:[...] with nested brackets', () => {
-    const result = renderMath('coords latexmath:[[u_0, u_1] \\leq 1.0] here');
-    expect(result).toContain('math-inline');
-    expect(result).toContain('katex');
-    expect(result).not.toContain('latexmath:');
+  it('converts ~text~ to <sub> (subscript)', () => {
+    expect(renderMath('H~2~O')).toBe('H<sub>2</sub>O');
   });
 
   it('converts bullet lines to <ul><li>', () => {
@@ -33,20 +33,6 @@ describe('renderMath', () => {
     expect(result).toContain('<li>second item</li>');
   });
 
-  it('does NOT convert *stem:[...] lines to list items', () => {
-    const result = renderMath('*stem:[x]*');
-    expect(result).not.toContain('<ul');
-    expect(result).toContain('math-bold');
-  });
-
-  it('converts *text* to <em> (italic)', () => {
-    expect(renderMath('some *italic* text')).toBe('some <em>italic</em> text');
-  });
-
-  it('converts ~text~ to <sub> (subscript)', () => {
-    expect(renderMath('H~2~O')).toBe('H<sub>2</sub>O');
-  });
-
   it('resolves URN inline refs via xrefResolver', () => {
     const resolver = (uri: string, term: string) => `[${term}→${uri}]`;
     const result = renderMath(
@@ -98,6 +84,14 @@ describe('renderMath', () => {
     expect(result).toBe('see some term');
   });
 
+  it('resolves cross-refs even in pre-rendered content', () => {
+    const resolver = (uri: string, term: string) => `[${term}→${uri}]`;
+    const preRendered = '<span class="math-inline"><math><mi>x</mi></math></span> and {{urn:iso:std:iso:14812:3.1.1.1,entity}}';
+    expect(renderMath(preRendered, resolver)).toBe(
+      '<span class="math-inline"><math><mi>x</mi></math></span> and [entity→urn:iso:std:iso:14812:3.1.1.1]',
+    );
+  });
+
   it('handles empty input', () => {
     expect(renderMath('')).toBe('');
   });
@@ -109,16 +103,9 @@ describe('renderMath', () => {
 });
 
 describe('cleanContent', () => {
-  it('strips stem:[...] to raw math text', () => {
-    expect(cleanContent('value stem:[x^2] here')).toBe('value x^2 here');
-  });
-
-  it('strips bold stem', () => {
-    expect(cleanContent('value *stem:[x]* here')).toBe('value x here');
-  });
-
-  it('strips latexmath:[...] with nested brackets', () => {
-    expect(cleanContent('coords latexmath:[[u_0, u_1] \\leq 1.0] end')).toBe('coords [u_0, u_1] \\leq 1.0 end');
+  it('strips pre-rendered HTML/MathML tags', () => {
+    expect(cleanContent('value <span class="math-inline"><math><mi>x</mi></math></span> here'))
+      .toBe('value x here');
   });
 
   it('strips *text* to plain text', () => {

package/src/main.ts

@@ -2,7 +2,6 @@ import { createApp } from 'vue';
 import { createPinia } from 'pinia';
 import App from './App.vue';
 import router from './router';
-import 'katex/dist/katex.min.css';
 import './style.css';
 
 const app = createApp(App);

package/src/style.css

@@ -159,12 +159,13 @@
   }
 
   /* Math */
-  .math-inline .katex {
+  .math-inline {
+    display: inline;
+  }
+  .math-inline math {
     font-size: 1.05em;
   }
-  .math-bold .katex .mord,
-  .math-bold .katex .mbin,
-  .math-bold .katex .mrel {
+  .math-bold .math-inline math {
     font-weight: bold;
   }
   .math-fallback {

package/src/utils/math.ts

@@ -1,5 +1,3 @@
-import katex from 'katex';
-
 export type XrefResolver = (uri: string, term: string) => string;
 export type BibResolver = (refId: string, title: string) => string;
 export type FigResolver = (figId: string) => string;
@@ -39,50 +37,6 @@ function convertLists(text: string): string {
   return result;
 }
 
-function replaceBracketed(
-  text: string,
-  prefix: string,
-  render: (math: string, bold: boolean) => string,
-): string {
-  let result = '';
-  let i = 0;
-  const boldPrefix = '*' + prefix;
-  while (i < text.length) {
-    if (text.startsWith(boldPrefix + '[', i)) {
-      i += boldPrefix.length + 1;
-      let j = i;
-      let d = 1;
-      while (j < text.length && d > 0) {
-        if (text[j] === '[') d++;
-        else if (text[j] === ']') d--;
-        j++;
-      }
-      const content = text.slice(i, j - 1);
-      let end = j;
-      if (end < text.length && text[end] === '*') end++;
-      result += render(content, true);
-      i = end;
-    }
-    else if (text.startsWith(prefix + '[', i)) {
-      i += prefix.length + 1;
-      let j = i;
-      let d = 1;
-      while (j < text.length && d > 0) {
-        if (text[j] === '[') d++;
-        else if (text[j] === ']') d--;
-        j++;
-      }
-      const content = text.slice(i, j - 1);
-      result += render(content, false);
-      i = j;
-    } else {
-      result += text[i];
-      i++;
-    }
-  }
-  return result;
-}
-
 export function renderMath(text: string, xrefResolverOrOpts?: XrefResolver | RenderOptions): string {
   if (!text) return '';
   let result = text;
@@ -91,11 +45,8 @@ export function renderMath(text: string, xrefResolverOrOpts?: XrefResolver | Ren
     ? { xrefResolver: xrefResolverOrOpts }
     : (xrefResolverOrOpts ?? {});
 
-  result = replaceBracketed(result, 'stem:', renderKatexSpan);
-  result = replaceBracketed(result, 'latexmath:', renderKatexSpan);
-
+  // Math (stem/latexmath) is pre-rendered at build time. Only process text formatting.
   result = convertLists(result);
-
   result = result.replace(/\*([^*]+)\*/g, '<em>$1</em>');
   result = result.replace(/~([^~]+)~/g, '<sub>$1</sub>');
 
@@ -134,19 +85,6 @@ export function renderMath(text: string, xrefResolverOrOpts?: XrefResolver | Ren
   return result;
 }
 
-function renderKatexSpan(math: string, bold: boolean): string {
-  try {
-    const html = katex.renderToString(math, {
-      throwOnError: false,
-      displayMode: false,
-      output: 'html',
-    });
-    return `<span class="math-inline${bold ? ' math-bold' : ''}">${html}</span>`;
-  } catch {
-    return `<code class="math-fallback">${escapeHtml(math)}</code>`;
-  }
-}
-
 function escapeHtml(text: string): string {
   return text
     .replace(/&/g, '&amp;')
@@ -157,6 +95,7 @@ function escapeHtml(text: string): string {
 export function cleanContent(text: string): string {
   if (!text) return '';
   let result = text
+    .replace(/<[^>]+>/g, '') // strip pre-rendered HTML/MathML
     .replace(/\*([^*]+)\*/g, '$1')
     .replace(/~([^~]+)~/g, '_$1')
     .replace(/\n[ \t]*\* /g, '; ')
@@ -165,7 +104,5 @@ export function cleanContent(text: string): string {
     .replace(/\{\{urn:[^,}]+,([^,}]+)(?:,[^}]+)?\}\}/g, '$1')
     .replace(/\{urn:[^,}]+,([^,}]+)(?:,[^}]+)?\}/g, '$1')
     .replace(/\{\{([^,}]+)(?:,\s*[^}]+)?\}\}/g, '$1');
-  result = replaceBracketed(result, 'stem:', (math) => math);
-  result = replaceBracketed(result, 'latexmath:', (math) => math);
   return result;
 }