From 1f24b96e91d69ef4bc41e7d616669e0eb00a60d0 Mon Sep 17 00:00:00 2001
From: Boris De Vloed <boris.de.vloed@gmail.com>
Date: Sun, 21 Jun 2026 21:34:38 +0200
Subject: [PATCH] source ref labels

---
 scripts/04_build_maps.py      |   2 +
 scripts/_lib/assets/app.js    | 161 ++++++++++++++++++++++++--
 scripts/_lib/content_block.py | 210 +++++++++++++++++++++++++++++++++-
 scripts/_lib/map_template.py  |  16 ++-
 tests/test_content_block.py   |  87 ++++++++++++++
 5 files changed, 464 insertions(+), 12 deletions(-)

diff --git a/scripts/04_build_maps.py b/scripts/04_build_maps.py
index 022a5a6..38737ee 100644
--- a/scripts/04_build_maps.py
+++ b/scripts/04_build_maps.py
@@ -82,6 +82,7 @@
 from _lib.bg.region import derive_region as derive_bg_region
 from _lib.ch.geometry import CHCommuneIndex, GESitgIndex
 from _lib.ch.geometry import resolve as ch_resolve_geometry
+from _lib.ch.canton import canton_name as ch_canton_name
 from _lib.ch.region import derive_region as derive_ch_region
 from _lib.cy.geometry import CYPolygonIndex
 from _lib.cy.region import derive_region as derive_cy_region
@@ -3074,6 +3075,7 @@ def _sources_for(record: dict) -> dict:
         return {
             "country": "ch",
             "canton": record.get("canton") or "",
+            "canton_name": ch_canton_name(record.get("canton") or "") if record.get("canton") else "",
             "source_lang": record.get("source_lang") or "",
             "ofag_repertoire_url": ofag.get("url", ""),
             "ofag_repertoire_label": ofag.get("label", ""),
diff --git a/scripts/_lib/assets/app.js b/scripts/_lib/assets/app.js
index 62ccb21..4f341b3 100644
--- a/scripts/_lib/assets/app.js
+++ b/scripts/_lib/assets/app.js
@@ -48,6 +48,18 @@
     si: 'specifikacija proizvoda',
     hr: 'specifikacija proizvoda',
     ro: 'caiet de sarcini',
+    de: 'Produktspezifikation',
+    hu: 'termékleírás',
+    bg: 'продуктова спецификация',
+    gr: 'προδιαγραφή προϊόντος',
+    cy: 'τεχνικός φάκελος',
+    sk: 'špecifikácia výrobku',
+    cz: 'specifikace výrobku',
+    lu: 'cahier des charges',
+    be: 'enig document / document unique',
+    nl: 'enig document',
+    mt: 'single document',
+    ch: 'règlement cantonal',
   };
   const GRAPES_INFO = (window.__OWM_DATA && window.__OWM_DATA.grapes_info) || {};
   // Slug -> siblings sharing the same VIVC variety id. Used to make the
@@ -913,18 +925,29 @@
     applyFilter({ fit: true });
   });
 
-  // Keyboard/SR path to open an appellation's detail panel — the WebGL polygons
-  // aren't DOM-reachable, so the facet "open" button is the only non-mouse way
-  // in. preventDefault/stopPropagation stop the click from toggling the
-  // enclosing label's filter checkbox.
+  // Opening an appellation's detail panel from the filter tree, two ways:
+  //   • the `→` open button — the keyboard/SR path (the WebGL polygons aren't
+  //     DOM-reachable, so this is the only non-mouse way in), AND
+  //   • clicking the appellation NAME — the expected "show me this one" gesture,
+  //     matching a map click and the search dropdown.
+  // The leading checkbox stays a multi-select FILTER: a click landing on the
+  // input itself toggles it and is handled by the `change` listener, so we bail
+  // here. preventDefault stops the wrapping <label> from toggling that checkbox
+  // on a name/button click; stopPropagation keeps it off document-level handlers.
   document.getElementById('facet-appellations')?.addEventListener('click', e => {
     const btn = e.target.closest('.open-aoc');
-    if (!btn) return;
+    const label = e.target.closest('label[data-slug]');
+    // Open on the → button, or on the name text — but never on the checkbox
+    // (or blank row padding), which stays a pure filter toggle.
+    const onName = !btn && label && e.target.closest('.name');
+    if (!btn && !onName) return;
     e.preventDefault();
     e.stopPropagation();
-    const slug = btn.dataset.slug;
+    const slug = (btn || label).dataset.slug;
     if (!AOCS[slug]) return;
-    lastPanelTrigger = btn;
+    // Return focus on close to the row's → button (the only focusable element
+    // in the row) whether the open came from the button or the name (WCAG 2.4.3).
+    lastPanelTrigger = btn || (label && label.querySelector('.open-aoc')) || null;
     lastStackKey = slug;
     stackFocusIndex = 0;
     renderPanelStack([slug], 0);
@@ -1015,8 +1038,13 @@
   }
 
   function swapMapLayers() {
-    const advLayers = ['appellations-fill', 'appellations-outline'];
-    const vilLayers = ['appellations-fill-villages', 'appellations-outline-villages'];
+    // Halo layers must flip with their fill/outline siblings: the selection
+    // halo is a dark, wide stroke drawn UNDER the cream outline. If the
+    // inactive mode's halo stays visible it sits above the active mode's cream
+    // outline (later in draw order) and dims the selection — so simple mode
+    // looked far less clearly selected than advanced. Toggle all three.
+    const advLayers = ['appellations-fill', 'appellations-halo', 'appellations-outline'];
+    const vilLayers = ['appellations-fill-villages', 'appellations-halo-villages', 'appellations-outline-villages'];
     const showAdv = viewMode === 'advanced';
     for (const id of advLayers) {
       if (map.getLayer(id)) map.setLayoutProperty(id, 'visibility', showAdv ? 'visible' : 'none');
@@ -1873,6 +1901,120 @@
       `<div class="menzioni-chips">${chips}</div></details>`;
   }
 
+  // Native EU single-document term per country — the fallback regulator-doc
+  // when no national-spec key is present (regulator is then the eAmbrosia
+  // register, gated on id_eambrosia). Mirrors _EU_DOC_TERM in content_block.py.
+  const PROV_EU_DOC_TERM = {
+    es: 'documento único', it: 'documento unico', at: 'Einziges Dokument',
+    de: 'Einziges Dokument', si: 'enotni dokument', hr: 'jedinstveni dokument',
+    hu: 'egységes dokumentum', ro: 'document unic', bg: 'единен документ',
+    gr: 'ενιαίο έγγραφο', cy: 'ενιαίο έγγραφο', sk: 'jednotný dokument',
+    cz: 'jednotný dokument', nl: 'enig document', mt: 'single document',
+  };
+  const PROV_ORG_LABEL = {
+    'onvpv': 'ONVPV', 'iavv': 'ИАЛВ/IAVV', 'ypaat': 'ΥΠΑΑΤ',
+    'upv-sr': 'ÚPV SR', 'mprv-sr': 'MPRV SR', 'szpi': 'SZPI',
+    'agrarminiszterium': 'Agrárminisztérium', 'mkgp': 'MKGP',
+    'moa-cy': 'the Cyprus Department of Agriculture',
+  };
+  const PROV_NATIONAL = {
+    hu: ['Agrárminisztérium', 'termékleírás'],
+    ro: ['ONVPV', 'caiet de sarcini'],
+    bg: ['ИАЛВ/IAVV', 'продуктова спецификация'],
+    gr: ['ΥΠΑΑΤ', 'προδιαγραφή προϊόντος'],
+    sk: ['ÚPV SR', 'špecifikácia výrobku'],
+    cy: ['the Cyprus Department of Agriculture', 'τεχνικός φάκελος'],
+  };
+
+  // Mirror of content_block.py:_provenance_source — returns
+  // [regulatorHtml, docTerm, isRoster, extraHtml] or null.
+  function provenanceSource(r) {
+    const s = r.sources || {};
+    const country = r.country || 'fr';
+    const fileNumber = s.file_number || '';
+    const hasEambrosia = !!s.id_eambrosia;
+    const extra = fileNumber ? ` (${escapeHtml(fileNumber)})` : '';
+    const eambrosiaReg = LABELS.provenance_reg_eambrosia;
+    const euFallback = () => (s.eur_lex_url && hasEambrosia)
+      ? [eambrosiaReg, PROV_EU_DOC_TERM[country] || 'single document', false, extra] : null;
+
+    if (country === 'fr') {
+      if (s.boagri) {
+        const d = s.homologation_date || s.jorf_date || '';
+        return ['INAO', 'cahier des charges', false, d ? ` (${escapeHtml(d)})` : ''];
+      }
+      return null;
+    }
+    if (country === 'es') return s.national_pliego_url ? ['MAPA', 'pliego de condiciones', false, extra] : euFallback();
+    if (country === 'pt') return s.ivv_caderno_url ? ['IVV', 'caderno de especificações', false, extra] : null;
+    if (country === 'it') {
+      if (s.masaf_pdf_filename || s.masaf_filename) return ['MASAF', 'disciplinare di produzione', false, extra];
+      if (s.regional_register_url) return ['MASAF', 'disciplinare di produzione', true, extra];
+      return euFallback();
+    }
+    if (country === 'de') return s.ble_produktspezifikation_url ? ['BLE', 'Produktspezifikation', false, extra] : euFallback();
+    if (country === 'si') {
+      if (s.specifikacija_url) return [escapeHtml(PROV_ORG_LABEL[s.specifikacija_source_org] || 'MKGP'), 'specifikacija proizvoda', false, extra];
+      return euFallback();
+    }
+    if (country === 'hr') return s.specifikacija_url ? ['Ministarstvo poljoprivrede', 'specifikacija proizvoda', false, extra] : euFallback();
+    if (PROV_NATIONAL[country]) {
+      if (s.national_spec_url) {
+        const [defaultReg, doc] = PROV_NATIONAL[country];
+        return [escapeHtml(PROV_ORG_LABEL[s.national_spec_source_org] || defaultReg), doc, false, extra];
+      }
+      return euFallback();
+    }
+    if (country === 'cz') return (s.national_spec_url || s.chzo_spec_url) ? ['SZPI', 'specifikace výrobku', true, extra] : null;
+    if (country === 'lu') return s.cahier_url ? ['IVV', 'cahier des charges', false, extra] : null;
+    if (country === 'ch') {
+      if (s.cantonal_reglement_url && s.canton) {
+        const canton = s.canton_name || String(s.canton).toUpperCase();
+        const reg = fmt(LABELS.provenance_reg_canton, { canton: escapeHtml(canton) });
+        const doc = ({ de: 'kantonales Reglement', it: 'regolamento cantonale' })[s.source_lang || 'fr'] || 'règlement cantonal';
+        return [reg, doc, true, ''];
+      }
+      return null;
+    }
+    if (country === 'be') {
+      if (s.eur_lex_url && hasEambrosia) return [eambrosiaReg, s.source_lang === 'nl' ? 'enig document' : 'document unique', false, extra];
+      return null;
+    }
+    if (country === 'at' || country === 'nl' || country === 'mt') return euFallback();
+    return null;
+  }
+
+  // Drop the verbatim-cahier cruft the pills keep — the "— synonym" tail and
+  // the trailing OIV colour letter ("Durella B. - Durello" -> "Durella").
+  const PROV_SYN_SEP = /\s+[-—]\s+/;
+  const PROV_COLOUR_TAIL = /\s+(?:B|N|G|RS|RG)\.\s*$/i;
+  function provGrapeName(g) {
+    return grapeName(g).split(PROV_SYN_SEP)[0].replace(PROV_COLOUR_TAIL, '').trim();
+  }
+
+  function provenanceGrapeClause(r) {
+    const slugs = r.grapes_principal || [];
+    if (!slugs.length) return '';
+    // Clean lexicon names (not the verbatim cahier spelling) for prose; list
+    // all when <=4, else 3 + "and N other grape varieties" (N>=2).
+    const clean = g => escapeHtml(provGrapeName(g));
+    if (slugs.length <= 4) return slugs.map(clean).join(', ');
+    return fmt(LABELS.provenance_grapes_more, { names: slugs.slice(0, 3).map(clean).join(', '), n: slugs.length - 3 });
+  }
+
+  // Mirror of content_block.py:_provenance_line.
+  function provenanceLine(r) {
+    const resolved = provenanceSource(r);
+    if (!resolved) return '';
+    const [regulator, doc, isRoster, extra] = resolved;
+    const docEm = `<em>${escapeHtml(doc)}</em>`;
+    const grapes = isRoster ? '' : provenanceGrapeClause(r);
+    const sentence = grapes
+      ? fmt(LABELS.provenance_with_grapes, { regulator, doc: docEm, grapes })
+      : fmt(LABELS.provenance_bare, { regulator, doc: docEm, extra });
+    return `<p class="provenance-line">${sentence}</p>`;
+  }
+
   function renderAocCard(slug, isPrimary) {
     const r = AOCS[slug];
     if (!r) return '';
@@ -1992,6 +2134,7 @@
         ${dulokBlock}
         ${menzioniBlock}
         ${noteBlock}
+        ${(!factsBlock && !r.summary) ? provenanceLine(r) : ''}
         ${renderSources(slug, r.sources)}
       </div>
     `;
diff --git a/scripts/_lib/content_block.py b/scripts/_lib/content_block.py
index 22ae2c9..f6e4903 100644
--- a/scripts/_lib/content_block.py
+++ b/scripts/_lib/content_block.py
@@ -18,8 +18,12 @@
 Each helper mirrors its JS counterpart one-for-one (same HTML templates + the
 same escaping) so the two renderers stay aligned; ``tests/test_content_block.py``
 snapshots the output as a drift guard, and every ``<article>`` carries a
-``data-ssr-sig`` (a hash of its normalised text) for a runtime JS cross-check in
-a later phase.
+``data-ssr-sig`` (a hash of its normalised text) used only as a test-only
+determinism guard — the client panel removes ``#ssr-content`` at boot and
+re-renders from the record, so there is NO runtime signature cross-check. A
+change to one renderer that isn't mirrored in the other therefore fails
+silently as crawler-vs-user divergence, not a crash; the parity tests are the
+only guard.
 """
 
 from __future__ import annotations
@@ -40,6 +44,18 @@
     "si": "specifikacija proizvoda",
     "hr": "specifikacija proizvoda",
     "ro": "caiet de sarcini",
+    "de": "Produktspezifikation",
+    "hu": "termékleírás",
+    "bg": "продуктова спецификация",
+    "gr": "προδιαγραφή προϊόντος",
+    "cy": "τεχνικός φάκελος",
+    "sk": "špecifikácia výrobku",
+    "cz": "specifikace výrobku",
+    "lu": "cahier des charges",
+    "be": "enig document / document unique",
+    "nl": "enig document",
+    "mt": "single document",
+    "ch": "règlement cantonal",
 }
 
 FACTS_SUB_ORDER = ("facteurs_naturels", "facteurs_humains", "produit", "interactions")
@@ -422,6 +438,189 @@ def render_sources(sources: dict | None, ctx: RenderCtx) -> str:
     return f'<h2>{lab["panel_sources_h"]}</h2><ul class="sources">{"".join(links)}</ul>'
 
 
+# ------------------------------------------------------------ provenance line
+
+# Native source-document term for the EU single document, per country — the
+# FALLBACK when no more-specific national-spec key is present on the record.
+# Regulator is then "the EU eAmbrosia register" (gated on id_eambrosia).
+_EU_DOC_TERM = {
+    "es": "documento único", "it": "documento unico", "at": "Einziges Dokument",
+    "de": "Einziges Dokument", "si": "enotni dokument", "hr": "jedinstveni dokument",
+    "hu": "egységes dokumentum", "ro": "document unic", "bg": "единен документ",
+    "gr": "ενιαίο έγγραφο", "cy": "ενιαίο έγγραφο", "sk": "jednotný dokument",
+    "cz": "jednotný dokument", "nl": "enig document", "mt": "single document",
+}
+
+# national-spec source-org token → human regulator name (the literal token
+# `_sources_for` surfaces as *_source_org). Falls back to the per-country
+# default in `_provenance_source` when the token is absent/unknown.
+_PROV_ORG_LABEL = {
+    "onvpv": "ONVPV", "iavv": "ИАЛВ/IAVV", "ypaat": "ΥΠΑΑΤ",
+    "upv-sr": "ÚPV SR", "mprv-sr": "MPRV SR", "szpi": "SZPI",
+    "agrarminiszterium": "Agrárminisztérium", "mkgp": "MKGP",
+    "moa-cy": "the Cyprus Department of Agriculture",
+}
+
+# per-country national-spec defaults (regulator, native doc term) for the
+# countries whose provenance resolves from `national_spec_url`.
+_PROV_NATIONAL = {
+    "hu": ("Agrárminisztérium", "termékleírás"),
+    "ro": ("ONVPV", "caiet de sarcini"),
+    "bg": ("ИАЛВ/IAVV", "продуктова спецификация"),
+    "gr": ("ΥΠΑΑΤ", "προδιαγραφή προϊόντος"),
+    "sk": ("ÚPV SR", "špecifikácia výrobku"),
+    "cy": ("the Cyprus Department of Agriculture", "τεχνικός φάκελος"),
+}
+
+
+def _provenance_source(rec: dict, ctx: RenderCtx) -> tuple[str, str, bool, str] | None:
+    """Resolve ``(regulator_html, doc_term, is_roster, extra_html)`` for the
+    provenance line, mirroring ``_sources_for``'s most-specific-first cascade.
+
+    Returns ``None`` when no public regulator source resolves (no line shown).
+    ``is_roster`` True means the authorised-variety list is a national/regional
+    roster, NOT an appellation-specific authorisation (CZ national list, IT
+    regional register, CH cantonal règlement) — the grapes clause is then
+    suppressed so we never misattribute a country-wide roster as this
+    designation's own. ``extra_html`` is a short per-record differentiator
+    (registration ref / homologation date) appended only to the grapeless
+    skeleton, so the degenerate strings are not byte-identical across records.
+
+    ``regulator_html`` is render-ready (proper-noun acronyms are esc'd; the
+    descriptive fallbacks come from the gettext catalog so they localise).
+    """
+    s = rec.get("sources") or {}
+    country = rec.get("country") or "fr"
+    lab = ctx.labels
+    file_number = s.get("file_number") or ""
+    has_eambrosia = bool(s.get("id_eambrosia"))
+    extra = f" ({esc(file_number)})" if file_number else ""
+    eambrosia_reg = lab["provenance_reg_eambrosia"]
+
+    def eu_fallback() -> tuple[str, str, bool, str] | None:
+        if s.get("eur_lex_url") and has_eambrosia:
+            return (eambrosia_reg, _EU_DOC_TERM.get(country, "single document"), False, extra)
+        return None
+
+    if country == "fr":
+        if s.get("boagri"):
+            d = s.get("homologation_date") or s.get("jorf_date") or ""
+            return ("INAO", "cahier des charges", False, f" ({esc(d)})" if d else "")
+        return None
+    if country == "es":
+        if s.get("national_pliego_url"):
+            return ("MAPA", "pliego de condiciones", False, extra)
+        return eu_fallback()
+    if country == "pt":
+        return ("IVV", "caderno de especificações", False, extra) if s.get("ivv_caderno_url") else None
+    if country == "it":
+        if s.get("masaf_pdf_filename") or s.get("masaf_filename"):
+            return ("MASAF", "disciplinare di produzione", False, extra)
+        if s.get("regional_register_url"):
+            # varieties come from a region-wide register, not this IGT's spec
+            return ("MASAF", "disciplinare di produzione", True, extra)
+        return eu_fallback()
+    if country == "de":
+        if s.get("ble_produktspezifikation_url"):
+            return ("BLE", "Produktspezifikation", False, extra)
+        return eu_fallback()
+    if country == "si":
+        if s.get("specifikacija_url"):
+            reg = _PROV_ORG_LABEL.get(s.get("specifikacija_source_org"), "MKGP")
+            return (esc(reg), "specifikacija proizvoda", False, extra)
+        return eu_fallback()
+    if country == "hr":
+        if s.get("specifikacija_url"):
+            return ("Ministarstvo poljoprivrede", "specifikacija proizvoda", False, extra)
+        return eu_fallback()
+    if country in _PROV_NATIONAL:
+        if s.get("national_spec_url"):
+            default_reg, doc = _PROV_NATIONAL[country]
+            reg = _PROV_ORG_LABEL.get(s.get("national_spec_source_org"), default_reg)
+            return (esc(reg), doc, False, extra)
+        return eu_fallback()
+    if country == "cz":
+        # CZ authorises one national 67-variety list across every wine —
+        # always a roster, never an appellation-specific authorisation.
+        if s.get("national_spec_url") or s.get("chzo_spec_url"):
+            return ("SZPI", "specifikace výrobku", True, extra)
+        return None
+    if country == "lu":
+        return ("IVV", "cahier des charges", False, extra) if s.get("cahier_url") else None
+    if country == "ch":
+        # NON-EU — never the eAmbrosia register. Canton-level variety lists →
+        # roster (drop the grapes clause); the canton name differentiates.
+        if s.get("cantonal_reglement_url") and s.get("canton"):
+            canton = s.get("canton_name") or str(s["canton"]).upper()
+            reg = fmt(lab["provenance_reg_canton"], {"canton": esc(canton)})
+            doc = {"de": "kantonales Reglement", "it": "regolamento cantonale"}.get(
+                s.get("source_lang") or "fr", "règlement cantonal"
+            )
+            return (reg, doc, True, "")
+        return None
+    if country == "be":
+        if s.get("eur_lex_url") and has_eambrosia:
+            doc = "enig document" if s.get("source_lang") == "nl" else "document unique"
+            return (eambrosia_reg, doc, False, extra)
+        return None
+    if country in ("at", "nl", "mt"):
+        return eu_fallback()
+    return None
+
+
+# A grape display name in prose drops the verbatim-cahier cruft the pills keep:
+# the ``— synonym`` / ``- synonym`` tail and the trailing OIV colour letter
+# (``B.`` / ``N.`` / ``Rs.`` …) — e.g. "Durella B. - Durello" → "Durella",
+# "Negro Amaro N. — Negroamaro" → "Negro Amaro".
+_GRAPE_SYNONYM_SEP_RE = re.compile(r"\s+[-—]\s+")
+_GRAPE_COLOUR_TAIL_RE = re.compile(r"\s+(?:B|N|G|RS|RG)\.\s*$", re.IGNORECASE)
+
+
+def _provenance_grape_name(g: str, ctx: RenderCtx) -> str:
+    name = _GRAPE_SYNONYM_SEP_RE.split(grape_name(g, ctx), 1)[0]
+    return _GRAPE_COLOUR_TAIL_RE.sub("", name).strip()
+
+
+def _provenance_grape_clause(rec: dict, ctx: RenderCtx) -> str:
+    """Clean principal-grape display names for the prose line (not the verbatim
+    cahier spelling, which carries OIV colour letters and ``— synonym`` tails
+    that read as cruft in a sentence). Lists all when ≤ 4; otherwise 3 names +
+    a localised ``and N other grape varieties`` tail (N ≥ 2, so the singular
+    ``1 other`` is never produced). Empty when the record has no principal
+    grapes."""
+    slugs = rec.get("grapes_principal") or []
+    if not slugs:
+        return ""
+    if len(slugs) <= 4:
+        return ", ".join(esc(_provenance_grape_name(g, ctx)) for g in slugs)
+    names = ", ".join(esc(_provenance_grape_name(g, ctx)) for g in slugs[:3])
+    return fmt(ctx.labels["provenance_grapes_more"], {"names": names, "n": len(slugs) - 3})
+
+
+def _provenance_line(rec: dict, ctx: RenderCtx) -> str:
+    """A single honest provenance sentence for the crawler-visible card: names
+    the regulator + native source document, and (for appellation-specific
+    sources only) the authorised principal grapes. Returns '' when no public
+    source resolves. Gated by the caller to the factless gap records."""
+    resolved = _provenance_source(rec, ctx)
+    if not resolved:
+        return ""
+    regulator, doc, is_roster, extra = resolved
+    doc_em = f"<em>{esc(doc)}</em>"
+    grapes = "" if is_roster else _provenance_grape_clause(rec, ctx)
+    if grapes:
+        sentence = fmt(
+            ctx.labels["provenance_with_grapes"],
+            {"regulator": regulator, "doc": doc_em, "grapes": grapes},
+        )
+    else:
+        sentence = fmt(
+            ctx.labels["provenance_bare"],
+            {"regulator": regulator, "doc": doc_em, "extra": extra},
+        )
+    return f'<p class="provenance-line">{sentence}</p>'
+
+
 # ---------------------------------------------------------------- pills
 
 def _grape_pill(g: str, cls: str, rec: dict, ctx: RenderCtx) -> str:
@@ -621,6 +820,12 @@ def render_content_block(rec: dict, slug: str, ctx: RenderCtx, children=None) ->
     else:
         note_block = ""
 
+    # Honest provenance sentence — only where the card would otherwise emit
+    # nothing between the pills and the Sources heading (no terroir facts and
+    # no summary). Fills the factless long-tail records with a sourced,
+    # answer-engine-liftable line naming the regulator + source document.
+    provenance = _provenance_line(rec, ctx) if not facts_block and not summary else ""
+
     inner = (
         f"<h1>{name_with_latin(rec)}</h1>"
         f'<div class="meta">{country_seg}{esc(rec.get("kind") or "")}{region_seg}{meta_tail}</div>'
@@ -633,6 +838,7 @@ def render_content_block(rec: dict, slug: str, ctx: RenderCtx, children=None) ->
         f"{facts_block or summary}"
         f"{note_block}"
         f"{render_subappellations(children, ctx, country)}"
+        f"{provenance}"
         f"{render_sources(rec.get('sources'), ctx)}"
     )
     sig = hashlib.sha256(_normalised_text(inner).encode("utf-8")).hexdigest()[:16]
diff --git a/scripts/_lib/map_template.py b/scripts/_lib/map_template.py
index f7fce4d..812acf3 100644
--- a/scripts/_lib/map_template.py
+++ b/scripts/_lib/map_template.py
@@ -142,7 +142,7 @@ def build_labels(_: Callable[[str], str]) -> dict[str, str]:
         "src_show_texte": _("Texte officiel INAO (show_texte)"),
         "src_product": _("Fiche produit INAO"),
         "src_syndicate": _("Site officiel de l'interprofession"),
-        "src_eur_lex": _("Pliego de condiciones (EUR-Lex, documento único)"),
+        "src_eur_lex": _("Cahier des charges (EUR-Lex, document unique)"),
         "src_national_pliego": _("Pliego de condiciones (national, PDF)"),
         "src_national_pliego_added": _("variétés ajoutées"),
         "src_national_spec": _("Cahier des charges national (PDF)"),
@@ -172,6 +172,17 @@ def build_labels(_: Callable[[str], str]) -> dict[str, str]:
             "Open Wine Map n'a pas encore trouvé de {doc} pour cette appellation."
         ),
         "stub_help_label": _("aidez-nous à le trouver"),
+        # Provenance line — an honest one-sentence sourcing statement shown on
+        # factless records. {regulator}/{doc}/{grapes}/{extra} are substituted
+        # verbatim (regulator names + native source-doc terms stay in their own
+        # language, like region labels); only this scaffold is translated.
+        "provenance_with_grapes": _(
+            "Délimitée par {regulator} dans son {doc}, qui autorise {grapes}."
+        ),
+        "provenance_bare": _("Délimitée par {regulator} dans son {doc}{extra}."),
+        "provenance_grapes_more": _("{names} et {n} autres cépages"),
+        "provenance_reg_eambrosia": _("le registre eAmbrosia de l'UE"),
+        "provenance_reg_canton": _("le canton de {canton}"),
         "fr_marker": _("(français)"),
         "fr_marker_aria": _("Texte source en français"),
         "es_marker": _("(español)"),
@@ -1938,6 +1949,9 @@ def _emit(slug: str, meta: dict, ssr: str, has_card: bool) -> None:
   .facet label:hover {{ color:#fff }}
   .facet input[type=checkbox] {{ accent-color:#c0392b; flex:0 0 auto }}
   .facet .name {{ flex:1; overflow:hidden; text-overflow:ellipsis; white-space:nowrap }}
+  /* The appellation name opens its detail panel (the checkbox is the filter) —
+     underline on name-hover signals the "go to this one" link affordance. */
+  .facet label[data-slug] > .name:hover {{ text-decoration:underline; text-decoration-color:#a8c08a; text-underline-offset:2px }}
   .facet .count {{ color:#666; font-size:11px; margin-left:4px }}
   .facet .syns {{ color:#888; font-size:11px; font-weight:normal }}
   /* Keyboard/SR path to open an appellation panel (the WebGL polygons aren't
diff --git a/tests/test_content_block.py b/tests/test_content_block.py
index e84cee3..b5149b2 100644
--- a/tests/test_content_block.py
+++ b/tests/test_content_block.py
@@ -74,6 +74,11 @@
     "translation_source_label_pt": "o caderno de especificações",
     "translation_attribution": "Machine-translated from {source}",
     "entity_nav_children": "Sub-appellations",
+    "provenance_with_grapes": "Delimited by {regulator} in its {doc}, which authorises {grapes}.",
+    "provenance_bare": "Delimited by {regulator} in its {doc}{extra}.",
+    "provenance_grapes_more": "{names} and {n} other grape varieties",
+    "provenance_reg_eambrosia": "the EU eAmbrosia register",
+    "provenance_reg_canton": "the canton of {canton}",
 }
 
 _GRAPES_INFO = {
@@ -83,6 +88,9 @@
                  "page_url": "https://pt.wikipedia.org/wiki/Tempranillo"},
     "touriga-nacional": {"name": "Touriga Nacional", "canonical_name": "Touriga Nacional"},
     "carignan": {"name": "Carignan"},
+    # IT cahier-style spelling: OIV colour letter + "— synonym" tail.
+    "durella": {"name": "Durella B. - Durello"},
+    "negro-amaro": {"name": "Negro Amaro N. — Negroamaro"},
 }
 _STYLES_INFO = {"red": {"extract": "Red wine.", "page_url": "https://en.wikipedia.org/wiki/Red_wine"}}
 _STYLE_LABELS = {"red": "red", "white": "white"}
@@ -257,6 +265,85 @@ def test_sources_block_branches() -> None:
     assert "eAmbrosia" in out and "PDO-FR-0001" in out
 
 
+def test_provenance_line_fr_with_grapes() -> None:
+    # FR cahier, no facts/no summary, grapes present -> named regulator + grape clause.
+    out = _render({"name": "Z", "kind": "AOC", "country": "fr",
+                   "grapes_principal": ["merlot", "carignan"],
+                   "sources": {"boagri": "http://b/p.pdf", "homologation_date": "2024-01-01"}})
+    assert 'class="provenance-line"' in out
+    assert "Delimited by INAO in its <em>cahier des charges</em>, which authorises" in out
+    assert "Merlot, Carignan." in out
+    assert "the EU eAmbrosia register" not in out  # FR never resolves to eAmbrosia
+
+
+def test_provenance_line_grapes_listed_all_when_four() -> None:
+    out = _render({"name": "Z", "kind": "AOC", "country": "fr",
+                   "grapes_principal": ["merlot", "carignan", "aragonez", "touriga-nacional"],
+                   "sources": {"boagri": "http://b/p.pdf"}})
+    assert "which authorises Merlot, Carignan, Aragonez, Touriga Nacional." in out  # <=4 -> all listed
+    assert "other grape varieties" not in out
+
+
+def test_provenance_line_grapes_more_tail() -> None:
+    out = _render({"name": "Z", "kind": "AOC", "country": "fr",
+                   "grapes_principal": ["merlot", "carignan", "aragonez", "touriga-nacional", "syrah"],
+                   "sources": {"boagri": "http://b/p.pdf"}})
+    assert "and 2 other grape varieties" in out  # 5 grapes -> 3 named + "2 other"
+
+
+def test_provenance_line_grape_names_cleaned_for_prose() -> None:
+    # OIV colour letter + "— synonym" tail stripped in the PROSE line (the grape
+    # pills keep the verbatim cahier spelling — only the sentence is cleaned).
+    import re
+    out = _render({"name": "Z", "kind": "DOP", "country": "it",
+                   "grapes_principal": ["durella", "negro-amaro"],
+                   "sources": {"eur_lex_url": "http://e/x", "id_eambrosia": "EUGI9",
+                               "masaf_pdf_filename": "z.pdf"}})
+    line = re.search(r'<p class="provenance-line">.*?</p>', out).group(0)
+    assert "which authorises Durella, Negro Amaro." in line
+    assert "Durello" not in line and "B." not in line and "N." not in line
+    assert "Durello" in out  # pill still carries the verbatim spelling
+
+
+def test_provenance_line_national_roster_suppresses_grapes() -> None:
+    # CZ authorises a single national variety list -> roster; grapes clause dropped,
+    # file_number differentiator appended to the bare skeleton.
+    out = _render({"name": "Litoměřická", "kind": "DOP", "country": "cz",
+                   "grapes_principal": ["merlot", "carignan"],
+                   "sources": {"national_spec_url": "http://s/v.pdf", "file_number": "PDO-CZ-A0888"}})
+    assert "Delimited by SZPI in its <em>specifikace výrobku</em> (PDO-CZ-A0888)." in out
+    assert "which authorises" not in out  # roster -> no per-appellation grape claim
+
+
+def test_provenance_line_eambrosia_fallback_and_ch_canton() -> None:
+    # eAmbrosia fallback only when id_eambrosia present (BG with no national spec).
+    bg = _render({"name": "X", "kind": "DOP", "country": "bg",
+                  "sources": {"eur_lex_url": "http://eurlex/x", "id_eambrosia": "EUGI1",
+                              "file_number": "PDO-BG-A1"}})
+    assert "Delimited by the EU eAmbrosia register in its <em>единен документ</em> (PDO-BG-A1)." in bg
+    # CH is non-EU: regulator is the named canton, never eAmbrosia.
+    ch = _render({"name": "Genève", "kind": "AOC", "country": "ch",
+                  "sources": {"cantonal_reglement_url": "http://ge/r.pdf", "canton": "ge",
+                              "canton_name": "Genève", "source_lang": "fr"}})
+    assert "Delimited by the canton of Genève in its <em>règlement cantonal</em>." in ch
+    assert "eAmbrosia" not in ch
+
+
+def test_provenance_line_absent_without_resolvable_source() -> None:
+    # No sources -> no provenance line at all.
+    out = _render({"name": "N", "kind": "AOC", "country": "fr", "grapes_principal": ["merlot"]})
+    assert "provenance-line" not in out
+
+
+def test_provenance_line_suppressed_when_facts_present() -> None:
+    rec = {"name": "B", "kind": "AOC", "country": "fr", "grapes_principal": ["merlot"],
+           "sources": {"boagri": "http://b/p.pdf"},
+           "terroir_facts": {"facts": [
+               {"bullet": "Granite soils.", "subsection": "facteurs_naturels", "provenance": "cahier"}],
+               "cahier_source_pdf_url": "http://c/p.pdf"}}
+    assert "provenance-line" not in _render(rec)  # facts present -> no provenance line
+
+
 def test_deterministic_output_and_sig() -> None:
     rec = {"name": "D", "kind": "AOC", "country": "fr", "region": "BORDEAUX",
            "grapes_principal": ["merlot", "aragonez"], "geom_source": "parcellaire"}