dsh-plugin-show-me-data 0.1.0

package/src/core/indicators/catalog.js

@@ -0,0 +1,1011 @@
+/**
+ * The seed indicator catalog — **data, not logic** (docs/02 §5.1, docs/03 §3).
+ *
+ * Adding an indicator is adding one object here (plus a recorded fixture for its
+ * series): cards, charts, statistics, insight rules, the AI context and the
+ * conversational lookup all pick it up with no code change. That promise is
+ * enforced by 'test/core/indicators-catalog.test.js'.
+ *
+ * Every 'seriesRef' below was verified against the live source while recording
+ * 'test/fixtures/**'; anything that could not be verified is listed in
+ * {@link UNSUPPORTED} with its investigation result instead of a guessed id.
+ *
+ * @module core/indicators/catalog
+ */
+
+/**
+ * @typedef {Object} IndicatorDef
+ * @property {string} id
+ * @property {'US'|'CN'|'GLOBAL'|'CUSTOM'} group
+ * @property {{ zh: string, en: string }} label
+ * @property {string} unit
+ * @property {'daily'|'weekly'|'monthly'|'quarterly'|'annual'} freq
+ * @property {'SA'|'NSA'|'NA'} seasonal
+ * @property {1|2|3|4|5} importance
+ * @property {{ adapter: string, seriesRef: string, params?: object }} [source]
+ * @property {{ op: 'spread'|'ratio'|'avg', operands: string[] }} [derive]
+ * @property {{ transform: string, window?: number, decimals?: number, polarity?: 'up-is-good'|'down-is-good'|'neutral' }} display
+ * @property {{ zh: string, en?: string }} [notes]
+ * @property {string[]} [tags]
+ * @property {string[]} [aliases]
+ */
+
+/** United States — mostly FRED, which needs no API key (docs/04 §1). */
+const US = [
+  {
+    id: 'us.cpi.yoy',
+    group: 'US',
+    label: { zh: '美国 CPI 同比', en: 'US CPI YoY' },
+    unit: '%',
+    freq: 'monthly',
+    seasonal: 'SA',
+    importance: 5,
+    source: { adapter: 'fred', seriesRef: 'CPIAUCSL' },
+    display: { transform: 'yoy', decimals: 1, polarity: 'down-is-good' },
+    notes: { zh: 'CPI 同比由指数序列现算：FRED 的 CSUS 系列只给指数，页面上的同比是它自己算的。' },
+    tags: ['inflation', 'us', 'policy'],
+    aliases: ['CPI', '通胀', '消费者物价', 'inflation'],
+  },
+  {
+    id: 'us.cpi',
+    group: 'US',
+    label: { zh: '美国 CPI 指数', en: 'US CPI Index' },
+    unit: '指数',
+    freq: 'monthly',
+    seasonal: 'SA',
+    importance: 2,
+    source: { adapter: 'fred', seriesRef: 'CPIAUCSL' },
+    display: { transform: 'raw', decimals: 2, polarity: 'neutral' },
+    notes: { zh: '1982–84 = 100。同比的分子分母都来自这条水平序列。' },
+    tags: ['inflation', 'us'],
+    aliases: ['CPI index', '物价指数'],
+  },
+  {
+    id: 'us.core.cpi.yoy',
+    group: 'US',
+    label: { zh: '美国核心 CPI 同比', en: 'US Core CPI YoY' },
+    unit: '%',
+    freq: 'monthly',
+    seasonal: 'SA',
+    importance: 5,
+    source: { adapter: 'fred', seriesRef: 'CPILFESL' },
+    display: { transform: 'yoy', decimals: 1, polarity: 'down-is-good' },
+    notes: { zh: '剔除食品与能源，是美联储更看重的通胀口径。' },
+    tags: ['inflation', 'us', 'policy'],
+    aliases: ['核心CPI', 'core CPI', 'core inflation'],
+  },
+  {
+    id: 'us.unrate',
+    group: 'US',
+    label: { zh: '美国失业率', en: 'US Unemployment Rate' },
+    unit: '%',
+    freq: 'monthly',
+    seasonal: 'SA',
+    importance: 5,
+    source: { adapter: 'fred', seriesRef: 'UNRATE' },
+    display: { transform: 'raw', decimals: 1, polarity: 'down-is-good' },
+    notes: { zh: 'U-3 口径（16 岁以上、积极求职者）。上升代表就业市场转弱。' },
+    tags: ['labor', 'us'],
+    aliases: ['失业率', 'unemployment', 'jobless rate'],
+  },
+  {
+    id: 'us.payrolls.change',
+    group: 'US',
+    label: { zh: '美国非农就业（月增）', en: 'US Nonfarm Payrolls (MoM)' },
+    unit: '万人',
+    freq: 'monthly',
+    seasonal: 'SA',
+    importance: 5,
+    source: { adapter: 'fred', seriesRef: 'PAYEMS' },
+    display: { transform: 'diff', window: 1, decimals: 1, polarity: 'up-is-good' },
+    notes: { zh: '由水平序列（千人）差分得到月增，单位换算为万人；发布时会同时修正前两月。' },
+    tags: ['labor', 'us'],
+    aliases: ['非农', 'nonfarm', 'payrolls', '就业'],
+  },
+  {
+    id: 'us.payrolls.level',
+    group: 'US',
+    label: { zh: '美国非农就业（总人数）', en: 'US Nonfarm Payrolls (Level)' },
+    unit: '万人',
+    freq: 'monthly',
+    seasonal: 'SA',
+    importance: 2,
+    source: { adapter: 'fred', seriesRef: 'PAYEMS' },
+    display: { transform: 'raw', decimals: 0, polarity: 'up-is-good' },
+    tags: ['labor', 'us'],
+    aliases: ['非农总数', 'payrolls level'],
+  },
+  {
+    id: 'us.payrolls.3m.avg',
+    group: 'US',
+    label: { zh: '美国非农 3 月均值', en: 'US Payrolls 3-Month Average' },
+    unit: '万人',
+    freq: 'monthly',
+    seasonal: 'SA',
+    importance: 3,
+    source: { adapter: 'fred', seriesRef: 'PAYEMS' },
+    display: { transform: 'diff', movingAvg: 3, decimals: 1, polarity: 'up-is-good' },
+    notes: { zh: '平滑单月波动；由月增序列的移动平均得到（见 core/stats/series.movingAverage）。' },
+    tags: ['labor', 'us'],
+    aliases: ['非农三月均值', 'payrolls 3m'],
+  },
+  {
+    id: 'us.fedfunds.daily',
+    group: 'US',
+    label: { zh: '联邦基金利率（日度）', en: 'Effective Fed Funds Rate (Daily)' },
+    unit: '%',
+    freq: 'daily',
+    seasonal: 'NA',
+    importance: 4,
+    source: { adapter: 'fred', seriesRef: 'DFF' },
+    display: { transform: 'raw', decimals: 2, polarity: 'down-is-good' },
+    notes: { zh: '有效联邦基金利率（EFFR），政策利率的实际成交口径。' },
+    tags: ['rates', 'us', 'policy'],
+    aliases: ['联邦基金利率', 'fed funds', 'EFFR', 'policy rate'],
+  },
+  {
+    id: 'us.fedfunds.monthly',
+    group: 'US',
+    label: { zh: '联邦基金利率（月均）', en: 'Effective Fed Funds Rate (Monthly)' },
+    unit: '%',
+    freq: 'monthly',
+    seasonal: 'NA',
+    importance: 3,
+    source: { adapter: 'fred', seriesRef: 'FEDFUNDS' },
+    display: { transform: 'raw', decimals: 2, polarity: 'down-is-good' },
+    tags: ['rates', 'us'],
+    aliases: ['月均联邦基金利率'],
+  },
+  {
+    id: 'us.dgs10',
+    group: 'US',
+    label: { zh: '美国 10Y 国债收益率', en: 'US 10-Year Treasury Yield' },
+    unit: '%',
+    freq: 'daily',
+    seasonal: 'NA',
+    importance: 5,
+    source: { adapter: 'us-treasury-rates', seriesRef: 'daily_treasury_yield_curve', params: { tenor: '10y' } },
+    display: { transform: 'raw', decimals: 2, polarity: 'neutral' },
+    notes: { zh: '恒定到期日（constant maturity）收益率，全球资产定价的锚。休市日上游返回 "."。' },
+    tags: ['rates', 'bond', 'us'],
+    aliases: ['10年期美债', '美债收益率', '10 year treasury', 'DGS10'],
+  },
+  {
+    id: 'us.dgs2',
+    group: 'US',
+    label: { zh: '美国 2Y 国债收益率', en: 'US 2-Year Treasury Yield' },
+    unit: '%',
+    freq: 'daily',
+    seasonal: 'NA',
+    importance: 4,
+    source: { adapter: 'us-treasury-rates', seriesRef: 'daily_treasury_yield_curve', params: { tenor: '2y' } },
+    display: { transform: 'raw', decimals: 2, polarity: 'neutral' },
+    notes: { zh: '对政策利率预期最敏感的一段。' },
+    tags: ['rates', 'bond', 'us'],
+    aliases: ['2年期美债', 'two year treasury'],
+  },
+  {
+    id: 'us.dgs3m',
+    group: 'US',
+    label: { zh: '美国 3M 国债收益率', en: 'US 3-Month Treasury Yield' },
+    unit: '%',
+    freq: 'daily',
+    seasonal: 'NA',
+    importance: 3,
+    source: { adapter: 'us-treasury-rates', seriesRef: 'daily_treasury_yield_curve', params: { tenor: '3m' } },
+    display: { transform: 'raw', decimals: 2, polarity: 'neutral' },
+    tags: ['rates', 'bond', 'us'],
+    aliases: ['3月期美债'],
+  },
+  {
+    id: 'us.curve.10y2y',
+    group: 'US',
+    label: { zh: '10Y−2Y 利差', en: '10Y−2Y Treasury Spread' },
+    unit: 'pp',
+    freq: 'daily',
+    seasonal: 'NA',
+    importance: 5,
+    source: { adapter: 'fred', seriesRef: 'T10Y2Y' },
+    display: { transform: 'raw', decimals: 2, polarity: 'up-is-good' },
+    notes: { zh: '负值 = 收益率曲线倒挂，历史上是衰退的领先信号之一；转正（解除倒挂）同样值得关注。' },
+    tags: ['rates', 'bond', 'us', 'signal'],
+    aliases: ['利差', '收益率曲线', '倒挂', 'yield curve', 'inversion'],
+  },
+  {
+    id: 'us.curve.10y3m',
+    group: 'US',
+    label: { zh: '10Y−3M 利差', en: '10Y−3M Treasury Spread' },
+    unit: 'pp',
+    freq: 'daily',
+    seasonal: 'NA',
+    importance: 3,
+    derive: { op: 'spread', operands: ['us.dgs10', 'us.dgs3m'] },
+    display: { transform: 'raw', decimals: 2, polarity: 'up-is-good' },
+    notes: { zh: '现算利差（10Y − 3M），与 FRED 的 T10Y3M 口径一致但由我们保证时间对齐。' },
+    tags: ['rates', 'bond', 'us'],
+    aliases: ['10y3m', '短端利差'],
+  },
+  {
+    id: 'us.breakeven10y',
+    group: 'US',
+    label: { zh: '美国 10Y 通胀预期', en: 'US 10-Year Breakeven Inflation' },
+    unit: '%',
+    freq: 'daily',
+    seasonal: 'NA',
+    importance: 4,
+    source: { adapter: 'fred', seriesRef: 'T10YIE' },
+    display: { transform: 'raw', decimals: 2, polarity: 'neutral' },
+    notes: { zh: '10Y 名义收益率 − 10Y TIPS 实际收益率，市场隐含的通胀补偿。' },
+    tags: ['inflation', 'rates', 'us'],
+    aliases: ['通胀预期', 'breakeven', 'T10YIE'],
+  },
+  {
+    id: 'us.real10y',
+    group: 'US',
+    label: { zh: '美国 10Y 实际利率', en: 'US 10-Year Real Rate' },
+    unit: '%',
+    freq: 'daily',
+    seasonal: 'NA',
+    importance: 4,
+    derive: { op: 'spread', operands: ['us.dgs10', 'us.breakeven10y'] },
+    display: { transform: 'raw', decimals: 2, polarity: 'down-is-good' },
+    notes: { zh: '名义 10Y 减通胀预期，衡量真实融资成本。' },
+    tags: ['rates', 'us'],
+    aliases: ['实际利率', 'real rate', 'real yield'],
+  },
+  {
+    id: 'us.gdp.real',
+    group: 'US',
+    label: { zh: '美国实际 GDP', en: 'US Real GDP' },
+    unit: '十亿美元',
+    freq: 'quarterly',
+    seasonal: 'SA',
+    importance: 4,
+    source: { adapter: 'fred', seriesRef: 'GDPC1' },
+    display: { transform: 'raw', decimals: 0, polarity: 'up-is-good' },
+    notes: { zh: '链式 2017 美元年化季率水平值；同比请用 yoy 变换。' },
+    tags: ['growth', 'us'],
+    aliases: ['GDP', '经济增长', 'real gdp'],
+  },
+  {
+    id: 'us.gdp.yoy',
+    group: 'US',
+    label: { zh: '美国实际 GDP 同比', en: 'US Real GDP YoY' },
+    unit: '%',
+    freq: 'quarterly',
+    seasonal: 'SA',
+    importance: 5,
+    source: { adapter: 'fred', seriesRef: 'GDPC1' },
+    display: { transform: 'yoy', decimals: 1, polarity: 'up-is-good' },
+    tags: ['growth', 'us'],
+    aliases: ['GDP同比', 'gdp growth'],
+  },
+  {
+    id: 'us.consumer.sentiment',
+    group: 'US',
+    label: { zh: '密歇根消费者信心', en: 'US Consumer Sentiment (UMich)' },
+    unit: '指数',
+    freq: 'monthly',
+    seasonal: 'NSA',
+    importance: 3,
+    source: { adapter: 'fred', seriesRef: 'UMCSENT' },
+    display: { transform: 'raw', decimals: 1, polarity: 'up-is-good' },
+    tags: ['sentiment', 'us'],
+    aliases: ['消费者信心', 'umich', 'sentiment'],
+  },
+  {
+    id: 'us.retail.sales',
+    group: 'US',
+    label: { zh: '美国零售销售', en: 'US Retail Sales' },
+    unit: '百万美元',
+    freq: 'monthly',
+    seasonal: 'SA',
+    importance: 3,
+    source: { adapter: 'fred', seriesRef: 'RSAFS' },
+    display: { transform: 'raw', decimals: 0, polarity: 'up-is-good' },
+    tags: ['consumption', 'us'],
+    aliases: ['零售销售', 'retail sales'],
+  },
+  {
+    id: 'us.mortgage30',
+    group: 'US',
+    label: { zh: '美国 30 年期房贷利率', en: 'US 30-Year Mortgage Rate' },
+    unit: '%',
+    freq: 'weekly',
+    seasonal: 'NA',
+    importance: 3,
+    source: { adapter: 'fred', seriesRef: 'MORTGAGE30US' },
+    display: { transform: 'raw', decimals: 2, polarity: 'down-is-good' },
+    notes: { zh: 'Freddie Mac 周频调查均值，周四发布。' },
+    tags: ['rates', 'housing', 'us'],
+    aliases: ['房贷利率', 'mortgage', '30年房贷'],
+  },
+  {
+    id: 'us.dollar.index',
+    group: 'US',
+    label: { zh: '美元指数（广义）', en: 'US Dollar Index (Broad)' },
+    unit: '指数',
+    freq: 'daily',
+    seasonal: 'NA',
+    importance: 3,
+    source: { adapter: 'fred', seriesRef: 'DTWEXBGS' },
+    display: { transform: 'raw', decimals: 2, polarity: 'neutral' },
+    notes: { zh: '美联储广义贸易加权美元指数（2006-01 = 100），不是 ICE 的 DXY。' },
+    tags: ['fx', 'us'],
+    aliases: ['美元指数', 'dollar index', 'DXY'],
+  },
+  {
+    id: 'us.oil.wti',
+    group: 'US',
+    label: { zh: 'WTI 原油', en: 'WTI Crude Oil' },
+    unit: '美元/桶',
+    freq: 'daily',
+    seasonal: 'NA',
+    importance: 4,
+    source: { adapter: 'fred', seriesRef: 'DCOILWTICO' },
+    display: { transform: 'raw', decimals: 2, polarity: 'neutral' },
+    notes: { zh: 'Cushing WTI 现货价；上游偶有 "." 缺失，函数一律跳过。' },
+    tags: ['commodity', 'energy'],
+    aliases: ['原油', 'WTI', '油价', 'oil'],
+  },
+  {
+    id: 'us.idx.spx',
+    group: 'US',
+    label: { zh: '标普 500', en: 'S&P 500' },
+    unit: '点',
+    freq: 'daily',
+    seasonal: 'NA',
+    importance: 5,
+    source: { adapter: 'sina-us', seriesRef: '.INX' },
+    display: { transform: 'raw', decimals: 2, polarity: 'up-is-good' },
+    tags: ['equity', 'us'],
+    aliases: ['标普', 'S&P', 'sp500'],
+  },
+  {
+    id: 'us.idx.dji',
+    group: 'US',
+    label: { zh: '道琼斯工业指数', en: 'Dow Jones Industrial Average' },
+    unit: '点',
+    freq: 'daily',
+    seasonal: 'NA',
+    importance: 4,
+    source: { adapter: 'sina-us', seriesRef: '.DJI' },
+    display: { transform: 'raw', decimals: 2, polarity: 'up-is-good' },
+    tags: ['equity', 'us'],
+    aliases: ['道指', '道琼斯', 'dow'],
+  },
+  {
+    id: 'us.idx.ndx',
+    group: 'US',
+    label: { zh: '纳斯达克 100', en: 'Nasdaq 100' },
+    unit: '点',
+    freq: 'daily',
+    seasonal: 'NA',
+    importance: 4,
+    source: { adapter: 'sina-us', seriesRef: '.NDX' },
+    display: { transform: 'raw', decimals: 2, polarity: 'up-is-good' },
+    tags: ['equity', 'us'],
+    aliases: ['纳指', '纳斯达克', 'nasdaq'],
+  },
+]
+
+/** 中国 — 东方财富行情 + 数据中心（docs/04 §2, §3）。 */
+const CN = [
+  {
+    id: 'cn.cpi.yoy',
+    group: 'CN',
+    label: { zh: '中国 CPI 同比', en: 'China CPI YoY' },
+    unit: '%',
+    freq: 'monthly',
+    seasonal: 'NSA',
+    importance: 5,
+    source: { adapter: 'eastmoney-macro', seriesRef: 'RPT_ECONOMY_CPI', params: { column: 'NATIONAL_SAME' } },
+    display: { transform: 'raw', decimals: 1, polarity: 'neutral' },
+    notes: { zh: '国家统计局口径同比，取自 RPT_ECONOMY_CPI 的 NATIONAL_SAME 列（上游本身就是百分比）。' },
+    tags: ['inflation', 'cn'],
+    aliases: ['中国CPI', 'CPI同比', '通胀'],
+  },
+  {
+    id: 'cn.cpi.mom',
+    group: 'CN',
+    label: { zh: '中国 CPI 环比', en: 'China CPI MoM' },
+    unit: '%',
+    freq: 'monthly',
+    seasonal: 'NSA',
+    importance: 3,
+    source: { adapter: 'eastmoney-macro', seriesRef: 'RPT_ECONOMY_CPI', params: { column: 'NATIONAL_SEQUENTIAL' } },
+    display: { transform: 'raw', decimals: 1, polarity: 'neutral' },
+    notes: { zh: 'NATIONAL_SEQUENTIAL 是环比（%），不是累计同比。' },
+    tags: ['inflation', 'cn'],
+    aliases: ['CPI环比', '环比'],
+  },
+  {
+    id: 'cn.ppi.yoy',
+    group: 'CN',
+    label: { zh: '中国 PPI 同比', en: 'China PPI YoY' },
+    unit: '%',
+    freq: 'monthly',
+    seasonal: 'NSA',
+    importance: 4,
+    source: { adapter: 'eastmoney-macro', seriesRef: 'RPT_ECONOMY_PPI', params: { column: 'BASE_SAME' } },
+    display: { transform: 'raw', decimals: 1, polarity: 'neutral' },
+    notes: { zh: 'PPI 同比在 BASE_SAME 列（BASE 是指数列）。' },
+    tags: ['inflation', 'cn', 'industry'],
+    aliases: ['PPI', '生产者价格'],
+  },
+  {
+    id: 'cn.pmi.mfg',
+    group: 'CN',
+    label: { zh: '中国制造业 PMI', en: 'China Manufacturing PMI' },
+    unit: '指数',
+    freq: 'monthly',
+    seasonal: 'SA',
+    importance: 5,
+    source: { adapter: 'eastmoney-macro', seriesRef: 'RPT_ECONOMY_PMI', params: { column: 'MAKE_INDEX' } },
+    display: { transform: 'raw', decimals: 1, polarity: 'up-is-good' },
+    notes: { zh: '50 是荣枯线。MAKE_SAME 是「较上月变化（pp）」，不是同比。' },
+    tags: ['growth', 'cn', 'industry'],
+    aliases: ['制造业PMI', 'PMI', 'pmi'],
+  },
+  {
+    id: 'cn.pmi.nonmfg',
+    group: 'CN',
+    label: { zh: '中国非制造业 PMI', en: 'China Non-Manufacturing PMI' },
+    unit: '指数',
+    freq: 'monthly',
+    seasonal: 'SA',
+    importance: 3,
+    source: { adapter: 'eastmoney-macro', seriesRef: 'RPT_ECONOMY_PMI', params: { column: 'NMAKE_INDEX' } },
+    display: { transform: 'raw', decimals: 1, polarity: 'up-is-good' },
+    tags: ['growth', 'cn', 'services'],
+    aliases: ['非制造业PMI', '服务业PMI'],
+  },
+  {
+    id: 'cn.gdp.yoy',
+    group: 'CN',
+    label: { zh: '中国 GDP 同比', en: 'China GDP YoY' },
+    unit: '%',
+    freq: 'quarterly',
+    seasonal: 'NSA',
+    importance: 5,
+    source: { adapter: 'eastmoney-macro', seriesRef: 'RPT_ECONOMY_GDP', params: { column: 'SUM_SAME' } },
+    display: { transform: 'raw', decimals: 1, polarity: 'up-is-good' },
+    notes: { zh: 'SUM_SAME 是累计同比口径（国家统计局按累计发布）。' },
+    tags: ['growth', 'cn'],
+    aliases: ['中国GDP', 'GDP增速'],
+  },
+  {
+    id: 'cn.gdp.level',
+    group: 'CN',
+    label: { zh: '中国 GDP 现价累计', en: 'China GDP (Cumulative, Current Prices)' },
+    unit: '亿元',
+    freq: 'quarterly',
+    seasonal: 'NSA',
+    importance: 3,
+    source: { adapter: 'eastmoney-macro', seriesRef: 'RPT_ECONOMY_GDP', params: { column: 'DOMESTICL_PRODUCT_BASE' } },
+    display: { transform: 'raw', decimals: 0, polarity: 'up-is-good' },
+    notes: { zh: '上游列名拼写为 DOMESTICL_PRODUCT_BASE（缺一个 S），照抄不纠正。' },
+    tags: ['growth', 'cn'],
+    aliases: ['GDP总量', 'gdp level'],
+  },
+  {
+    id: 'cn.m2.yoy',
+    group: 'CN',
+    label: { zh: '中国 M2 同比', en: 'China M2 YoY' },
+    unit: '%',
+    freq: 'monthly',
+    seasonal: 'NSA',
+    importance: 5,
+    source: { adapter: 'eastmoney-macro', seriesRef: 'RPT_ECONOMY_CURRENCY_SUPPLY', params: { column: 'BASIC_CURRENCY_SAME' } },
+    display: { transform: 'raw', decimals: 1, polarity: 'neutral' },
+    notes: {
+      zh: '口径陷阱：在 RPT_ECONOMY_CURRENCY_SUPPLY 里 BASIC_CURRENCY 才是 M2（约 355 万亿），CURRENCY 是 M1（约 115 万亿）。列名与直觉相反。',
+    },
+    tags: ['money', 'cn'],
+    aliases: ['M2', '货币供应', 'm2 growth'],
+  },
+  {
+    id: 'cn.m1.yoy',
+    group: 'CN',
+    label: { zh: '中国 M1 同比', en: 'China M1 YoY' },
+    unit: '%',
+    freq: 'monthly',
+    seasonal: 'NSA',
+    importance: 4,
+    source: { adapter: 'eastmoney-macro', seriesRef: 'RPT_ECONOMY_CURRENCY_SUPPLY', params: { column: 'CURRENCY_SAME' } },
+    display: { transform: 'raw', decimals: 1, polarity: 'neutral' },
+    notes: { zh: 'CURRENCY_SAME 是 M1 同比；M1−M2 剪刀差常被用来观察资金活化程度。' },
+    tags: ['money', 'cn'],
+    aliases: ['M1', 'm1 growth'],
+  },
+  {
+    id: 'cn.m2.m1.spread',
+    group: 'CN',
+    label: { zh: '中国 M2−M1 剪刀差', en: 'China M2−M1 Growth Spread' },
+    unit: 'pp',
+    freq: 'monthly',
+    seasonal: 'NSA',
+    importance: 4,
+    derive: { op: 'spread', operands: ['cn.m2.yoy', 'cn.m1.yoy'] },
+    display: { transform: 'raw', decimals: 1, polarity: 'down-is-good' },
+    notes: { zh: '剪刀差扩大代表资金淤积在定期存款，活化程度下降。' },
+    tags: ['money', 'cn', 'signal'],
+    aliases: ['剪刀差', 'm2 m1'],
+  },
+  {
+    id: 'cn.idx.sse',
+    group: 'CN',
+    label: { zh: '上证指数', en: 'Shanghai Composite' },
+    unit: '点',
+    freq: 'daily',
+    seasonal: 'NA',
+    importance: 5,
+    source: { adapter: 'quote', seriesRef: 'sse' },
+    display: { transform: 'raw', decimals: 2, polarity: 'up-is-good' },
+    tags: ['equity', 'cn'],
+    aliases: ['上证', '大盘', 'shanghai composite'],
+  },
+  {
+    id: 'cn.idx.szse',
+    group: 'CN',
+    label: { zh: '深证成指', en: 'Shenzhen Component' },
+    unit: '点',
+    freq: 'daily',
+    seasonal: 'NA',
+    importance: 4,
+    source: { adapter: 'quote', seriesRef: 'szse' },
+    display: { transform: 'raw', decimals: 2, polarity: 'up-is-good' },
+    tags: ['equity', 'cn'],
+    aliases: ['深成指', '深证', 'shenzhen'],
+  },
+  {
+    id: 'cn.idx.csi300',
+    group: 'CN',
+    label: { zh: '沪深 300', en: 'CSI 300' },
+    unit: '点',
+    freq: 'daily',
+    seasonal: 'NA',
+    importance: 5,
+    source: { adapter: 'quote', seriesRef: 'csi300' },
+    display: { transform: 'raw', decimals: 2, polarity: 'up-is-good' },
+    notes: { zh: '覆盖沪深两市大盘蓝筹，是 A 股宽基基准。' },
+    tags: ['equity', 'cn'],
+    aliases: ['沪深300', 'csi300', 'hs300'],
+  },
+  {
+    id: 'cn.idx.chinext',
+    group: 'CN',
+    label: { zh: '创业板指', en: 'ChiNext Index' },
+    unit: '点',
+    freq: 'daily',
+    seasonal: 'NA',
+    importance: 3,
+    source: { adapter: 'quote', seriesRef: 'chinext' },
+    display: { transform: 'raw', decimals: 2, polarity: 'up-is-good' },
+    tags: ['equity', 'cn'],
+    aliases: ['创业板', 'chinext'],
+  },
+  {
+    id: 'cn.idx.dividend',
+    group: 'CN',
+    label: { zh: '上证红利指数', en: 'SSE Dividend Index' },
+    unit: '点',
+    freq: 'daily',
+    seasonal: 'NA',
+    importance: 2,
+    source: { adapter: 'quote', seriesRef: 'dividend' },
+    display: { transform: 'raw', decimals: 2, polarity: 'up-is-good' },
+    tags: ['equity', 'cn', 'dividend'],
+    aliases: ['红利指数', 'dividend index'],
+  },
+  {
+    id: 'cn.bond.govt.index',
+    group: 'CN',
+    label: { zh: '上证国债指数', en: 'SSE Government Bond Index' },
+    unit: '点',
+    freq: 'daily',
+    seasonal: 'NA',
+    importance: 4,
+    source: { adapter: 'quote', seriesRef: 'govtbond' },
+    display: { transform: 'raw', decimals: 2, polarity: 'up-is-good' },
+    notes: { zh: '这是债券价格指数，不是到期收益率；中国 10Y 收益率暂无可用公开源（见 docs/03 §3.6）。行情取自多源级联（腾讯 → 东方财富），任一源被限流不影响该卡片。' },
+    tags: ['bond', 'cn'],
+    aliases: ['国债指数', '国债', 'government bond'],
+  },
+  {
+    id: 'cn.bond.corp.index',
+    group: 'CN',
+    label: { zh: '上证企债指数', en: 'SSE Corporate Bond Index' },
+    unit: '点',
+    freq: 'daily',
+    seasonal: 'NA',
+    importance: 4,
+    source: { adapter: 'quote', seriesRef: 'corpbond' },
+    display: { transform: 'raw', decimals: 2, polarity: 'up-is-good' },
+    tags: ['bond', 'cn', 'credit'],
+    aliases: ['企债指数', '信用债', 'corporate bond'],
+  },
+  {
+    id: 'cn.bond.credit.spread',
+    group: 'CN',
+    label: { zh: '中国信用债−国债比价', en: 'China Corporate vs Government Bond Ratio' },
+    unit: '比值',
+    freq: 'daily',
+    seasonal: 'NA',
+    importance: 3,
+    derive: { op: 'ratio', operands: ['cn.bond.corp.index', 'cn.bond.govt.index'] },
+    display: { transform: 'raw', decimals: 4, polarity: 'up-is-good' },
+    notes: { zh: '两条指数按日期内连接后取比值；上升代表信用债相对走强（风险偏好改善）。' },
+    tags: ['bond', 'cn', 'signal'],
+    aliases: ['信用利差代理', 'credit spread proxy'],
+  },
+  {
+    id: 'cn.houseprice.new',
+    group: 'CN',
+    label: { zh: '中国 70 城新房价格同比', en: 'China 70-City New Home Price YoY' },
+    unit: '%',
+    freq: 'monthly',
+    seasonal: 'NSA',
+    importance: 5,
+    source: { adapter: 'eastmoney-macro', seriesRef: 'RPT_ECONOMY_HOUSE_PRICE', params: { column: 'FIRST_COMHOUSE_SAME', city: '北京' } },
+    display: { transform: 'raw', decimals: 1, polarity: 'up-is-good' },
+    notes: { zh: '国家统计局 70 城新建商品住宅销售价格同比（%），100 为基准。上游该报表按城市分行，取北京作一线代表；FIRST_COMHOUSE_SAME 本身就是同比百分比。' },
+    tags: ['housing', 'cn'],
+    aliases: ['房价', '新房价格', '70城房价'],
+  },
+  {
+    id: 'cn.houseprice.second',
+    group: 'CN',
+    label: { zh: '中国 70 城二手房价格同比', en: 'China 70-City Existing Home Price YoY' },
+    unit: '%',
+    freq: 'monthly',
+    seasonal: 'NSA',
+    importance: 4,
+    source: { adapter: 'eastmoney-macro', seriesRef: 'RPT_ECONOMY_HOUSE_PRICE', params: { column: 'SECOND_HOUSE_SAME', city: '北京' } },
+    display: { transform: 'raw', decimals: 1, polarity: 'up-is-good' },
+    notes: { zh: '二手住宅同比（%）。二手房比新房更早反映真实成交，二者背离时以二手房为领先参考。' },
+    tags: ['housing', 'cn'],
+    aliases: ['二手房', '二手房价'],
+  },
+  {
+    id: 'cn.population.birthrate',
+    group: 'CN',
+    label: { zh: '中国人口出生率', en: 'China Birth Rate' },
+    unit: '‰',
+    freq: 'annual',
+    seasonal: 'NSA',
+    importance: 4,
+    source: { adapter: 'worldbank', seriesRef: 'SP.DYN.CBRT.IN', params: { country: 'CN', date: '1990:3000' } },
+    display: { transform: 'raw', decimals: 2, polarity: 'up-is-good' },
+    notes: { zh: '世界银行粗出生率（每千人），年度频率，最新年份取决于上游发布节奏。' },
+    tags: ['population', 'cn'],
+    aliases: ['出生率', '人口', 'birth rate'],
+  },
+  {
+    id: 'cn.population.fertility',
+    group: 'CN',
+    label: { zh: '中国总和生育率', en: 'China Fertility Rate' },
+    unit: '孩/妇女',
+    freq: 'annual',
+    seasonal: 'NSA',
+    importance: 4,
+    source: { adapter: 'worldbank', seriesRef: 'SP.DYN.TFRT.IN', params: { country: 'CN', date: '1990:3000' } },
+    display: { transform: 'raw', decimals: 3, polarity: 'up-is-good' },
+    notes: { zh: '世界银行总和生育率（每名妇女生育数）。替代水平约 2.1，长期低于该值是人口结构压力的核心指标。' },
+    tags: ['population', 'cn'],
+    aliases: ['生育率', '总和生育率', 'fertility'],
+  },
+  {
+    id: 'cn.population.urban',
+    group: 'CN',
+    label: { zh: '中国城镇化率', en: 'China Urban Population Share' },
+    unit: '%',
+    freq: 'annual',
+    seasonal: 'NSA',
+    importance: 3,
+    source: { adapter: 'worldbank', seriesRef: 'SP.URB.TOTL.IN.ZS', params: { country: 'CN', date: '1990:3000' } },
+    display: { transform: 'raw', decimals: 2, polarity: 'neutral' },
+    notes: { zh: '城镇人口占比（%）。与楼市需求同源，其增速放缓通常领先于房价同比走弱。' },
+    tags: ['population', 'housing', 'cn'],
+    aliases: ['城镇化', '城市化', 'urban'],
+  },
+  {
+    id: 'cn.trade.exports',
+    group: 'CN',
+    label: { zh: '中国出口金额', en: 'China Exports' },
+    // The upstream publishes 万美元; changing the unit would require rescaling,
+    // so the unit string states what the source really returns.
+    unit: '万美元',
+    freq: 'monthly',
+    seasonal: 'NSA',
+    importance: 4,
+    source: { adapter: 'eastmoney-macro', seriesRef: 'RPT_ECONOMY_CUSTOMS', params: { column: 'EXIT_BASE' } },
+    display: { transform: 'raw', decimals: 0, polarity: 'up-is-good' },
+    notes: { zh: '海关总署月度出口金额，单位与上游一致（万美元）。上游另有 EXIT_BASE_SAME 给出同比（%），这里取绝对额以便看水平与趋势。' },
+    tags: ['trade', 'cn'],
+    aliases: ['出口', '出口金额', 'exports'],
+  },
+  {
+    id: 'cn.trade.imports',
+    group: 'CN',
+    label: { zh: '中国进口金额', en: 'China Imports' },
+    unit: '万美元',
+    freq: 'monthly',
+    seasonal: 'NSA',
+    importance: 4,
+    source: { adapter: 'eastmoney-macro', seriesRef: 'RPT_ECONOMY_CUSTOMS', params: { column: 'IMPORT_BASE' } },
+    display: { transform: 'raw', decimals: 0, polarity: 'up-is-good' },
+    notes: { zh: '海关总署月度进口金额，单位与上游一致（万美元）。进口走弱常先于出口反映内需变化。' },
+    tags: ['trade', 'cn'],
+    aliases: ['进口', '进口金额', 'imports'],
+  },
+  {
+    id: 'cn.trade.balance',
+    group: 'CN',
+    label: { zh: '中国贸易顺差', en: 'China Trade Balance' },
+    unit: '万美元',
+    freq: 'monthly',
+    seasonal: 'NSA',
+    importance: 4,
+    derive: { op: 'spread', operands: ['cn.trade.exports', 'cn.trade.imports'] },
+    display: { transform: 'raw', decimals: 0, polarity: 'neutral' },
+    notes: { zh: '出口减进口（万美元），按日期内连接后相减；两条序列同为月度且同日发布，差值近似月度贸易顺差。' },
+    tags: ['trade', 'cn', 'signal'],
+    aliases: ['贸易顺差', '顺差', 'trade balance', '进出口'],
+  },
+]
+
+/** 全球与跨市场（World Bank / ECB / 美国财政部 / 海外指数）。 */
+const GLOBAL = [
+  {
+    id: 'ecb.exr.usd',
+    group: 'GLOBAL',
+    label: { zh: '欧元/美元', en: 'EUR/USD' },
+    unit: '汇率',
+    freq: 'daily',
+    seasonal: 'NA',
+    importance: 4,
+    source: { adapter: 'ecb', seriesRef: 'EXR/D.USD.EUR.SP00.A', params: { lastNObservations: 1600 } },
+    display: { transform: 'raw', decimals: 4, polarity: 'neutral' },
+    notes: { zh: 'ECB 每日参考汇率（约 16:00 CET 定盘），不是实时报价。' },
+    tags: ['fx', 'eu'],
+    aliases: ['欧元', 'eurusd', '汇率'],
+  },
+  {
+    id: 'wb.gdp.us',
+    group: 'GLOBAL',
+    label: { zh: '美国 GDP（现价美元）', en: 'US GDP (current US$)' },
+    unit: '美元',
+    freq: 'annual',
+    seasonal: 'NA',
+    importance: 3,
+    source: { adapter: 'worldbank', seriesRef: 'NY.GDP.MKTP.CD', params: { country: 'US' } },
+    display: { transform: 'raw', decimals: 0, polarity: 'up-is-good' },
+    notes: { zh: 'World Bank 年度口径，年末记账；发布滞后 1–2 年，陈旧阈值 400 天。' },
+    tags: ['growth', 'global'],
+    aliases: ['美国GDP总量', 'world bank gdp'],
+  },
+  {
+    id: 'wb.gdp.cn',
+    group: 'GLOBAL',
+    label: { zh: '中国 GDP（现价美元）', en: 'China GDP (current US$)' },
+    unit: '美元',
+    freq: 'annual',
+    seasonal: 'NA',
+    importance: 3,
+    source: { adapter: 'worldbank', seriesRef: 'NY.GDP.MKTP.CD', params: { country: 'CN' } },
+    display: { transform: 'raw', decimals: 0, polarity: 'up-is-good' },
+    tags: ['growth', 'global'],
+    aliases: ['中国GDP总量'],
+  },
+  {
+    id: 'wb.cpi.cn',
+    group: 'GLOBAL',
+    label: { zh: '中国通胀（WB 年频）', en: 'China Inflation (World Bank)' },
+    unit: '%',
+    freq: 'annual',
+    seasonal: 'NA',
+    importance: 2,
+    source: { adapter: 'worldbank', seriesRef: 'FP.CPI.TOTL.ZG', params: { country: 'CN' } },
+    display: { transform: 'raw', decimals: 1, polarity: 'neutral' },
+    notes: { zh: '可与 cn.cpi.yoy 交叉校验：两条独立来源同向才算可信。' },
+    tags: ['inflation', 'global'],
+    aliases: ['WB通胀', 'world bank cpi'],
+  },
+  {
+    id: 'wb.unemployment.us',
+    group: 'GLOBAL',
+    label: { zh: '美国失业率（ILO 口径）', en: 'US Unemployment (ILO)' },
+    unit: '%',
+    freq: 'annual',
+    seasonal: 'NA',
+    importance: 2,
+    source: { adapter: 'worldbank', seriesRef: 'SL.UEM.TOTL.ZS', params: { country: 'US' } },
+    display: { transform: 'raw', decimals: 1, polarity: 'down-is-good' },
+    notes: { zh: 'ILO 建模估计，与 BLS 的 us.unrate 口径不同（后者更及时）。' },
+    tags: ['labor', 'global'],
+    aliases: ['ILO失业率'],
+  },
+  {
+    id: 'wb.lending.cn',
+    group: 'GLOBAL',
+    label: { zh: '中国贷款加权平均利率', en: 'China Lending Interest Rate (World Bank)' },
+    unit: '%',
+    freq: 'annual',
+    seasonal: 'NA',
+    importance: 3,
+    source: { adapter: 'worldbank', seriesRef: 'FR.INR.LEND', params: { country: 'CN' } },
+    display: { transform: 'raw', decimals: 2, polarity: 'down-is-good' },
+    notes: { zh: 'LPR 没有可用公开时序源（docs/03 §3.6）；这是 World Bank 的贷款加权平均利率年频口径，作为替代观察项。' },
+    tags: ['rates', 'cn'],
+    aliases: ['LPR替代', '贷款利率', 'lending rate'],
+  },
+  {
+    id: 'ust.avg.rate.notes',
+    group: 'GLOBAL',
+    label: { zh: '美国国债平均利率（Notes）', en: 'US Treasury Average Rate (Notes)' },
+    unit: '%',
+    freq: 'monthly',
+    seasonal: 'NA',
+    importance: 3,
+    source: {
+      adapter: 'us-treasury',
+      seriesRef: 'avg_interest_rates',
+      params: { filter: 'security_desc:eq:Treasury Notes', valueField: 'avg_interest_rate_amt' },
+    },
+    display: { transform: 'raw', decimals: 3, polarity: 'neutral' },
+    notes: { zh: '存续国债的平均票息，反映财政付息成本；必须带 filter，否则会混入 Bills/Bonds/TIPS。' },
+    tags: ['rates', 'fiscal', 'global'],
+    aliases: ['国债平均利率', 'treasury average rate'],
+  },
+]
+
+/** 用户自定义指标落在这个分组（'group: 'CUSTOM''）。 */
+const CUSTOM = [
+  {
+    id: 'custom.example.placeholder',
+    group: 'CUSTOM',
+    label: { zh: '自定义指标（示例占位）', en: 'Custom Indicator (placeholder)' },
+    unit: '%',
+    freq: 'monthly',
+    seasonal: 'NA',
+    importance: 1,
+    source: { adapter: 'fred', seriesRef: 'PAYEMS' },
+    display: { transform: 'raw', decimals: 2, polarity: 'neutral' },
+    notes: { zh: '仅用于演示 CUSTOM 分组；用户新增的指标由 WatchlistRepository 管理，不写进种子目录。' },
+    tags: ['custom'],
+    aliases: ['自定义', 'custom'],
+  },
+]
+
+/** The full seed catalog. */
+export const CATALOG = [...US, ...CN, ...GLOBAL, ...CUSTOM]
+
+/**
+ * Indicators that were investigated and deliberately left out, with the reason
+ * (docs/10 hard rule 3: never guess an interface). 'cn.us.10y.spread' depends on
+ * a China 10-year yield, so it is unsupported until such a source exists.
+ *
+ * @type {Array<{ id: string, label: { zh: string, en: string }, group: string, reason: string, investigated: string[] }>}
+ */
+export const UNSUPPORTED = [
+  {
+    id: 'cn.bond.10y.yield',
+    label: { zh: '中国 10Y 国债收益率', en: 'China 10-Year Government Bond Yield' },
+    group: 'CN',
+    reason: '没有找到可用的公开时序源，按纪律标为 unsupported 而不是猜接口。',
+    investigated: [
+      '东方财富 datacenter RPT_ECONOMY_INTEREST_RATE / RPT_BOND_CB_YIELD → code 9501「报表配置不存在」',
+      '东方财富行情 secid 0.100303（10Y 国债收益率）→ rc=100、data=null',
+      '中国债券信息网 yield.chinabond.com.cn/cbweb-mn/yield_main/getYieldData → HTTP 404',
+      '新浪债券行情 hq.sinajs.cn → HTTP 403（需要特定 Referer）',
+      '中金所 CFFEX 日行情 XML → 只有单交易日快照，且是国债期货价格而非收益率',
+    ],
+  },
+  {
+    id: 'cn.lpr.1y',
+    label: { zh: '中国 1 年期 LPR', en: 'China 1-Year LPR' },
+    group: 'CN',
+    reason: 'datacenter 无对应报表；LPR 目前只能从新闻/公告获得，无法构成时序。',
+    investigated: ['RPT_ECONOMY_LPR → code 9501', '替代口径：World Bank FR.INR.LEND（年频，已作为 wb.lending.cn 收录）'],
+  },
+  {
+    id: 'cn.tsf.level',
+    label: { zh: '中国社会融资规模', en: 'China Total Social Financing' },
+    group: 'CN',
+    reason: 'datacenter 未确认存在社融报表（RPT_ECONOMY_* 枚举中无 TS/社融），不猜 reportName。',
+    investigated: ['RPT_ECONOMY_TRADE / RPT_ECONOMY_SHIBOR / RPT_ECONOMY_INTEREST_RATE → code 9501', '未逐个枚举全部报表名'],
+  },
+  {
+    id: 'hk.idx.hsi',
+    label: { zh: '恒生指数', en: 'Hang Seng Index' },
+    group: 'GLOBAL',
+    reason: '本网络可达的三个行情端点都不提供恒指日线：新浪 A 股接口对该代码返回 null（实测），腾讯返回 501，东方财富行情域主动断连。',
+    investigated: [
+      '新浪 CN_MarketDataService.getKLineData：hkHSI / rt_hkHSI / hkHSI.HK 全部返回 x(null)',
+      '腾讯 fqkline：hkHSI 曾有数据，现返回 HTTP 501',
+      '东方财富 push2his：UND_ERR_SOCKET（该域对本网络断连）',
+    ],
+  },
+  {
+    id: 'jp.idx.n225',
+    label: { zh: '日经 225', en: 'Nikkei 225' },
+    group: 'GLOBAL',
+    reason: '本部署可达的行情源都不提供日经 225 的日线历史：腾讯接口对该代码返回 param error，东方财富行情域被网络阻断，FRED 被边缘 WAF 拒绝。',
+    investigated: [
+      '腾讯 web.ifzq.gtimg.cn kline：jpNI225 → param error',
+      '新浪美股日线 US_MinKService：.N225 → 连接失败',
+      '东方财富 push2his：UND_ERR_SOCKET（该域对本网络断连）',
+      'FRED（NASDAQ100/NIKKEI 系列）：HTTP 403 AkamaiGHost',
+    ],
+  },
+  {
+    id: 'kr.idx.kospi',
+    label: { zh: '韩国 KOSPI', en: 'KOSPI' },
+    group: 'GLOBAL',
+    reason: '同上：没有可达的日线历史源。',
+    investigated: ['腾讯 krKOSPI → param error', '新浪 .KS11 → 连接失败', '东方财富 100.KS11 → 域被阻断'],
+  },
+  {
+    id: 'de.idx.dax',
+    label: { zh: '德国 DAX 30', en: 'DAX 30' },
+    group: 'GLOBAL',
+    reason: '同上：没有可达的日线历史源。',
+    investigated: ['腾讯 deDAXI → param error', '新浪 .GDAXI → 连接失败', '东方财富 100.GDAXI → 域被阻断'],
+  },
+  {
+    id: 'uk.idx.ftse',
+    label: { zh: '英国富时 100', en: 'FTSE 100' },
+    group: 'GLOBAL',
+    reason: '腾讯返回了数据节点但 day 为空，新浪无该符号，东方财富域被阻断。',
+    investigated: ['腾讯 ukFTSE → day: []（空）', '新浪 .FTSE → 连接失败', '东方财富 100.FTSE → 域被阻断'],
+  },
+  {
+    id: 'fr.idx.cac',
+    label: { zh: '法国 CAC 40', en: 'CAC 40' },
+    group: 'GLOBAL',
+    reason: '同上：没有可达的日线历史源。',
+    investigated: ['腾讯 frCAC → param error', '新浪 .FCHI → 连接失败', '东方财富 100.FCHI → 域被阻断'],
+  },
+  {
+    id: 'eu.idx.stoxx50',
+    label: { zh: '欧洲斯托克 50', en: 'Euro Stoxx 50' },
+    group: 'GLOBAL',
+    reason: '同上：没有可达的日线历史源。',
+    investigated: ['腾讯 euSX5E → param error', '新浪 .STOXX50E → 连接失败', '东方财富 100.SX5E → 域被阻断'],
+  },
+  {
+    id: 'au.idx.asx200',
+    label: { zh: '澳大利亚标普 200', en: 'S&P/ASX 200' },
+    group: 'GLOBAL',
+    reason: '同上：没有可达的日线历史源。',
+    investigated: ['腾讯 auAS51/100.AS51 → param error', '新浪 .AXJO → 连接失败', '东方财富 100.AS51 → 域被阻断'],
+  },
+  {
+    id: 'cn.us.10y.spread',
+    label: { zh: '中美 10Y 利差', en: 'China–US 10-Year Yield Spread' },
+    group: 'GLOBAL',
+    reason: '依赖 cn.bond.10y.yield；美国一侧（us.dgs10）可用，但缺中国一侧，因此整条不可用。',
+    investigated: ['美国一侧 us.dgs10 已实测可用（FRED DGS10）'],
+  },
+]
+
+/**
+ * Index the catalog by id.
+ *
+ * @param {IndicatorDef[]} [catalog] - catalog to index.
+ * @returns {Map<string, IndicatorDef>} id → definition.
+ */
+export function indexById(catalog = CATALOG) {
+  return new Map(catalog.map((indicator) => [indicator.id, indicator]))
+}
+
+/**
+ * Look one indicator up.
+ *
+ * @param {string} id - indicator id.
+ * @returns {IndicatorDef|undefined} definition.
+ */
+export function getIndicator(id) {
+  return CATALOG.find((indicator) => indicator.id === id)
+}