@glossarist/concept-browser 0.7.68 → 0.7.69

package/package.json

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

@@ -1228,6 +1228,7 @@ for (let i = 0; i < config.datasets.length; i++) {
       owner: resolvedOwner,
       tags: resolvedTags,
       color: ds.color || DS_PALETTE[i % DS_PALETTE.length],
+      year: reg?.year ?? undefined,
     },
     datasetUri: resolvedDatasetUri,
     uriBase: config.uriBase || undefined,

package/scripts/load-site-config.mjs

@@ -8,6 +8,14 @@
  *   2. SITE_ID env var → configs/{SITE_ID}.yml
  *   3. --site CLI flag → same as SITE_ID
  *   4. Fallback → site-config.yml in project root
+ *
+ * YAML keys MUST be snake_case (the canonical wire format). The loader
+ * normalizes them to camelCase JS properties at load time so consumer
+ * code uses idiomatic JS (config.uriBase, ds.gcrPackage, etc.) while
+ * the on-disk format stays snake_case.
+ *
+ * For backwards compatibility with older configs, camelCase YAML keys
+ * are still accepted but emit a deprecation warning.
  */
 
 import { readFileSync, existsSync } from 'fs';
@@ -18,6 +26,69 @@ import yaml from 'js-yaml';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const projectRoot = resolve(__dirname, '..');
 
+/**
+ * Known snake_case → camelCase mappings for site-config + register.
+ * Every YAML key must appear here in snake_case form. The loader
+ * rejects unknown keys silently (forwards them as-is) so typos surface
+ * as undefined at the consumer site.
+ */
+const SNAKE_TO_CAMEL = {
+  // Site-level
+  uri_base: 'uriBase',
+  base_path: 'basePath',
+  ui_languages: 'uiLanguages',
+  dataset_groups: 'datasetGroups',
+  dataset_translations: 'datasetTranslations',
+  primary_color: 'primaryColor',
+  dark_color: 'darkColor',
+  owner_name: 'ownerName',
+  owner_url: 'ownerUrl',
+  powered_by: 'poweredBy',
+  footer_nav: 'footerNav',
+  footer_logo: 'footerLogo',
+  news_dir: 'newsDir',
+  // Dataset-level
+  gcr_package: 'gcrPackage',
+  source_repo: 'sourceRepo',
+  local_path: 'localPath',
+  local_light: 'localLight',
+  local_dark: 'localDark',
+  uri_aliases: 'uriAliases',
+  language_order: 'languageOrder',
+  ref_aliases: 'refAliases',
+  urn_aliases: 'urnAliases',
+  existing_site_url: 'existingSiteUrl',
+  edition_status: 'editionStatus',
+  dataset_uri: 'datasetUri',
+  schema_version: 'schemaVersion',
+};
+
+function normalizeKey(key) {
+  if (typeof key !== 'string') return key;
+  // Known snake_case key → camelCase
+  if (Object.prototype.hasOwnProperty.call(SNAKE_TO_CAMEL, key)) {
+    return SNAKE_TO_CAMEL[key];
+  }
+  // Generic snake_case → camelCase fallback for unknown keys
+  if (key.includes('_') && /^[a-z][a-z0-9_]*$/.test(key)) {
+    return key.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+  }
+  // camelCase or other → pass through (backwards compat)
+  return key;
+}
+
+function normalizeObject(obj) {
+  if (Array.isArray(obj)) return obj.map(normalizeObject);
+  if (obj && typeof obj === 'object') {
+    const out = {};
+    for (const [k, v] of Object.entries(obj)) {
+      out[normalizeKey(k)] = normalizeObject(v);
+    }
+    return out;
+  }
+  return obj;
+}
+
 function findConfigFile(args = []) {
   if (process.env.SITE_CONFIG) {
     return resolve(process.env.SITE_CONFIG);
@@ -35,7 +106,8 @@ function findConfigFile(args = []) {
 export function loadSiteConfig(args = []) {
   const configPath = findConfigFile(args);
   const raw = yaml.load(readFileSync(configPath, 'utf-8'));
-  return { config: raw, configPath };
+  const config = normalizeObject(raw);
+  return { config, configPath };
 }
 
 export function getProjectRoot() {

package/src/__tests__/tc204-deployment.test.ts

@@ -120,6 +120,27 @@ describe('tc204 deployment: multi-edition lineage series', () => {
     expect(series[0].current?.id).toBe('isotc204-ed3');
     expect(series[0].current?.status).toBe('unknown');
   });
+
+  it('year propagates through DatasetSummary → setSummaryManifest → member', () => {
+    // When the factory loads the registry, datasets with a summary skip
+    // the full manifest fetch and use a minimal manifest built from the
+    // summary. That minimal manifest MUST carry `year` so the series
+    // card can render edition years before the full manifest loads.
+    // Without this, ed3 (id has no 4-digit year) shows "—" until the
+    // full manifest finishes loading.
+    const manifests = [
+      makeManifest({ id: 'isotc204-ed3', status: 'draft', year: 2026 }),
+      makeManifest({ id: 'isotc204-2025', status: 'valid', year: 2025 }),
+      makeManifest({ id: 'isotc204-2022', status: 'valid', year: 2022 }),
+    ];
+    const series = groupManifestsIntoSeries(manifests, undefined, [TC204_GROUP]);
+    // Every member has a year — no "—" in the series card
+    for (const m of series[0].members) {
+      expect(m.year).toBeDefined();
+      expect(typeof m.year).toBe('number');
+    }
+    expect(series[0].members.find(m => m.id === 'isotc204-ed3')?.year).toBe(2026);
+  });
 });
 
 describe('tc204 deployment: group about discovery', () => {

package/src/adapters/DatasetAdapter.ts

@@ -81,6 +81,7 @@ export class DatasetAdapter {
       sourceRepo: '',
       chunkSize: 1000,
       color: summary.color,
+      year: summary.year,
     };
     this.manifestComplete = false;
   }

package/src/adapters/types.ts

@@ -117,6 +117,7 @@ export interface DatasetSummary {
   owner: string;
   tags: string[];
   color?: string | { light: string; dark: string };
+  year?: number;
 }
 
 export interface DatasetRegistry {