@glossarist/concept-browser 0.7.63 → 0.7.65

package/package.json

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

package/scripts/build-edges.js

@@ -49,7 +49,8 @@ function extractReferences(concept, registerId) {
 }
 
 function extractDomains(concept, registerId, uriBase) {
-  const base = uriBase || 'https://glossarist.org';
+  if (!uriBase) throw new Error('build-edges: uriBase is required — set uriBase in site-config.yml');
+  const base = uriBase;
   const edges = [];
   const sourceUri = concept['@id'];
   const seen = new Set();
@@ -188,7 +189,8 @@ function buildEdgesForDataset(datasetDir, registerId, uriBase, urnMap, manifest)
   // Build domain-nodes.json from manifest sections (authoritative source)
   const manifestSections = manifest.sections;
   if (manifestSections && manifestSections.length > 0) {
-    const uriBase = manifest.uriBase || 'https://glossarist.org';
+    const uriBase = manifest.uriBase;
+    if (!uriBase) throw new Error('build-edges: manifest.uriBase is required');
 
     function buildSectionNode(section, idx) {
       const sectionId = `section-${section.id}`;
@@ -293,7 +295,8 @@ for (const ds of datasets) {
   if (!manifest) continue;
   try {
     console.log(`${manifest.title} (${ds}):`);
-    const uriBase = manifest.uriBase || 'https://glossarist.org';
+    const uriBase = manifest.uriBase;
+    if (!uriBase) throw new Error('build-edges: manifest.uriBase is required');
     const result = buildEdgesForDataset(join(DATA_DIR, ds), ds, uriBase, urnMap, manifest);
     allDatasetEdges.set(ds, result.edges);
     allSourceRefs.push(...result.sourceRefs);
@@ -347,7 +350,8 @@ if (auditUnmatched.size > 0) {
 // edges.json contains edges targeting that dataset's URIs.
 const datasetUriPrefixes = new Map();
 for (const [ds, manifest] of manifestCache) {
-  const uriBase = manifest.uriBase || 'https://glossarist.org';
+  const uriBase = manifest.uriBase;
+    if (!uriBase) throw new Error('build-edges: manifest.uriBase is required');
   datasetUriPrefixes.set(ds, `${uriBase}/${ds}/`);
 }
 

package/scripts/generate-data.mjs

@@ -92,7 +92,8 @@ function writeJson(filePath, data) {
 }
 
 async function writeDatasetRdf(register, manifest, concepts, refMaps, opts) {
-  const uriBase = refMaps?.uriBase ?? 'https://glossarist.org';
+  const uriBase = refMaps?.uriBase;
+  if (!uriBase) throw new Error('generate-data: uriBase is required — set uriBase in site-config.yml');
   const datasetIri = `${uriBase}/${register}/`;
   const topConceptUris = concepts
     .slice(0, 32)
@@ -139,7 +140,7 @@ async function writeDatasetRdf(register, manifest, concepts, refMaps, opts) {
   fs.writeFileSync(path.join(DATA, register, `${register}.ttl`), ttl);
 }
 
-async function writeBuildActivity(conceptCount, datasetRegisters) {
+async function writeBuildActivity(conceptCount, datasetRegisters, baseUri) {
   const runId = process.env.GITHUB_RUN_ID
     ? `${process.env.GITHUB_RUN_ID}-${process.env.GITHUB_RUN_ATTEMPT ?? '1'}`
     : `local-${new Date().toISOString().replace(/[:.]/g, '-')}`;
@@ -161,6 +162,7 @@ async function writeBuildActivity(conceptCount, datasetRegisters) {
     datasetRegisters,
     conceptCount,
     associatedAgentIri: agentIri,
+    baseUri,
   });
   const activityDir = path.join(DATA, 'activity');
   fs.mkdirSync(activityDir, { recursive: true });
@@ -375,7 +377,8 @@ function buildRefMaps(config, registerCache) {
   const xref = config.crossReferences || {};
   if (xref.refPrefixMap) Object.assign(refPrefixMap, xref.refPrefixMap);
 
-  const uriBase = config.uriBase || `https://${config.domain}`;
+  const uriBase = config.uriBase;
+  if (!uriBase) throw new Error('site-config.yml: uriBase is required');
   return { patternIndex, refPrefixMap, uriBase, register: null };
 }
 
@@ -1610,14 +1613,14 @@ for (const [id, count] of Object.entries(counts)) {
   console.log(`  ${id}: ${count} concepts`);
 }
 
-await writeBuildActivity(total, registry.map(r => r.id));
+await writeBuildActivity(total, registry.map(r => r.id), refMaps.uriBase);
 
 fs.writeFileSync(path.join(DATA, '_vocab.ttl'), await buildVocabularyTurtle());
 console.log('Emitted vocabulary graph: data/_vocab.ttl');
 
 const contributors = config.contributors ?? [];
 if (contributors.length > 0) {
-  fs.writeFileSync(path.join(DATA, 'agents.ttl'), await buildAgentsTurtle(contributors));
+  fs.writeFileSync(path.join(DATA, 'agents.ttl'), await buildAgentsTurtle(contributors, refMaps.uriBase + '/agent'));
   console.log(`Emitted agents graph: data/agents.ttl (${contributors.length} contributors)`);
 }
 
@@ -1626,7 +1629,7 @@ for (const ds of registry) {
   const bibPath = path.join(DATA, ds.id, 'bibliography.json');
   if (fs.existsSync(bibPath)) {
     const bibJson = JSON.parse(fs.readFileSync(bibPath, 'utf8'));
-    const bibTtl = await buildBibliographyTurtle(ds.id, bibJson);
+    const bibTtl = await buildBibliographyTurtle(ds.id, bibJson, refMaps.uriBase);
     fs.writeFileSync(path.join(DATA, ds.id, 'bib.ttl'), bibTtl);
   }
 }

package/scripts/lib/agents-turtle.mjs

@@ -19,7 +19,8 @@ function writerPrefixes() {
   };
 }
 
-export async function buildAgentsTurtle(contributors, agentBase = 'https://glossarist.org/agent') {
+export async function buildAgentsTurtle(contributors, agentBase) {
+  if (!agentBase) throw new Error('buildAgentsTurtle requires agentBase');
   const agents = agentsFromContributors(contributors ?? [], agentBase);
   const quads = collectQuads(agentsToQuads(agents));
   return writeTurtle(quads, { prefixes: writerPrefixes() });

package/scripts/lib/bibliography-turtle.mjs

@@ -10,7 +10,7 @@ import {
   writeTurtle,
 } from 'glossarist/rdf';
 
-const DEFAULT_BASE_URI = 'https://glossarist.org';
+// No hardcoded default base URI — callers MUST pass it.
 
 function writerPrefixes() {
   return {
@@ -22,7 +22,8 @@ function writerPrefixes() {
 
 export { normalizeBibliographyData };
 
-export async function buildBibliographyTurtle(register, bibliographyJson, baseUri = DEFAULT_BASE_URI) {
+export async function buildBibliographyTurtle(register, bibliographyJson, baseUri) {
+  if (!baseUri) throw new Error('buildBibliographyTurtle requires baseUri');
   const entries = normalizeBibliographyData(bibliographyJson);
   const quads = collectQuads(bibliographyToQuads({ registerId: register, entries, baseUri }));
   return writeTurtle(quads, { prefixes: writerPrefixes() });

package/src/__tests__/dataset-adapter.test.ts

@@ -19,6 +19,7 @@ describe('DatasetAdapter', () => {
 
   beforeEach(() => {
     adapter = new DatasetAdapter('test', '/data/test');
+    adapter.manifest = { uriBase: 'https://glossarist.org' } as any;
     mockFetch.mockReset();
   });
 

package/src/__tests__/scripts/agents-turtle.test.ts

@@ -16,13 +16,13 @@ const RDF_TYPE = 'http://www.w3.org/1999/02/22-rdf-syntax-ns#type';
 
 describe('buildAgentsTurtle (mjs)', () => {
   it('parses without errors', async () => {
-    const ttl = await buildAgentsTurtle([{ name: 'Ada Lovelace' }]);
+    const ttl = await buildAgentsTurtle([{ name: 'Ada Lovelace' }], 'https://glossarist.org/agent');
     const store = parse(ttl);
     expect(store.size).toBeGreaterThan(0);
   });
 
   it('types each person as foaf:Person, prov:Person, prov:Agent', async () => {
-    const ttl = await buildAgentsTurtle([{ name: 'Ada Lovelace' }]);
+    const ttl = await buildAgentsTurtle([{ name: 'Ada Lovelace' }], 'https://glossarist.org/agent');
     const store = parse(ttl);
     const types = store.getObjects('https://glossarist.org/agent/ada-lovelace', RDF_TYPE, null).map(q => q.value);
     expect(types).toContain(`${FOAF}Person`);
@@ -33,7 +33,7 @@ describe('buildAgentsTurtle (mjs)', () => {
   it('records name, mailto mbox, role, and seeAlso', async () => {
     const ttl = await buildAgentsTurtle([
       { name: 'Ada Lovelace', email: 'ada@example.org', role: 'Editor', url: 'https://example.org/ada' },
-    ]);
+    ], 'https://glossarist.org/agent');
     const store = parse(ttl);
     const iri = 'https://glossarist.org/agent/ada-lovelace';
     expect(store.getObjects(iri, `${FOAF}name`, null).map(q => q.value)).toContain('Ada Lovelace');
@@ -46,7 +46,7 @@ describe('buildAgentsTurtle (mjs)', () => {
     const ttl = await buildAgentsTurtle([
       { name: 'Alice', organization: 'ISO' },
       { name: 'Bob',   organization: 'ISO' },
-    ]);
+    ], 'https://glossarist.org/agent');
     const store = parse(ttl);
     const types = store.getObjects('https://glossarist.org/org/iso', RDF_TYPE, null).map(q => q.value);
     expect(types).toContain(`${FOAF}Organization`);
@@ -54,7 +54,7 @@ describe('buildAgentsTurtle (mjs)', () => {
   });
 
   it('emits only prefix declarations for an empty input', async () => {
-    const ttl = await buildAgentsTurtle([]);
+    const ttl = await buildAgentsTurtle([], 'https://glossarist.org/agent');
     expect(ttl).toContain('@prefix foaf:');
     expect(ttl).not.toContain('<https://glossarist.org/agent/');
   });

package/src/__tests__/scripts/bibliography-turtle.test.ts

@@ -15,13 +15,13 @@ function parse(turtle: string): Store {
 
 describe('buildBibliographyTurtle (mjs)', () => {
   it('parses without errors', async () => {
-    const ttl = await buildBibliographyTurtle('iso-geodetic', { iso704: { reference: 'ISO 704' } });
+    const ttl = await buildBibliographyTurtle('iso-geodetic', { iso704: { reference: 'ISO 704' } }, 'https://glossarist.org');
     const store = parse(ttl);
     expect(store.size).toBeGreaterThan(0);
   });
 
   it('types each entry as dcterms:BibliographicResource', async () => {
-    const ttl = await buildBibliographyTurtle('iso-geodetic', { iso704: { reference: 'ISO 704' } });
+    const ttl = await buildBibliographyTurtle('iso-geodetic', { iso704: { reference: 'ISO 704' } }, 'https://glossarist.org');
     const store = parse(ttl);
     const types = store.getObjects('https://glossarist.org/iso-geodetic/bib/iso704', RDF_TYPE, null).map(q => q.value);
     expect(types).toContain(`${DCTERMS}BibliographicResource`);
@@ -30,7 +30,7 @@ describe('buildBibliographyTurtle (mjs)', () => {
   it('emits identifier, bibliographicCitation, and title', async () => {
     const ttl = await buildBibliographyTurtle('iso-geodetic', {
       iso704: { reference: 'ISO 704', title: 'Terminology work — Principles and methods' },
-    });
+    }, 'https://glossarist.org');
     const store = parse(ttl);
     const iri = 'https://glossarist.org/iso-geodetic/bib/iso704';
     expect(store.getObjects(iri, `${DCTERMS}identifier`, null).map(q => q.value)).toContain('iso704');
@@ -41,7 +41,7 @@ describe('buildBibliographyTurtle (mjs)', () => {
   it('emits foaf:page when link is provided', async () => {
     const ttl = await buildBibliographyTurtle('iso-geodetic', {
       ref: { reference: 'X', link: 'https://example.org/x' },
-    });
+    }, 'https://glossarist.org');
     const store = parse(ttl);
     const iri = 'https://glossarist.org/iso-geodetic/bib/ref';
     expect(store.getObjects(iri, `${FOAF}page`, null).map(q => q.value)).toContain('https://example.org/x');
@@ -51,7 +51,7 @@ describe('buildBibliographyTurtle (mjs)', () => {
     const ttl = await buildBibliographyTurtle('iso-geodetic', {
       a: { reference: 'A' },
       b: { reference: 'B' },
-    });
+    }, 'https://glossarist.org');
     const store = parse(ttl);
     expect(store.getObjects('https://glossarist.org/iso-geodetic/bib/a', `${DCTERMS}bibliographicCitation`, null).map(q => q.value)).toContain('A');
     expect(store.getObjects('https://glossarist.org/iso-geodetic/bib/b', `${DCTERMS}bibliographicCitation`, null).map(q => q.value)).toContain('B');

package/src/__tests__/scripts/build-integration.test.ts

@@ -61,7 +61,7 @@ describe('WS F Layer 8 — build pipeline integration', () => {
   it('agents-turtle.mjs produces parseable foaf:Person', () => {
     const out = runInline(`
       import { buildAgentsTurtle } from './scripts/lib/agents-turtle.mjs';
-      console.log(await buildAgentsTurtle([{ name: 'Ada Lovelace', role: 'Editor', organization: 'Royal Society' }]));
+      console.log(await buildAgentsTurtle([{ name: 'Ada Lovelace', role: 'Editor', organization: 'Royal Society' }], 'https://glossarist.org/agent'));
     `);
     const store = parseTurtle(out);
     const persons = [...store].filter(q =>
@@ -74,7 +74,7 @@ describe('WS F Layer 8 — build pipeline integration', () => {
   it('bibliography-turtle.mjs produces parseable dcterms:BibliographicResource', () => {
     const out = runInline(`
       import { buildBibliographyTurtle } from './scripts/lib/bibliography-turtle.mjs';
-      console.log(await buildBibliographyTurtle('test', { iso704: { reference: 'ISO 704' } }));
+      console.log(await buildBibliographyTurtle('test', { iso704: { reference: 'ISO 704' } }, 'https://glossarist.org'));
     `);
     const store = parseTurtle(out);
     const bibs = [...store].filter(q =>
@@ -122,8 +122,8 @@ describe('WS F Layer 8 — build pipeline integration', () => {
         await buildVocabularyTurtle(),
         await buildDatasetTurtle({ datasetIri: 'https://glossarist.org/test/', registerId: 'test', title: 't', modified: '2026-01-01', languages: ['eng'], distributions: [], topConceptUris: [], sections: [] }),
         await buildActivityTurtle({ runId: 'r', startedAt: '2026-01-01T00:00:00Z', endedAt: '2026-01-01T00:05:00Z', toolId: 'cb', toolVersion: '0', datasetRegisters: [], conceptCount: 0 }),
-        await buildAgentsTurtle([{ name: 'Ada' }]),
-        await buildBibliographyTurtle('test', { x: { reference: 'X' } }),
+        await buildAgentsTurtle([{ name: 'Ada' }], 'https://glossarist.org/agent'),
+        await buildBibliographyTurtle('test', { x: { reference: 'X' } }, 'https://glossarist.org'),
         await buildVersionHistoryTurtle({ registerId: 't', datasetIri: 'https://glossarist.org/t/', versions: [{ version: '1', generatedAt: '2026-01-01' }] }),
       ];
       console.log(parts.join('\\n'));

package/src/__tests__/test-helpers.ts

@@ -38,6 +38,7 @@ export function makeManifest(overrides: Partial<Manifest> = {}): Manifest {
 
 export interface AdapterStubOptions {
   concepts?: ConceptSummary[];
+  manifest?: Manifest | null;
   search?: () => SearchHit[];
   fetchConcept?: () => Promise<any>;
   getAdjacentConcepts?: () => { prev: string | null; next: string | null };
@@ -55,7 +56,7 @@ export interface AdapterStubOptions {
 export function makeAdapterStub(options: AdapterStubOptions = {}): any {
   return {
     index: options.concepts ?? [],
-    manifest: null,
+    manifest: options.manifest ?? makeManifest(),
     registerId: 'test',
     getConceptCount: () => (options.concepts ?? []).length,
     getConcepts: () => options.concepts ?? [],

package/src/adapters/GraphDataSource.ts

@@ -42,7 +42,9 @@ export class GraphDataSource {
   }
 
   private get uriBase(): string {
-    return this.adapter.manifest?.uriBase || 'https://glossarist.org';
+    const uriBase = this.adapter.manifest?.uriBase;
+    if (!uriBase) throw new Error('GraphDataSource: manifest.uriBase is required');
+    return uriBase;
   }
 
   private get urnMap(): ReadonlyMap<string, string> {

package/src/components/RelationSphere.vue

@@ -113,7 +113,8 @@ let navDuration = 2200;  /* mutable — shorter for expand changes than for conc
 async function loadNeighborTerms() {
   const factory = getFactory();
   const lang = sphereLang.value;
-  const uriBase = props.manifest.uriBase || 'https://glossarist.org';
+  const uriBase = props.manifest.uriBase;
+  if (!uriBase) throw new Error('RelationSphere: manifest.uriBase is required');
   const neighborRegisters = new Set<string>();
 
   /* Phase 1: collect which neighbor datasets we need to load */

package/src/stores/vocabulary.ts

@@ -207,7 +207,8 @@ export const useVocabularyStore = defineStore('vocabulary', () => {
       // We do NOT call adapter.extractEdges(concept) here because that would duplicate
       // edges already present in edges.json, causing double-rendering of relations.
       const domainEdges = adapter.extractDomainEdges(concept);
-      const uriBase = adapter.manifest?.uriBase || 'https://glossarist.org';
+      const uriBase = adapter.manifest?.uriBase;
+      if (!uriBase) throw new Error('vocabulary store: manifest.uriBase is required — set uriBase in site-config.yml');
       const uri = conceptUri(concept, registerId, uriBase);
 
       const designations: Record<string, string> = {};