@glossarist/concept-browser 0.7.8 → 0.7.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glossarist/concept-browser",
-  "version": "0.7.8",
+  "version": "0.7.10",
   "description": "Vue SPA for browsing Glossarist terminology datasets with cross-reference resolution, graph visualization, and multi-language support",
   "type": "module",
   "bin": {

package/scripts/generate-data.mjs

@@ -1112,6 +1112,30 @@ function processPages(config) {
 
 const processedPages = processPages(config);
 
+// Auto-generate dataset about pages from {localPath}/about.md
+const _pagesDir = path.join(PUBLIC, 'pages');
+for (const ds of config.datasets || []) {
+  if (!ds.localPath) continue;
+  const aboutSrc = path.resolve(ROOT, ds.localPath, 'about.md');
+  if (!fs.existsSync(aboutSrc)) continue;
+  const raw = fs.readFileSync(aboutSrc, 'utf8');
+  const html = renderMarkdown(stripFrontmatter(raw));
+  const route = `${ds.id}-about`;
+  writeJson(path.join(_pagesDir, `${route}.json`), { title: 'About', html });
+  console.log(`  Auto-generated dataset about page: ${route}`);
+  const uiLangs = (config.uiLanguages || []).map(l => l.code).filter(l => l !== 'eng');
+  const dsTranslations = ds.translations || {};
+  for (const lang of uiLangs) {
+    const trAboutSrc = path.resolve(ROOT, ds.localPath, `about-${lang}.md`);
+    if (!fs.existsSync(trAboutSrc)) continue;
+    const trRaw = fs.readFileSync(trAboutSrc, 'utf8');
+    const trHtml = renderMarkdown(stripFrontmatter(trRaw));
+    const trTitle = dsTranslations[lang]?.title ? `About ${dsTranslations[lang].title}` : 'About';
+    writeJson(path.join(_pagesDir, `${route}.${lang}.json`), { title: trTitle, html: trHtml });
+    console.log(`  Auto-generated dataset about page: ${route}.${lang}`);
+  }
+}
+
 // Generate site-config.json from site config
 const siteBranding = { ...config.branding };
 // Rewrite logo paths to destination filenames and strip build-time fields

package/src/__tests__/math.test.ts

@@ -33,6 +33,15 @@ describe('renderMath', () => {
     expect(result).toContain('<li>second item</li>');
   });
 
+  it('converts AsciiDoc pipe-delimited tables to <table>', () => {
+    const input = 'Intro text\n\n|===\n| a | b | c\n| d | e | f\n|===';
+    const result = renderMath(input);
+    expect(result).toContain('<table class="concept-table">');
+    expect(result).toContain('<tr><td>a</td><td>b</td><td>c</td></tr>');
+    expect(result).toContain('<tr><td>d</td><td>e</td><td>f</td></tr>');
+    expect(result).not.toContain('|===');
+  });
+
   it('resolves URN inline refs via xrefResolver', () => {
     const resolver = (uri: string, term: string) => `[${term}→${uri}]`;
     const result = renderMath(

package/src/components/AppSidebar.vue

@@ -83,6 +83,21 @@ const datasetEntries = computed(() => {
   return entries;
 });
 
+const datasetIds = computed(() => new Set(datasetEntries.value.map(d => d.id)));
+
+// Hide dataset-prefixed pages (e.g. "viml-about") from global nav
+const filteredGlobalPages = computed(() =>
+  globalPages.value.filter(p => {
+    const r = p.route || '';
+    return !Array.from(datasetIds.value).some(dsId => r.startsWith(dsId + '-'));
+  })
+);
+
+// Show only standard dataset pages (Concepts, Statistics, About)
+const filteredDatasetPages = computed(() =>
+  datasetPages.value.filter(p => ['', 'stats', 'about'].includes(p.route || ''))
+);
+
 const currentManifest = computed(() => store.manifests.get(currentDataset.value));
 const showDatasetNav = computed(() => !!currentManifest.value || !!siteConfig.value?.defaultDataset);
 
@@ -169,7 +184,7 @@ function navTitle(page: { route: string }): string {
       <!-- Navigation -->
       <div class="section-label">{{ t('nav.navigation') }}</div>
       <nav class="space-y-0.5 mb-6">
-        <template v-for="page in globalPages" :key="page.route || 'home'">
+        <template v-for="page in filteredGlobalPages" :key="page.route || 'home'">
           <router-link
             :to="pageRoute(page)"
             class="btn-ghost w-full text-left flex items-center gap-2"
@@ -456,84 +471,67 @@ function navTitle(page: { route: string }): string {
         </template>
       </nav>
 
-      <!-- Dataset-level navigation (shown when viewing a dataset) -->
-      <div v-if="showDatasetNav" class="mb-6">
-        <div class="section-label">{{ localizedDatasetField(currentDataset, 'title', currentManifest?.title || siteConfig?.title || 'Dataset') }}</div>
-        <nav class="space-y-0.5">
-          <router-link
-            v-for="page in datasetPages"
-            :key="page.route || 'concepts'"
-            :to="pageRoute(page)"
-            class="btn-ghost w-full text-left flex items-center gap-2"
-            :class="isActive(page) ? 'active' : ''"
-            @click="closeMobile"
-          >
-            <NavIcon :name="page.icon" />
-            {{ navTitle(page) }}
-          </router-link>
-        </nav>
-      </div>
-
       <!-- Datasets -->
       <div class="section-label">{{ t('nav.datasets') }}</div>
       <nav class="space-y-1">
-        <button
+        <div
           v-for="ds in datasetEntries"
           :key="ds.id"
-          @click="goToDataset(ds.id)"
-          class="w-full text-left px-3 py-2.5 rounded-lg text-sm transition-all duration-150 border-l-2"
-          :class="[
-            currentDataset === ds.id
-              ? 'bg-surface text-ink-800'
-              : 'border-transparent text-ink-600 hover:bg-ink-50 hover:text-ink-800'
-          ]"
-          :style="currentDataset === ds.id ? { borderLeftColor: getColor(ds.id), borderLeftWidth: '2px' } : {}"
+          class="rounded-lg transition-all duration-150"
+          :class="currentDataset === ds.id ? 'bg-surface' : ''"
         >
-          <div class="font-medium truncate leading-snug">{{ localizedDatasetField(ds.id, 'title', ds.title) }}</div>
-          <div v-if="ds.loaded" class="text-xs mt-0.5" :class="currentDataset === ds.id ? 'text-ink-400' : 'text-ink-300'">
-            {{ ds.conceptCount.toLocaleString() }} {{ t('home.concepts').toLowerCase() }}
-          </div>
-        </button>
-      </nav>
-
-      <!-- Dataset provenance -->
-      <div v-if="provenance.owner" class="mt-6 pt-4 border-t border-ink-100/60">
-        <div class="text-[11px] text-ink-300 space-y-1.5">
-          <div class="font-medium text-ink-400">{{ t('sidebar.provenance') }}</div>
-
-          <div v-if="provenance.ref" class="text-xs font-semibold text-ink-700">
-            {{ provenance.ref }}
-          </div>
-
-          <div class="flex items-center gap-1">
-            <span class="text-ink-400">{{ t('sidebar.publishedBy') }}</span>
-            <a v-if="provenance.ownerUrl" :href="provenance.ownerUrl" target="_blank" rel="noopener" class="concept-link font-medium">{{ provenance.owner }}</a>
-            <span v-else class="text-ink-600 font-medium">{{ provenance.owner }}</span>
-          </div>
-
-          <div v-if="provenance.status" class="flex items-center gap-1.5">
-            <span class="inline-block w-1.5 h-1.5 rounded-full" :class="provenance.status === 'valid' ? 'bg-emerald-500' : 'bg-amber-400'"></span>
-            <span class="text-[10px] uppercase tracking-wide font-medium" :class="provenance.status === 'valid' ? 'text-emerald-600' : 'text-amber-600'">
-              {{ provenance.status }}
-            </span>
-          </div>
-
-          <div v-if="provenance.lastUpdated" class="text-ink-300">
-            {{ t('sidebar.updated') }} {{ provenance.lastUpdated }}
-          </div>
-
-          <div v-if="provenance.conceptCount" class="text-ink-400">
-            {{ provenance.conceptCount.toLocaleString() }} {{ t('sidebar.concepts').toLowerCase() }}
-            <template v-if="provenance.languageCount">
-              · {{ provenance.languageCount }} {{ t('sidebar.languages').toLowerCase() }}
-            </template>
-          </div>
-
-          <div v-if="provenance.sourceRepo">
-            <a :href="provenance.sourceRepo" target="_blank" rel="noopener" class="concept-link">{{ t('sidebar.viewSource') }}</a>
+          <button
+            @click="goToDataset(ds.id)"
+            class="w-full text-left px-3 py-2.5 rounded-lg text-sm border-l-2"
+            :class="[
+              currentDataset === ds.id
+                ? 'text-ink-800'
+                : 'border-transparent text-ink-600 hover:bg-ink-50 hover:text-ink-800'
+            ]"
+            :style="currentDataset === ds.id ? { borderLeftColor: getColor(ds.id), borderLeftWidth: '2px' } : {}"
+          >
+            <div class="font-medium truncate leading-snug">{{ localizedDatasetField(ds.id, 'title', ds.title) }}</div>
+            <div v-if="ds.loaded" class="text-xs mt-0.5" :class="currentDataset === ds.id ? 'text-ink-400' : 'text-ink-300'">
+              {{ ds.conceptCount.toLocaleString() }} {{ t('home.concepts').toLowerCase() }}
+            </div>
+          </button>
+
+          <!-- Expanded dataset: sub-pages + provenance -->
+          <div v-if="currentDataset === ds.id && (filteredDatasetPages.length || provenance.owner)" class="px-2 pb-2">
+            <!-- Sub-pages -->
+            <nav v-if="filteredDatasetPages.length" class="space-y-0.5 mt-1">
+              <router-link
+                v-for="page in filteredDatasetPages"
+                :key="page.route || 'concepts'"
+                :to="pageRoute(page)"
+                class="btn-ghost w-full text-left flex items-center gap-2 text-sm"
+                :class="isActive(page) ? 'active' : ''"
+                @click="closeMobile"
+              >
+                <NavIcon :name="page.icon" />
+                {{ navTitle(page) }}
+              </router-link>
+            </nav>
+
+            <!-- Provenance -->
+            <div v-if="provenance.owner" class="mt-3 pt-3 border-t border-ink-100/60">
+              <div class="text-[11px] text-ink-300 space-y-1.5 px-1">
+                <div v-if="provenance.ref" class="text-xs font-semibold text-ink-700">
+                  {{ provenance.ref }}
+                </div>
+                <div class="flex items-center gap-1">
+                  <span class="text-ink-400">{{ t('sidebar.publishedBy') }}</span>
+                  <a v-if="provenance.ownerUrl" :href="provenance.ownerUrl" target="_blank" rel="noopener" class="concept-link font-medium">{{ provenance.owner }}</a>
+                  <span v-else class="text-ink-600 font-medium">{{ provenance.owner }}</span>
+                </div>
+                <div v-if="provenance.sourceRepo">
+                  <a :href="provenance.sourceRepo" target="_blank" rel="noopener" class="concept-link">{{ t('sidebar.viewSource') }}</a>
+                </div>
+              </div>
+            </div>
           </div>
         </div>
-      </div>
+      </nav>
     </div>
   </aside>
 </template>

package/src/components/SearchBar.vue

@@ -1,18 +1,15 @@
 <script setup lang="ts">
-import { useRouter, useRoute } from 'vue-router';
+import { useRouter } from 'vue-router';
 import { useUiStore } from '../stores/ui';
 import { useVocabularyStore } from '../stores/vocabulary';
 import { ref, watch, onMounted, computed, nextTick } from 'vue';
 import type { SearchHit } from '../adapters/types';
-import { langLabel, langName } from '../utils/lang';
-import { useDsStyle } from '../utils/dataset-style';
 import { useI18n } from '../i18n';
+import SearchResults from './SearchResults.vue';
 
 const router = useRouter();
-const route = useRoute();
 const ui = useUiStore();
 const store = useVocabularyStore();
-const { getStyle } = useDsStyle();
 const { t } = useI18n();
 const query = ref('');
 const results = ref<SearchHit[]>([]);
@@ -38,9 +35,7 @@ async function doSearch() {
   }
   searched.value = true;
   selectedIdx.value = -1;
-  if (route.query.q !== q) {
-    router.replace({ query: { q } });
-  }
+  router.replace({ query: { q } });
 }
 
 function onInput() {
@@ -65,11 +60,9 @@ function clearSearch() {
   router.replace({ query: {} });
 }
 
-// Group results by dataset
 interface GroupedResults {
   registerId: string;
   title: string;
-  style: { light: string; dark: string; color: string };
   hits: SearchHit[];
 }
 
@@ -84,23 +77,12 @@ const groupedResults = computed(() => {
   const groups: GroupedResults[] = [];
   for (const [registerId, hits] of map) {
     const m = store.manifests.get(registerId);
-    groups.push({
-      registerId,
-      title: m?.title ?? registerId,
-      style: getStyle(registerId),
-      hits,
-    });
+    groups.push({ registerId, title: m?.title ?? registerId, hits });
   }
   return groups;
 });
 
-// Flatten for keyboard navigation
 const flatHits = computed(() => groupedResults.value.flatMap(g => g.hits));
-const hitIndexMap = computed(() => {
-  const map = new Map<SearchHit, number>();
-  flatHits.value.forEach((hit, i) => map.set(hit, i));
-  return map;
-});
 
 function goToHit(hit: SearchHit) {
   router.push({
@@ -132,7 +114,6 @@ function scrollToSelected() {
   });
 }
 
-// Sync with UI store search query
 watch(() => ui.searchQuery, (q) => {
   if (q && q !== query.value) {
     query.value = q;
@@ -183,65 +164,16 @@ onMounted(() => {
       </div>
     </form>
 
-    <div v-if="loading" class="text-center py-16">
-      <svg class="w-8 h-8 text-ink-300 animate-spin mx-auto mb-4" fill="none" viewBox="0 0 24 24">
-        <circle class="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" stroke-width="4"></circle>
-        <path class="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4zm2 5.291A7.962 7.962 0 014 12H0c0 3.042 1.135 5.824 3 7.938l3-2.647z"></path>
-      </svg>
-      <p class="text-sm text-ink-400">{{ t('search.searching') }}</p>
-    </div>
-
-    <div v-else-if="searchError" class="text-center py-16">
-      <div class="card p-8 border-red-200 bg-red-50/50 max-w-md mx-auto">
-        <p class="text-red-700 font-medium mb-1">{{ t('search.failed') }}</p>
-        <p class="text-sm text-red-600/80 mb-4">{{ searchError }}</p>
-        <button @click="doSearch" class="btn-primary">{{ t('search.retry') }}</button>
-      </div>
-    </div>
-
-    <div v-else-if="searched">
-      <p class="text-sm text-ink-400 mb-4">{{ results.length === 1 ? t('search.oneResultFor', { query: ui.searchQuery }) : t('search.manyResultsFor', { count: String(results.length), query: ui.searchQuery }) }}</p>
-      <div v-if="results.length === 0" class="text-center py-16">
-        <div class="text-ink-200 text-5xl mb-4 font-serif">&empty;</div>
-        <p class="text-ink-500 font-medium">{{ t('search.noResults') }}</p>
-        <p class="text-sm text-ink-300 mt-1">{{ t('search.tryDifferent') }}</p>
-      </div>
-
-      <!-- Grouped results -->
-      <div v-else class="space-y-6">
-        <div v-for="group in groupedResults" :key="group.registerId">
-          <!-- Dataset header -->
-          <div class="flex items-center gap-2 mb-2">
-            <span class="w-2 h-2 rounded-full flex-shrink-0" :style="{ backgroundColor: group.style.color }"></span>
-            <span class="text-xs font-semibold text-ink-500 uppercase tracking-wide">{{ group.title }}</span>
-            <span class="text-xs text-ink-300">{{ group.hits.length }} {{ group.hits.length === 1 ? t('search.result') : t('search.results') }}</span>
-          </div>
-          <!-- Hits -->
-          <div class="space-y-1.5">
-            <button
-              v-for="hit in group.hits"
-              :key="hit.conceptId + hit.language"
-              @click="goToHit(hit)"
-              :class="selectedIdx === hitIndexMap.get(hit) ? 'bg-ink-50 border-ink-200 search-hit-selected' : ''"
-              class="card-hover p-3 w-full text-left flex items-center justify-between group"
-            >
-              <div class="min-w-0">
-                <span class="font-medium text-ink-800 group-hover:text-ink-900 transition-colors">{{ hit.designation }}</span>
-                <span class="text-xs text-ink-300 ml-2 font-mono">{{ hit.conceptId }}</span>
-                <span v-if="hit.snippet" class="block text-xs text-ink-300 mt-0.5 truncate">{{ hit.snippet }}</span>
-              </div>
-              <div class="flex items-center gap-2 flex-shrink-0">
-                <span v-if="hit.matchField === 'id'" class="badge badge-gray text-[10px]">{{ t('search.idMatch') }}</span>
-                <span class="text-xs font-semibold text-ink-500 bg-ink-50 px-1.5 py-0.5 rounded">{{ langName(hit.language) }}</span>
-              </div>
-            </button>
-          </div>
-        </div>
-      </div>
-
-      <div v-if="results.length > 100" class="text-center text-sm text-ink-300 mt-6 pt-4 border-t border-ink-100/60">
-        {{ t('search.showingFirst', { max: '100', total: String(results.length) }) }}
-      </div>
-    </div>
+    <SearchResults
+      :loading="loading"
+      :search-error="searchError"
+      :searched="searched"
+      :search-query="ui.searchQuery"
+      :results="results"
+      :grouped-results="groupedResults"
+      :selected-idx="selectedIdx"
+      @retry="doSearch"
+      @go-hit="goToHit"
+    />
   </div>
 </template>

package/src/components/SearchResults.vue

@@ -0,0 +1,98 @@
+<script setup lang="ts">
+import { computed } from 'vue';
+import type { SearchHit } from '../adapters/types';
+import { langName } from '../utils/lang';
+import { useDsStyle } from '../utils/dataset-style';
+import { useI18n } from '../i18n';
+
+interface GroupedResults {
+  registerId: string;
+  title: string;
+  hits: SearchHit[];
+}
+
+const props = defineProps<{
+  loading: boolean;
+  searchError: string | null;
+  searched: boolean;
+  searchQuery: string;
+  results: SearchHit[];
+  groupedResults: GroupedResults[];
+  selectedIdx: number;
+}>();
+
+const emit = defineEmits<{
+  retry: [];
+  goHit: [hit: SearchHit];
+}>();
+
+const { getStyle } = useDsStyle();
+const { t } = useI18n();
+
+const flatHits = computed(() => props.groupedResults.flatMap(g => g.hits));
+const hitIndexMap = computed(() => {
+  const map = new Map<SearchHit, number>();
+  flatHits.value.forEach((hit, i) => map.set(hit, i));
+  return map;
+});
+</script>
+
+<template>
+  <div v-if="loading" class="text-center py-16">
+    <svg class="w-8 h-8 text-ink-300 animate-spin mx-auto mb-4" fill="none" viewBox="0 0 24 24">
+      <circle class="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" stroke-width="4"></circle>
+      <path class="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4zm2 5.291A7.962 7.962 0 014 12H0c0 3.042 1.135 5.824 3 7.938l3-2.647z"></path>
+    </svg>
+    <p class="text-sm text-ink-400">{{ t('search.searching') }}</p>
+  </div>
+
+  <div v-else-if="searchError" class="text-center py-16">
+    <div class="card p-8 border-red-200 bg-red-50/50 max-w-md mx-auto">
+      <p class="text-red-700 font-medium mb-1">{{ t('search.failed') }}</p>
+      <p class="text-sm text-red-600/80 mb-4">{{ searchError }}</p>
+      <button @click="emit('retry')" class="btn-primary">{{ t('search.retry') }}</button>
+    </div>
+  </div>
+
+  <div v-else-if="searched" class="search-results">
+    <p class="text-sm text-ink-400 mb-4">{{ results.length === 1 ? t('search.oneResultFor', { query: searchQuery }) : t('search.manyResultsFor', { count: String(results.length), query: searchQuery }) }}</p>
+    <div v-if="results.length === 0" class="text-center py-16">
+      <div class="text-ink-200 text-5xl mb-4 font-serif">&empty;</div>
+      <p class="text-ink-500 font-medium">{{ t('search.noResults') }}</p>
+      <p class="text-sm text-ink-300 mt-1">{{ t('search.tryDifferent') }}</p>
+    </div>
+
+    <div v-else class="space-y-6">
+      <div v-for="group in groupedResults" :key="group.registerId">
+        <div class="flex items-center gap-2 mb-2">
+          <span class="w-2 h-2 rounded-full flex-shrink-0" :style="{ backgroundColor: getStyle(group.registerId).color }"></span>
+          <span class="text-xs font-semibold text-ink-500 uppercase tracking-wide">{{ group.title }}</span>
+          <span class="text-xs text-ink-300">{{ group.hits.length }} {{ group.hits.length === 1 ? t('search.result') : t('search.results') }}</span>
+        </div>
+        <div class="space-y-1.5">
+          <button
+            v-for="hit in group.hits"
+            :key="hit.conceptId + hit.language"
+            @click="emit('goHit', hit)"
+            :class="selectedIdx === hitIndexMap.get(hit) ? 'bg-ink-50 border-ink-200 search-hit-selected' : ''"
+            class="card-hover p-3 w-full text-left flex items-center justify-between group"
+          >
+            <div class="min-w-0">
+              <span class="font-medium text-ink-800 group-hover:text-ink-900 transition-colors">{{ hit.designation }}</span>
+              <span class="text-xs text-ink-300 ml-2 font-mono">{{ hit.conceptId }}</span>
+              <span v-if="hit.snippet" class="block text-xs text-ink-300 mt-0.5 truncate">{{ hit.snippet }}</span>
+            </div>
+            <div class="flex items-center gap-2 flex-shrink-0">
+              <span v-if="hit.matchField === 'id'" class="badge badge-gray text-[10px]">{{ t('search.idMatch') }}</span>
+              <span class="text-xs font-semibold text-ink-500 bg-ink-50 px-1.5 py-0.5 rounded">{{ langName(hit.language) }}</span>
+            </div>
+          </button>
+        </div>
+      </div>
+    </div>
+
+    <div v-if="results.length > 100" class="text-center text-sm text-ink-300 mt-6 pt-4 border-t border-ink-100/60">
+      {{ t('search.showingFirst', { max: '100', total: String(results.length) }) }}
+    </div>
+  </div>
+</template>

package/src/style.css

@@ -146,6 +146,19 @@
     margin: 0.25rem 0;
   }
 
+  .concept-table {
+    border-collapse: collapse;
+    margin: 0.75rem 0;
+    font-size: 0.875rem;
+    width: 100%;
+  }
+  .concept-table td {
+    border: 1px solid var(--ink-200, #d1d5db);
+    padding: 0.375rem 0.625rem;
+    vertical-align: top;
+    text-align: left;
+  }
+
   /* Smooth collapse for language sections */
   .lang-content {
     overflow: hidden;

package/src/utils/math.ts

@@ -54,7 +54,20 @@ function mathPlaceholder(expr: string, format: string, bold: boolean): string {
 }
 
 function convertLists(text: string): string {
-  let result = text.replace(/(?:^|\n)((?:[ \t]*\* [^\n]+)(?:\n[ \t]*\* [^\n]+)*)/g, (_, block) => {
+  // AsciiDoc pipe-delimited tables: |=== ... |===
+  let result = text.replace(/\|===\n([\s\S]*?)\n\|===/g, (_, body) => {
+    const rows = body.split('\n').filter(line => line.trim().length > 0);
+    const htmlRows = rows.map(row => {
+      // Each row starts with "| " — strip the leading pipe then split on " | "
+      const cells = row.replace(/^\| */, '').split(/ \| /);
+      const htmlCells = cells.map(c => `<td>${c.trim()}</td>`).join('');
+      return `<tr>${htmlCells}</tr>`;
+    });
+    return `<table class="concept-table">${htmlRows.join('')}</table>`;
+  });
+
+  // Bullet lists: * item
+  result = result.replace(/(?:^|\n)((?:[ \t]*\* [^\n]+)(?:\n[ \t]*\* [^\n]+)*)/g, (_, block) => {
     if (/^\*stem:\[/.test(block.trimStart())) return _;
     const items: string[] = [];
     const re = /[ \t]*\* ([^\n]+)/g;
@@ -67,6 +80,7 @@ function convertLists(text: string): string {
     return `\n<ul class="concept-list">${lis}</ul>`;
   });
 
+  // Numbered lists: 1) item or 1. item
   result = result.replace(/(?:^|\n)((?:[ \t]*\d+[).][ \t]+[^\n]+)(?:\n[ \t]*\d+[).][ \t]+[^\n]+)*)/g, (_, block) => {
     const items: string[] = [];
     const re = /[ \t]*\d+[).][ \t]+([^\n]+)/g;