metweave 0.1.0 → 0.1.1

package/README.md

@@ -25,7 +25,7 @@ L.tileLayer(
   `https://t{s}.tianditu.gov.cn/vec_w/wmts?SERVICE=WMTS&REQUEST=GetTile&VERSION=1.0.0&LAYER=vec&STYLE=default&TILEMATRIXSET=w&FORMAT=tiles&TILEMATRIX={z}&TILEROW={y}&TILECOL={x}&tk=${TDT_KEY}`,
   { subdomains: ["0", "1", "2", "3", "4", "5", "6", "7"], attribution: "底图 © 天地图" },
 ).addTo(map);
-addMetarLayer(map, await getMetarReports(), { conditionColors: true });
+await addMetarLayer(map, await getMetarReports(), { conditionColors: true });
 ```
 
 本包再导出 `@metweave/core` / `parser` / `render`（整条管道一个入口，含 `toValues` 与机读错误类）；`metweave/sources` 提供取数 helper。文档与完整示例见[主仓库](https://github.com/yaojaro/metweave)。

package/dist/sources.cjs

@@ -75,7 +75,7 @@ async function getMetars(network = "CN__ASOS", options = {}) {
 * 传 options.onUnparseable 则逐行容错——失败行跳过并逐条回调（可观测），好行照常返回。
 */
 async function getMetarReports(network = "CN__ASOS", options = {}) {
-	const { stations, onUnparseable, ...fetchOptions } = options;
+	const { stations, onUnparseable, spans, ...fetchOptions } = options;
 	const table = new Map((stations ?? []).map((s) => [s.icao, s]));
 	const observations = await getMetars(network, fetchOptions);
 	const items = [];
@@ -87,7 +87,7 @@ async function getMetarReports(network = "CN__ASOS", options = {}) {
 		if (lat === null || lon === null) continue;
 		try {
 			items.push({
-				report: (0, _metweave_parser.parse)(obs.raw),
+				report: (0, _metweave_parser.parse)(obs.raw, spans === false ? { spans: false } : void 0),
 				position: [lat, lon],
 				title: `${obs.station}${station?.name ? ` ${station.name}` : ""}`
 			});

package/dist/sources.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"sources.cjs","names":["MetarSourceError","parse","MetarParseError"],"sources":["../src/sources.ts"],"sourcesContent":["/**\n * metweave/sources — 取数 helper（伞包子路径）。\n *\n * 纪律：只做端点模板 + fetch + 取数侧整理（解析、定位联表）——缓存/质控/归档等\n * 数据管理逻辑永不进入开源包；核心包（core/parser/render）零网络代码。\n * 不静默：HTTP 失败、响应 schema 不符、报文解析失败一律 throw，绝不吞错返回空数组。\n * 错误面机读化：五路失败一律抛 MetarSourceError（code 稳定契约 + network 网络名字段；\n * message 权威文案为中文；英文用 @metweave/core 导出的 EN_MESSAGES[code] 查表，\n * 或渲染层 locale:\"en\" 整卡切换（card locale 已内置 code→英文映射））。\n */\nimport type { MetarReport } from \"@metweave/core\";\nimport type { MetarParseErrorCode } from \"@metweave/core\";\nimport { MetarParseError, MetarSourceError } from \"@metweave/core\";\nimport { parse } from \"@metweave/parser\";\n\n// 错误类复出（API 完整性）：消费方从 sources 子路径 import 即可 catch 两类错误，\n// 不必再从伞包主入口双入口引入（类实体与 core 同一，instanceof 双向成立）。\nexport { MetarParseError, MetarSourceError } from \"@metweave/core\";\n\n/**\n * One fetched observation row: station, verbatim raw report, and source-provided coordinates (city-level for IEM China rows).\n * 单条取数观测行：站名、原样报文、源站坐标（IEM 中国行为城市级粗坐标）。\n */\nexport interface MetarObservation {\n  /** 站名（ICAO） */\n  station: string;\n  /** 报文原文（IEM 通路无类型词，IEM 自带坐标为城市级粗坐标——定位请使用站点元数据） */\n  raw: string;\n  lat: number | null;\n  lon: number | null;\n}\n\n/**\n * Options for getMetars: external abort signal and request timeout (either firing aborts).\n * getMetars 的选项：外部取消信号与请求超时（任一触发即中止）。\n */\nexport interface GetMetarsOptions {\n  /** 外部取消信号（与超时组合，任一触发即中止） */\n  signal?: AbortSignal;\n  /** 请求超时毫秒数（触发即中止并抛出超时错误） */\n  timeoutMs?: number;\n}\n\n/**\n * Station metadata for lookup joins: authoritative coordinates overriding the source's city-level ones.\n * 站点元数据（联表用）：坐标为权威定位源，覆盖源站的城市级粗坐标。\n */\nexport interface StationRef {\n  /** 站名（ICAO） */\n  icao: string;\n  /** 纬度（WGS-84） */\n  lat: number;\n  /** 经度（WGS-84） */\n  lon: number;\n  /** 站点名称（进 tooltip 标题） */\n  name?: string;\n}\n\n/**\n * Per-row failure detail (the onUnparseable callback argument): one observation row failed to parse wholesale (missing station/time etc.).\n * 逐行容错的失败详情（onUnparseable 回调入参）：一行观测报文解析整体失败（站名/时组缺失等）。\n * `code` is the machine-readable failure code (MetarParseError's stable contract); `error` is the narrative message.\n * code 是机读失败码（MetarParseError 的稳定契约），error 是中文 message。\n */\nexport interface UnparseableReport {\n  /** 源站站名（IEM 行的 station 字段） */\n  station: string;\n  /** 报文原文 */\n  raw: string;\n  /** 机读失败码（missing-station / missing-time / invalid-time） */\n  code: MetarParseErrorCode;\n  /** 解析失败原因（Error.message，中文） */\n  error: string;\n}\n\n/**\n * Options for getMetarReports: fetch options plus station metadata and the per-row tolerance callback.\n * getMetarReports 的选项：取数选项 + 站点联表元数据 + 逐行容错回调。\n */\nexport interface GetMetarReportsOptions extends GetMetarsOptions {\n  /** 按 icao 联表的站点元数据：命中则用其精确坐标与名称，未命中回落源站坐标 */\n  stations?: readonly StationRef[];\n  /**\n   * 逐行容错（缺省关闭）：传入时解析失败的行跳过并逐条回调——失败可观测，不静默；\n   * 不传时任一失败仍聚合抛出（默认行为不变，全有或全无）。\n   */\n  onUnparseable?: (failure: UnparseableReport) => void;\n}\n\n/**\n * A map-ready report item (structurally compatible with MetarLayerItem): the { report, position, title } triple —\n * report is the parsed IR (raw text preserved verbatim on report.raw; field values via toValues(report)),\n * position is WGS-84 [lat, lon], title is the hover title.\n * 可直接喂给地图适配器（如 addMetarLayer）的报文项（与 MetarLayerItem 结构兼容）：\n * `{ report, position, title }` 三件套——report 是已解析的 IR（报文原文在 report.raw 原样保真，\n * 需要字段值走 toValues(report)），position 是 WGS-84 [lat, lon]，title 是悬浮提示标题。\n */\nexport interface MetarReportItem {\n  /** 已解析的报文 IR（原文经 report.raw 原样保真回溯） */\n  report: MetarReport;\n  /** 站点坐标（WGS-84 [lat, lon]） */\n  position: [number, number];\n  /** 站点提示（「ICAO 站名」；适配器缺省回落 IR 站名） */\n  title: string;\n}\n\nconst IEM_BASE = \"https://mesonet.agron.iastate.edu\";\n\n/**\n * The IEM whole-network currents endpoint (CORS-open, direct browser access). Defaults to the China ASOS network (39 stations).\n * IEM 整网实况端点（CORS 全开，浏览器可直连）。缺省中国 ASOS 网（39 站）。\n * @param network - IEM network name (e.g. CN__ASOS, RU__ASOS, IA_ASOS). IEM 网络名。\n */\nexport function iemCurrentsUrl(network = \"CN__ASOS\"): string {\n  return `${IEM_BASE}/api/1/currents.json?network=${encodeURIComponent(network)}`;\n}\n\n/** 观测记录守卫：station/raw 均须为字符串（只查键不查类型是旧洞）。 */\nfunction isObservation(v: unknown): v is MetarObservation {\n  if (typeof v !== \"object\" || v === null) return false;\n  const rec = v as { station?: unknown; raw?: unknown };\n  return typeof rec.station === \"string\" && typeof rec.raw === \"string\";\n}\n\n/**\n * Fetch IEM whole-network current observations (station/raw/coordinates passed through).\n * 拉取 IEM 整网实况观测（station/raw/坐标透传）。\n * No-silent-failure discipline on the fetch side / 不静默纪律的取数面：\n * - 空数组是错误网络名的典型形态（IEM 对未知 network 返回 200 + 空 data，合法网络不会返回空）——显式 throw；\n * - fetch 网络层失败（断网/DNS）包装为中文可读错误（原始 message 保留在文末与 cause）；\n * - 超时/外部 AbortSignal 触发的拒绝不包装、原样透传（保持取消语义）。\n */\nexport async function getMetars(\n  network = \"CN__ASOS\",\n  options: GetMetarsOptions = {},\n): Promise<MetarObservation[]> {\n  // 手工组合超时与外部信号（不依赖 AbortSignal.any：兼容 Node 20 全系；setTimeout 可被测试假时钟接管）\n  const controller = new AbortController();\n  const external = options.signal;\n  const forward = (): void => {\n    controller.abort(external?.reason);\n  };\n  if (external !== undefined) {\n    if (external.aborted) forward();\n    else external.addEventListener(\"abort\", forward, { once: true });\n  }\n  const timer =\n    options.timeoutMs === undefined\n      ? undefined\n      : setTimeout(\n          () =>\n            controller.abort(\n              // 超时中止原因即最终抛出的错误：code \"timeout\"（外部 signal 取消不在此列，reason 原样透传）\n              new MetarSourceError(\n                \"timeout\",\n                network,\n                `IEM 请求超时（>${options.timeoutMs}ms，network=${network}）`,\n              ),\n            ),\n          options.timeoutMs,\n        );\n  try {\n    let res: Response;\n    try {\n      res = await fetch(iemCurrentsUrl(network), { signal: controller.signal });\n    } catch (err) {\n      // 取消/超时引发的拒绝（controller 已中止）原样透传——保持 AbortSignal 语义\n      //（超时场景透传的即上方 MetarSourceError \"timeout\"）；\n      // 其余（断网/DNS 的 TypeError 等）包装为 MetarSourceError \"network\"，原始 message 保留在文末与 cause\n      if (controller.signal.aborted) throw err;\n      const reason = err instanceof Error ? err.message : String(err);\n      throw new MetarSourceError(\n        \"network\",\n        network,\n        `网络请求失败（源：IEM，network=${network}）：请检查网络连通性后重试（${reason}）`,\n        { cause: err },\n      );\n    }\n    if (!res.ok) {\n      throw new MetarSourceError(\n        \"http-error\",\n        network,\n        `IEM HTTP ${res.status}（network=${network}）`,\n      );\n    }\n    let body: unknown;\n    try {\n      body = await res.json();\n    } catch (err) {\n      // HTTP 200 但响应体不是 JSON（企业代理/防火墙拦截页的典型形态）——裸 SyntaxError 打穿属错误面缺口；\n      // 归入 bad-schema 机读码，人话提示指向代理环境。中止引发的拒绝不在此列（保持取消语义透传）\n      if (controller.signal.aborted) throw err;\n      const reason = err instanceof Error ? err.message : String(err);\n      throw new MetarSourceError(\n        \"bad-schema\",\n        network,\n        `IEM 响应不是合法 JSON（可能被代理/防火墙拦截，network=${network}）：${reason}`,\n        { cause: err },\n      );\n    }\n    if (\n      typeof body !== \"object\" ||\n      body === null ||\n      !(\"data\" in body) ||\n      !Array.isArray(body.data)\n    ) {\n      throw new MetarSourceError(\n        \"bad-schema\",\n        network,\n        `IEM 响应异常：缺少 data 数组（network=${network}，schema 不符）`,\n      );\n    }\n    const rows = body.data;\n    if (!rows.every(isObservation)) {\n      throw new MetarSourceError(\n        \"bad-schema\",\n        network,\n        `IEM 响应异常：data 存在 station/raw 非字符串的记录（network=${network}，schema 不符）`,\n      );\n    }\n    if (rows.length === 0) {\n      // 合法网络不会返回空（整网实况端点）——空 data 几乎必然是网络名写错（IEM 对未知网络名返回 200 + 空数组）\n      throw new MetarSourceError(\n        \"empty-data\",\n        network,\n        `IEM 返回空数据（network=${network}）——请核对 IEM 网络名（如 CN__ASOS/RU__ASOS，参考 https://mesonet.agron.iastate.edu/sites/networks.php）`,\n      );\n    }\n    return rows;\n  } finally {\n    if (timer !== undefined) clearTimeout(timer);\n    external?.removeEventListener(\"abort\", forward);\n  }\n}\n\n/**\n * Fetch → parse → locate in one step: returns map-ready report items.\n * 取数 → 解析 → 定位一步到位：返回可直接喂给地图适配器的报文项数组。\n *\n * 定位规则：stations 命中的站用元数据精确坐标（并带站名），未命中的回落源站坐标\n * （IEM 中国站为城市级粗坐标，严肃场景请传站点元数据——见 examples 的 stations.json 用法）；\n * 源站坐标为 null 且无元数据的行跳过。\n * 失败语义（不静默，两种模式）：缺省任一报文解析整体失败（站名/时组缺失）即聚合抛出，绝不静默丢行；\n * 传 options.onUnparseable 则逐行容错——失败行跳过并逐条回调（可观测），好行照常返回。\n */\nexport async function getMetarReports(\n  network = \"CN__ASOS\",\n  options: GetMetarReportsOptions = {},\n): Promise<MetarReportItem[]> {\n  const { stations, onUnparseable, ...fetchOptions } = options;\n  const table = new Map((stations ?? []).map((s) => [s.icao, s] as const));\n  const observations = await getMetars(network, fetchOptions);\n  const items: MetarReportItem[] = [];\n  const failures: string[] = [];\n  for (const obs of observations) {\n    const station = table.get(obs.station);\n    const lat = station?.lat ?? obs.lat;\n    const lon = station?.lon ?? obs.lon;\n    if (lat === null || lon === null) continue;\n    try {\n      items.push({\n        report: parse(obs.raw),\n        position: [lat, lon],\n        title: `${obs.station}${station?.name ? ` ${station.name}` : \"\"}`,\n      });\n    } catch (err) {\n      // parse 对字符串输入只抛 MetarParseError（code 稳定契约）；其他异常属编程错误，直接上抛不降级\n      if (!(err instanceof MetarParseError)) throw err;\n      if (onUnparseable !== undefined) {\n        onUnparseable({ station: obs.station, raw: obs.raw, code: err.code, error: err.message });\n        continue;\n      }\n      failures.push(`${obs.station}: ${err.message}`);\n    }\n  }\n  if (failures.length > 0) {\n    // 聚合错误机读化（原裸 Error）：code 'batch-parse-failed' 稳定契约；raw 字段在此承载\n    // 汇总信息（网络名/条数/逐条站名与原因）而非单条报文原文——语义调整见 core/errors.ts 注释\n    const summary = `network=${network}; failures=${failures.length}; ${failures.join(\"; \")}`;\n    throw new MetarParseError(\n      \"batch-parse-failed\",\n      summary,\n      `报文解析失败 ${failures.length} 条（network=${network}）——${failures.slice(0, 3).join(\"；\")}${failures.length > 3 ? \"……\" : \"\"}`,\n    );\n  }\n  return items;\n}\n"],"mappings":"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"}
+{"version":3,"file":"sources.cjs","names":["MetarSourceError","parse","MetarParseError"],"sources":["../src/sources.ts"],"sourcesContent":["/**\n * metweave/sources — 取数 helper（伞包子路径）。\n *\n * 纪律：只做端点模板 + fetch + 取数侧整理（解析、定位联表）——缓存/质控/归档等\n * 数据管理逻辑永不进入开源包；核心包（core/parser/render）零网络代码。\n * 不静默：HTTP 失败、响应 schema 不符、报文解析失败一律 throw，绝不吞错返回空数组。\n * 错误面机读化：五路失败一律抛 MetarSourceError（code 稳定契约 + network 网络名字段；\n * message 权威文案为中文；英文用 @metweave/core 导出的 EN_MESSAGES[code] 查表，\n * 或渲染层 locale:\"en\" 整卡切换（card locale 已内置 code→英文映射））。\n */\nimport type { MetarReport } from \"@metweave/core\";\nimport type { MetarParseErrorCode } from \"@metweave/core\";\nimport { MetarParseError, MetarSourceError } from \"@metweave/core\";\nimport { parse } from \"@metweave/parser\";\n\n// 错误类复出（API 完整性）：消费方从 sources 子路径 import 即可 catch 两类错误，\n// 不必再从伞包主入口双入口引入（类实体与 core 同一，instanceof 双向成立）。\nexport { MetarParseError, MetarSourceError } from \"@metweave/core\";\n\n/**\n * One fetched observation row: station, verbatim raw report, and source-provided coordinates (city-level for IEM China rows).\n * 单条取数观测行：站名、原样报文、源站坐标（IEM 中国行为城市级粗坐标）。\n */\nexport interface MetarObservation {\n  /** 站名（ICAO） */\n  station: string;\n  /** 报文原文（IEM 通路无类型词，IEM 自带坐标为城市级粗坐标——定位请使用站点元数据） */\n  raw: string;\n  lat: number | null;\n  lon: number | null;\n}\n\n/**\n * Options for getMetars: external abort signal and request timeout (either firing aborts).\n * getMetars 的选项：外部取消信号与请求超时（任一触发即中止）。\n */\nexport interface GetMetarsOptions {\n  /** 外部取消信号（与超时组合，任一触发即中止） */\n  signal?: AbortSignal;\n  /** 请求超时毫秒数（触发即中止并抛出超时错误） */\n  timeoutMs?: number;\n}\n\n/**\n * Station metadata for lookup joins: authoritative coordinates overriding the source's city-level ones.\n * 站点元数据（联表用）：坐标为权威定位源，覆盖源站的城市级粗坐标。\n */\nexport interface StationRef {\n  /** 站名（ICAO） */\n  icao: string;\n  /** 纬度（WGS-84） */\n  lat: number;\n  /** 经度（WGS-84） */\n  lon: number;\n  /** 站点名称（进 tooltip 标题） */\n  name?: string;\n}\n\n/**\n * Per-row failure detail (the onUnparseable callback argument): one observation row failed to parse wholesale (missing station/time etc.).\n * 逐行容错的失败详情（onUnparseable 回调入参）：一行观测报文解析整体失败（站名/时组缺失等）。\n * `code` is the machine-readable failure code (MetarParseError's stable contract); `error` is the narrative message.\n * code 是机读失败码（MetarParseError 的稳定契约），error 是中文 message。\n */\nexport interface UnparseableReport {\n  /** 源站站名（IEM 行的 station 字段） */\n  station: string;\n  /** 报文原文 */\n  raw: string;\n  /** 机读失败码（missing-station / missing-time / invalid-time） */\n  code: MetarParseErrorCode;\n  /** 解析失败原因（Error.message，中文） */\n  error: string;\n}\n\n/**\n * Options for getMetarReports: fetch options plus station metadata and the per-row tolerance callback.\n * getMetarReports 的选项：取数选项 + 站点联表元数据 + 逐行容错回调。\n */\nexport interface GetMetarReportsOptions extends GetMetarsOptions {\n  /** 按 icao 联表的站点元数据：命中则用其精确坐标与名称，未命中回落源站坐标 */\n  stations?: readonly StationRef[];\n  /**\n   * 逐行容错（缺省关闭）：传入时解析失败的行跳过并逐条回调——失败可观测，不静默；\n   * 不传时任一失败仍聚合抛出（默认行为不变，全有或全无）。\n   */\n  onUnparseable?: (failure: UnparseableReport) => void;\n  /**\n   * 紧凑模式：parse 产物剥除全部 span 字段（存储体积约 -32%，入库供屏场景推荐）；\n   * 缺省 undefined = 完整模式（span 在位，原文回溯用）。\n   */\n  spans?: false;\n}\n\n/**\n * A map-ready report item (structurally compatible with MetarLayerItem): the { report, position, title } triple —\n * report is the parsed IR (raw text preserved verbatim on report.raw; field values via toValues(report)),\n * position is WGS-84 [lat, lon], title is the hover title.\n * 可直接喂给地图适配器（如 addMetarLayer）的报文项（与 MetarLayerItem 结构兼容）：\n * `{ report, position, title }` 三件套——report 是已解析的 IR（报文原文在 report.raw 原样保真，\n * 需要字段值走 toValues(report)），position 是 WGS-84 [lat, lon]，title 是悬浮提示标题。\n */\nexport interface MetarReportItem {\n  /** 已解析的报文 IR（原文经 report.raw 原样保真回溯） */\n  report: MetarReport;\n  /** 站点坐标（WGS-84 [lat, lon]） */\n  position: [number, number];\n  /** 站点提示（「ICAO 站名」；适配器缺省回落 IR 站名） */\n  title: string;\n}\n\nconst IEM_BASE = \"https://mesonet.agron.iastate.edu\";\n\n/**\n * The IEM whole-network currents endpoint (CORS-open, direct browser access). Defaults to the China ASOS network (39 stations).\n * IEM 整网实况端点（CORS 全开，浏览器可直连）。缺省中国 ASOS 网（39 站）。\n * @param network - IEM network name (e.g. CN__ASOS, RU__ASOS, IA_ASOS). IEM 网络名。\n */\nexport function iemCurrentsUrl(network = \"CN__ASOS\"): string {\n  return `${IEM_BASE}/api/1/currents.json?network=${encodeURIComponent(network)}`;\n}\n\n/** 观测记录守卫：station/raw 均须为字符串（只查键不查类型是旧洞）。 */\nfunction isObservation(v: unknown): v is MetarObservation {\n  if (typeof v !== \"object\" || v === null) return false;\n  const rec = v as { station?: unknown; raw?: unknown };\n  return typeof rec.station === \"string\" && typeof rec.raw === \"string\";\n}\n\n/**\n * Fetch IEM whole-network current observations (station/raw/coordinates passed through).\n * 拉取 IEM 整网实况观测（station/raw/坐标透传）。\n * No-silent-failure discipline on the fetch side / 不静默纪律的取数面：\n * - 空数组是错误网络名的典型形态（IEM 对未知 network 返回 200 + 空 data，合法网络不会返回空）——显式 throw；\n * - fetch 网络层失败（断网/DNS）包装为中文可读错误（原始 message 保留在文末与 cause）；\n * - 超时/外部 AbortSignal 触发的拒绝不包装、原样透传（保持取消语义）。\n */\nexport async function getMetars(\n  network = \"CN__ASOS\",\n  options: GetMetarsOptions = {},\n): Promise<MetarObservation[]> {\n  // 手工组合超时与外部信号（不依赖 AbortSignal.any：兼容 Node 20 全系；setTimeout 可被测试假时钟接管）\n  const controller = new AbortController();\n  const external = options.signal;\n  const forward = (): void => {\n    controller.abort(external?.reason);\n  };\n  if (external !== undefined) {\n    if (external.aborted) forward();\n    else external.addEventListener(\"abort\", forward, { once: true });\n  }\n  const timer =\n    options.timeoutMs === undefined\n      ? undefined\n      : setTimeout(\n          () =>\n            controller.abort(\n              // 超时中止原因即最终抛出的错误：code \"timeout\"（外部 signal 取消不在此列，reason 原样透传）\n              new MetarSourceError(\n                \"timeout\",\n                network,\n                `IEM 请求超时（>${options.timeoutMs}ms，network=${network}）`,\n              ),\n            ),\n          options.timeoutMs,\n        );\n  try {\n    let res: Response;\n    try {\n      res = await fetch(iemCurrentsUrl(network), { signal: controller.signal });\n    } catch (err) {\n      // 取消/超时引发的拒绝（controller 已中止）原样透传——保持 AbortSignal 语义\n      //（超时场景透传的即上方 MetarSourceError \"timeout\"）；\n      // 其余（断网/DNS 的 TypeError 等）包装为 MetarSourceError \"network\"，原始 message 保留在文末与 cause\n      if (controller.signal.aborted) throw err;\n      const reason = err instanceof Error ? err.message : String(err);\n      throw new MetarSourceError(\n        \"network\",\n        network,\n        `网络请求失败（源：IEM，network=${network}）：请检查网络连通性后重试（${reason}）`,\n        { cause: err },\n      );\n    }\n    if (!res.ok) {\n      throw new MetarSourceError(\n        \"http-error\",\n        network,\n        `IEM HTTP ${res.status}（network=${network}）`,\n      );\n    }\n    let body: unknown;\n    try {\n      body = await res.json();\n    } catch (err) {\n      // HTTP 200 但响应体不是 JSON（企业代理/防火墙拦截页的典型形态）——裸 SyntaxError 打穿属错误面缺口；\n      // 归入 bad-schema 机读码，人话提示指向代理环境。中止引发的拒绝不在此列（保持取消语义透传）\n      if (controller.signal.aborted) throw err;\n      const reason = err instanceof Error ? err.message : String(err);\n      throw new MetarSourceError(\n        \"bad-schema\",\n        network,\n        `IEM 响应不是合法 JSON（可能被代理/防火墙拦截，network=${network}）：${reason}`,\n        { cause: err },\n      );\n    }\n    if (\n      typeof body !== \"object\" ||\n      body === null ||\n      !(\"data\" in body) ||\n      !Array.isArray(body.data)\n    ) {\n      throw new MetarSourceError(\n        \"bad-schema\",\n        network,\n        `IEM 响应异常：缺少 data 数组（network=${network}，schema 不符）`,\n      );\n    }\n    const rows = body.data;\n    if (!rows.every(isObservation)) {\n      throw new MetarSourceError(\n        \"bad-schema\",\n        network,\n        `IEM 响应异常：data 存在 station/raw 非字符串的记录（network=${network}，schema 不符）`,\n      );\n    }\n    if (rows.length === 0) {\n      // 合法网络不会返回空（整网实况端点）——空 data 几乎必然是网络名写错（IEM 对未知网络名返回 200 + 空数组）\n      throw new MetarSourceError(\n        \"empty-data\",\n        network,\n        `IEM 返回空数据（network=${network}）——请核对 IEM 网络名（如 CN__ASOS/RU__ASOS，参考 https://mesonet.agron.iastate.edu/sites/networks.php）`,\n      );\n    }\n    return rows;\n  } finally {\n    if (timer !== undefined) clearTimeout(timer);\n    external?.removeEventListener(\"abort\", forward);\n  }\n}\n\n/**\n * Fetch → parse → locate in one step: returns map-ready report items.\n * 取数 → 解析 → 定位一步到位：返回可直接喂给地图适配器的报文项数组。\n *\n * 定位规则：stations 命中的站用元数据精确坐标（并带站名），未命中的回落源站坐标\n * （IEM 中国站为城市级粗坐标，严肃场景请传站点元数据——见 examples 的 stations.json 用法）；\n * 源站坐标为 null 且无元数据的行跳过。\n * 失败语义（不静默，两种模式）：缺省任一报文解析整体失败（站名/时组缺失）即聚合抛出，绝不静默丢行；\n * 传 options.onUnparseable 则逐行容错——失败行跳过并逐条回调（可观测），好行照常返回。\n */\nexport async function getMetarReports(\n  network = \"CN__ASOS\",\n  options: GetMetarReportsOptions = {},\n): Promise<MetarReportItem[]> {\n  const { stations, onUnparseable, spans, ...fetchOptions } = options;\n  const table = new Map((stations ?? []).map((s) => [s.icao, s] as const));\n  const observations = await getMetars(network, fetchOptions);\n  const items: MetarReportItem[] = [];\n  const failures: string[] = [];\n  for (const obs of observations) {\n    const station = table.get(obs.station);\n    const lat = station?.lat ?? obs.lat;\n    const lon = station?.lon ?? obs.lon;\n    if (lat === null || lon === null) continue;\n    try {\n      items.push({\n        report: parse(obs.raw, spans === false ? { spans: false } : undefined),\n        position: [lat, lon],\n        title: `${obs.station}${station?.name ? ` ${station.name}` : \"\"}`,\n      });\n    } catch (err) {\n      // parse 对字符串输入只抛 MetarParseError（code 稳定契约）；其他异常属编程错误，直接上抛不降级\n      if (!(err instanceof MetarParseError)) throw err;\n      if (onUnparseable !== undefined) {\n        onUnparseable({ station: obs.station, raw: obs.raw, code: err.code, error: err.message });\n        continue;\n      }\n      failures.push(`${obs.station}: ${err.message}`);\n    }\n  }\n  if (failures.length > 0) {\n    // 聚合错误机读化（原裸 Error）：code 'batch-parse-failed' 稳定契约；raw 字段在此承载\n    // 汇总信息（网络名/条数/逐条站名与原因）而非单条报文原文——语义调整见 core/errors.ts 注释\n    const summary = `network=${network}; failures=${failures.length}; ${failures.join(\"; \")}`;\n    throw new MetarParseError(\n      \"batch-parse-failed\",\n      summary,\n      `报文解析失败 ${failures.length} 条（network=${network}）——${failures.slice(0, 3).join(\"；\")}${failures.length > 3 ? \"……\" : \"\"}`,\n    );\n  }\n  return items;\n}\n"],"mappings":"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"}

package/dist/sources.d.cts

@@ -64,6 +64,11 @@ export interface GetMetarReportsOptions extends GetMetarsOptions {
    * 不传时任一失败仍聚合抛出（默认行为不变，全有或全无）。
    */
   onUnparseable?: (failure: UnparseableReport) => void;
+  /**
+   * 紧凑模式：parse 产物剥除全部 span 字段（存储体积约 -32%，入库供屏场景推荐）；
+   * 缺省 undefined = 完整模式（span 在位，原文回溯用）。
+   */
+  spans?: false;
 }
 /**
  * A map-ready report item (structurally compatible with MetarLayerItem): the { report, position, title } triple —

package/dist/sources.d.ts

@@ -64,6 +64,11 @@ export interface GetMetarReportsOptions extends GetMetarsOptions {
    * 不传时任一失败仍聚合抛出（默认行为不变，全有或全无）。
    */
   onUnparseable?: (failure: UnparseableReport) => void;
+  /**
+   * 紧凑模式：parse 产物剥除全部 span 字段（存储体积约 -32%，入库供屏场景推荐）；
+   * 缺省 undefined = 完整模式（span 在位，原文回溯用）。
+   */
+  spans?: false;
 }
 /**
  * A map-ready report item (structurally compatible with MetarLayerItem): the { report, position, title } triple —

package/dist/sources.js

@@ -74,7 +74,7 @@ async function getMetars(network = "CN__ASOS", options = {}) {
 * 传 options.onUnparseable 则逐行容错——失败行跳过并逐条回调（可观测），好行照常返回。
 */
 async function getMetarReports(network = "CN__ASOS", options = {}) {
-	const { stations, onUnparseable, ...fetchOptions } = options;
+	const { stations, onUnparseable, spans, ...fetchOptions } = options;
 	const table = new Map((stations ?? []).map((s) => [s.icao, s]));
 	const observations = await getMetars(network, fetchOptions);
 	const items = [];
@@ -86,7 +86,7 @@ async function getMetarReports(network = "CN__ASOS", options = {}) {
 		if (lat === null || lon === null) continue;
 		try {
 			items.push({
-				report: parse(obs.raw),
+				report: parse(obs.raw, spans === false ? { spans: false } : void 0),
 				position: [lat, lon],
 				title: `${obs.station}${station?.name ? ` ${station.name}` : ""}`
 			});

package/dist/sources.js.map

@@ -1 +1 @@
-{"version":3,"file":"sources.js","names":["MetarSourceError","MetarParseError"],"sources":["../src/sources.ts"],"sourcesContent":["/**\n * metweave/sources — 取数 helper（伞包子路径）。\n *\n * 纪律：只做端点模板 + fetch + 取数侧整理（解析、定位联表）——缓存/质控/归档等\n * 数据管理逻辑永不进入开源包；核心包（core/parser/render）零网络代码。\n * 不静默：HTTP 失败、响应 schema 不符、报文解析失败一律 throw，绝不吞错返回空数组。\n * 错误面机读化：五路失败一律抛 MetarSourceError（code 稳定契约 + network 网络名字段；\n * message 权威文案为中文；英文用 @metweave/core 导出的 EN_MESSAGES[code] 查表，\n * 或渲染层 locale:\"en\" 整卡切换（card locale 已内置 code→英文映射））。\n */\nimport type { MetarReport } from \"@metweave/core\";\nimport type { MetarParseErrorCode } from \"@metweave/core\";\nimport { MetarParseError, MetarSourceError } from \"@metweave/core\";\nimport { parse } from \"@metweave/parser\";\n\n// 错误类复出（API 完整性）：消费方从 sources 子路径 import 即可 catch 两类错误，\n// 不必再从伞包主入口双入口引入（类实体与 core 同一，instanceof 双向成立）。\nexport { MetarParseError, MetarSourceError } from \"@metweave/core\";\n\n/**\n * One fetched observation row: station, verbatim raw report, and source-provided coordinates (city-level for IEM China rows).\n * 单条取数观测行：站名、原样报文、源站坐标（IEM 中国行为城市级粗坐标）。\n */\nexport interface MetarObservation {\n  /** 站名（ICAO） */\n  station: string;\n  /** 报文原文（IEM 通路无类型词，IEM 自带坐标为城市级粗坐标——定位请使用站点元数据） */\n  raw: string;\n  lat: number | null;\n  lon: number | null;\n}\n\n/**\n * Options for getMetars: external abort signal and request timeout (either firing aborts).\n * getMetars 的选项：外部取消信号与请求超时（任一触发即中止）。\n */\nexport interface GetMetarsOptions {\n  /** 外部取消信号（与超时组合，任一触发即中止） */\n  signal?: AbortSignal;\n  /** 请求超时毫秒数（触发即中止并抛出超时错误） */\n  timeoutMs?: number;\n}\n\n/**\n * Station metadata for lookup joins: authoritative coordinates overriding the source's city-level ones.\n * 站点元数据（联表用）：坐标为权威定位源，覆盖源站的城市级粗坐标。\n */\nexport interface StationRef {\n  /** 站名（ICAO） */\n  icao: string;\n  /** 纬度（WGS-84） */\n  lat: number;\n  /** 经度（WGS-84） */\n  lon: number;\n  /** 站点名称（进 tooltip 标题） */\n  name?: string;\n}\n\n/**\n * Per-row failure detail (the onUnparseable callback argument): one observation row failed to parse wholesale (missing station/time etc.).\n * 逐行容错的失败详情（onUnparseable 回调入参）：一行观测报文解析整体失败（站名/时组缺失等）。\n * `code` is the machine-readable failure code (MetarParseError's stable contract); `error` is the narrative message.\n * code 是机读失败码（MetarParseError 的稳定契约），error 是中文 message。\n */\nexport interface UnparseableReport {\n  /** 源站站名（IEM 行的 station 字段） */\n  station: string;\n  /** 报文原文 */\n  raw: string;\n  /** 机读失败码（missing-station / missing-time / invalid-time） */\n  code: MetarParseErrorCode;\n  /** 解析失败原因（Error.message，中文） */\n  error: string;\n}\n\n/**\n * Options for getMetarReports: fetch options plus station metadata and the per-row tolerance callback.\n * getMetarReports 的选项：取数选项 + 站点联表元数据 + 逐行容错回调。\n */\nexport interface GetMetarReportsOptions extends GetMetarsOptions {\n  /** 按 icao 联表的站点元数据：命中则用其精确坐标与名称，未命中回落源站坐标 */\n  stations?: readonly StationRef[];\n  /**\n   * 逐行容错（缺省关闭）：传入时解析失败的行跳过并逐条回调——失败可观测，不静默；\n   * 不传时任一失败仍聚合抛出（默认行为不变，全有或全无）。\n   */\n  onUnparseable?: (failure: UnparseableReport) => void;\n}\n\n/**\n * A map-ready report item (structurally compatible with MetarLayerItem): the { report, position, title } triple —\n * report is the parsed IR (raw text preserved verbatim on report.raw; field values via toValues(report)),\n * position is WGS-84 [lat, lon], title is the hover title.\n * 可直接喂给地图适配器（如 addMetarLayer）的报文项（与 MetarLayerItem 结构兼容）：\n * `{ report, position, title }` 三件套——report 是已解析的 IR（报文原文在 report.raw 原样保真，\n * 需要字段值走 toValues(report)），position 是 WGS-84 [lat, lon]，title 是悬浮提示标题。\n */\nexport interface MetarReportItem {\n  /** 已解析的报文 IR（原文经 report.raw 原样保真回溯） */\n  report: MetarReport;\n  /** 站点坐标（WGS-84 [lat, lon]） */\n  position: [number, number];\n  /** 站点提示（「ICAO 站名」；适配器缺省回落 IR 站名） */\n  title: string;\n}\n\nconst IEM_BASE = \"https://mesonet.agron.iastate.edu\";\n\n/**\n * The IEM whole-network currents endpoint (CORS-open, direct browser access). Defaults to the China ASOS network (39 stations).\n * IEM 整网实况端点（CORS 全开，浏览器可直连）。缺省中国 ASOS 网（39 站）。\n * @param network - IEM network name (e.g. CN__ASOS, RU__ASOS, IA_ASOS). IEM 网络名。\n */\nexport function iemCurrentsUrl(network = \"CN__ASOS\"): string {\n  return `${IEM_BASE}/api/1/currents.json?network=${encodeURIComponent(network)}`;\n}\n\n/** 观测记录守卫：station/raw 均须为字符串（只查键不查类型是旧洞）。 */\nfunction isObservation(v: unknown): v is MetarObservation {\n  if (typeof v !== \"object\" || v === null) return false;\n  const rec = v as { station?: unknown; raw?: unknown };\n  return typeof rec.station === \"string\" && typeof rec.raw === \"string\";\n}\n\n/**\n * Fetch IEM whole-network current observations (station/raw/coordinates passed through).\n * 拉取 IEM 整网实况观测（station/raw/坐标透传）。\n * No-silent-failure discipline on the fetch side / 不静默纪律的取数面：\n * - 空数组是错误网络名的典型形态（IEM 对未知 network 返回 200 + 空 data，合法网络不会返回空）——显式 throw；\n * - fetch 网络层失败（断网/DNS）包装为中文可读错误（原始 message 保留在文末与 cause）；\n * - 超时/外部 AbortSignal 触发的拒绝不包装、原样透传（保持取消语义）。\n */\nexport async function getMetars(\n  network = \"CN__ASOS\",\n  options: GetMetarsOptions = {},\n): Promise<MetarObservation[]> {\n  // 手工组合超时与外部信号（不依赖 AbortSignal.any：兼容 Node 20 全系；setTimeout 可被测试假时钟接管）\n  const controller = new AbortController();\n  const external = options.signal;\n  const forward = (): void => {\n    controller.abort(external?.reason);\n  };\n  if (external !== undefined) {\n    if (external.aborted) forward();\n    else external.addEventListener(\"abort\", forward, { once: true });\n  }\n  const timer =\n    options.timeoutMs === undefined\n      ? undefined\n      : setTimeout(\n          () =>\n            controller.abort(\n              // 超时中止原因即最终抛出的错误：code \"timeout\"（外部 signal 取消不在此列，reason 原样透传）\n              new MetarSourceError(\n                \"timeout\",\n                network,\n                `IEM 请求超时（>${options.timeoutMs}ms，network=${network}）`,\n              ),\n            ),\n          options.timeoutMs,\n        );\n  try {\n    let res: Response;\n    try {\n      res = await fetch(iemCurrentsUrl(network), { signal: controller.signal });\n    } catch (err) {\n      // 取消/超时引发的拒绝（controller 已中止）原样透传——保持 AbortSignal 语义\n      //（超时场景透传的即上方 MetarSourceError \"timeout\"）；\n      // 其余（断网/DNS 的 TypeError 等）包装为 MetarSourceError \"network\"，原始 message 保留在文末与 cause\n      if (controller.signal.aborted) throw err;\n      const reason = err instanceof Error ? err.message : String(err);\n      throw new MetarSourceError(\n        \"network\",\n        network,\n        `网络请求失败（源：IEM，network=${network}）：请检查网络连通性后重试（${reason}）`,\n        { cause: err },\n      );\n    }\n    if (!res.ok) {\n      throw new MetarSourceError(\n        \"http-error\",\n        network,\n        `IEM HTTP ${res.status}（network=${network}）`,\n      );\n    }\n    let body: unknown;\n    try {\n      body = await res.json();\n    } catch (err) {\n      // HTTP 200 但响应体不是 JSON（企业代理/防火墙拦截页的典型形态）——裸 SyntaxError 打穿属错误面缺口；\n      // 归入 bad-schema 机读码，人话提示指向代理环境。中止引发的拒绝不在此列（保持取消语义透传）\n      if (controller.signal.aborted) throw err;\n      const reason = err instanceof Error ? err.message : String(err);\n      throw new MetarSourceError(\n        \"bad-schema\",\n        network,\n        `IEM 响应不是合法 JSON（可能被代理/防火墙拦截，network=${network}）：${reason}`,\n        { cause: err },\n      );\n    }\n    if (\n      typeof body !== \"object\" ||\n      body === null ||\n      !(\"data\" in body) ||\n      !Array.isArray(body.data)\n    ) {\n      throw new MetarSourceError(\n        \"bad-schema\",\n        network,\n        `IEM 响应异常：缺少 data 数组（network=${network}，schema 不符）`,\n      );\n    }\n    const rows = body.data;\n    if (!rows.every(isObservation)) {\n      throw new MetarSourceError(\n        \"bad-schema\",\n        network,\n        `IEM 响应异常：data 存在 station/raw 非字符串的记录（network=${network}，schema 不符）`,\n      );\n    }\n    if (rows.length === 0) {\n      // 合法网络不会返回空（整网实况端点）——空 data 几乎必然是网络名写错（IEM 对未知网络名返回 200 + 空数组）\n      throw new MetarSourceError(\n        \"empty-data\",\n        network,\n        `IEM 返回空数据（network=${network}）——请核对 IEM 网络名（如 CN__ASOS/RU__ASOS，参考 https://mesonet.agron.iastate.edu/sites/networks.php）`,\n      );\n    }\n    return rows;\n  } finally {\n    if (timer !== undefined) clearTimeout(timer);\n    external?.removeEventListener(\"abort\", forward);\n  }\n}\n\n/**\n * Fetch → parse → locate in one step: returns map-ready report items.\n * 取数 → 解析 → 定位一步到位：返回可直接喂给地图适配器的报文项数组。\n *\n * 定位规则：stations 命中的站用元数据精确坐标（并带站名），未命中的回落源站坐标\n * （IEM 中国站为城市级粗坐标，严肃场景请传站点元数据——见 examples 的 stations.json 用法）；\n * 源站坐标为 null 且无元数据的行跳过。\n * 失败语义（不静默，两种模式）：缺省任一报文解析整体失败（站名/时组缺失）即聚合抛出，绝不静默丢行；\n * 传 options.onUnparseable 则逐行容错——失败行跳过并逐条回调（可观测），好行照常返回。\n */\nexport async function getMetarReports(\n  network = \"CN__ASOS\",\n  options: GetMetarReportsOptions = {},\n): Promise<MetarReportItem[]> {\n  const { stations, onUnparseable, ...fetchOptions } = options;\n  const table = new Map((stations ?? []).map((s) => [s.icao, s] as const));\n  const observations = await getMetars(network, fetchOptions);\n  const items: MetarReportItem[] = [];\n  const failures: string[] = [];\n  for (const obs of observations) {\n    const station = table.get(obs.station);\n    const lat = station?.lat ?? obs.lat;\n    const lon = station?.lon ?? obs.lon;\n    if (lat === null || lon === null) continue;\n    try {\n      items.push({\n        report: parse(obs.raw),\n        position: [lat, lon],\n        title: `${obs.station}${station?.name ? ` ${station.name}` : \"\"}`,\n      });\n    } catch (err) {\n      // parse 对字符串输入只抛 MetarParseError（code 稳定契约）；其他异常属编程错误，直接上抛不降级\n      if (!(err instanceof MetarParseError)) throw err;\n      if (onUnparseable !== undefined) {\n        onUnparseable({ station: obs.station, raw: obs.raw, code: err.code, error: err.message });\n        continue;\n      }\n      failures.push(`${obs.station}: ${err.message}`);\n    }\n  }\n  if (failures.length > 0) {\n    // 聚合错误机读化（原裸 Error）：code 'batch-parse-failed' 稳定契约；raw 字段在此承载\n    // 汇总信息（网络名/条数/逐条站名与原因）而非单条报文原文——语义调整见 core/errors.ts 注释\n    const summary = `network=${network}; failures=${failures.length}; ${failures.join(\"; \")}`;\n    throw new MetarParseError(\n      \"batch-parse-failed\",\n      summary,\n      `报文解析失败 ${failures.length} 条（network=${network}）——${failures.slice(0, 3).join(\"；\")}${failures.length > 3 ? \"……\" : \"\"}`,\n    );\n  }\n  return items;\n}\n"],"mappings":"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"}
+{"version":3,"file":"sources.js","names":["MetarSourceError","MetarParseError"],"sources":["../src/sources.ts"],"sourcesContent":["/**\n * metweave/sources — 取数 helper（伞包子路径）。\n *\n * 纪律：只做端点模板 + fetch + 取数侧整理（解析、定位联表）——缓存/质控/归档等\n * 数据管理逻辑永不进入开源包；核心包（core/parser/render）零网络代码。\n * 不静默：HTTP 失败、响应 schema 不符、报文解析失败一律 throw，绝不吞错返回空数组。\n * 错误面机读化：五路失败一律抛 MetarSourceError（code 稳定契约 + network 网络名字段；\n * message 权威文案为中文；英文用 @metweave/core 导出的 EN_MESSAGES[code] 查表，\n * 或渲染层 locale:\"en\" 整卡切换（card locale 已内置 code→英文映射））。\n */\nimport type { MetarReport } from \"@metweave/core\";\nimport type { MetarParseErrorCode } from \"@metweave/core\";\nimport { MetarParseError, MetarSourceError } from \"@metweave/core\";\nimport { parse } from \"@metweave/parser\";\n\n// 错误类复出（API 完整性）：消费方从 sources 子路径 import 即可 catch 两类错误，\n// 不必再从伞包主入口双入口引入（类实体与 core 同一，instanceof 双向成立）。\nexport { MetarParseError, MetarSourceError } from \"@metweave/core\";\n\n/**\n * One fetched observation row: station, verbatim raw report, and source-provided coordinates (city-level for IEM China rows).\n * 单条取数观测行：站名、原样报文、源站坐标（IEM 中国行为城市级粗坐标）。\n */\nexport interface MetarObservation {\n  /** 站名（ICAO） */\n  station: string;\n  /** 报文原文（IEM 通路无类型词，IEM 自带坐标为城市级粗坐标——定位请使用站点元数据） */\n  raw: string;\n  lat: number | null;\n  lon: number | null;\n}\n\n/**\n * Options for getMetars: external abort signal and request timeout (either firing aborts).\n * getMetars 的选项：外部取消信号与请求超时（任一触发即中止）。\n */\nexport interface GetMetarsOptions {\n  /** 外部取消信号（与超时组合，任一触发即中止） */\n  signal?: AbortSignal;\n  /** 请求超时毫秒数（触发即中止并抛出超时错误） */\n  timeoutMs?: number;\n}\n\n/**\n * Station metadata for lookup joins: authoritative coordinates overriding the source's city-level ones.\n * 站点元数据（联表用）：坐标为权威定位源，覆盖源站的城市级粗坐标。\n */\nexport interface StationRef {\n  /** 站名（ICAO） */\n  icao: string;\n  /** 纬度（WGS-84） */\n  lat: number;\n  /** 经度（WGS-84） */\n  lon: number;\n  /** 站点名称（进 tooltip 标题） */\n  name?: string;\n}\n\n/**\n * Per-row failure detail (the onUnparseable callback argument): one observation row failed to parse wholesale (missing station/time etc.).\n * 逐行容错的失败详情（onUnparseable 回调入参）：一行观测报文解析整体失败（站名/时组缺失等）。\n * `code` is the machine-readable failure code (MetarParseError's stable contract); `error` is the narrative message.\n * code 是机读失败码（MetarParseError 的稳定契约），error 是中文 message。\n */\nexport interface UnparseableReport {\n  /** 源站站名（IEM 行的 station 字段） */\n  station: string;\n  /** 报文原文 */\n  raw: string;\n  /** 机读失败码（missing-station / missing-time / invalid-time） */\n  code: MetarParseErrorCode;\n  /** 解析失败原因（Error.message，中文） */\n  error: string;\n}\n\n/**\n * Options for getMetarReports: fetch options plus station metadata and the per-row tolerance callback.\n * getMetarReports 的选项：取数选项 + 站点联表元数据 + 逐行容错回调。\n */\nexport interface GetMetarReportsOptions extends GetMetarsOptions {\n  /** 按 icao 联表的站点元数据：命中则用其精确坐标与名称，未命中回落源站坐标 */\n  stations?: readonly StationRef[];\n  /**\n   * 逐行容错（缺省关闭）：传入时解析失败的行跳过并逐条回调——失败可观测，不静默；\n   * 不传时任一失败仍聚合抛出（默认行为不变，全有或全无）。\n   */\n  onUnparseable?: (failure: UnparseableReport) => void;\n  /**\n   * 紧凑模式：parse 产物剥除全部 span 字段（存储体积约 -32%，入库供屏场景推荐）；\n   * 缺省 undefined = 完整模式（span 在位，原文回溯用）。\n   */\n  spans?: false;\n}\n\n/**\n * A map-ready report item (structurally compatible with MetarLayerItem): the { report, position, title } triple —\n * report is the parsed IR (raw text preserved verbatim on report.raw; field values via toValues(report)),\n * position is WGS-84 [lat, lon], title is the hover title.\n * 可直接喂给地图适配器（如 addMetarLayer）的报文项（与 MetarLayerItem 结构兼容）：\n * `{ report, position, title }` 三件套——report 是已解析的 IR（报文原文在 report.raw 原样保真，\n * 需要字段值走 toValues(report)），position 是 WGS-84 [lat, lon]，title 是悬浮提示标题。\n */\nexport interface MetarReportItem {\n  /** 已解析的报文 IR（原文经 report.raw 原样保真回溯） */\n  report: MetarReport;\n  /** 站点坐标（WGS-84 [lat, lon]） */\n  position: [number, number];\n  /** 站点提示（「ICAO 站名」；适配器缺省回落 IR 站名） */\n  title: string;\n}\n\nconst IEM_BASE = \"https://mesonet.agron.iastate.edu\";\n\n/**\n * The IEM whole-network currents endpoint (CORS-open, direct browser access). Defaults to the China ASOS network (39 stations).\n * IEM 整网实况端点（CORS 全开，浏览器可直连）。缺省中国 ASOS 网（39 站）。\n * @param network - IEM network name (e.g. CN__ASOS, RU__ASOS, IA_ASOS). IEM 网络名。\n */\nexport function iemCurrentsUrl(network = \"CN__ASOS\"): string {\n  return `${IEM_BASE}/api/1/currents.json?network=${encodeURIComponent(network)}`;\n}\n\n/** 观测记录守卫：station/raw 均须为字符串（只查键不查类型是旧洞）。 */\nfunction isObservation(v: unknown): v is MetarObservation {\n  if (typeof v !== \"object\" || v === null) return false;\n  const rec = v as { station?: unknown; raw?: unknown };\n  return typeof rec.station === \"string\" && typeof rec.raw === \"string\";\n}\n\n/**\n * Fetch IEM whole-network current observations (station/raw/coordinates passed through).\n * 拉取 IEM 整网实况观测（station/raw/坐标透传）。\n * No-silent-failure discipline on the fetch side / 不静默纪律的取数面：\n * - 空数组是错误网络名的典型形态（IEM 对未知 network 返回 200 + 空 data，合法网络不会返回空）——显式 throw；\n * - fetch 网络层失败（断网/DNS）包装为中文可读错误（原始 message 保留在文末与 cause）；\n * - 超时/外部 AbortSignal 触发的拒绝不包装、原样透传（保持取消语义）。\n */\nexport async function getMetars(\n  network = \"CN__ASOS\",\n  options: GetMetarsOptions = {},\n): Promise<MetarObservation[]> {\n  // 手工组合超时与外部信号（不依赖 AbortSignal.any：兼容 Node 20 全系；setTimeout 可被测试假时钟接管）\n  const controller = new AbortController();\n  const external = options.signal;\n  const forward = (): void => {\n    controller.abort(external?.reason);\n  };\n  if (external !== undefined) {\n    if (external.aborted) forward();\n    else external.addEventListener(\"abort\", forward, { once: true });\n  }\n  const timer =\n    options.timeoutMs === undefined\n      ? undefined\n      : setTimeout(\n          () =>\n            controller.abort(\n              // 超时中止原因即最终抛出的错误：code \"timeout\"（外部 signal 取消不在此列，reason 原样透传）\n              new MetarSourceError(\n                \"timeout\",\n                network,\n                `IEM 请求超时（>${options.timeoutMs}ms，network=${network}）`,\n              ),\n            ),\n          options.timeoutMs,\n        );\n  try {\n    let res: Response;\n    try {\n      res = await fetch(iemCurrentsUrl(network), { signal: controller.signal });\n    } catch (err) {\n      // 取消/超时引发的拒绝（controller 已中止）原样透传——保持 AbortSignal 语义\n      //（超时场景透传的即上方 MetarSourceError \"timeout\"）；\n      // 其余（断网/DNS 的 TypeError 等）包装为 MetarSourceError \"network\"，原始 message 保留在文末与 cause\n      if (controller.signal.aborted) throw err;\n      const reason = err instanceof Error ? err.message : String(err);\n      throw new MetarSourceError(\n        \"network\",\n        network,\n        `网络请求失败（源：IEM，network=${network}）：请检查网络连通性后重试（${reason}）`,\n        { cause: err },\n      );\n    }\n    if (!res.ok) {\n      throw new MetarSourceError(\n        \"http-error\",\n        network,\n        `IEM HTTP ${res.status}（network=${network}）`,\n      );\n    }\n    let body: unknown;\n    try {\n      body = await res.json();\n    } catch (err) {\n      // HTTP 200 但响应体不是 JSON（企业代理/防火墙拦截页的典型形态）——裸 SyntaxError 打穿属错误面缺口；\n      // 归入 bad-schema 机读码，人话提示指向代理环境。中止引发的拒绝不在此列（保持取消语义透传）\n      if (controller.signal.aborted) throw err;\n      const reason = err instanceof Error ? err.message : String(err);\n      throw new MetarSourceError(\n        \"bad-schema\",\n        network,\n        `IEM 响应不是合法 JSON（可能被代理/防火墙拦截，network=${network}）：${reason}`,\n        { cause: err },\n      );\n    }\n    if (\n      typeof body !== \"object\" ||\n      body === null ||\n      !(\"data\" in body) ||\n      !Array.isArray(body.data)\n    ) {\n      throw new MetarSourceError(\n        \"bad-schema\",\n        network,\n        `IEM 响应异常：缺少 data 数组（network=${network}，schema 不符）`,\n      );\n    }\n    const rows = body.data;\n    if (!rows.every(isObservation)) {\n      throw new MetarSourceError(\n        \"bad-schema\",\n        network,\n        `IEM 响应异常：data 存在 station/raw 非字符串的记录（network=${network}，schema 不符）`,\n      );\n    }\n    if (rows.length === 0) {\n      // 合法网络不会返回空（整网实况端点）——空 data 几乎必然是网络名写错（IEM 对未知网络名返回 200 + 空数组）\n      throw new MetarSourceError(\n        \"empty-data\",\n        network,\n        `IEM 返回空数据（network=${network}）——请核对 IEM 网络名（如 CN__ASOS/RU__ASOS，参考 https://mesonet.agron.iastate.edu/sites/networks.php）`,\n      );\n    }\n    return rows;\n  } finally {\n    if (timer !== undefined) clearTimeout(timer);\n    external?.removeEventListener(\"abort\", forward);\n  }\n}\n\n/**\n * Fetch → parse → locate in one step: returns map-ready report items.\n * 取数 → 解析 → 定位一步到位：返回可直接喂给地图适配器的报文项数组。\n *\n * 定位规则：stations 命中的站用元数据精确坐标（并带站名），未命中的回落源站坐标\n * （IEM 中国站为城市级粗坐标，严肃场景请传站点元数据——见 examples 的 stations.json 用法）；\n * 源站坐标为 null 且无元数据的行跳过。\n * 失败语义（不静默，两种模式）：缺省任一报文解析整体失败（站名/时组缺失）即聚合抛出，绝不静默丢行；\n * 传 options.onUnparseable 则逐行容错——失败行跳过并逐条回调（可观测），好行照常返回。\n */\nexport async function getMetarReports(\n  network = \"CN__ASOS\",\n  options: GetMetarReportsOptions = {},\n): Promise<MetarReportItem[]> {\n  const { stations, onUnparseable, spans, ...fetchOptions } = options;\n  const table = new Map((stations ?? []).map((s) => [s.icao, s] as const));\n  const observations = await getMetars(network, fetchOptions);\n  const items: MetarReportItem[] = [];\n  const failures: string[] = [];\n  for (const obs of observations) {\n    const station = table.get(obs.station);\n    const lat = station?.lat ?? obs.lat;\n    const lon = station?.lon ?? obs.lon;\n    if (lat === null || lon === null) continue;\n    try {\n      items.push({\n        report: parse(obs.raw, spans === false ? { spans: false } : undefined),\n        position: [lat, lon],\n        title: `${obs.station}${station?.name ? ` ${station.name}` : \"\"}`,\n      });\n    } catch (err) {\n      // parse 对字符串输入只抛 MetarParseError（code 稳定契约）；其他异常属编程错误，直接上抛不降级\n      if (!(err instanceof MetarParseError)) throw err;\n      if (onUnparseable !== undefined) {\n        onUnparseable({ station: obs.station, raw: obs.raw, code: err.code, error: err.message });\n        continue;\n      }\n      failures.push(`${obs.station}: ${err.message}`);\n    }\n  }\n  if (failures.length > 0) {\n    // 聚合错误机读化（原裸 Error）：code 'batch-parse-failed' 稳定契约；raw 字段在此承载\n    // 汇总信息（网络名/条数/逐条站名与原因）而非单条报文原文——语义调整见 core/errors.ts 注释\n    const summary = `network=${network}; failures=${failures.length}; ${failures.join(\"; \")}`;\n    throw new MetarParseError(\n      \"batch-parse-failed\",\n      summary,\n      `报文解析失败 ${failures.length} 条（network=${network}）——${failures.slice(0, 3).join(\"；\")}${failures.length > 3 ? \"……\" : \"\"}`,\n    );\n  }\n  return items;\n}\n"],"mappings":"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"}

package/dist/stations-cn.cjs

@@ -0,0 +1,283 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#endregion
+//#region src/stations-cn.ts
+/** 中国 39 站整网元数据（可直接传给 `getMetarReports` 的 `stations` 参数） */
+const CN_STATIONS = [
+	{
+		icao: "ZBAA",
+		name: "Beijing Intl, BJ, CN",
+		lat: 40.082,
+		lon: 116.603,
+		elevM: 31
+	},
+	{
+		icao: "ZBAD",
+		name: "Beijing/Daxing Arpt, BJ, CN",
+		lat: 39.501,
+		lon: 116.412,
+		elevM: 25
+	},
+	{
+		icao: "ZBTJ",
+		name: "Tianjin/Binhai Intl, TJ, CN",
+		lat: 39.124,
+		lon: 117.346,
+		elevM: 4
+	},
+	{
+		icao: "ZBSJ",
+		name: "Zhengding Arpt, HA, CN",
+		lat: 38.281,
+		lon: 114.697,
+		elevM: 70
+	},
+	{
+		icao: "ZBHH",
+		name: "Hohhot/Baita Intl, NM, CN",
+		lat: 40.854,
+		lon: 111.827,
+		elevM: 1081
+	},
+	{
+		icao: "ZBYN",
+		name: "Taiyuan/Wusu Intl, SX, CN",
+		lat: 37.747,
+		lon: 112.628,
+		elevM: 778
+	},
+	{
+		icao: "ZSPD",
+		name: "Shanghai/Pudong Intl, SH, CN",
+		lat: 31.146,
+		lon: 121.8,
+		elevM: 4
+	},
+	{
+		icao: "ZSSS",
+		name: "Shanghai/Hongqiao Intl, SH, CN",
+		lat: 31.209,
+		lon: 121.337,
+		elevM: 2
+	},
+	{
+		icao: "ZSHC",
+		name: "Hangzhou/Xiaoshan Intl, ZJ, CN",
+		lat: 30.229,
+		lon: 120.434,
+		elevM: 8
+	},
+	{
+		icao: "ZSNJ",
+		name: "Nanjing/Lukou Intl, JS, CN",
+		lat: 31.739,
+		lon: 118.863,
+		elevM: 27
+	},
+	{
+		icao: "ZSNB",
+		name: "Ningbo/Lishe Intl, ZJ, CN",
+		lat: 29.827,
+		lon: 121.462,
+		elevM: 5
+	},
+	{
+		icao: "ZSQD",
+		name: "Qingdao/Jiaodong Arpt, SD, CN",
+		lat: 36.362,
+		lon: 120.087,
+		elevM: 2
+	},
+	{
+		icao: "ZSAM",
+		name: "Xiamen-Gaoqi Intl, FJ, CN",
+		lat: 24.546,
+		lon: 118.131,
+		elevM: 13
+	},
+	{
+		icao: "ZSFZ",
+		name: "Fuzhou/Changle Intl, FJ, CN",
+		lat: 25.936,
+		lon: 119.666,
+		elevM: 14
+	},
+	{
+		icao: "ZSOF",
+		name: "Hefei/Xinqiao Intl, AH, CN",
+		lat: 31.99,
+		lon: 116.965,
+		elevM: 64
+	},
+	{
+		icao: "ZGGG",
+		name: "Guangzhou/Baiyun Intl, GD, CN",
+		lat: 23.392,
+		lon: 113.307,
+		elevM: 11
+	},
+	{
+		icao: "ZGSZ",
+		name: "Shenzhen/Boan Intl, GD, CN",
+		lat: 22.639,
+		lon: 113.803,
+		elevM: 18
+	},
+	{
+		icao: "ZGOW",
+		name: "Jieyang/Chaoshan Intl, GD, CN",
+		lat: 23.55,
+		lon: 116.505,
+		elevM: 4
+	},
+	{
+		icao: "ZGKL",
+		name: "Guilin/Liangjiang Intl, GX, CN",
+		lat: 25.22,
+		lon: 110.04,
+		elevM: 151
+	},
+	{
+		icao: "ZGNN",
+		name: "Nanning/Wuwei Intl, GX, CN",
+		lat: 22.609,
+		lon: 108.173,
+		elevM: 128
+	},
+	{
+		icao: "ZGHA",
+		name: "Changsha/Huanghua Arpt, HN, CN",
+		lat: 28.18,
+		lon: 113.219,
+		elevM: 61
+	},
+	{
+		icao: "ZHCC",
+		name: "Zhengzhou/Xinzheng Arpt, HA, CN",
+		lat: 34.52,
+		lon: 113.834,
+		elevM: 149
+	},
+	{
+		icao: "ZHEC",
+		name: "Ezhou Huahu Arpt, HB, CN",
+		lat: 30.3424,
+		lon: 115.0389,
+		elevM: 21
+	},
+	{
+		icao: "ZHHH",
+		name: "Wuhan/Tianhe Intl, HB, CN",
+		lat: 30.783,
+		lon: 114.205,
+		elevM: 33
+	},
+	{
+		icao: "ZJHK",
+		name: "Haikou/Meilan Intl, HI, CN",
+		lat: 19.934,
+		lon: 110.445,
+		elevM: 21
+	},
+	{
+		icao: "ZJSY",
+		name: "Sanya/Phoenix Intl, HN, CN",
+		lat: 18.303,
+		lon: 109.412,
+		elevM: 27
+	},
+	{
+		icao: "ZUUU",
+		name: "Chengdu/Shuangliu Intl, CQ, CN",
+		lat: 30.576,
+		lon: 103.95,
+		elevM: 494
+	},
+	{
+		icao: "ZUTF",
+		name: "Chengdu/Tianfu Arpt, CQ, CN",
+		lat: 30.304,
+		lon: 104.436,
+		elevM: 443
+	},
+	{
+		icao: "ZUCK",
+		name: "Chongqing/Jiangbei Intl, CQ, CN",
+		lat: 29.718,
+		lon: 106.639,
+		elevM: 416
+	},
+	{
+		icao: "ZUGY",
+		name: "Guizhou/Longdongbao Arpt, GZ, CN",
+		lat: 26.538,
+		lon: 106.801,
+		elevM: 1130
+	},
+	{
+		icao: "ZPPP",
+		name: "Kunming/Changshui Intl, YN, CN",
+		lat: 25.107,
+		lon: 102.934,
+		elevM: 2104
+	},
+	{
+		icao: "ZLLL",
+		name: "Lanzhou/Zhongchuan Arpt, GS, CN",
+		lat: 36.513,
+		lon: 103.623,
+		elevM: 1939
+	},
+	{
+		icao: "ZLXY",
+		name: "Xianyang Intl, SN, CN",
+		lat: 34.449,
+		lon: 108.752,
+		elevM: 478
+	},
+	{
+		icao: "ZWWW",
+		name: "Ürümqi/Diwopu Arpt, XJ, CN",
+		lat: 43.907,
+		lon: 87.474,
+		elevM: 654
+	},
+	{
+		icao: "ZWSH",
+		name: "Kashgar Arpt, XJ, CN",
+		lat: 39.542,
+		lon: 76.019,
+		elevM: 1374
+	},
+	{
+		icao: "ZYHB",
+		name: "Harbin/Taiping Arpt, HL, CN",
+		lat: 45.628,
+		lon: 126.259,
+		elevM: 134
+	},
+	{
+		icao: "ZYCC",
+		name: "Changchun/Longjia Intl, JL, CN",
+		lat: 43.993,
+		lon: 125.682,
+		elevM: 211
+	},
+	{
+		icao: "ZYTL",
+		name: "Dalian/Zhoushuizi Intl, LN, CN",
+		lat: 38.961,
+		lon: 121.556,
+		elevM: 33
+	},
+	{
+		icao: "ZYTX",
+		name: "Shenyang/Taoxian Intl, LN, CN",
+		lat: 41.639,
+		lon: 123.485,
+		elevM: 56
+	}
+];
+//#endregion
+exports.CN_STATIONS = CN_STATIONS;
+
+//# sourceMappingURL=stations-cn.cjs.map

package/dist/stations-cn.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stations-cn.cjs","names":[],"sources":["../src/stations-cn.data.ts","../src/stations-cn.ts"],"sourcesContent":["/**\n * 由 `pnpm gen:stations` 机械再生——单一来源 = aviationweather.gov/api/data/metar 一次拉取\n * （采集纪律与字段口径见 scripts/generate-stations.mjs）；请勿手改。\n * 生成时刻：2026-09-11T08:29:45.262Z\n */\n\nexport interface CnStationRaw {\n  icao: string;\n  name: string;\n  lat: number;\n  lon: number;\n  elevM: number;\n}\n\nexport const CN_STATIONS_SOURCE = \"aviationweather.gov/api/data/metar\";\n\nexport const CN_STATIONS_GENERATED_AT = \"2026-09-11T08:29:45.262Z\";\n\nexport const CN_STATIONS_DATA: readonly CnStationRaw[] = [\n  {\n    icao: \"ZBAA\",\n    name: \"Beijing Intl, BJ, CN\",\n    lat: 40.082,\n    lon: 116.603,\n    elevM: 31,\n  },\n  {\n    icao: \"ZBAD\",\n    name: \"Beijing/Daxing Arpt, BJ, CN\",\n    lat: 39.501,\n    lon: 116.412,\n    elevM: 25,\n  },\n  {\n    icao: \"ZBTJ\",\n    name: \"Tianjin/Binhai Intl, TJ, CN\",\n    lat: 39.124,\n    lon: 117.346,\n    elevM: 4,\n  },\n  {\n    icao: \"ZBSJ\",\n    name: \"Zhengding Arpt, HA, CN\",\n    lat: 38.281,\n    lon: 114.697,\n    elevM: 70,\n  },\n  {\n    icao: \"ZBHH\",\n    name: \"Hohhot/Baita Intl, NM, CN\",\n    lat: 40.854,\n    lon: 111.827,\n    elevM: 1081,\n  },\n  {\n    icao: \"ZBYN\",\n    name: \"Taiyuan/Wusu Intl, SX, CN\",\n    lat: 37.747,\n    lon: 112.628,\n    elevM: 778,\n  },\n  {\n    icao: \"ZSPD\",\n    name: \"Shanghai/Pudong Intl, SH, CN\",\n    lat: 31.146,\n    lon: 121.8,\n    elevM: 4,\n  },\n  {\n    icao: \"ZSSS\",\n    name: \"Shanghai/Hongqiao Intl, SH, CN\",\n    lat: 31.209,\n    lon: 121.337,\n    elevM: 2,\n  },\n  {\n    icao: \"ZSHC\",\n    name: \"Hangzhou/Xiaoshan Intl, ZJ, CN\",\n    lat: 30.229,\n    lon: 120.434,\n    elevM: 8,\n  },\n  {\n    icao: \"ZSNJ\",\n    name: \"Nanjing/Lukou Intl, JS, CN\",\n    lat: 31.739,\n    lon: 118.863,\n    elevM: 27,\n  },\n  {\n    icao: \"ZSNB\",\n    name: \"Ningbo/Lishe Intl, ZJ, CN\",\n    lat: 29.827,\n    lon: 121.462,\n    elevM: 5,\n  },\n  {\n    icao: \"ZSQD\",\n    name: \"Qingdao/Jiaodong Arpt, SD, CN\",\n    lat: 36.362,\n    lon: 120.087,\n    elevM: 2,\n  },\n  {\n    icao: \"ZSAM\",\n    name: \"Xiamen-Gaoqi Intl, FJ, CN\",\n    lat: 24.546,\n    lon: 118.131,\n    elevM: 13,\n  },\n  {\n    icao: \"ZSFZ\",\n    name: \"Fuzhou/Changle Intl, FJ, CN\",\n    lat: 25.936,\n    lon: 119.666,\n    elevM: 14,\n  },\n  {\n    icao: \"ZSOF\",\n    name: \"Hefei/Xinqiao Intl, AH, CN\",\n    lat: 31.99,\n    lon: 116.965,\n    elevM: 64,\n  },\n  {\n    icao: \"ZGGG\",\n    name: \"Guangzhou/Baiyun Intl, GD, CN\",\n    lat: 23.392,\n    lon: 113.307,\n    elevM: 11,\n  },\n  {\n    icao: \"ZGSZ\",\n    name: \"Shenzhen/Boan Intl, GD, CN\",\n    lat: 22.639,\n    lon: 113.803,\n    elevM: 18,\n  },\n  {\n    icao: \"ZGOW\",\n    name: \"Jieyang/Chaoshan Intl, GD, CN\",\n    lat: 23.55,\n    lon: 116.505,\n    elevM: 4,\n  },\n  {\n    icao: \"ZGKL\",\n    name: \"Guilin/Liangjiang Intl, GX, CN\",\n    lat: 25.22,\n    lon: 110.04,\n    elevM: 151,\n  },\n  {\n    icao: \"ZGNN\",\n    name: \"Nanning/Wuwei Intl, GX, CN\",\n    lat: 22.609,\n    lon: 108.173,\n    elevM: 128,\n  },\n  {\n    icao: \"ZGHA\",\n    name: \"Changsha/Huanghua Arpt, HN, CN\",\n    lat: 28.18,\n    lon: 113.219,\n    elevM: 61,\n  },\n  {\n    icao: \"ZHCC\",\n    name: \"Zhengzhou/Xinzheng Arpt, HA, CN\",\n    lat: 34.52,\n    lon: 113.834,\n    elevM: 149,\n  },\n  {\n    icao: \"ZHEC\",\n    name: \"Ezhou Huahu Arpt, HB, CN\",\n    lat: 30.3424,\n    lon: 115.0389,\n    elevM: 21,\n  },\n  {\n    icao: \"ZHHH\",\n    name: \"Wuhan/Tianhe Intl, HB, CN\",\n    lat: 30.783,\n    lon: 114.205,\n    elevM: 33,\n  },\n  {\n    icao: \"ZJHK\",\n    name: \"Haikou/Meilan Intl, HI, CN\",\n    lat: 19.934,\n    lon: 110.445,\n    elevM: 21,\n  },\n  {\n    icao: \"ZJSY\",\n    name: \"Sanya/Phoenix Intl, HN, CN\",\n    lat: 18.303,\n    lon: 109.412,\n    elevM: 27,\n  },\n  {\n    icao: \"ZUUU\",\n    name: \"Chengdu/Shuangliu Intl, CQ, CN\",\n    lat: 30.576,\n    lon: 103.95,\n    elevM: 494,\n  },\n  {\n    icao: \"ZUTF\",\n    name: \"Chengdu/Tianfu Arpt, CQ, CN\",\n    lat: 30.304,\n    lon: 104.436,\n    elevM: 443,\n  },\n  {\n    icao: \"ZUCK\",\n    name: \"Chongqing/Jiangbei Intl, CQ, CN\",\n    lat: 29.718,\n    lon: 106.639,\n    elevM: 416,\n  },\n  {\n    icao: \"ZUGY\",\n    name: \"Guizhou/Longdongbao Arpt, GZ, CN\",\n    lat: 26.538,\n    lon: 106.801,\n    elevM: 1130,\n  },\n  {\n    icao: \"ZPPP\",\n    name: \"Kunming/Changshui Intl, YN, CN\",\n    lat: 25.107,\n    lon: 102.934,\n    elevM: 2104,\n  },\n  {\n    icao: \"ZLLL\",\n    name: \"Lanzhou/Zhongchuan Arpt, GS, CN\",\n    lat: 36.513,\n    lon: 103.623,\n    elevM: 1939,\n  },\n  {\n    icao: \"ZLXY\",\n    name: \"Xianyang Intl, SN, CN\",\n    lat: 34.449,\n    lon: 108.752,\n    elevM: 478,\n  },\n  {\n    icao: \"ZWWW\",\n    name: \"\\u00dcr\\u00fcmqi/Diwopu Arpt, XJ, CN\",\n    lat: 43.907,\n    lon: 87.474,\n    elevM: 654,\n  },\n  {\n    icao: \"ZWSH\",\n    name: \"Kashgar Arpt, XJ, CN\",\n    lat: 39.542,\n    lon: 76.019,\n    elevM: 1374,\n  },\n  {\n    icao: \"ZYHB\",\n    name: \"Harbin/Taiping Arpt, HL, CN\",\n    lat: 45.628,\n    lon: 126.259,\n    elevM: 134,\n  },\n  {\n    icao: \"ZYCC\",\n    name: \"Changchun/Longjia Intl, JL, CN\",\n    lat: 43.993,\n    lon: 125.682,\n    elevM: 211,\n  },\n  {\n    icao: \"ZYTL\",\n    name: \"Dalian/Zhoushuizi Intl, LN, CN\",\n    lat: 38.961,\n    lon: 121.556,\n    elevM: 33,\n  },\n  {\n    icao: \"ZYTX\",\n    name: \"Shenyang/Taoxian Intl, LN, CN\",\n    lat: 41.639,\n    lon: 123.485,\n    elevM: 56,\n  },\n];\n","/**\n * `metweave/stations-cn` —— 中国 39 站静态元数据（ICAO / 名称 / WGS-84 坐标 / 标高米）。\n *\n * 数据来源 aviationweather.gov（一次采集，`pnpm gen:stations` 单源再生，见 stations-cn.data.ts 头注）；\n * 用途：`getMetarReports(network, { stations })` 联表——IEM 自带的站点坐标是城市级粗定位，\n * 传入本表即得精确机场坐标与站名（「四字码 → 站名」开箱即用）。\n * 事实性元数据，随包分发；观测报文数据不在此列（许可边界见主 README「许可」）。\n */\nimport type { StationRef } from \"./sources.js\";\nimport { CN_STATIONS_DATA } from \"./stations-cn.data.js\";\n\n/** 一个中国站点的静态元数据（StationRef 联表形态 + 标高） */\nexport interface CnStation extends StationRef {\n  /** 标高（米，上游即米制口径） */\n  elevM: number;\n}\n\n/** 中国 39 站整网元数据（可直接传给 `getMetarReports` 的 `stations` 参数） */\nexport const CN_STATIONS: readonly CnStation[] = CN_STATIONS_DATA;\n"],"mappings":";;;;ACkBA,MAAa,cAAoC;CDC/C;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;ACjR+C"}

package/dist/stations-cn.d.cts

@@ -0,0 +1,11 @@
+import { StationRef } from "./sources.cjs";
+//#region src/stations-cn.d.ts
+/** 一个中国站点的静态元数据（StationRef 联表形态 + 标高） */
+export interface CnStation extends StationRef {
+  /** 标高（米，上游即米制口径） */
+  elevM: number;
+}
+/** 中国 39 站整网元数据（可直接传给 `getMetarReports` 的 `stations` 参数） */
+export declare const CN_STATIONS: readonly CnStation[];
+//#endregion
+//# sourceMappingURL=stations-cn.d.cts.map

package/dist/stations-cn.d.ts

@@ -0,0 +1,11 @@
+import { StationRef } from "./sources.js";
+//#region src/stations-cn.d.ts
+/** 一个中国站点的静态元数据（StationRef 联表形态 + 标高） */
+export interface CnStation extends StationRef {
+  /** 标高（米，上游即米制口径） */
+  elevM: number;
+}
+/** 中国 39 站整网元数据（可直接传给 `getMetarReports` 的 `stations` 参数） */
+export declare const CN_STATIONS: readonly CnStation[];
+//#endregion
+//# sourceMappingURL=stations-cn.d.ts.map

package/dist/stations-cn.js

@@ -0,0 +1,282 @@
+//#endregion
+//#region src/stations-cn.ts
+/** 中国 39 站整网元数据（可直接传给 `getMetarReports` 的 `stations` 参数） */
+const CN_STATIONS = [
+	{
+		icao: "ZBAA",
+		name: "Beijing Intl, BJ, CN",
+		lat: 40.082,
+		lon: 116.603,
+		elevM: 31
+	},
+	{
+		icao: "ZBAD",
+		name: "Beijing/Daxing Arpt, BJ, CN",
+		lat: 39.501,
+		lon: 116.412,
+		elevM: 25
+	},
+	{
+		icao: "ZBTJ",
+		name: "Tianjin/Binhai Intl, TJ, CN",
+		lat: 39.124,
+		lon: 117.346,
+		elevM: 4
+	},
+	{
+		icao: "ZBSJ",
+		name: "Zhengding Arpt, HA, CN",
+		lat: 38.281,
+		lon: 114.697,
+		elevM: 70
+	},
+	{
+		icao: "ZBHH",
+		name: "Hohhot/Baita Intl, NM, CN",
+		lat: 40.854,
+		lon: 111.827,
+		elevM: 1081
+	},
+	{
+		icao: "ZBYN",
+		name: "Taiyuan/Wusu Intl, SX, CN",
+		lat: 37.747,
+		lon: 112.628,
+		elevM: 778
+	},
+	{
+		icao: "ZSPD",
+		name: "Shanghai/Pudong Intl, SH, CN",
+		lat: 31.146,
+		lon: 121.8,
+		elevM: 4
+	},
+	{
+		icao: "ZSSS",
+		name: "Shanghai/Hongqiao Intl, SH, CN",
+		lat: 31.209,
+		lon: 121.337,
+		elevM: 2
+	},
+	{
+		icao: "ZSHC",
+		name: "Hangzhou/Xiaoshan Intl, ZJ, CN",
+		lat: 30.229,
+		lon: 120.434,
+		elevM: 8
+	},
+	{
+		icao: "ZSNJ",
+		name: "Nanjing/Lukou Intl, JS, CN",
+		lat: 31.739,
+		lon: 118.863,
+		elevM: 27
+	},
+	{
+		icao: "ZSNB",
+		name: "Ningbo/Lishe Intl, ZJ, CN",
+		lat: 29.827,
+		lon: 121.462,
+		elevM: 5
+	},
+	{
+		icao: "ZSQD",
+		name: "Qingdao/Jiaodong Arpt, SD, CN",
+		lat: 36.362,
+		lon: 120.087,
+		elevM: 2
+	},
+	{
+		icao: "ZSAM",
+		name: "Xiamen-Gaoqi Intl, FJ, CN",
+		lat: 24.546,
+		lon: 118.131,
+		elevM: 13
+	},
+	{
+		icao: "ZSFZ",
+		name: "Fuzhou/Changle Intl, FJ, CN",
+		lat: 25.936,
+		lon: 119.666,
+		elevM: 14
+	},
+	{
+		icao: "ZSOF",
+		name: "Hefei/Xinqiao Intl, AH, CN",
+		lat: 31.99,
+		lon: 116.965,
+		elevM: 64
+	},
+	{
+		icao: "ZGGG",
+		name: "Guangzhou/Baiyun Intl, GD, CN",
+		lat: 23.392,
+		lon: 113.307,
+		elevM: 11
+	},
+	{
+		icao: "ZGSZ",
+		name: "Shenzhen/Boan Intl, GD, CN",
+		lat: 22.639,
+		lon: 113.803,
+		elevM: 18
+	},
+	{
+		icao: "ZGOW",
+		name: "Jieyang/Chaoshan Intl, GD, CN",
+		lat: 23.55,
+		lon: 116.505,
+		elevM: 4
+	},
+	{
+		icao: "ZGKL",
+		name: "Guilin/Liangjiang Intl, GX, CN",
+		lat: 25.22,
+		lon: 110.04,
+		elevM: 151
+	},
+	{
+		icao: "ZGNN",
+		name: "Nanning/Wuwei Intl, GX, CN",
+		lat: 22.609,
+		lon: 108.173,
+		elevM: 128
+	},
+	{
+		icao: "ZGHA",
+		name: "Changsha/Huanghua Arpt, HN, CN",
+		lat: 28.18,
+		lon: 113.219,
+		elevM: 61
+	},
+	{
+		icao: "ZHCC",
+		name: "Zhengzhou/Xinzheng Arpt, HA, CN",
+		lat: 34.52,
+		lon: 113.834,
+		elevM: 149
+	},
+	{
+		icao: "ZHEC",
+		name: "Ezhou Huahu Arpt, HB, CN",
+		lat: 30.3424,
+		lon: 115.0389,
+		elevM: 21
+	},
+	{
+		icao: "ZHHH",
+		name: "Wuhan/Tianhe Intl, HB, CN",
+		lat: 30.783,
+		lon: 114.205,
+		elevM: 33
+	},
+	{
+		icao: "ZJHK",
+		name: "Haikou/Meilan Intl, HI, CN",
+		lat: 19.934,
+		lon: 110.445,
+		elevM: 21
+	},
+	{
+		icao: "ZJSY",
+		name: "Sanya/Phoenix Intl, HN, CN",
+		lat: 18.303,
+		lon: 109.412,
+		elevM: 27
+	},
+	{
+		icao: "ZUUU",
+		name: "Chengdu/Shuangliu Intl, CQ, CN",
+		lat: 30.576,
+		lon: 103.95,
+		elevM: 494
+	},
+	{
+		icao: "ZUTF",
+		name: "Chengdu/Tianfu Arpt, CQ, CN",
+		lat: 30.304,
+		lon: 104.436,
+		elevM: 443
+	},
+	{
+		icao: "ZUCK",
+		name: "Chongqing/Jiangbei Intl, CQ, CN",
+		lat: 29.718,
+		lon: 106.639,
+		elevM: 416
+	},
+	{
+		icao: "ZUGY",
+		name: "Guizhou/Longdongbao Arpt, GZ, CN",
+		lat: 26.538,
+		lon: 106.801,
+		elevM: 1130
+	},
+	{
+		icao: "ZPPP",
+		name: "Kunming/Changshui Intl, YN, CN",
+		lat: 25.107,
+		lon: 102.934,
+		elevM: 2104
+	},
+	{
+		icao: "ZLLL",
+		name: "Lanzhou/Zhongchuan Arpt, GS, CN",
+		lat: 36.513,
+		lon: 103.623,
+		elevM: 1939
+	},
+	{
+		icao: "ZLXY",
+		name: "Xianyang Intl, SN, CN",
+		lat: 34.449,
+		lon: 108.752,
+		elevM: 478
+	},
+	{
+		icao: "ZWWW",
+		name: "Ürümqi/Diwopu Arpt, XJ, CN",
+		lat: 43.907,
+		lon: 87.474,
+		elevM: 654
+	},
+	{
+		icao: "ZWSH",
+		name: "Kashgar Arpt, XJ, CN",
+		lat: 39.542,
+		lon: 76.019,
+		elevM: 1374
+	},
+	{
+		icao: "ZYHB",
+		name: "Harbin/Taiping Arpt, HL, CN",
+		lat: 45.628,
+		lon: 126.259,
+		elevM: 134
+	},
+	{
+		icao: "ZYCC",
+		name: "Changchun/Longjia Intl, JL, CN",
+		lat: 43.993,
+		lon: 125.682,
+		elevM: 211
+	},
+	{
+		icao: "ZYTL",
+		name: "Dalian/Zhoushuizi Intl, LN, CN",
+		lat: 38.961,
+		lon: 121.556,
+		elevM: 33
+	},
+	{
+		icao: "ZYTX",
+		name: "Shenyang/Taoxian Intl, LN, CN",
+		lat: 41.639,
+		lon: 123.485,
+		elevM: 56
+	}
+];
+//#endregion
+export { CN_STATIONS };
+
+//# sourceMappingURL=stations-cn.js.map

package/dist/stations-cn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stations-cn.js","names":[],"sources":["../src/stations-cn.data.ts","../src/stations-cn.ts"],"sourcesContent":["/**\n * 由 `pnpm gen:stations` 机械再生——单一来源 = aviationweather.gov/api/data/metar 一次拉取\n * （采集纪律与字段口径见 scripts/generate-stations.mjs）；请勿手改。\n * 生成时刻：2026-09-11T08:29:45.262Z\n */\n\nexport interface CnStationRaw {\n  icao: string;\n  name: string;\n  lat: number;\n  lon: number;\n  elevM: number;\n}\n\nexport const CN_STATIONS_SOURCE = \"aviationweather.gov/api/data/metar\";\n\nexport const CN_STATIONS_GENERATED_AT = \"2026-09-11T08:29:45.262Z\";\n\nexport const CN_STATIONS_DATA: readonly CnStationRaw[] = [\n  {\n    icao: \"ZBAA\",\n    name: \"Beijing Intl, BJ, CN\",\n    lat: 40.082,\n    lon: 116.603,\n    elevM: 31,\n  },\n  {\n    icao: \"ZBAD\",\n    name: \"Beijing/Daxing Arpt, BJ, CN\",\n    lat: 39.501,\n    lon: 116.412,\n    elevM: 25,\n  },\n  {\n    icao: \"ZBTJ\",\n    name: \"Tianjin/Binhai Intl, TJ, CN\",\n    lat: 39.124,\n    lon: 117.346,\n    elevM: 4,\n  },\n  {\n    icao: \"ZBSJ\",\n    name: \"Zhengding Arpt, HA, CN\",\n    lat: 38.281,\n    lon: 114.697,\n    elevM: 70,\n  },\n  {\n    icao: \"ZBHH\",\n    name: \"Hohhot/Baita Intl, NM, CN\",\n    lat: 40.854,\n    lon: 111.827,\n    elevM: 1081,\n  },\n  {\n    icao: \"ZBYN\",\n    name: \"Taiyuan/Wusu Intl, SX, CN\",\n    lat: 37.747,\n    lon: 112.628,\n    elevM: 778,\n  },\n  {\n    icao: \"ZSPD\",\n    name: \"Shanghai/Pudong Intl, SH, CN\",\n    lat: 31.146,\n    lon: 121.8,\n    elevM: 4,\n  },\n  {\n    icao: \"ZSSS\",\n    name: \"Shanghai/Hongqiao Intl, SH, CN\",\n    lat: 31.209,\n    lon: 121.337,\n    elevM: 2,\n  },\n  {\n    icao: \"ZSHC\",\n    name: \"Hangzhou/Xiaoshan Intl, ZJ, CN\",\n    lat: 30.229,\n    lon: 120.434,\n    elevM: 8,\n  },\n  {\n    icao: \"ZSNJ\",\n    name: \"Nanjing/Lukou Intl, JS, CN\",\n    lat: 31.739,\n    lon: 118.863,\n    elevM: 27,\n  },\n  {\n    icao: \"ZSNB\",\n    name: \"Ningbo/Lishe Intl, ZJ, CN\",\n    lat: 29.827,\n    lon: 121.462,\n    elevM: 5,\n  },\n  {\n    icao: \"ZSQD\",\n    name: \"Qingdao/Jiaodong Arpt, SD, CN\",\n    lat: 36.362,\n    lon: 120.087,\n    elevM: 2,\n  },\n  {\n    icao: \"ZSAM\",\n    name: \"Xiamen-Gaoqi Intl, FJ, CN\",\n    lat: 24.546,\n    lon: 118.131,\n    elevM: 13,\n  },\n  {\n    icao: \"ZSFZ\",\n    name: \"Fuzhou/Changle Intl, FJ, CN\",\n    lat: 25.936,\n    lon: 119.666,\n    elevM: 14,\n  },\n  {\n    icao: \"ZSOF\",\n    name: \"Hefei/Xinqiao Intl, AH, CN\",\n    lat: 31.99,\n    lon: 116.965,\n    elevM: 64,\n  },\n  {\n    icao: \"ZGGG\",\n    name: \"Guangzhou/Baiyun Intl, GD, CN\",\n    lat: 23.392,\n    lon: 113.307,\n    elevM: 11,\n  },\n  {\n    icao: \"ZGSZ\",\n    name: \"Shenzhen/Boan Intl, GD, CN\",\n    lat: 22.639,\n    lon: 113.803,\n    elevM: 18,\n  },\n  {\n    icao: \"ZGOW\",\n    name: \"Jieyang/Chaoshan Intl, GD, CN\",\n    lat: 23.55,\n    lon: 116.505,\n    elevM: 4,\n  },\n  {\n    icao: \"ZGKL\",\n    name: \"Guilin/Liangjiang Intl, GX, CN\",\n    lat: 25.22,\n    lon: 110.04,\n    elevM: 151,\n  },\n  {\n    icao: \"ZGNN\",\n    name: \"Nanning/Wuwei Intl, GX, CN\",\n    lat: 22.609,\n    lon: 108.173,\n    elevM: 128,\n  },\n  {\n    icao: \"ZGHA\",\n    name: \"Changsha/Huanghua Arpt, HN, CN\",\n    lat: 28.18,\n    lon: 113.219,\n    elevM: 61,\n  },\n  {\n    icao: \"ZHCC\",\n    name: \"Zhengzhou/Xinzheng Arpt, HA, CN\",\n    lat: 34.52,\n    lon: 113.834,\n    elevM: 149,\n  },\n  {\n    icao: \"ZHEC\",\n    name: \"Ezhou Huahu Arpt, HB, CN\",\n    lat: 30.3424,\n    lon: 115.0389,\n    elevM: 21,\n  },\n  {\n    icao: \"ZHHH\",\n    name: \"Wuhan/Tianhe Intl, HB, CN\",\n    lat: 30.783,\n    lon: 114.205,\n    elevM: 33,\n  },\n  {\n    icao: \"ZJHK\",\n    name: \"Haikou/Meilan Intl, HI, CN\",\n    lat: 19.934,\n    lon: 110.445,\n    elevM: 21,\n  },\n  {\n    icao: \"ZJSY\",\n    name: \"Sanya/Phoenix Intl, HN, CN\",\n    lat: 18.303,\n    lon: 109.412,\n    elevM: 27,\n  },\n  {\n    icao: \"ZUUU\",\n    name: \"Chengdu/Shuangliu Intl, CQ, CN\",\n    lat: 30.576,\n    lon: 103.95,\n    elevM: 494,\n  },\n  {\n    icao: \"ZUTF\",\n    name: \"Chengdu/Tianfu Arpt, CQ, CN\",\n    lat: 30.304,\n    lon: 104.436,\n    elevM: 443,\n  },\n  {\n    icao: \"ZUCK\",\n    name: \"Chongqing/Jiangbei Intl, CQ, CN\",\n    lat: 29.718,\n    lon: 106.639,\n    elevM: 416,\n  },\n  {\n    icao: \"ZUGY\",\n    name: \"Guizhou/Longdongbao Arpt, GZ, CN\",\n    lat: 26.538,\n    lon: 106.801,\n    elevM: 1130,\n  },\n  {\n    icao: \"ZPPP\",\n    name: \"Kunming/Changshui Intl, YN, CN\",\n    lat: 25.107,\n    lon: 102.934,\n    elevM: 2104,\n  },\n  {\n    icao: \"ZLLL\",\n    name: \"Lanzhou/Zhongchuan Arpt, GS, CN\",\n    lat: 36.513,\n    lon: 103.623,\n    elevM: 1939,\n  },\n  {\n    icao: \"ZLXY\",\n    name: \"Xianyang Intl, SN, CN\",\n    lat: 34.449,\n    lon: 108.752,\n    elevM: 478,\n  },\n  {\n    icao: \"ZWWW\",\n    name: \"\\u00dcr\\u00fcmqi/Diwopu Arpt, XJ, CN\",\n    lat: 43.907,\n    lon: 87.474,\n    elevM: 654,\n  },\n  {\n    icao: \"ZWSH\",\n    name: \"Kashgar Arpt, XJ, CN\",\n    lat: 39.542,\n    lon: 76.019,\n    elevM: 1374,\n  },\n  {\n    icao: \"ZYHB\",\n    name: \"Harbin/Taiping Arpt, HL, CN\",\n    lat: 45.628,\n    lon: 126.259,\n    elevM: 134,\n  },\n  {\n    icao: \"ZYCC\",\n    name: \"Changchun/Longjia Intl, JL, CN\",\n    lat: 43.993,\n    lon: 125.682,\n    elevM: 211,\n  },\n  {\n    icao: \"ZYTL\",\n    name: \"Dalian/Zhoushuizi Intl, LN, CN\",\n    lat: 38.961,\n    lon: 121.556,\n    elevM: 33,\n  },\n  {\n    icao: \"ZYTX\",\n    name: \"Shenyang/Taoxian Intl, LN, CN\",\n    lat: 41.639,\n    lon: 123.485,\n    elevM: 56,\n  },\n];\n","/**\n * `metweave/stations-cn` —— 中国 39 站静态元数据（ICAO / 名称 / WGS-84 坐标 / 标高米）。\n *\n * 数据来源 aviationweather.gov（一次采集，`pnpm gen:stations` 单源再生，见 stations-cn.data.ts 头注）；\n * 用途：`getMetarReports(network, { stations })` 联表——IEM 自带的站点坐标是城市级粗定位，\n * 传入本表即得精确机场坐标与站名（「四字码 → 站名」开箱即用）。\n * 事实性元数据，随包分发；观测报文数据不在此列（许可边界见主 README「许可」）。\n */\nimport type { StationRef } from \"./sources.js\";\nimport { CN_STATIONS_DATA } from \"./stations-cn.data.js\";\n\n/** 一个中国站点的静态元数据（StationRef 联表形态 + 标高） */\nexport interface CnStation extends StationRef {\n  /** 标高（米，上游即米制口径） */\n  elevM: number;\n}\n\n/** 中国 39 站整网元数据（可直接传给 `getMetarReports` 的 `stations` 参数） */\nexport const CN_STATIONS: readonly CnStation[] = CN_STATIONS_DATA;\n"],"mappings":";;;ACkBA,MAAa,cAAoC;CDC/C;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;CACA;EACE,MAAM;EACN,MAAM;EACN,KAAK;EACL,KAAK;EACL,OAAO;CACT;ACjR+C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "metweave",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Show live airport weather on a Leaflet map in ten lines — METAR parsing, report cards and map layers, straight from public sources.",
   "keywords": [
     "airport",
@@ -50,15 +50,25 @@
         "types": "./dist/sources.d.cts",
         "default": "./dist/sources.cjs"
       }
+    },
+    "./stations-cn": {
+      "import": {
+        "types": "./dist/stations-cn.d.ts",
+        "default": "./dist/stations-cn.js"
+      },
+      "require": {
+        "types": "./dist/stations-cn.d.cts",
+        "default": "./dist/stations-cn.cjs"
+      }
     }
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@metweave/core": "0.1.0",
-    "@metweave/parser": "0.1.0",
-    "@metweave/render": "0.1.0"
+    "@metweave/core": "0.1.1",
+    "@metweave/parser": "0.1.1",
+    "@metweave/render": "0.1.1"
   },
   "engines": {
     "node": ">=20"