@glossarist/concept-browser 0.4.18 → 0.5.1

package/README.md

@@ -291,6 +291,38 @@ BASE_PATH=/vocab/ npm run build
 
 This sets the Vite `base` config so all asset paths are prefixed correctly.
 
+**How it works:**
+
+The `BASE_PATH` environment variable controls subpath deployment through two mechanisms:
+
+1. **Build time (Node.js scripts):** `generate-data.mjs` uses `BASE_PATH` to prefix logo paths in the generated `site-config.json`. The favicon generation in `cli/index.mjs` also prefixes favicon link hrefs. These are build-time rewrites because they produce static JSON/HTML that can't use Vite's runtime resolution.
+
+2. **Runtime (browser):** The Vue app uses `import.meta.env.BASE_URL` (a Vite compile-time constant derived from `base`) to prefix all `fetch()` paths. This includes:
+   - `datasets.json` (dataset registry)
+   - `site-config.json` (branding, features)
+   - `data/{id}/...` (concept data via `DatasetAdapter`)
+   - `pages/*.json` (content pages)
+   - `news.json` (news feed)
+   - `data/{id}/bibliography.json` and `data/{id}/images/*` (render-time resources)
+
+The Vite `base` config normalizes trailing slashes automatically, so `BASE_PATH=/vocab` and `BASE_PATH=/vocab/` both work. The value is passed through to `import.meta.env.BASE_URL` which always ends with `/`.
+
+**CLI usage:**
+
+When using the `concept-browser` CLI from a deployment repo (not the package source):
+
+```bash
+git clone --branch fix/subpath-base-url --depth 1 https://github.com/glossarist/concept-browser.git /tmp/cb
+cd /tmp/cb && npm install --ignore-scripts
+npm install --prefix /tmp/cb sharp 2>/dev/null || true
+
+# Build from the deployment repo's working directory
+cd /path/to/deployment-repo
+node /tmp/cb/cli/index.mjs build
+```
+
+The CLI looks for `site-config.yml` in the CWD first, then falls back to the package's own `site-config.yml`.
+
 ### Other hosting platforms
 
 The build produces static files in `dist/` with an SPA `404.html` fallback. Deploy `dist/` to any static host:

package/cli/index.mjs

@@ -141,6 +141,10 @@ Environment:
 
     // Pass favicon tags to Vite via env
     if (faviconHtml) {
+      const basePath = process.env.BASE_PATH?.replace(/\/+$/, '') || '';
+      if (basePath) {
+        faviconHtml = faviconHtml.replace(/(href|content)="\/([^"]+)"/g, `$1="${basePath}/$2"`);
+      }
       process.env.FAVICON_HTML = faviconHtml;
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glossarist/concept-browser",
-  "version": "0.4.18",
+  "version": "0.5.1",
   "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

@@ -1063,10 +1063,11 @@ const processedPages = processPages(config);
 // Generate site-config.json from site config
 const siteBranding = { ...config.branding };
 // Rewrite logo paths to destination filenames and strip build-time fields
+const basePathPrefix = process.env.BASE_PATH?.replace(/\/+$/, '') || '';
 for (const key of ['logo', 'footerLogo']) {
   const suffix = key === 'logo' ? 'logo.svg' : 'footer-logo.svg';
   if (siteBranding[key]) {
-    siteBranding[key] = { ...siteBranding[key], path: `/logos/${config.id}-${suffix}` };
+    siteBranding[key] = { ...siteBranding[key], path: `${basePathPrefix}/logos/${config.id}-${suffix}` };
     delete siteBranding[key].localPath;
     delete siteBranding[key].remoteUrl;
   }

package/src/adapters/factory.ts

@@ -18,9 +18,10 @@ export class AdapterFactory {
     if (!resp.ok) throw new Error(`Failed to load dataset registry: ${resp.status}`);
     const registry = (await resp.json()) as DatasetRegistry[];
 
+    const base = import.meta.env.BASE_URL;
     const adapters: DatasetAdapter[] = [];
     for (const reg of registry) {
-      const adapter = new DatasetAdapter(reg.id, `/data/${reg.id}`);
+      const adapter = new DatasetAdapter(reg.id, `${base}data/${reg.id}`);
       this.adapters.set(reg.id, adapter);
       adapters.push(adapter);
     }
@@ -45,7 +46,7 @@ export class AdapterFactory {
     const manifest = await adapter.loadManifest();
     await adapter.loadIndex();
 
-    this.router.registerDataset(registerId, `/data/${registerId}`, manifest);
+    this.router.registerDataset(registerId, `${import.meta.env.BASE_URL}data/${registerId}`, manifest);
 
     const uriPatterns = [
       manifest.datasetUri,

package/src/composables/use-render-options.ts

@@ -14,7 +14,7 @@ const bibCache = new Map<string, Record<string, BibEntry>>();
 async function loadBibliography(registerId: string): Promise<Record<string, BibEntry> | null> {
   if (bibCache.has(registerId)) return bibCache.get(registerId)!;
   try {
-    const resp = await fetch(`/data/${registerId}/bibliography.json`);
+    const resp = await fetch(`${import.meta.env.BASE_URL}data/${registerId}/bibliography.json`);
     if (!resp.ok) return null;
     const data = await resp.json();
     bibCache.set(registerId, data);
@@ -47,7 +47,7 @@ export function useRenderOptions(registerId: () => string) {
 
   const figResolver: FigResolver = (figId) => {
     const id = registerId();
-    const imgSrc = `/data/${id}/images/${figId}.png`;
+    const imgSrc = `${import.meta.env.BASE_URL}data/${id}/images/${figId}.png`;
     return `<span class="fig-ref"><a href="${escapeAttr(imgSrc)}" target="_blank" rel="noopener">${escapeAttr(figId)}</a></span>`;
   };
 

package/src/config/use-site-config.ts

@@ -94,7 +94,7 @@ function applyBranding(config: RuntimeSiteConfig) {
 async function loadConfig(): Promise<RuntimeSiteConfig | null> {
   if (loaded.value) return siteConfig.value;
   try {
-    const resp = await fetch('/site-config.json');
+    const resp = await fetch(`${import.meta.env.BASE_URL}site-config.json`);
     if (resp.ok) {
       siteConfig.value = await resp.json();
       if (siteConfig.value) applyBranding(siteConfig.value);

package/src/stores/vocabulary.ts

@@ -52,7 +52,7 @@ export const useVocabularyStore = defineStore('vocabulary', () => {
     loading.value = true;
     error.value = null;
     try {
-      const adapters = await factory.discoverDatasets('/datasets.json');
+      const adapters = await factory.discoverDatasets(`${import.meta.env.BASE_URL}datasets.json`);
       for (const adapter of adapters) {
         datasets.value.set(adapter.registerId, adapter);
         if (adapter.manifest) {

package/src/views/NewsView.vue

@@ -23,7 +23,7 @@ const activeLoading = ref(false);
 
 onMounted(async () => {
   try {
-    const resp = await fetch('/news.json');
+    const resp = await fetch(`${import.meta.env.BASE_URL}news.json`);
     if (resp.ok) posts.value = await resp.json();
   } catch (e: any) {
     error.value = e.message;

package/src/views/PageView.vue

@@ -23,9 +23,10 @@ onMounted(async () => {
   const page = pageName.value;
   const dsId = registerId.value;
 
+  const base = import.meta.env.BASE_URL;
   const urls = dsId
-    ? [`/pages/${dsId}-${page}.json`, `/pages/${page}.json`]
-    : [`/pages/${page}.json`];
+    ? [`${base}pages/${dsId}-${page}.json`, `${base}pages/${page}.json`]
+    : [`${base}pages/${page}.json`];
 
   for (const url of urls) {
     try {