@glossarist/concept-browser 0.7.101 → 0.7.103

package/cli/index.mjs

@@ -1,24 +1,14 @@
 #!/usr/bin/env node
 
 /**
- * Glossarist Concept Browser CLI.
+ * Glossarist Concept Browser CLI — runtime entrypoint.
  *
- * Commands:
- *   fetch      Fetch/update datasets (from GCR packages or source repos)
- *   generate   Convert harmonized YAML concepts to JSON-LD static files
- *   edges      Build cross-reference edges from generated concept data
- *   build      Full pipeline: fetch + generate + edges + vite build
- *   site       Same as build (alias)
- *   normalize  NFC-normalize YAML files in .datasets/ (use --check for CI gate)
- *   doctor     Diagnose the local environment (deps, datasets, shapes, context)
+ * This is the published bin entry. It stays as plain JS (no tsx dependency)
+ * so consumers who install with --omit=dev can use it.
  *
- * Options:
- *   --site <id>  Site config to use (looks for site-config.yml in CWD)
- *
- * Environment:
- *   SITE_CONFIG          Path to site config file (overrides --site)
- *   SITE_ID              Site config ID (overrides --site)
- *   GITHUB_TOKEN         GitHub token for private repos
+ * The TypeScript version lives at cli/index.ts for type-checking during
+ * development. The two files should be kept in sync manually until
+ * TODO.typescript/03 adds a compile step.
  */
 
 import { loadSiteConfig } from '../scripts/load-site-config.mjs';
@@ -79,7 +69,6 @@ Environment:
     process.exit(cmd ? 0 : 1);
   }
 
-  // Pre-load site config so scripts can use it
   if (!process.env.SITE_CONFIG && !process.env.SITE_ID && named.site) {
     process.env.SITE_ID = named.site;
   }
@@ -94,7 +83,6 @@ Environment:
       await commands[step]();
     }
 
-    // Generate favicons from site logo
     const fs = await import('fs');
     const publicDir = resolve(process.cwd(), 'public');
     fs.mkdirSync(publicDir, { recursive: true });
@@ -124,7 +112,6 @@ Environment:
         },
       });
 
-      // Write all generated images and files to public/
       for (const img of response.images) {
         fs.writeFileSync(resolve(publicDir, img.name), img.contents);
       }
@@ -132,22 +119,18 @@ Environment:
         fs.writeFileSync(resolve(publicDir, file.name), file.contents);
       }
 
-      // Keep the original SVG for dark mode support
       if (faviconSrc.endsWith('.svg')) {
         fs.copyFileSync(faviconSrc, resolve(publicDir, 'favicon.svg'));
       }
 
       faviconHtml = response.html.join('\n    ');
-      // Add SVG favicon
       if (faviconSrc.endsWith('.svg')) {
         faviconHtml += '\n    <link rel="icon" type="image/svg+xml" href="/favicon.svg">';
       }
-      // Write tags for Vite plugin to pick up
       fs.writeFileSync(resolve(publicDir, 'favicon-links.html'), faviconHtml);
       console.log(`  Generated ${response.images.length} favicon files`);
     }
 
-    // Pass favicon tags to Vite via env
     if (faviconHtml) {
       const basePath = process.env.BASE_PATH?.replace(/\/+$/, '') || '';
       if (basePath) {
@@ -156,7 +139,6 @@ Environment:
       process.env.FAVICON_HTML = faviconHtml;
     }
 
-    // Pass branding info for HTML transformation
     process.env.SITE_TITLE = config?.title || 'Glossarist';
     if (branding.fonts?.header || branding.fonts?.body) {
       const fontFamilies = [];
@@ -173,14 +155,12 @@ Environment:
       }
     }
 
-    // Bridge data to Astro content collections
     console.log(`\n=== BRIDGE DATA ===\n`);
     const bridge = resolve(pkgRoot, 'scripts', 'bridge-to-astro.mjs');
     if (existsSync(bridge)) {
       await import(`file://${bridge}`);
     }
 
-    // Run Astro build (TODO.astro/22)
     console.log(`\n=== BUILD ASTRO ===\n`);
     const astroConfig = resolve(pkgRoot, 'astro.config.mjs');
     if (existsSync(astroConfig)) {
@@ -195,14 +175,12 @@ Environment:
         await viteBuild({ configFile: viteConfig, root: pkgRoot, mode: 'production' });
       }
     } else {
-      // Fall back to Vite SPA if Astro config doesn't exist
       console.log(`\n=== BUILD SPA ===\n`);
       const viteConfig = resolve(pkgRoot, 'vite.config.ts');
       const { build: viteBuild } = await import('vite');
       await viteBuild({ configFile: viteConfig, root: pkgRoot, mode: 'production' });
     }
 
-    // Run postbuild (404 page) via dynamic import
     const postbuild = resolve(pkgRoot, 'scripts', 'generate-404.js');
     if (existsSync(postbuild)) {
       await import(`file://${postbuild}`);

package/cli/index.ts

@@ -0,0 +1,289 @@
+#!/usr/bin/env node
+
+/**
+ * Glossarist Concept Browser CLI.
+ *
+ * Commands:
+ *   fetch      Fetch/update datasets (from GCR packages or source repos)
+ *   generate   Convert harmonized YAML concepts to JSON-LD static files
+ *   edges      Build cross-reference edges from generated concept data
+ *   build      Full pipeline: fetch + generate + edges + vite build
+ *   site       Same as build (alias)
+ *   normalize  NFC-normalize YAML files in .datasets/ (use --check for CI gate)
+ *   doctor     Diagnose the local environment (deps, datasets, shapes, context)
+ *
+ * Options:
+ *   --site <id>  Site config to use (looks for site-config.yml in CWD)
+ *
+ * Environment:
+ *   SITE_CONFIG          Path to site config file (overrides --site)
+ *   SITE_ID              Site config ID (overrides --site)
+ *   GITHUB_TOKEN         GitHub token for private repos
+ */
+
+// Scripts are still .mjs (TODO.typescript/02). These imports will be fully
+// typed once the scripts convert to .ts.
+// @ts-expect-error — .mjs module without declaration
+import { loadSiteConfig } from '../scripts/load-site-config.mjs';
+import { existsSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname: string = dirname(fileURLToPath(import.meta.url));
+const pkgRoot: string = resolve(__dirname, '..');
+
+interface ParsedArgs {
+  positional: string[];
+  named: Record<string, string>;
+}
+
+type CommandRunner = () => Promise<void>;
+
+const commands: Record<string, CommandRunner> = {
+  fetch:    async () => (await import('../scripts/fetch-datasets.mjs' as string)).main(),
+  generate: async () => { await import('../scripts/generate-data.mjs' as string); },
+  edges:    async () => (await import('../scripts/build-edges.js' as string)).main(),
+  about:    async () => (await import('../scripts/process-about-pages.mjs' as string)).main(),
+};
+
+function parseArgs(argv: readonly string[]): ParsedArgs {
+  const positional: string[] = [];
+  const named: Record<string, string> = {};
+  for (let i = 0; i < argv.length; i++) {
+    if (argv[i].startsWith('--') && i + 1 < argv.length) {
+      named[argv[i].slice(2)] = argv[i + 1];
+      i++;
+    } else if (!argv[i].startsWith('-')) {
+      positional.push(argv[i]);
+    }
+  }
+  return { positional, named };
+}
+
+interface BrandingFonts {
+  source?: string;
+  family?: string;
+  weights?: number[];
+}
+
+interface BrandingConfig {
+  favicon?: string;
+  logo?: { localPath?: string };
+  primaryColor?: string;
+  fonts?: { header?: BrandingFonts; body?: BrandingFonts };
+}
+
+interface SiteConfig {
+  basePath?: string;
+  title?: string;
+  branding?: BrandingConfig;
+}
+
+interface FaviconResponse {
+  images: Array<{ name: string; contents: string | Buffer }>;
+  files: Array<{ name: string; contents: string | Buffer }>;
+  html: string[];
+}
+
+async function runBuildPipeline(config: SiteConfig | null): Promise<void> {
+  if (!process.env.BASE_PATH && config?.basePath) {
+    process.env.BASE_PATH = config.basePath;
+  }
+  for (const step of ['fetch', 'generate', 'edges', 'about'] as const) {
+    console.log(`\n=== ${step.toUpperCase()} ===\n`);
+    await commands[step]();
+  }
+
+  const fs = await import('fs');
+  const publicDir: string = resolve(process.cwd(), 'public');
+  fs.mkdirSync(publicDir, { recursive: true });
+
+  const branding: BrandingConfig = config?.branding ?? {};
+  const faviconSrc: string =
+    (branding.favicon && resolve(process.cwd(), branding.favicon)) ||
+    (branding.logo?.localPath && resolve(process.cwd(), branding.logo.localPath)) ||
+    resolve(pkgRoot, 'public', 'favicon.svg');
+
+  let faviconHtml = '';
+  if (fs.existsSync(faviconSrc)) {
+    console.log(`\n=== FAVICONS ===\n`);
+    const favicons = (await import('favicons')).default;
+    const source: Buffer = fs.readFileSync(faviconSrc);
+    const response: FaviconResponse = await favicons(source, {
+      appName: config?.title || 'Glossarist',
+      background: branding.primaryColor || '#2563eb',
+      theme_color: branding.primaryColor || '#2563eb',
+      icons: {
+        android: false,
+        appleIcon: true,
+        appleStartup: false,
+        favicons: true,
+        windows: false,
+        yandex: false,
+      },
+    });
+
+    for (const img of response.images) {
+      fs.writeFileSync(resolve(publicDir, img.name), img.contents);
+    }
+    for (const file of response.files) {
+      fs.writeFileSync(resolve(publicDir, file.name), file.contents);
+    }
+
+    if (faviconSrc.endsWith('.svg')) {
+      fs.copyFileSync(faviconSrc, resolve(publicDir, 'favicon.svg'));
+    }
+
+    faviconHtml = response.html.join('\n    ');
+    if (faviconSrc.endsWith('.svg')) {
+      faviconHtml += '\n    <link rel="icon" type="image/svg+xml" href="/favicon.svg">';
+    }
+    fs.writeFileSync(resolve(publicDir, 'favicon-links.html'), faviconHtml);
+    console.log(`  Generated ${response.images.length} favicon files`);
+  }
+
+  if (faviconHtml) {
+    const basePath: string = process.env.BASE_PATH?.replace(/\/+$/, '') || '';
+    if (basePath) {
+      faviconHtml = faviconHtml.replace(/(href|content)="\/([^"]+)"/g, `$1="${basePath}/$2"`);
+    }
+    process.env.FAVICON_HTML = faviconHtml;
+  }
+
+  process.env.SITE_TITLE = config?.title || 'Glossarist';
+  if (branding.fonts?.header || branding.fonts?.body) {
+    const fontFamilies: string[] = [];
+    if (branding.fonts.header?.source === 'google') {
+      const w: string = (branding.fonts.header.weights || [400, 700]).join(';');
+      fontFamilies.push(`family=${branding.fonts.header.family!.replace(/ /g, '+')}:wght@${w}`);
+    }
+    if (branding.fonts.body?.source === 'google') {
+      const w: string = (branding.fonts.body.weights || [400, 700]).join(';');
+      fontFamilies.push(`family=${branding.fonts.body.family!.replace(/ /g, '+')}:wght@${w}`);
+    }
+    if (fontFamilies.length) {
+      process.env.SITE_FONTS_URL = `https://fonts.googleapis.com/css2?${fontFamilies.join('&')}&display=swap`;
+    }
+  }
+
+  console.log(`\n=== BRIDGE DATA ===\n`);
+  const bridge: string = resolve(pkgRoot, 'scripts', 'bridge-to-astro.mjs');
+  if (existsSync(bridge)) {
+    await import(`file://${bridge}`);
+  }
+
+  console.log(`\n=== BUILD ASTRO ===\n`);
+  const astroConfig: string = resolve(pkgRoot, 'astro.config.mjs');
+  if (existsSync(astroConfig)) {
+    try {
+      const { build: astroBuild } = await import('astro');
+      await astroBuild({ root: pkgRoot, logLevel: 'info' });
+    } catch (e: unknown) {
+      const msg = e instanceof Error ? e.message : String(e);
+      console.warn(`  Astro build failed (${msg}), falling back to Vite SPA`);
+      console.log(`\n=== BUILD SPA ===\n`);
+      const viteConfig: string = resolve(pkgRoot, 'vite.config.ts');
+      const { build: viteBuild } = await import('vite');
+      await viteBuild({ configFile: viteConfig, root: pkgRoot, mode: 'production' });
+    }
+  } else {
+    console.log(`\n=== BUILD SPA ===\n`);
+    const viteConfig: string = resolve(pkgRoot, 'vite.config.ts');
+    const { build: viteBuild } = await import('vite');
+    await viteBuild({ configFile: viteConfig, root: pkgRoot, mode: 'production' });
+  }
+
+  const postbuild: string = resolve(pkgRoot, 'scripts', 'generate-404.js');
+  if (existsSync(postbuild)) {
+    await import(`file://${postbuild}`);
+  }
+}
+
+async function runNormalize(): Promise<void> {
+  const mod = await import('../scripts/normalize-yaml.mjs' as string);
+  const normalizeYaml = mod.normalizeYaml;
+  const check: boolean = process.argv.includes('--check');
+  const paths: string[] = process.argv.slice(2).filter(a => !a.startsWith('-') && a !== 'normalize');
+  const { checked, nonNfc, fixed }: { checked: number; nonNfc: number; fixed: string[] } = normalizeYaml({ check, paths });
+  if (check) {
+    if (nonNfc === 0) {
+      console.log(`NFC OK: ${checked} file(s) checked, all normalized`);
+      return;
+    }
+    console.error(`NFC check failed: ${nonNfc} of ${checked} file(s) are not NFC-normalized\n`);
+    for (const f of fixed) console.error(`  ${f}`);
+    process.exit(1);
+  }
+  if (nonNfc === 0) {
+    console.log(`NFC OK: ${checked} file(s) checked, all already normalized`);
+  } else {
+    console.log(`Normalized ${nonNfc} of ${checked} file(s)`);
+    for (const f of fixed) console.log(`  ${f}`);
+  }
+}
+
+async function main(): Promise<void> {
+  const args: readonly string[] = process.argv.slice(2);
+  const { positional, named }: ParsedArgs = parseArgs(args);
+  const cmd: string | undefined = positional[0];
+
+  if (!cmd || cmd === 'help' || cmd === '--help') {
+    console.log(`concept-browser <command> [options]
+
+Commands:
+  fetch      Fetch/update datasets from GCR packages or source repos
+  generate   Convert YAML concepts to JSON-LD static data
+  edges      Build cross-reference edges from generated concepts
+  about      Compile per-dataset and per-group about pages
+  build      Full pipeline (fetch + generate + edges + about + vite build)
+  site       Same as build
+  normalize  NFC-normalize YAML files in .datasets/
+  doctor     Diagnose the local environment (deps, datasets, shapes, context)
+
+Options:
+  --site <id>  Site config ID (looks for site-config.yml in CWD)
+  --check      (normalize only) Non-mutating; exit 1 if any file is not NFC
+
+Environment:
+  SITE_CONFIG          Site config file path (highest priority)
+  SITE_ID              Site config ID (same as --site)
+  GITHUB_TOKEN         GitHub token for private repos`);
+    process.exit(cmd ? 0 : 1);
+  }
+
+  if (!process.env.SITE_CONFIG && !process.env.SITE_ID && named.site) {
+    process.env.SITE_ID = named.site;
+  }
+  const { config }: { config: SiteConfig | null } = loadSiteConfig(named.site ? [named.site] : []);
+
+  if (cmd === 'build' || cmd === 'site') {
+    await runBuildPipeline(config);
+    return;
+  }
+
+  const runner: CommandRunner | undefined = commands[cmd];
+  if (runner) {
+    await runner();
+    return;
+  }
+
+  if (cmd === 'normalize') {
+    await runNormalize();
+    return;
+  }
+
+  if (cmd === 'doctor') {
+    const mod = await import('../scripts/doctor.mjs' as string);
+    await mod.main();
+    return;
+  }
+
+  console.error(`Unknown command: ${cmd}`);
+  console.error('Run `concept-browser help` for usage.');
+  process.exit(1);
+}
+
+main().catch((e: unknown) => {
+  console.error(e);
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glossarist/concept-browser",
-  "version": "0.7.101",
+  "version": "0.7.103",
   "description": "Vue SPA for browsing Glossarist terminology datasets with cross-reference resolution, graph visualization, and multi-language support",
   "type": "module",
   "bin": {
@@ -37,7 +37,7 @@
     "astro": "^7.0.7",
     "d3": "^7.9.0",
     "favicons": "^7.2.0",
-    "glossarist": "^0.4.34",
+    "glossarist": "^0.4.51",
     "js-yaml": "^4.1.0",
     "jszip": "^3.10.1",
     "pinia": "^2.3.1",

package/src/__tests__/__fixtures__/concepts.ts

@@ -87,8 +87,8 @@ function withSources(): Concept {
         type: 'authoritative',
         modification: 'revised 2024',
         origin: {
-          ref: { source: 'ISO 704', id: '3.1', version: '2020' },
-          locality: { type: 'clause', referenceFrom: '3.1', referenceTo: '3.5' },
+          ref: { source: 'ISO 704', id: '3.1', version: '2020' } as any,
+          locality: { type: 'clause', referenceFrom: '3.1', referenceTo: '3.5' } as any,
           link: 'https://example.org/iso-704',
           original: 'Original wording here.',
         },
@@ -98,7 +98,7 @@ function withSources(): Concept {
         type: 'lineage',
         origin: {
           ref: { source: 'IEC 60050', id: '102-01', version: '2008' },
-          locality: { type: 'clause', referenceFrom: '102-01-01' },
+          locality: { type: 'clause', referenceFrom: '102-01-01' } as any,
         },
       },
       {

package/src/__tests__/composables/use-concept-edges-v2.test.ts

@@ -1,3 +1,4 @@
+// @ts-nocheck — TODO.typescript/12: remove after glossarist TS migration
 import { describe, it, expect } from 'vitest';
 // glossarist 0.4.33 renamed PartitiveRelation → PartitiveHyperedge.
 // Import from glossarist/models (extended by our local augmentation).

package/src/__tests__/designation-relationship.test.ts

@@ -197,8 +197,8 @@ describe('designation target matching robustness', () => {
     // Terms are in model order, not raw order
     const pdf = lc.terms.find(t => t.designation === 'PDF')!;
     const iso = lc.terms.find(t => t.designation === 'ISO')!;
-    expect(getDesignationTarget(pdf.related[0])).toBe('Portable Document Format');
-    expect(getDesignationTarget(iso.related[0])).toBe('International Organization for Standardization');
+    expect(getDesignationTarget(pdf.related[0] as any)).toBe('Portable Document Format');
+    expect(getDesignationTarget(iso.related[0] as any)).toBe('International Organization for Standardization');
   });
 });
 

package/src/__tests__/perf/serialization-perf.test.ts

@@ -1,3 +1,4 @@
+// @ts-nocheck — TODO.typescript/12: remove after glossarist TS migration
 import { describe, it, expect } from 'vitest';
 import { Concept } from 'glossarist';
 import { conceptToQuads, collectQuads, writeTurtleSync, PREFIXES } from 'glossarist/rdf';

package/src/__tests__/use-rdf-document.test.ts

@@ -1,3 +1,4 @@
+// @ts-nocheck — TODO.typescript/12: remove after glossarist TS migration
 import { describe, it, expect } from 'vitest';
 import { ref } from 'vue';
 import { Concept } from 'glossarist';

package/src/adapters/bibliography-adapter.ts

@@ -38,7 +38,7 @@ export class BibliographyAdapter {
     return this.data?.find(id) ?? null;
   }
 
-  all(): BibliographyEntry[] {
+  all(): readonly BibliographyEntry[] {
     return this.data?.entries ?? [];
   }
 

package/src/adapters/model-bridge.ts

@@ -61,7 +61,7 @@ import type {
   JsonLdPartitiveMember,
   JsonLdPartitiveRelation,
   JsonLdConcept,
-} from './model-bridge/jsonld-types';
+} from './jsonld-types';
 
 // ── Bridges for fields not yet in glossarist-js ────────────────────────────
 // Remove each bridge when glossarist-js publishes native support.
@@ -173,7 +173,7 @@ function attachBridges(concept: Concept, localizations: Record<string, unknown>)
  * instances, since RelatedConcept.fromJSON only reads type/content/ref.
  */
 function attachRelatedBridges(
-  modelRelated: Array<{ type?: string | null; content?: Record<string, string> | string | null; ref?: any; related?: any[] }>,
+  modelRelated: ReadonlyArray<{ type?: string | null; content?: Record<string, string> | string | null; ref?: any; related?: ReadonlyArray<any> }>,
   rawRelated: unknown[],
 ): void {
   for (const rawRel of rawRelated) {
@@ -241,7 +241,7 @@ function mapDesignationFromJsonLd(d: JsonLdDesignation): Record<string, unknown>
 
   const pronunciation = d[GL.PRONUNCIATION];
   if (pronunciation?.length) {
-    result.pronunciation = pronunciation.map(p => ({
+    result.pronunciation = pronunciation.map((p: any) => ({
       content: p[GL.CONTENT] ?? null,
       language: p[GL.LANGUAGE] ?? null,
       script: p[GL.SCRIPT] ?? null,
@@ -257,7 +257,7 @@ function mapDesignationFromJsonLd(d: JsonLdDesignation): Record<string, unknown>
 
   const related = d[GL.RELATED];
   if (related?.length) {
-    result.related = related.map(r => {
+    result.related = related.map((r: any) => {
       const relType = r[GL.RELATIONSHIP_TYPE] ?? 'references';
       if (DESIGNATION_REL_TYPES.has(relType) && r[GL.TARGET]) {
         return { type: relType, target: r[GL.TARGET] };
@@ -272,7 +272,7 @@ function mapDesignationFromJsonLd(d: JsonLdDesignation): Record<string, unknown>
   }
   const grammarInfo = d[GL.GRAMMAR_INFO];
   if (grammarInfo?.length) {
-    result.grammar_info = grammarInfo.map(gi => ({
+    result.grammar_info = grammarInfo.map((gi: any) => ({
       gender: gi[GL.GENDER] ?? null,
       number: gi[GL.NUMBER] ?? null,
       part_of_speech: gi[GL.PART_OF_SPEECH] ?? null,
@@ -354,7 +354,7 @@ function mapSourceFromJsonLd(s: JsonLdSource): Record<string, unknown> {
 
   const sf = s[GL.SOURCED_FROM] ?? s[GL.SOURCED_FROM_ALT];
   if (sf?.length) {
-    result.sourced_from = sf.map(item => mapOriginFromJsonLd(item));
+    result.sourced_from = sf.map((item: any) => mapOriginFromJsonLd(item));
   }
 
   return result;
@@ -445,7 +445,7 @@ function mapLocalizedFromJsonLd(lc: JsonLdLocalizedConcept): Record<string, unkn
 
   const dates = lc[GL.DATES];
   if (dates?.length) {
-    data.dates = dates.map(d => ({
+    data.dates = dates.map((d: any) => ({
       date: d[GL.DATE] ?? null,
       type: d[GL.DATE_TYPE] ?? null,
     }));
@@ -471,7 +471,7 @@ function mapPartitiveRelationFromJsonLd(r: JsonLdPartitiveRelation): Record<stri
   if (!comprehensive) return null;
 
   const partitives = (r[GL.HAS_PARTITIVE] ?? [])
-    .map((m): Record<string, unknown> | null => {
+    .map((m: any): Record<string, unknown> | null => {
       const ref = m[GL.REF] ? mapRefFromJsonLd(m[GL.REF]) : null;
       if (!ref) return null;
       const out: Record<string, unknown> = { ref };
@@ -494,7 +494,7 @@ function mapPartitiveRelationFromJsonLd(r: JsonLdPartitiveRelation): Record<stri
       if (m[GL.IS_DELIMITING] === true) out.is_delimiting = true;
       return out;
     })
-    .filter((m): m is Record<string, unknown> => m !== null);
+    .filter((m: any): m is Record<string, unknown> => m !== null);
 
   // ISO 704 requires ≥2 partitives. Skip malformed relations rather
   // than letting the constructor throw and break the whole concept.
@@ -529,7 +529,7 @@ function mapGenericRelationFromJsonLd(r: JsonLdPartitiveRelation): Record<string
   if (!comprehensive) return null;
 
   const members = (r[GL.HAS_GENERIC] ?? [])
-    .map((m): Record<string, unknown> | null => {
+    .map((m: any): Record<string, unknown> | null => {
       const ref = m[GL.REF] ? mapRefFromJsonLd(m[GL.REF]) : null;
       if (!ref) return null;
       const out: Record<string, unknown> = { ref };
@@ -552,7 +552,7 @@ function mapGenericRelationFromJsonLd(r: JsonLdPartitiveRelation): Record<string
       }
       return out;
     })
-    .filter((m): m is Record<string, unknown> => m !== null);
+    .filter((m: any): m is Record<string, unknown> => m !== null);
 
   if (members.length < 2) return null;
 
@@ -589,7 +589,7 @@ function splitMultiplicity(m: string): { presence: 'required' | 'optional'; coun
 
 function conceptFromJsonLd(doc: JsonLdConcept): Concept {
   const id = String(doc[GL.IDENTIFIER] ?? doc['@id']?.split('/').pop() ?? '');
-  const localizations: Record<string, unknown> = {};
+  const localizations: Record<string, Record<string, unknown>> = {};
 
   const rawLc = doc[GL.LOCALIZED_CONCEPT] ?? {};
   for (const [lang, lc] of Object.entries(rawLc)) {
@@ -601,10 +601,10 @@ function conceptFromJsonLd(doc: JsonLdConcept): Concept {
   const related = (doc[GL.RELATED] ?? []).map(mapRelatedFromJsonLd);
   const partitiveRelations = (doc[GL.PARTITIVE_RELATIONS] ?? [])
     .map(mapPartitiveRelationFromJsonLd)
-    .filter((r): r is Record<string, unknown> => r !== null);
+    .filter((r: any): r is Record<string, unknown> => r !== null);
   const genericRelations = (doc[GL.GENERIC_RELATIONS] ?? [])
     .map(mapGenericRelationFromJsonLd)
-    .filter((r): r is Record<string, unknown> => r !== null);
+    .filter((r: any): r is Record<string, unknown> => r !== null);
   const tagsArr = doc[GL.TAGS];
   const tags = Array.isArray(tagsArr) ? [...tagsArr] : [];
 
@@ -612,7 +612,7 @@ function conceptFromJsonLd(doc: JsonLdConcept): Concept {
     id,
     term: doc[GL.TERM] ?? null,
     uri: doc['@id'] ?? null,
-    localizations,
+    localizations: localizations as Record<string, any>,
     related,
     partitive_relations: partitiveRelations,
     generic_relations: genericRelations,

package/src/adapters/non-verbal/figure-bridge.ts

@@ -48,7 +48,7 @@ function imageFromJsonLd(raw: Record<string, unknown>): FigureImage | null {
     ...(typeof width === 'number' && { width }),
     ...(typeof height === 'number' && { height }),
     ...(typeof scale === 'number' && { scale }),
-  });
+  } as any);
 }
 
 function imagesFromJsonLd(raw: unknown): FigureImage[] {
@@ -96,5 +96,5 @@ export function figureFromJsonLd(doc: Record<string, unknown>): Figure | null {
     ...(description && { description }),
     ...(subfigures && { subfigures }),
     ...(sources.length && { sources }),
-  });
+  } as any);
 }

package/src/adapters/non-verbal/formula-bridge.ts

@@ -40,11 +40,11 @@ export function formulaFromJsonLd(doc: Record<string, unknown>): Formula | null
 
   return new Formula({
     id,
-    expression,
+    expression: expression as any,
     notation,
     ...(identifier && { identifier }),
     ...(caption && { caption }),
     ...(description && { description }),
     ...(sources.length && { sources }),
-  });
+  } as any);
 }

package/src/adapters/non-verbal/table-bridge.ts

@@ -90,11 +90,11 @@ export function tableFromJsonLd(doc: Record<string, unknown>): Table | null {
 
   return new Table({
     id,
-    content: content as Record<string, unknown>,
+    content: content as any,
     ...(identifier && { identifier }),
     ...(caption && { caption }),
     ...(description && { description }),
     ...(format && { format }),
     ...(sources.length && { sources }),
-  });
+  } as any);
 }

package/src/components/CitationDisplay.vue

@@ -107,7 +107,7 @@ async function loadPreview() {
     const def = lc?.definitions?.[0]?.content || concept.definition('eng');
     const term = lc?.terms?.[0]?.designation || concept.primaryDesignation('eng');
     preview.value = {
-      designation: term || entry?.designations?.eng || conceptId,
+      designation: String(term || entry?.designations?.eng || conceptId),
       definition: typeof def === 'string' ? def.slice(0, 200) : '',
     };
   } catch {