Analysis: warn on degenerate gamut volume

iccviz's GamutVolume now flags a `degenerate` result (IccVizModel.cpp) when the
gamut boundary collapsed or was mostly non-finite, so that intent's volume is
unreliable. Surface it in the Analysis tab's Profile Statistics rather than
presenting a bogus number as trustworthy:

- plot-wrapper.cpp: gamutVolume() JSON now carries `degenerate` (it was dropped).
- AnalysisPanel.jsx: capture the flag per intent and, near the gamut-volume
  display, render a ⚠ marker on the affected cell (tooltip) plus a note below
  the table when any intent is degenerate.
- AnalysisPanel.module.css: add .warnMark / .statWarning (uses --warning).
- i18n.jsx: new stats_gamut_degenerate key across all 12 locales; xlsx resynced
  (188 keys).

Dormant until the next WASM rebuild: the committed iccplot.wasm predates both the
wrapper's new field and IccVizModel.cpp's degenerate logic, so r.degenerate reads
undefined (marker/note simply don't render) until the deploy-time rebuild picks
both up.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XTfq9wJh9ZWT1fTN62LkDN

Author: colourbill-ctrl

frontend/src/components/AnalysisPanel.jsx

@@ -67,10 +67,13 @@ function ProfileStatsSection({ bytes, t }) {
     ;(async () => {
       const rows = []
       for (const it of STATS_INTENTS) {
-        let vol = null, rt = null
-        try { vol = (await gamutVolume(bytes, it.tag, it.intent)).volume } catch { /* AToB tag absent */ }
+        let vol = null, degenerate = false, rt = null
+        try {
+          const g = await gamutVolume(bytes, it.tag, it.intent)
+          vol = g.volume; degenerate = !!g.degenerate   // iccviz flags a collapsed/unreliable gamut boundary
+        } catch { /* AToB tag absent */ }
         try { rt = await roundTripDE(bytes, it.intent) } catch { /* AToB/BToA tags absent */ }
-        if (vol != null || rt != null) rows.push({ key: it.key, fallback: it.fallback, vol, rt })
+        if (vol != null || rt != null) rows.push({ key: it.key, fallback: it.fallback, vol, degenerate, rt })
       }
       if (cancelled) return
       statsCache.set(bytes, rows)
@@ -95,6 +98,13 @@ function ProfileStatsSection({ bytes, t }) {
     rtPad[key] = strs.map((s) => ' '.repeat(w - s.length) + s)
   }
 
+  // iccviz sets `degenerate` when a gamut boundary collapsed / was mostly
+  // non-finite, so that intent's volume is unreliable — flag it (⚠ on the cell +
+  // a note below) rather than presenting a bogus number as trustworthy.
+  const degenerateMsg = t('stats_gamut_degenerate') ||
+    'The gamut boundary collapsed or was mostly undefined, so this gamut volume is unreliable.'
+  const anyDegenerate = state.rows.some((r) => r.degenerate)
+
   return (
     <Collapsible title={t('analysis_stats_heading') || 'Profile Statistics'} defaultOpen>
       <p className={styles.sectionIntro}>
@@ -126,7 +136,10 @@ function ProfileStatsSection({ bytes, t }) {
             {state.rows.map((r, i) => (
               <tr key={r.key}>
                 <td>{t(r.key) || r.fallback}</td>
-                <td className={styles.statNum}>{fmtVol(r.vol)}</td>
+                <td className={styles.statNum}>
+                  {fmtVol(r.vol)}
+                  {r.degenerate && <span className={styles.warnMark} title={degenerateMsg} aria-label={degenerateMsg}> ⚠</span>}
+                </td>
                 {RT.map(({ key }) => (
                   <td key={key} className={styles.statNumC}>{rtPad[key][i]}</td>
                 ))}
@@ -135,6 +148,7 @@ function ProfileStatsSection({ bytes, t }) {
           </tbody>
         </table>
       )}
+      {anyDegenerate && <div className={styles.statWarning}>⚠ {degenerateMsg}</div>}
     </Collapsible>
   )
 }

frontend/src/components/AnalysisPanel.module.css

@@ -103,6 +103,19 @@
 .table th.statNum,  .table td.statNum  { text-align: right; }
 .table th.statNumC, .table td.statNumC { text-align: center; }
 
+/* Degenerate-gamut flag: a ⚠ appended to the unreliable volume cell, plus a note
+   below the table. Uses --warning so it reads as caution, not error. */
+.warnMark { color: var(--warning); cursor: help; }
+.statWarning {
+  margin-top: 10px;
+  padding: 8px 12px;
+  border-radius: var(--radius);
+  background: var(--surface-tint);
+  color: var(--warning);
+  font-size: 0.8rem;
+  line-height: 1.4;
+}
+
 /* ── status / loading / diagnostics ───────────────────────────────────────── */
 .status,
 .loading {

frontend/src/i18n.jsx

@@ -41,6 +41,7 @@ export const I18N = {
     analysis_stats_intro: 'Whole-profile metrics per rendering intent: the gamut volume enclosed by the device→PCS transform (ΔE*ab³), and the B2A round-trip accuracy — ΔE*ab of a Lab → device → Lab round trip through the profile.',
     analysis_stats_na: 'No device↔PCS CLUTs in this profile — profile statistics do not apply (e.g. a matrix/TRC display profile).',
     stats_intent: 'Rendering intent', stats_gamut_volume: 'Gamut volume (ΔE³)', stats_roundtrip: 'Round-trip ΔE',
+    stats_gamut_degenerate: 'The gamut boundary collapsed or was mostly undefined, so this gamut volume is unreliable.',
     stats_mean: 'mean', stats_p90: 'P90', stats_max: 'max',
     analysis_loading: 'Analysing…', analysis_title: 'Analysis',
     analysis_intro: 'Profile-wide quality analyses derived from the device-to-PCS transform.',
@@ -152,6 +153,7 @@ export const I18N = {
     analysis_stats_na: 'Aucune CLUT périphérique↔PCS dans ce profil — les statistiques du profil ne s’appliquent pas (par exemple un profil d’affichage matrice/TRC).',
     stats_intent: 'Intention de rendu',
     stats_gamut_volume: 'Volume de gamut (ΔE³)',
+    stats_gamut_degenerate: 'La frontière du gamut s’est effondrée ou était en grande partie indéfinie ; ce volume de gamut n’est pas fiable.',
     stats_roundtrip: 'ΔE aller-retour',
     stats_mean: 'moyenne',
     stats_p90: 'P90',
@@ -295,6 +297,7 @@ export const I18N = {
     analysis_stats_na: 'Keine Gerät↔PCS-CLUTs in diesem Profil — die Profilstatistik ist nicht anwendbar (z. B. ein Matrix/TRC-Displayprofil).',
     stats_intent: 'Render-Intent',
     stats_gamut_volume: 'Gamut-Volumen (ΔE³)',
+    stats_gamut_degenerate: 'Die Gamut-Grenze ist kollabiert oder war größtenteils undefiniert; dieses Gamut-Volumen ist unzuverlässig.',
     stats_roundtrip: 'Roundtrip-ΔE',
     stats_mean: 'Mittel',
     stats_p90: 'P90',
@@ -438,6 +441,7 @@ export const I18N = {
     analysis_stats_na: 'Nessuna CLUT dispositivo↔PCS in questo profilo — le statistiche del profilo non si applicano (ad es. un profilo monitor matrice/TRC).',
     stats_intent: 'Intento di rendering',
     stats_gamut_volume: 'Volume del gamut (ΔE³)',
+    stats_gamut_degenerate: 'Il confine del gamut è collassato o era in gran parte indefinito; questo volume di gamut non è affidabile.',
     stats_roundtrip: 'ΔE round-trip',
     stats_mean: 'media',
     stats_p90: 'P90',
@@ -581,6 +585,7 @@ export const I18N = {
     analysis_stats_na: 'Este perfil no tiene CLUT dispositivo↔PCS — las estadísticas del perfil no se aplican (p. ej. un perfil de pantalla matriz/TRC).',
     stats_intent: 'Propósito de representación',
     stats_gamut_volume: 'Volumen de gama (ΔE³)',
+    stats_gamut_degenerate: 'El contorno de la gama se colapsó o quedó mayormente indefinido, por lo que este volumen de gama no es fiable.',
     stats_roundtrip: 'ΔE de ciclo',
     stats_mean: 'media',
     stats_p90: 'P90',
@@ -724,6 +729,7 @@ export const I18N = {
     analysis_stats_na: 'Este perfil não tem CLUTs dispositivo↔PCS — as estatísticas do perfil não se aplicam (por exemplo, um perfil de ecrã matriz/TRC).',
     stats_intent: 'Intenção de renderização',
     stats_gamut_volume: 'Volume de gamute (ΔE³)',
+    stats_gamut_degenerate: 'A fronteira do gamute colapsou ou ficou maioritariamente indefinida, pelo que este volume de gamute não é fiável.',
     stats_roundtrip: 'ΔE de percurso',
     stats_mean: 'média',
     stats_p90: 'P90',
@@ -867,6 +873,7 @@ export const I18N = {
     analysis_stats_na: 'Este perfil não tem CLUTs dispositivo↔PCS — as estatísticas do perfil não se aplicam (por exemplo, um perfil de tela matriz/TRC).',
     stats_intent: 'Intenção de renderização',
     stats_gamut_volume: 'Volume de gamut (ΔE³)',
+    stats_gamut_degenerate: 'A fronteira do gamut colapsou ou ficou majoritariamente indefinida, então este volume de gamut não é confiável.',
     stats_roundtrip: 'ΔE de percurso',
     stats_mean: 'média',
     stats_p90: 'P90',
@@ -1010,6 +1017,7 @@ export const I18N = {
     analysis_stats_na: 'Inga enhet↔PCS-CLUT:ar i den här profilen — profilstatistiken gäller inte (t.ex. en matris/TRC-skärmprofil).',
     stats_intent: 'Renderingsavsikt',
     stats_gamut_volume: 'Gamutvolym (ΔE³)',
+    stats_gamut_degenerate: 'Gamytens gräns kollapsade eller var mestadels odefinierad, så denna gamutvolym är otillförlitlig.',
     stats_roundtrip: 'Rundtur-ΔE',
     stats_mean: 'medel',
     stats_p90: 'P90',
@@ -1153,6 +1161,7 @@ export const I18N = {
     analysis_stats_na: '此特性文件没有设备↔PCS CLUT——特性文件统计不适用（例如矩阵/TRC 显示器特性文件）。',
     stats_intent: '渲染意图',
     stats_gamut_volume: '色域体积 (ΔE³)',
+    stats_gamut_degenerate: '色域边界塌陷或大部分未定义，因此此色域体积不可靠。',
     stats_roundtrip: '往返 ΔE',
     stats_mean: '均值',
     stats_p90: 'P90',
@@ -1296,6 +1305,7 @@ export const I18N = {
     analysis_stats_na: '此特性檔沒有裝置↔PCS CLUT——特性檔統計不適用（例如矩陣/TRC 顯示器特性檔）。',
     stats_intent: '轉換意圖',
     stats_gamut_volume: '色域體積 (ΔE³)',
+    stats_gamut_degenerate: '色域邊界塌陷或大部分未定義，因此此色域體積不可靠。',
     stats_roundtrip: '往返 ΔE',
     stats_mean: '平均',
     stats_p90: 'P90',
@@ -1439,6 +1449,7 @@ export const I18N = {
     analysis_stats_na: 'このプロファイルにはデバイス↔PCS CLUT がありません——プロファイル統計は適用されません（例：マトリクス/TRC ディスプレイプロファイル）。',
     stats_intent: 'レンダリングインテント',
     stats_gamut_volume: '色域体積 (ΔE³)',
+    stats_gamut_degenerate: 'この色域の境界が崩壊したか、ほとんど未定義のため、この色域体積は信頼できません。',
     stats_roundtrip: '往復 ΔE',
     stats_mean: '平均',
     stats_p90: 'P90',
@@ -1582,6 +1593,7 @@ export const I18N = {
     analysis_stats_na: '이 프로파일에는 장치↔PCS CLUT가 없습니다 — 프로파일 통계가 적용되지 않습니다(예: 행렬/TRC 디스플레이 프로파일).',
     stats_intent: '렌더링 의도',
     stats_gamut_volume: '색역 부피 (ΔE³)',
+    stats_gamut_degenerate: '색역 경계가 붕괴되었거나 대부분 정의되지 않아 이 색역 부피를 신뢰할 수 없습니다.',
     stats_roundtrip: '왕복 ΔE',
     stats_mean: '평균',
     stats_p90: 'P90',