metweave 0.1.1 → 0.2.0

package/README.md

@@ -1,6 +1,6 @@
 # metweave
 
-把公开气象数据编织成可嵌入产品的图：机场报文（METAR / SPECI）经「解析 → 标准化 → 渲染」一条管道，变成报文卡片与地图图层。数据直连公开源（IEM currents 端点 CORS 全开，浏览器可直连）；解析与渲染全部在浏览器端完成——报文不经过你自己的服务器，无需自建后端。
+把公开气象数据编织成可嵌入产品的图：机场报文（METAR / SPECI 观测与 TAF 预报）经「解析 → 标准化 → 渲染」一条管道，变成报文卡片与地图图层。数据直连公开源（IEM 实况端点 CORS 全开，浏览器可直连；TAF 上游无 CORS 头，需代理或镜像——见下）；解析与渲染全部在浏览器端完成——报文不经过你自己的服务器，无需自建后端。
 
 ### 安装
 
@@ -16,6 +16,7 @@ npm install metweave @metweave/leaflet leaflet
 ```ts
 import * as L from "leaflet";
 import "leaflet/dist/leaflet.css"; // 别漏：不引入 CSS 地图不渲染
+import { CN_STATIONS } from "metweave/stations-cn";
 import { getMetarReports } from "metweave/sources"; // 取数 → 解析 → 定位
 import { addMetarLayer } from "@metweave/leaflet";
 
@@ -28,7 +29,21 @@ L.tileLayer(
 await addMetarLayer(map, await getMetarReports(), { conditionColors: true });
 ```
 
-本包再导出 `@metweave/core` / `parser` / `render`（整条管道一个入口，含 `toValues` 与机读错误类）；`metweave/sources` 提供取数 helper。文档与完整示例见[主仓库](https://github.com/yaojaro/metweave)。
+### TAF 预报侧（同样三步）
+
+```ts
+import { getTafReports } from "metweave/sources";
+import { addTafLayer } from "@metweave/leaflet";
+
+// TAF 端点不提供坐标——stations 联表是定位的唯一来源（中国 39 站元数据随包自带）
+const tafItems = await getTafReports(["ZBAA", "ZBAD"], {
+  baseUrl: "/aw-taf", // 上游无 CORS 头：浏览器直连走自建代理/镜像（根因与三条出路见主仓库 README「TAF 取数与 CORS」）
+  stations: CN_STATIONS,
+});
+const tafLayer = await addTafLayer(map, tafItems); // 圆点四档色/悬停摘要/TAF 卡弹窗，与实况层同款
+```
+
+本包再导出 `@metweave/core` / `parser` / `render`（整条管道一个入口，含 `toValues` 与机读错误类）：预报侧 `parseTaf`（tolerant 与 `mode: "strict"` 严判）、`expandTaf` 时间线展开、`tafSegments` 分段明细、`validateTaf` 条文判据校验、`renderTafCard` TAF 卡片。`metweave/sources` 提供双线取数 helper（`getMetars` / `getMetarReports` 与 `getTafs` / `getTafReports`，各带 `baseUrl` 换源位）；`metweave/stations-cn` 提供中国 39 站元数据。文档与完整示例见[主仓库](https://github.com/yaojaro/metweave)。
 
 ## 许可
 

package/dist/sources.cjs

@@ -7,9 +7,10 @@ const IEM_BASE = "https://mesonet.agron.iastate.edu";
 * The IEM whole-network currents endpoint (CORS-open, direct browser access). Defaults to the China ASOS network (39 stations).
 * IEM 整网实况端点（CORS 全开，浏览器可直连）。缺省中国 ASOS 网（39 站）。
 * @param network - IEM network name (e.g. CN__ASOS, RU__ASOS, IA_ASOS). IEM 网络名。
+* @param baseUrl - IEM 站点根覆盖（内网镜像/自建网关——换源口径，见 GetMetarsOptions.baseUrl）。
 */
-function iemCurrentsUrl(network = "CN__ASOS") {
-	return `${IEM_BASE}/api/1/currents.json?network=${encodeURIComponent(network)}`;
+function iemCurrentsUrl(network = "CN__ASOS", baseUrl = IEM_BASE) {
+	return `${baseUrl}/api/1/currents.json?network=${encodeURIComponent(network)}`;
 }
 /** 观测记录守卫：station/raw 均须为字符串（只查键不查类型是旧洞）。 */
 function isObservation(v) {
@@ -39,7 +40,7 @@ async function getMetars(network = "CN__ASOS", options = {}) {
 	try {
 		let res;
 		try {
-			res = await fetch(iemCurrentsUrl(network), { signal: controller.signal });
+			res = await fetch(iemCurrentsUrl(network, options.baseUrl), { signal: controller.signal });
 		} catch (err) {
 			if (controller.signal.aborted) throw err;
 			const reason = err instanceof Error ? err.message : String(err);
@@ -111,7 +112,230 @@ async function getMetarReports(network = "CN__ASOS", options = {}) {
 	}
 	return items;
 }
+/** aviationweather TAF 数据端点（上游无 CORS 头：浏览器直连须自建代理/镜像——baseUrl 覆盖即为此用） */
+const AW_TAF_ENDPOINT = "https://aviationweather.gov/api/data/taf";
+/**
+* The aviationweather TAF endpoint (raw format). ids joined as given; date serialized when present.
+* aviationweather TAF 端点模板（format=raw）。ids 数组逗号连接；date 存在时序列化为查询参数。
+*/
+function awTafUrl(ids, options = {}) {
+	const idList = typeof ids === "string" ? ids : ids.join(",");
+	const params = new URLSearchParams({
+		ids: idList,
+		format: "raw"
+	});
+	const d = options.date;
+	if (d !== void 0) params.set("date", d instanceof Date ? d.toISOString() : d);
+	return `${options.baseUrl ?? "https://aviationweather.gov/api/data/taf"}?${params.toString()}`;
+}
+/** raw 文本 → 整份报文行（缩进续行并回上一份；与报池语义同源）+ best-effort 站码提取 */
+function mergeTafLines(text) {
+	const merged = [];
+	for (const line of text.split("\n")) {
+		if (line.trim() === "") continue;
+		if (/^\s/.test(line) && merged.length > 0) merged[merged.length - 1] += ` ${line.trim()}`;
+		else merged.push(line.trim());
+	}
+	return merged.map((raw) => {
+		const toks = raw.split(/\s+/);
+		let k = toks[0] === "TAF" ? 1 : 0;
+		while (toks[k] === "AMD" || toks[k] === "COR") k += 1;
+		const head = toks[k] ?? "";
+		return {
+			station: /^[A-Z0-9]{4}$/.test(head) ? head : "",
+			raw
+		};
+	});
+}
+/**
+* Fetch aviationweather TAFs (raw format) with station extracted and continuation lines merged.
+* 拉取 aviationweather TAF（raw 格式）：续行归并 + 站码提取的取数侧整理。
+* 失败语义与 getMetars 同族（不静默）：timeout/network/http-error/empty-data 一律 MetarSourceError
+* 机读码；上游对未知 ids 也返回 200 + 空体，空数据显式 throw 而非空数组静默。
+*/
+async function getTafs(ids, options = {}) {
+	const controller = new AbortController();
+	const external = options.signal;
+	const forward = () => {
+		controller.abort(external?.reason);
+	};
+	if (external !== void 0) {
+		if (external.aborted) forward();
+		else external.addEventListener("abort", forward, { once: true });
+	}
+	const timer = options.timeoutMs === void 0 ? void 0 : setTimeout(() => controller.abort(new _metweave_core.MetarSourceError("timeout", "aviationweather", `aviationweather TAF 请求超时（>${options.timeoutMs}ms）`)), options.timeoutMs);
+	try {
+		let res;
+		try {
+			res = await fetch(awTafUrl(ids, options), { signal: controller.signal });
+		} catch (err) {
+			if (controller.signal.aborted) throw err;
+			const reason = err instanceof Error ? err.message : String(err);
+			throw new _metweave_core.MetarSourceError("network", "aviationweather", `网络请求失败（源：aviationweather TAF）：请检查网络连通性后重试（${reason}）`, { cause: err });
+		}
+		if (!res.ok) throw new _metweave_core.MetarSourceError("http-error", "aviationweather", `aviationweather TAF HTTP ${res.status}`);
+		let text;
+		try {
+			text = await res.text();
+		} catch (err) {
+			if (controller.signal.aborted) throw err;
+			const reason = err instanceof Error ? err.message : String(err);
+			throw new _metweave_core.MetarSourceError("network", "aviationweather", `aviationweather TAF 响应读取失败：${reason}`, { cause: err });
+		}
+		const rows = mergeTafLines(text);
+		if (rows.length === 0) throw new _metweave_core.MetarSourceError("empty-data", "aviationweather", "aviationweather TAF 返回空数据——请核对 ids 站码（如 ZBAA,ZBAD；端点 format=raw）");
+		return rows;
+	} finally {
+		if (timer !== void 0) clearTimeout(timer);
+		external?.removeEventListener("abort", forward);
+	}
+}
+/**
+* TAF 版的取数 → 解析 → 定位一步到位（契约沿 getMetarReports）：stations 命中的站带精确坐标与站名，
+* 未命中跳过（TAF 端点无坐标可回落，与 getMetarReports 的无坐标跳行同规则）；解析失败两种模式
+* （缺省聚合抛出 batch-parse-failed、传 onUnparseable 逐行容错）。报池等数据管理逻辑不进本层。
+*/
+async function getTafReports(ids, options = {}) {
+	const { stations, onUnparseable, spans, ...fetchOptions } = options;
+	const table = new Map((stations ?? []).map((s) => [s.icao, s]));
+	const observations = await getTafs(ids, fetchOptions);
+	const items = [];
+	const failures = [];
+	for (const obs of observations) try {
+		const report = (0, _metweave_parser.parseTaf)(obs.raw, spans === false ? { spans: false } : void 0);
+		const station = table.get(report.station);
+		if (station === void 0) continue;
+		items.push({
+			report,
+			position: [station.lat, station.lon],
+			title: `${report.station}${station.name ? ` ${station.name}` : ""}`
+		});
+	} catch (err) {
+		if (!(err instanceof _metweave_core.MetarParseError)) throw err;
+		if (onUnparseable !== void 0) {
+			onUnparseable({
+				station: obs.station,
+				raw: obs.raw,
+				code: err.code,
+				error: err.message
+			});
+			continue;
+		}
+		failures.push(`${obs.station}: ${err.message}`);
+	}
+	if (failures.length > 0) {
+		const summary = `source=aviationweather; failures=${failures.length}; ${failures.join("; ")}`;
+		throw new _metweave_core.MetarParseError("batch-parse-failed", summary, `TAF 解析失败 ${failures.length} 条（aviationweather）——${failures.slice(0, 3).join("；")}${failures.length > 3 ? "……" : ""}`);
+	}
+	return items;
+}
+/** ogimet display_metars2.php 端点（tipo=FT＝TAF；无 CORS 头：浏览器直连须代理/镜像——baseUrl 覆盖即为此用） */
+const OGIMET_TAF_ENDPOINT = "https://www.ogimet.com/display_metars2.php";
+/**
+* ogimet TAF 端点模板（配方＝私有管线 backfill_ogimet.py 同源）：tipo=FT、txt 形、
+* 服务端按 <pre> 区回 HTML（解析见 parseOgimetTafs）。免费公益服务——调用方自行节制频率。
+*/
+/** UTC 日期字段补零组（ogimet 查询串的 ano/mes/day/hora/min 族） */
+const ogimetFields = (d) => ({
+	ano: `${d.getUTCFullYear()}`,
+	mes: `${d.getUTCMonth() + 1}`.padStart(2, "0"),
+	day: `${d.getUTCDate()}`.padStart(2, "0"),
+	hora: `${d.getUTCHours()}`.padStart(2, "0"),
+	min: `${d.getUTCMinutes()}`.padStart(2, "0")
+});
+function ogimetTafUrl(station, window, options = {}) {
+	const a = ogimetFields(window.from);
+	const b = ogimetFields(window.to);
+	const qs = new URLSearchParams({
+		lang: "en",
+		lugar: station,
+		tipo: "FT",
+		ord: "DIR",
+		nil: "SI",
+		fmt: "txt",
+		ano: a.ano,
+		mes: a.mes,
+		day: a.day,
+		hora: a.hora,
+		min: a.min,
+		anof: b.ano,
+		mesf: b.mes,
+		dayf: b.day,
+		horaf: b.hora,
+		minf: b.min,
+		send: "send",
+		nohtmlo: "yes",
+		annot: "yes",
+		leng: "0"
+	});
+	return `${options.baseUrl ?? "https://www.ogimet.com/display_metars2.php"}?${qs.toString()}`;
+}
+/** 电头站码 best-effort 提取（TAF/AMD/COR 剥词；剥不出返回空串）——与 mergeTafLines 同判式（aviationweather 取数线） */
+const stationHeadOf = (raw) => {
+	const toks = raw.split(/\s+/);
+	let k = toks[0] === "TAF" ? 1 : 0;
+	while (toks[k] === "AMD" || toks[k] === "COR") k += 1;
+	const head = toks[k] ?? "";
+	return /^[A-Z0-9]{4}$/.test(head) ? head : "";
+};
+/**
+* ogimet 响应解析（<pre> 区）：12 位时间戳前缀行（YYYYMMDDHHmm，收报序）起新记录、无前缀行并入上一条
+* （多行报文并单——与私有管线 parse_tafs 同协议）；# 注释/空行跳过；只收 TAF 起头报文。
+* 站码 best-effort 取自电头（query 站名兜底）；空模板（无 <pre> 或零报文）返回空数组——
+* 由调用方判空（ogimet 缺数常见，属正常降级而非错误面）。
+*/
+function parseOgimetTafs(html, fallbackStation = "") {
+	const pre = /<pre>([\s\S]*?)<\/pre>/.exec(html);
+	if (pre === null) return [];
+	const PREFIX = /^(\d{12})\s+(.*)$/;
+	const merged = [];
+	for (const line of (pre[1] ?? "").split("\n")) {
+		const t = line.trim();
+		if (t === "" || t.startsWith("#")) continue;
+		const pm = PREFIX.exec(t);
+		if (pm !== null) merged.push(pm[2] ?? "");
+		else if (merged.length > 0) merged[merged.length - 1] += ` ${t}`;
+	}
+	return merged.filter((raw) => raw.startsWith("TAF")).map((raw) => ({
+		station: stationHeadOf(raw) || fallbackStation,
+		raw
+	}));
+}
+/**
+* Fetch one station's recent TAFs from ogimet (latest + previous publication cycles).
+* 拉取单站的 ogimet 近窗 TAF（最新与上一发布周期——报池补充线，供与 aviationweather 线合并去重）。
+* 失败语义与 getTafs 同族（timeout/network/http-error 机读码）；空数据返回空数组而非抛错
+* （ogimet 站点级缺数常见——它是补充线，空窗属正常降级，不静默丢整批）。
+*/
+async function getTafsOgimet(station, window, options = {}) {
+	const controller = new AbortController();
+	const external = options.signal;
+	const forward = () => {
+		controller.abort(external?.reason);
+	};
+	if (external !== void 0) {
+		if (external.aborted) forward();
+		else external.addEventListener("abort", forward, { once: true });
+	}
+	const timer = options.timeoutMs === void 0 ? void 0 : setTimeout(() => controller.abort(new _metweave_core.MetarSourceError("timeout", "ogimet", `ogimet TAF 请求超时（>${options.timeoutMs}ms，站=${station}）`)), options.timeoutMs);
+	try {
+		let res;
+		try {
+			res = await fetch(ogimetTafUrl(station, window, options), { signal: controller.signal });
+		} catch (err) {
+			if (controller.signal.aborted) throw err;
+			const reason = err instanceof Error ? err.message : String(err);
+			throw new _metweave_core.MetarSourceError("network", "ogimet", `网络请求失败（源：ogimet TAF，站=${station}）：${reason}`, { cause: err });
+		}
+		if (!res.ok) throw new _metweave_core.MetarSourceError("http-error", "ogimet", `ogimet TAF HTTP ${res.status}（站=${station}）`);
+		return parseOgimetTafs(await res.text(), station);
+	} finally {
+		if (timer !== void 0) clearTimeout(timer);
+		external?.removeEventListener("abort", forward);
+	}
+}
 //#endregion
+exports.AW_TAF_ENDPOINT = AW_TAF_ENDPOINT;
 Object.defineProperty(exports, "MetarParseError", {
 	enumerable: true,
 	get: function() {
@@ -124,8 +348,15 @@ Object.defineProperty(exports, "MetarSourceError", {
 		return _metweave_core.MetarSourceError;
 	}
 });
+exports.OGIMET_TAF_ENDPOINT = OGIMET_TAF_ENDPOINT;
+exports.awTafUrl = awTafUrl;
 exports.getMetarReports = getMetarReports;
 exports.getMetars = getMetars;
+exports.getTafReports = getTafReports;
+exports.getTafs = getTafs;
+exports.getTafsOgimet = getTafsOgimet;
 exports.iemCurrentsUrl = iemCurrentsUrl;
+exports.ogimetTafUrl = ogimetTafUrl;
+exports.parseOgimetTafs = parseOgimetTafs;
 
 //# sourceMappingURL=sources.cjs.map

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   * 紧凑模式：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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"}
+{"version":3,"file":"sources.cjs","names":["MetarSourceError","parse","MetarParseError","parseTaf"],"sources":["../src/sources.ts"],"sourcesContent":["/**\n * metweave/sources — 取数 helper（伞包子路径）。双线：IEM METAR 实况 + aviationweather TAF 预报（主）+ ogimet TAF 报池补充（次）。\n *\n * 纪律：只做端点模板 + fetch + 取数侧整理（解析、定位联表）——缓存/质控/归档等\n * 数据管理逻辑永不进入开源包；核心包（core/parser/render）零网络代码。\n * 换源口径（内网的人切换到自己的数据源」指令）：两条线各留 baseUrl 覆盖位\n * （IEM＝站点根、TAF＝端点根）——内网镜像/自建网关只换根、路径与查询串由本层拼装。\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, TafReport } from \"@metweave/core\";\nimport type { MetarParseErrorCode } from \"@metweave/core\";\nimport { MetarParseError, MetarSourceError } from \"@metweave/core\";\nimport { parse, parseTaf } 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   * IEM 站点根覆盖（缺省官方 https://mesonet.agron.iastate.edu）：内网镜像/自建网关\n   * 只换根——/api/1/currents.json 路径与查询串由本层拼装（换源口径，见文件头）。\n   */\n  baseUrl?: string;\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 * @param baseUrl - IEM 站点根覆盖（内网镜像/自建网关——换源口径，见 GetMetarsOptions.baseUrl）。\n */\nexport function iemCurrentsUrl(network = \"CN__ASOS\", baseUrl = IEM_BASE): string {\n  return `${baseUrl}/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, options.baseUrl), { 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\n// ---------------------------------------------------------------- TAF 取数线（收进 sources」指令）\n\n/** aviationweather TAF 数据端点（上游无 CORS 头：浏览器直连须自建代理/镜像——baseUrl 覆盖即为此用） */\nexport const AW_TAF_ENDPOINT = \"https://aviationweather.gov/api/data/taf\";\n\n/**\n * One fetched TAF row: station (best-effort) and the verbatim report (continuation lines already merged).\n * 单条 TAF 取数行：站码（best-effort）与报文原文（续行已归并）。\n */\nexport interface TafObservation {\n  /** 站码：剥 TAF/AMD/COR 电头词后的首枚 4 位码；剥不出为 \"\"（解析层 missing-station 兜底出声） */\n  station: string;\n  /** 报文原文（上游 raw 格式的缩进续行已并回所属报文；report.raw 语义一致——原文保真） */\n  raw: string;\n}\n\n/** Options for getTafs: fetch options plus the TAF endpoint-root override and the as-of date. */\nexport interface GetTafsOptions {\n  /** 外部取消信号（与超时组合，任一触发即中止） */\n  signal?: AbortSignal;\n  /** 请求超时毫秒数（触发即中止并抛出超时错误） */\n  timeoutMs?: number;\n  /**\n   * TAF 端点根覆盖（缺省官方 https://aviationweather.gov/api/data/taf）：内网镜像/自建代理\n   * 只换根——?ids=&format=raw 查询串由本层拼装（换源口径，见文件头；examples 即用 /aw-taf 代理根）。\n   */\n  baseUrl?: string;\n  /**\n   * 「该时刻已发布的最新报」（上游 date 参数语义）：回看上一发布周期用（examples 报池即 date=now-4h）。\n   * Date 转 ISO；字符串原样透传（上游亦收相对形态）。\n   */\n  date?: Date | string;\n}\n\n/**\n * The aviationweather TAF endpoint (raw format). ids joined as given; date serialized when present.\n * aviationweather TAF 端点模板（format=raw）。ids 数组逗号连接；date 存在时序列化为查询参数。\n */\nexport function awTafUrl(\n  ids: string | readonly string[],\n  options: { baseUrl?: string; date?: Date | string } = {},\n): string {\n  const idList = typeof ids === \"string\" ? ids : ids.join(\",\");\n  const params = new URLSearchParams({ ids: idList, format: \"raw\" });\n  const d = options.date;\n  if (d !== undefined) params.set(\"date\", d instanceof Date ? d.toISOString() : d);\n  return `${options.baseUrl ?? AW_TAF_ENDPOINT}?${params.toString()}`;\n}\n\n/** raw 文本 → 整份报文行（缩进续行并回上一份；与报池语义同源）+ best-effort 站码提取 */\nfunction mergeTafLines(text: string): TafObservation[] {\n  const merged: string[] = [];\n  for (const line of text.split(\"\\n\")) {\n    if (line.trim() === \"\") continue;\n    if (/^\\s/.test(line) && merged.length > 0) merged[merged.length - 1] += ` ${line.trim()}`;\n    else merged.push(line.trim());\n  }\n  return merged.map((raw) => {\n    const toks = raw.split(/\\s+/);\n    let k = toks[0] === \"TAF\" ? 1 : 0;\n    while (toks[k] === \"AMD\" || toks[k] === \"COR\") k += 1;\n    const head = toks[k] ?? \"\";\n    return { station: /^[A-Z0-9]{4}$/.test(head) ? head : \"\", raw };\n  });\n}\n\n/**\n * Fetch aviationweather TAFs (raw format) with station extracted and continuation lines merged.\n * 拉取 aviationweather TAF（raw 格式）：续行归并 + 站码提取的取数侧整理。\n * 失败语义与 getMetars 同族（不静默）：timeout/network/http-error/empty-data 一律 MetarSourceError\n * 机读码；上游对未知 ids 也返回 200 + 空体，空数据显式 throw 而非空数组静默。\n */\nexport async function getTafs(\n  ids: string | readonly string[],\n  options: GetTafsOptions = {},\n): Promise<TafObservation[]> {\n  // 手工组合超时与外部信号（与 getMetars 同款：不依赖 AbortSignal.any，兼容 Node 20；假时钟可测）\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              new MetarSourceError(\n                \"timeout\",\n                \"aviationweather\",\n                `aviationweather TAF 请求超时（>${options.timeoutMs}ms）`,\n              ),\n            ),\n          options.timeoutMs,\n        );\n  try {\n    let res: Response;\n    try {\n      res = await fetch(awTafUrl(ids, options), { signal: controller.signal });\n    } catch (err) {\n      // 取消/超时引发的拒绝原样透传（AbortSignal 语义）；断网/DNS 包装为 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        \"aviationweather\",\n        `网络请求失败（源：aviationweather TAF）：请检查网络连通性后重试（${reason}）`,\n        { cause: err },\n      );\n    }\n    if (!res.ok) {\n      throw new MetarSourceError(\n        \"http-error\",\n        \"aviationweather\",\n        `aviationweather TAF HTTP ${res.status}`,\n      );\n    }\n    let text: string;\n    try {\n      text = await res.text();\n    } catch (err) {\n      if (controller.signal.aborted) throw err;\n      const reason = err instanceof Error ? err.message : String(err);\n      throw new MetarSourceError(\n        \"network\",\n        \"aviationweather\",\n        `aviationweather TAF 响应读取失败：${reason}`,\n        { cause: err },\n      );\n    }\n    const rows = mergeTafLines(text);\n    if (rows.length === 0) {\n      throw new MetarSourceError(\n        \"empty-data\",\n        \"aviationweather\",\n        \"aviationweather TAF 返回空数据——请核对 ids 站码（如 ZBAA,ZBAD；端点 format=raw）\",\n      );\n    }\n    return rows;\n  } finally {\n    if (timer !== undefined) clearTimeout(timer);\n    external?.removeEventListener(\"abort\", forward);\n  }\n}\n\n/** Options for getTafReports: fetch options plus station metadata and the per-row tolerance callback. */\nexport interface GetTafReportsOptions extends GetTafsOptions {\n  /** 按 icao 联表的站点元数据（TAF 端点不提供坐标——stations 是定位的唯一来源，缺省将得空数组） */\n  stations?: readonly StationRef[];\n  /** 逐行容错（缺省关闭）：传入时解析失败的行跳过并逐条回调；不传时聚合抛出（全有或全无） */\n  onUnparseable?: (failure: UnparseableReport) => void;\n  /** 紧凑模式：parseTaf 产物剥除全部 span 字段（存储场景推荐）；缺省完整模式 */\n  spans?: false;\n}\n\n/**\n * A map-ready TAF item (structurally compatible with TafLayerItem's report/position/title triple).\n * 可直接喂给地图适配器（如 addTafLayer）的预报项：{ report, position, title } 三件套。\n */\nexport interface TafReportItem {\n  /** 已解析的 TAF IR（原文经 report.raw 原样保真） */\n  report: TafReport;\n  /** 站点坐标（WGS-84 [lat, lon]；TAF 端点无坐标，来自 stations 联表） */\n  position: [number, number];\n  /** 站点提示（「ICAO 站名」；适配器缺省回落 IR 站名） */\n  title: string;\n}\n\n/**\n * TAF 版的取数 → 解析 → 定位一步到位（契约沿 getMetarReports）：stations 命中的站带精确坐标与站名，\n * 未命中跳过（TAF 端点无坐标可回落，与 getMetarReports 的无坐标跳行同规则）；解析失败两种模式\n * （缺省聚合抛出 batch-parse-failed、传 onUnparseable 逐行容错）。报池等数据管理逻辑不进本层。\n */\nexport async function getTafReports(\n  ids: string | readonly string[],\n  options: GetTafReportsOptions = {},\n): Promise<TafReportItem[]> {\n  const { stations, onUnparseable, spans, ...fetchOptions } = options;\n  const table = new Map((stations ?? []).map((s) => [s.icao, s] as const));\n  const observations = await getTafs(ids, fetchOptions);\n  const items: TafReportItem[] = [];\n  const failures: string[] = [];\n  for (const obs of observations) {\n    try {\n      const report = parseTaf(obs.raw, spans === false ? { spans: false } : undefined);\n      const station = table.get(report.station);\n      if (station === undefined) continue; // 站表未命中（端点无坐标可回落）——跳过，规则同 getMetarReports\n      items.push({\n        report,\n        position: [station.lat, station.lon],\n        title: `${report.station}${station.name ? ` ${station.name}` : \"\"}`,\n      });\n    } catch (err) {\n      // parseTaf 对字符串输入只抛 MetarParseError；其他异常属编程错误直接上抛\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    const summary = `source=aviationweather; failures=${failures.length}; ${failures.join(\"; \")}`;\n    throw new MetarParseError(\n      \"batch-parse-failed\",\n      summary,\n      `TAF 解析失败 ${failures.length} 条（aviationweather）——${failures.slice(0, 3).join(\"；\")}${failures.length > 3 ? \"……\" : \"\"}`,\n    );\n  }\n  return items;\n}\n\n// ---------------------------------------------------------------- ogimet TAF 补充线（指令：aviationweather 取最新，ogimet 取最新/次新合并补充）\n\n/** ogimet display_metars2.php 端点（tipo=FT＝TAF；无 CORS 头：浏览器直连须代理/镜像——baseUrl 覆盖即为此用） */\nexport const OGIMET_TAF_ENDPOINT = \"https://www.ogimet.com/display_metars2.php\";\n\n/** ogimet 查询窗（UTC 起止） */\nexport interface OgimetTafWindow {\n  readonly from: Date;\n  readonly to: Date;\n}\n\n/**\n * ogimet TAF 端点模板（配方＝私有管线 backfill_ogimet.py 同源）：tipo=FT、txt 形、\n * 服务端按 <pre> 区回 HTML（解析见 parseOgimetTafs）。免费公益服务——调用方自行节制频率。\n */\n/** UTC 日期字段补零组（ogimet 查询串的 ano/mes/day/hora/min 族） */\nconst ogimetFields = (\n  d: Date,\n): { ano: string; mes: string; day: string; hora: string; min: string } => ({\n  ano: `${d.getUTCFullYear()}`,\n  mes: `${d.getUTCMonth() + 1}`.padStart(2, \"0\"),\n  day: `${d.getUTCDate()}`.padStart(2, \"0\"),\n  hora: `${d.getUTCHours()}`.padStart(2, \"0\"),\n  min: `${d.getUTCMinutes()}`.padStart(2, \"0\"),\n});\n\nexport function ogimetTafUrl(\n  station: string,\n  window: OgimetTafWindow,\n  options: { baseUrl?: string } = {},\n): string {\n  const a = ogimetFields(window.from);\n  const b = ogimetFields(window.to);\n  const qs = new URLSearchParams({\n    lang: \"en\",\n    lugar: station,\n    tipo: \"FT\",\n    ord: \"DIR\",\n    nil: \"SI\",\n    fmt: \"txt\",\n    ano: a.ano,\n    mes: a.mes,\n    day: a.day,\n    hora: a.hora,\n    min: a.min,\n    anof: b.ano,\n    mesf: b.mes,\n    dayf: b.day,\n    horaf: b.hora,\n    minf: b.min,\n    send: \"send\",\n    nohtmlo: \"yes\",\n    annot: \"yes\",\n    leng: \"0\",\n  });\n  return `${options.baseUrl ?? OGIMET_TAF_ENDPOINT}?${qs.toString()}`;\n}\n\n/** 电头站码 best-effort 提取（TAF/AMD/COR 剥词；剥不出返回空串）——与 mergeTafLines 同判式（aviationweather 取数线） */\nconst stationHeadOf = (raw: string): string => {\n  const toks = raw.split(/\\s+/);\n  let k = toks[0] === \"TAF\" ? 1 : 0;\n  while (toks[k] === \"AMD\" || toks[k] === \"COR\") k += 1;\n  const head = toks[k] ?? \"\";\n  return /^[A-Z0-9]{4}$/.test(head) ? head : \"\";\n};\n\n/**\n * ogimet 响应解析（<pre> 区）：12 位时间戳前缀行（YYYYMMDDHHmm，收报序）起新记录、无前缀行并入上一条\n * （多行报文并单——与私有管线 parse_tafs 同协议）；# 注释/空行跳过；只收 TAF 起头报文。\n * 站码 best-effort 取自电头（query 站名兜底）；空模板（无 <pre> 或零报文）返回空数组——\n * 由调用方判空（ogimet 缺数常见，属正常降级而非错误面）。\n */\nexport function parseOgimetTafs(html: string, fallbackStation = \"\"): TafObservation[] {\n  const pre = /<pre>([\\s\\S]*?)<\\/pre>/.exec(html);\n  if (pre === null) return [];\n  const PREFIX = /^(\\d{12})\\s+(.*)$/;\n  const merged: string[] = [];\n  for (const line of (pre[1] ?? \"\").split(\"\\n\")) {\n    const t = line.trim();\n    if (t === \"\" || t.startsWith(\"#\")) continue;\n    const pm = PREFIX.exec(t);\n    if (pm !== null) merged.push(pm[2] ?? \"\");\n    else if (merged.length > 0) merged[merged.length - 1] += ` ${t}`;\n  }\n  return merged\n    .filter((raw) => raw.startsWith(\"TAF\"))\n    .map((raw) => ({ station: stationHeadOf(raw) || fallbackStation, raw }));\n}\n\n/** Options for getTafsOgimet: fetch options plus the ogimet endpoint-root override. */\nexport interface GetTafsOgimetOptions {\n  /** 外部取消信号（与超时组合，任一触发即中止） */\n  signal?: AbortSignal;\n  /** 请求超时毫秒数（触发即中止并抛出超时错误） */\n  timeoutMs?: number;\n  /** ogimet 端点根覆盖（内网镜像/自建代理；examples 走 /ogimet-taf 代理根） */\n  baseUrl?: string;\n}\n\n/**\n * Fetch one station's recent TAFs from ogimet (latest + previous publication cycles).\n * 拉取单站的 ogimet 近窗 TAF（最新与上一发布周期——报池补充线，供与 aviationweather 线合并去重）。\n * 失败语义与 getTafs 同族（timeout/network/http-error 机读码）；空数据返回空数组而非抛错\n * （ogimet 站点级缺数常见——它是补充线，空窗属正常降级，不静默丢整批）。\n */\nexport async function getTafsOgimet(\n  station: string,\n  window: OgimetTafWindow,\n  options: GetTafsOgimetOptions = {},\n): Promise<TafObservation[]> {\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              new MetarSourceError(\n                \"timeout\",\n                \"ogimet\",\n                `ogimet TAF 请求超时（>${options.timeoutMs}ms，站=${station}）`,\n              ),\n            ),\n          options.timeoutMs,\n        );\n  try {\n    let res: Response;\n    try {\n      res = await fetch(ogimetTafUrl(station, window, options), { signal: controller.signal });\n    } catch (err) {\n      if (controller.signal.aborted) throw err;\n      const reason = err instanceof Error ? err.message : String(err);\n      throw new MetarSourceError(\n        \"network\",\n        \"ogimet\",\n        `网络请求失败（源：ogimet TAF，站=${station}）：${reason}`,\n        { cause: err },\n      );\n    }\n    if (!res.ok) {\n      throw new MetarSourceError(\n        \"http-error\",\n        \"ogimet\",\n        `ogimet TAF HTTP ${res.status}（站=${station}）`,\n      );\n    }\n    return parseOgimetTafs(await res.text(), station);\n  } finally {\n    if (timer !== undefined) clearTimeout(timer);\n    external?.removeEventListener(\"abort\", forward);\n  }\n}\n"],"mappings":";;;;AAsHA,MAAM,WAAW;;;;;;;AAQjB,SAAgB,eAAe,UAAU,YAAY,UAAU,UAAkB;CAC/E,OAAO,GAAG,QAAQ,+BAA+B,mBAAmB,OAAO;AAC7E;;AAGA,SAAS,cAAc,GAAmC;CACxD,IAAI,OAAO,MAAM,YAAY,MAAM,MAAM,OAAO;CAChD,MAAM,MAAM;CACZ,OAAO,OAAO,IAAI,YAAY,YAAY,OAAO,IAAI,QAAQ;AAC/D;;;;;;;;;AAUA,eAAsB,UACpB,UAAU,YACV,UAA4B,CAAC,GACA;CAE7B,MAAM,aAAa,IAAI,gBAAgB;CACvC,MAAM,WAAW,QAAQ;CACzB,MAAM,gBAAsB;EAC1B,WAAW,MAAM,UAAU,MAAM;CACnC;CACA,IAAI,aAAa,KAAA,GAAW;EAC1B,IAAI,SAAS,SAAS,QAAQ;OACzB,SAAS,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;CACjE;CACA,MAAM,QACJ,QAAQ,cAAc,KAAA,IAClB,KAAA,IACA,iBAEI,WAAW,MAET,IAAIA,eAAAA,iBACF,WACA,SACA,aAAa,QAAQ,UAAU,aAAa,QAAQ,EACtD,CACF,GACF,QAAQ,SACV;CACN,IAAI;EACF,IAAI;EACJ,IAAI;GACF,MAAM,MAAM,MAAM,eAAe,SAAS,QAAQ,OAAO,GAAG,EAAE,QAAQ,WAAW,OAAO,CAAC;EAC3F,SAAS,KAAK;GAIZ,IAAI,WAAW,OAAO,SAAS,MAAM;GACrC,MAAM,SAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;GAC9D,MAAM,IAAIA,eAAAA,iBACR,WACA,SACA,wBAAwB,QAAQ,gBAAgB,OAAO,IACvD,EAAE,OAAO,IAAI,CACf;EACF;EACA,IAAI,CAAC,IAAI,IACP,MAAM,IAAIA,eAAAA,iBACR,cACA,SACA,YAAY,IAAI,OAAO,WAAW,QAAQ,EAC5C;EAEF,IAAI;EACJ,IAAI;GACF,OAAO,MAAM,IAAI,KAAK;EACxB,SAAS,KAAK;GAGZ,IAAI,WAAW,OAAO,SAAS,MAAM;GACrC,MAAM,SAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;GAC9D,MAAM,IAAIA,eAAAA,iBACR,cACA,SACA,uCAAuC,QAAQ,IAAI,UACnD,EAAE,OAAO,IAAI,CACf;EACF;EACA,IACE,OAAO,SAAS,YAChB,SAAS,QACT,EAAE,UAAU,SACZ,CAAC,MAAM,QAAQ,KAAK,IAAI,GAExB,MAAM,IAAIA,eAAAA,iBACR,cACA,SACA,+BAA+B,QAAQ,YACzC;EAEF,MAAM,OAAO,KAAK;EAClB,IAAI,CAAC,KAAK,MAAM,aAAa,GAC3B,MAAM,IAAIA,eAAAA,iBACR,cACA,SACA,gDAAgD,QAAQ,YAC1D;EAEF,IAAI,KAAK,WAAW,GAElB,MAAM,IAAIA,eAAAA,iBACR,cACA,SACA,qBAAqB,QAAQ,4FAC/B;EAEF,OAAO;CACT,UAAU;EACR,IAAI,UAAU,KAAA,GAAW,aAAa,KAAK;EAC3C,UAAU,oBAAoB,SAAS,OAAO;CAChD;AACF;;;;;;;;;;;AAYA,eAAsB,gBACpB,UAAU,YACV,UAAkC,CAAC,GACP;CAC5B,MAAM,EAAE,UAAU,eAAe,OAAO,GAAG,iBAAiB;CAC5D,MAAM,QAAQ,IAAI,KAAK,YAAY,CAAC,EAAA,CAAG,KAAK,MAAM,CAAC,EAAE,MAAM,CAAC,CAAU,CAAC;CACvE,MAAM,eAAe,MAAM,UAAU,SAAS,YAAY;CAC1D,MAAM,QAA2B,CAAC;CAClC,MAAM,WAAqB,CAAC;CAC5B,KAAK,MAAM,OAAO,cAAc;EAC9B,MAAM,UAAU,MAAM,IAAI,IAAI,OAAO;EACrC,MAAM,MAAM,SAAS,OAAO,IAAI;EAChC,MAAM,MAAM,SAAS,OAAO,IAAI;EAChC,IAAI,QAAQ,QAAQ,QAAQ,MAAM;EAClC,IAAI;GACF,MAAM,KAAK;IACT,SAAA,GAAQC,iBAAAA,MAAAA,CAAM,IAAI,KAAK,UAAU,QAAQ,EAAE,OAAO,MAAM,IAAI,KAAA,CAAS;IACrE,UAAU,CAAC,KAAK,GAAG;IACnB,OAAO,GAAG,IAAI,UAAU,SAAS,OAAO,IAAI,QAAQ,SAAS;GAC/D,CAAC;EACH,SAAS,KAAK;GAEZ,IAAI,EAAE,eAAeC,eAAAA,kBAAkB,MAAM;GAC7C,IAAI,kBAAkB,KAAA,GAAW;IAC/B,cAAc;KAAE,SAAS,IAAI;KAAS,KAAK,IAAI;KAAK,MAAM,IAAI;KAAM,OAAO,IAAI;IAAQ,CAAC;IACxF;GACF;GACA,SAAS,KAAK,GAAG,IAAI,QAAQ,IAAI,IAAI,SAAS;EAChD;CACF;CACA,IAAI,SAAS,SAAS,GAAG;EAGvB,MAAM,UAAU,WAAW,QAAQ,aAAa,SAAS,OAAO,IAAI,SAAS,KAAK,IAAI;EACtF,MAAM,IAAIA,eAAAA,gBACR,sBACA,SACA,UAAU,SAAS,OAAO,aAAa,QAAQ,KAAK,SAAS,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,SAAS,SAAS,IAAI,OAAO,IACpH;CACF;CACA,OAAO;AACT;;AAKA,MAAa,kBAAkB;;;;;AAmC/B,SAAgB,SACd,KACA,UAAsD,CAAC,GAC/C;CACR,MAAM,SAAS,OAAO,QAAQ,WAAW,MAAM,IAAI,KAAK,GAAG;CAC3D,MAAM,SAAS,IAAI,gBAAgB;EAAE,KAAK;EAAQ,QAAQ;CAAM,CAAC;CACjE,MAAM,IAAI,QAAQ;CAClB,IAAI,MAAM,KAAA,GAAW,OAAO,IAAI,QAAQ,aAAa,OAAO,EAAE,YAAY,IAAI,CAAC;CAC/E,OAAO,GAAG,QAAQ,WAAA,2CAA2B,GAAG,OAAO,SAAS;AAClE;;AAGA,SAAS,cAAc,MAAgC;CACrD,MAAM,SAAmB,CAAC;CAC1B,KAAK,MAAM,QAAQ,KAAK,MAAM,IAAI,GAAG;EACnC,IAAI,KAAK,KAAK,MAAM,IAAI;EACxB,IAAI,MAAM,KAAK,IAAI,KAAK,OAAO,SAAS,GAAG,OAAO,OAAO,SAAS,MAAM,IAAI,KAAK,KAAK;OACjF,OAAO,KAAK,KAAK,KAAK,CAAC;CAC9B;CACA,OAAO,OAAO,KAAK,QAAQ;EACzB,MAAM,OAAO,IAAI,MAAM,KAAK;EAC5B,IAAI,IAAI,KAAK,OAAO,QAAQ,IAAI;EAChC,OAAO,KAAK,OAAO,SAAS,KAAK,OAAO,OAAO,KAAK;EACpD,MAAM,OAAO,KAAK,MAAM;EACxB,OAAO;GAAE,SAAS,gBAAgB,KAAK,IAAI,IAAI,OAAO;GAAI;EAAI;CAChE,CAAC;AACH;;;;;;;AAQA,eAAsB,QACpB,KACA,UAA0B,CAAC,GACA;CAE3B,MAAM,aAAa,IAAI,gBAAgB;CACvC,MAAM,WAAW,QAAQ;CACzB,MAAM,gBAAsB;EAC1B,WAAW,MAAM,UAAU,MAAM;CACnC;CACA,IAAI,aAAa,KAAA,GAAW;EAC1B,IAAI,SAAS,SAAS,QAAQ;OACzB,SAAS,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;CACjE;CACA,MAAM,QACJ,QAAQ,cAAc,KAAA,IAClB,KAAA,IACA,iBAEI,WAAW,MACT,IAAIF,eAAAA,iBACF,WACA,mBACA,6BAA6B,QAAQ,UAAU,IACjD,CACF,GACF,QAAQ,SACV;CACN,IAAI;EACF,IAAI;EACJ,IAAI;GACF,MAAM,MAAM,MAAM,SAAS,KAAK,OAAO,GAAG,EAAE,QAAQ,WAAW,OAAO,CAAC;EACzE,SAAS,KAAK;GAEZ,IAAI,WAAW,OAAO,SAAS,MAAM;GACrC,MAAM,SAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;GAC9D,MAAM,IAAIA,eAAAA,iBACR,WACA,mBACA,6CAA6C,OAAO,IACpD,EAAE,OAAO,IAAI,CACf;EACF;EACA,IAAI,CAAC,IAAI,IACP,MAAM,IAAIA,eAAAA,iBACR,cACA,mBACA,4BAA4B,IAAI,QAClC;EAEF,IAAI;EACJ,IAAI;GACF,OAAO,MAAM,IAAI,KAAK;EACxB,SAAS,KAAK;GACZ,IAAI,WAAW,OAAO,SAAS,MAAM;GACrC,MAAM,SAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;GAC9D,MAAM,IAAIA,eAAAA,iBACR,WACA,mBACA,8BAA8B,UAC9B,EAAE,OAAO,IAAI,CACf;EACF;EACA,MAAM,OAAO,cAAc,IAAI;EAC/B,IAAI,KAAK,WAAW,GAClB,MAAM,IAAIA,eAAAA,iBACR,cACA,mBACA,kEACF;EAEF,OAAO;CACT,UAAU;EACR,IAAI,UAAU,KAAA,GAAW,aAAa,KAAK;EAC3C,UAAU,oBAAoB,SAAS,OAAO;CAChD;AACF;;;;;;AA8BA,eAAsB,cACpB,KACA,UAAgC,CAAC,GACP;CAC1B,MAAM,EAAE,UAAU,eAAe,OAAO,GAAG,iBAAiB;CAC5D,MAAM,QAAQ,IAAI,KAAK,YAAY,CAAC,EAAA,CAAG,KAAK,MAAM,CAAC,EAAE,MAAM,CAAC,CAAU,CAAC;CACvE,MAAM,eAAe,MAAM,QAAQ,KAAK,YAAY;CACpD,MAAM,QAAyB,CAAC;CAChC,MAAM,WAAqB,CAAC;CAC5B,KAAK,MAAM,OAAO,cAChB,IAAI;EACF,MAAM,UAAA,GAASG,iBAAAA,SAAAA,CAAS,IAAI,KAAK,UAAU,QAAQ,EAAE,OAAO,MAAM,IAAI,KAAA,CAAS;EAC/E,MAAM,UAAU,MAAM,IAAI,OAAO,OAAO;EACxC,IAAI,YAAY,KAAA,GAAW;EAC3B,MAAM,KAAK;GACT;GACA,UAAU,CAAC,QAAQ,KAAK,QAAQ,GAAG;GACnC,OAAO,GAAG,OAAO,UAAU,QAAQ,OAAO,IAAI,QAAQ,SAAS;EACjE,CAAC;CACH,SAAS,KAAK;EAEZ,IAAI,EAAE,eAAeD,eAAAA,kBAAkB,MAAM;EAC7C,IAAI,kBAAkB,KAAA,GAAW;GAC/B,cAAc;IAAE,SAAS,IAAI;IAAS,KAAK,IAAI;IAAK,MAAM,IAAI;IAAM,OAAO,IAAI;GAAQ,CAAC;GACxF;EACF;EACA,SAAS,KAAK,GAAG,IAAI,QAAQ,IAAI,IAAI,SAAS;CAChD;CAEF,IAAI,SAAS,SAAS,GAAG;EACvB,MAAM,UAAU,oCAAoC,SAAS,OAAO,IAAI,SAAS,KAAK,IAAI;EAC1F,MAAM,IAAIA,eAAAA,gBACR,sBACA,SACA,YAAY,SAAS,OAAO,uBAAuB,SAAS,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,SAAS,SAAS,IAAI,OAAO,IACnH;CACF;CACA,OAAO;AACT;;AAKA,MAAa,sBAAsB;;;;;;AAanC,MAAM,gBACJ,OAC0E;CAC1E,KAAK,GAAG,EAAE,eAAe;CACzB,KAAK,GAAG,EAAE,YAAY,IAAI,IAAI,SAAS,GAAG,GAAG;CAC7C,KAAK,GAAG,EAAE,WAAW,IAAI,SAAS,GAAG,GAAG;CACxC,MAAM,GAAG,EAAE,YAAY,IAAI,SAAS,GAAG,GAAG;CAC1C,KAAK,GAAG,EAAE,cAAc,IAAI,SAAS,GAAG,GAAG;AAC7C;AAEA,SAAgB,aACd,SACA,QACA,UAAgC,CAAC,GACzB;CACR,MAAM,IAAI,aAAa,OAAO,IAAI;CAClC,MAAM,IAAI,aAAa,OAAO,EAAE;CAChC,MAAM,KAAK,IAAI,gBAAgB;EAC7B,MAAM;EACN,OAAO;EACP,MAAM;EACN,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,EAAE;EACP,KAAK,EAAE;EACP,KAAK,EAAE;EACP,MAAM,EAAE;EACR,KAAK,EAAE;EACP,MAAM,EAAE;EACR,MAAM,EAAE;EACR,MAAM,EAAE;EACR,OAAO,EAAE;EACT,MAAM,EAAE;EACR,MAAM;EACN,SAAS;EACT,OAAO;EACP,MAAM;CACR,CAAC;CACD,OAAO,GAAG,QAAQ,WAAA,6CAA+B,GAAG,GAAG,SAAS;AAClE;;AAGA,MAAM,iBAAiB,QAAwB;CAC7C,MAAM,OAAO,IAAI,MAAM,KAAK;CAC5B,IAAI,IAAI,KAAK,OAAO,QAAQ,IAAI;CAChC,OAAO,KAAK,OAAO,SAAS,KAAK,OAAO,OAAO,KAAK;CACpD,MAAM,OAAO,KAAK,MAAM;CACxB,OAAO,gBAAgB,KAAK,IAAI,IAAI,OAAO;AAC7C;;;;;;;AAQA,SAAgB,gBAAgB,MAAc,kBAAkB,IAAsB;CACpF,MAAM,MAAM,yBAAyB,KAAK,IAAI;CAC9C,IAAI,QAAQ,MAAM,OAAO,CAAC;CAC1B,MAAM,SAAS;CACf,MAAM,SAAmB,CAAC;CAC1B,KAAK,MAAM,SAAS,IAAI,MAAM,GAAA,CAAI,MAAM,IAAI,GAAG;EAC7C,MAAM,IAAI,KAAK,KAAK;EACpB,IAAI,MAAM,MAAM,EAAE,WAAW,GAAG,GAAG;EACnC,MAAM,KAAK,OAAO,KAAK,CAAC;EACxB,IAAI,OAAO,MAAM,OAAO,KAAK,GAAG,MAAM,EAAE;OACnC,IAAI,OAAO,SAAS,GAAG,OAAO,OAAO,SAAS,MAAM,IAAI;CAC/D;CACA,OAAO,OACJ,QAAQ,QAAQ,IAAI,WAAW,KAAK,CAAC,CAAC,CACtC,KAAK,SAAS;EAAE,SAAS,cAAc,GAAG,KAAK;EAAiB;CAAI,EAAE;AAC3E;;;;;;;AAkBA,eAAsB,cACpB,SACA,QACA,UAAgC,CAAC,GACN;CAC3B,MAAM,aAAa,IAAI,gBAAgB;CACvC,MAAM,WAAW,QAAQ;CACzB,MAAM,gBAAsB;EAC1B,WAAW,MAAM,UAAU,MAAM;CACnC;CACA,IAAI,aAAa,KAAA,GAAW;EAC1B,IAAI,SAAS,SAAS,QAAQ;OACzB,SAAS,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;CACjE;CACA,MAAM,QACJ,QAAQ,cAAc,KAAA,IAClB,KAAA,IACA,iBAEI,WAAW,MACT,IAAIF,eAAAA,iBACF,WACA,UACA,oBAAoB,QAAQ,UAAU,OAAO,QAAQ,EACvD,CACF,GACF,QAAQ,SACV;CACN,IAAI;EACF,IAAI;EACJ,IAAI;GACF,MAAM,MAAM,MAAM,aAAa,SAAS,QAAQ,OAAO,GAAG,EAAE,QAAQ,WAAW,OAAO,CAAC;EACzF,SAAS,KAAK;GACZ,IAAI,WAAW,OAAO,SAAS,MAAM;GACrC,MAAM,SAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;GAC9D,MAAM,IAAIA,eAAAA,iBACR,WACA,UACA,yBAAyB,QAAQ,IAAI,UACrC,EAAE,OAAO,IAAI,CACf;EACF;EACA,IAAI,CAAC,IAAI,IACP,MAAM,IAAIA,eAAAA,iBACR,cACA,UACA,mBAAmB,IAAI,OAAO,KAAK,QAAQ,EAC7C;EAEF,OAAO,gBAAgB,MAAM,IAAI,KAAK,GAAG,OAAO;CAClD,UAAU;EACR,IAAI,UAAU,KAAA,GAAW,aAAa,KAAK;EAC3C,UAAU,oBAAoB,SAAS,OAAO;CAChD;AACF"}

package/dist/sources.d.cts

@@ -1,4 +1,4 @@
-import { MetarParseError, MetarParseErrorCode, MetarReport, MetarSourceError } from "@metweave/core";
+import { MetarParseError, MetarParseErrorCode, MetarReport, MetarSourceError, TafReport } from "@metweave/core";
 //#region src/sources.d.ts
 /**
  * One fetched observation row: station, verbatim raw report, and source-provided coordinates (city-level for IEM China rows).
@@ -21,6 +21,11 @@ export interface GetMetarsOptions {
   signal?: AbortSignal;
   /** 请求超时毫秒数（触发即中止并抛出超时错误） */
   timeoutMs?: number;
+  /**
+   * IEM 站点根覆盖（缺省官方 https://mesonet.agron.iastate.edu）：内网镜像/自建网关
+   * 只换根——/api/1/currents.json 路径与查询串由本层拼装（换源口径，见文件头）。
+   */
+  baseUrl?: string;
 }
 /**
  * Station metadata for lookup joins: authoritative coordinates overriding the source's city-level ones.
@@ -90,8 +95,9 @@ export interface MetarReportItem {
  * The IEM whole-network currents endpoint (CORS-open, direct browser access). Defaults to the China ASOS network (39 stations).
  * IEM 整网实况端点（CORS 全开，浏览器可直连）。缺省中国 ASOS 网（39 站）。
  * @param network - IEM network name (e.g. CN__ASOS, RU__ASOS, IA_ASOS). IEM 网络名。
+ * @param baseUrl - IEM 站点根覆盖（内网镜像/自建网关——换源口径，见 GetMetarsOptions.baseUrl）。
  */
-export declare function iemCurrentsUrl(network?: string): string;
+export declare function iemCurrentsUrl(network?: string, baseUrl?: string): string;
 /**
  * Fetch IEM whole-network current observations (station/raw/coordinates passed through).
  * 拉取 IEM 整网实况观测（station/raw/坐标透传）。
@@ -112,6 +118,110 @@ export declare function getMetars(network?: string, options?: GetMetarsOptions):
  * 传 options.onUnparseable 则逐行容错——失败行跳过并逐条回调（可观测），好行照常返回。
  */
 export declare function getMetarReports(network?: string, options?: GetMetarReportsOptions): Promise<MetarReportItem[]>;
+/** aviationweather TAF 数据端点（上游无 CORS 头：浏览器直连须自建代理/镜像——baseUrl 覆盖即为此用） */
+export declare const AW_TAF_ENDPOINT = "https://aviationweather.gov/api/data/taf";
+/**
+ * One fetched TAF row: station (best-effort) and the verbatim report (continuation lines already merged).
+ * 单条 TAF 取数行：站码（best-effort）与报文原文（续行已归并）。
+ */
+export interface TafObservation {
+  /** 站码：剥 TAF/AMD/COR 电头词后的首枚 4 位码；剥不出为 ""（解析层 missing-station 兜底出声） */
+  station: string;
+  /** 报文原文（上游 raw 格式的缩进续行已并回所属报文；report.raw 语义一致——原文保真） */
+  raw: string;
+}
+/** Options for getTafs: fetch options plus the TAF endpoint-root override and the as-of date. */
+export interface GetTafsOptions {
+  /** 外部取消信号（与超时组合，任一触发即中止） */
+  signal?: AbortSignal;
+  /** 请求超时毫秒数（触发即中止并抛出超时错误） */
+  timeoutMs?: number;
+  /**
+   * TAF 端点根覆盖（缺省官方 https://aviationweather.gov/api/data/taf）：内网镜像/自建代理
+   * 只换根——?ids=&format=raw 查询串由本层拼装（换源口径，见文件头；examples 即用 /aw-taf 代理根）。
+   */
+  baseUrl?: string;
+  /**
+   * 「该时刻已发布的最新报」（上游 date 参数语义）：回看上一发布周期用（examples 报池即 date=now-4h）。
+   * Date 转 ISO；字符串原样透传（上游亦收相对形态）。
+   */
+  date?: Date | string;
+}
+/**
+ * The aviationweather TAF endpoint (raw format). ids joined as given; date serialized when present.
+ * aviationweather TAF 端点模板（format=raw）。ids 数组逗号连接；date 存在时序列化为查询参数。
+ */
+export declare function awTafUrl(ids: string | readonly string[], options?: {
+  baseUrl?: string;
+  date?: Date | string;
+}): string;
+/**
+ * Fetch aviationweather TAFs (raw format) with station extracted and continuation lines merged.
+ * 拉取 aviationweather TAF（raw 格式）：续行归并 + 站码提取的取数侧整理。
+ * 失败语义与 getMetars 同族（不静默）：timeout/network/http-error/empty-data 一律 MetarSourceError
+ * 机读码；上游对未知 ids 也返回 200 + 空体，空数据显式 throw 而非空数组静默。
+ */
+export declare function getTafs(ids: string | readonly string[], options?: GetTafsOptions): Promise<TafObservation[]>;
+/** Options for getTafReports: fetch options plus station metadata and the per-row tolerance callback. */
+export interface GetTafReportsOptions extends GetTafsOptions {
+  /** 按 icao 联表的站点元数据（TAF 端点不提供坐标——stations 是定位的唯一来源，缺省将得空数组） */
+  stations?: readonly StationRef[];
+  /** 逐行容错（缺省关闭）：传入时解析失败的行跳过并逐条回调；不传时聚合抛出（全有或全无） */
+  onUnparseable?: (failure: UnparseableReport) => void;
+  /** 紧凑模式：parseTaf 产物剥除全部 span 字段（存储场景推荐）；缺省完整模式 */
+  spans?: false;
+}
+/**
+ * A map-ready TAF item (structurally compatible with TafLayerItem's report/position/title triple).
+ * 可直接喂给地图适配器（如 addTafLayer）的预报项：{ report, position, title } 三件套。
+ */
+export interface TafReportItem {
+  /** 已解析的 TAF IR（原文经 report.raw 原样保真） */
+  report: TafReport;
+  /** 站点坐标（WGS-84 [lat, lon]；TAF 端点无坐标，来自 stations 联表） */
+  position: [number, number];
+  /** 站点提示（「ICAO 站名」；适配器缺省回落 IR 站名） */
+  title: string;
+}
+/**
+ * TAF 版的取数 → 解析 → 定位一步到位（契约沿 getMetarReports）：stations 命中的站带精确坐标与站名，
+ * 未命中跳过（TAF 端点无坐标可回落，与 getMetarReports 的无坐标跳行同规则）；解析失败两种模式
+ * （缺省聚合抛出 batch-parse-failed、传 onUnparseable 逐行容错）。报池等数据管理逻辑不进本层。
+ */
+export declare function getTafReports(ids: string | readonly string[], options?: GetTafReportsOptions): Promise<TafReportItem[]>;
+/** ogimet display_metars2.php 端点（tipo=FT＝TAF；无 CORS 头：浏览器直连须代理/镜像——baseUrl 覆盖即为此用） */
+export declare const OGIMET_TAF_ENDPOINT = "https://www.ogimet.com/display_metars2.php";
+/** ogimet 查询窗（UTC 起止） */
+export interface OgimetTafWindow {
+  readonly from: Date;
+  readonly to: Date;
+}
+export declare function ogimetTafUrl(station: string, window: OgimetTafWindow, options?: {
+  baseUrl?: string;
+}): string;
+/**
+ * ogimet 响应解析（<pre> 区）：12 位时间戳前缀行（YYYYMMDDHHmm，收报序）起新记录、无前缀行并入上一条
+ * （多行报文并单——与私有管线 parse_tafs 同协议）；# 注释/空行跳过；只收 TAF 起头报文。
+ * 站码 best-effort 取自电头（query 站名兜底）；空模板（无 <pre> 或零报文）返回空数组——
+ * 由调用方判空（ogimet 缺数常见，属正常降级而非错误面）。
+ */
+export declare function parseOgimetTafs(html: string, fallbackStation?: string): TafObservation[];
+/** Options for getTafsOgimet: fetch options plus the ogimet endpoint-root override. */
+export interface GetTafsOgimetOptions {
+  /** 外部取消信号（与超时组合，任一触发即中止） */
+  signal?: AbortSignal;
+  /** 请求超时毫秒数（触发即中止并抛出超时错误） */
+  timeoutMs?: number;
+  /** ogimet 端点根覆盖（内网镜像/自建代理；examples 走 /ogimet-taf 代理根） */
+  baseUrl?: string;
+}
+/**
+ * Fetch one station's recent TAFs from ogimet (latest + previous publication cycles).
+ * 拉取单站的 ogimet 近窗 TAF（最新与上一发布周期——报池补充线，供与 aviationweather 线合并去重）。
+ * 失败语义与 getTafs 同族（timeout/network/http-error 机读码）；空数据返回空数组而非抛错
+ * （ogimet 站点级缺数常见——它是补充线，空窗属正常降级，不静默丢整批）。
+ */
+export declare function getTafsOgimet(station: string, window: OgimetTafWindow, options?: GetTafsOgimetOptions): Promise<TafObservation[]>;
 //#endregion
 export { MetarParseError, MetarSourceError };
 //# sourceMappingURL=sources.d.cts.map

package/dist/sources.d.ts

@@ -1,4 +1,4 @@
-import { MetarParseError, MetarParseErrorCode, MetarReport, MetarSourceError } from "@metweave/core";
+import { MetarParseError, MetarParseErrorCode, MetarReport, MetarSourceError, TafReport } from "@metweave/core";
 //#region src/sources.d.ts
 /**
  * One fetched observation row: station, verbatim raw report, and source-provided coordinates (city-level for IEM China rows).
@@ -21,6 +21,11 @@ export interface GetMetarsOptions {
   signal?: AbortSignal;
   /** 请求超时毫秒数（触发即中止并抛出超时错误） */
   timeoutMs?: number;
+  /**
+   * IEM 站点根覆盖（缺省官方 https://mesonet.agron.iastate.edu）：内网镜像/自建网关
+   * 只换根——/api/1/currents.json 路径与查询串由本层拼装（换源口径，见文件头）。
+   */
+  baseUrl?: string;
 }
 /**
  * Station metadata for lookup joins: authoritative coordinates overriding the source's city-level ones.
@@ -90,8 +95,9 @@ export interface MetarReportItem {
  * The IEM whole-network currents endpoint (CORS-open, direct browser access). Defaults to the China ASOS network (39 stations).
  * IEM 整网实况端点（CORS 全开，浏览器可直连）。缺省中国 ASOS 网（39 站）。
  * @param network - IEM network name (e.g. CN__ASOS, RU__ASOS, IA_ASOS). IEM 网络名。
+ * @param baseUrl - IEM 站点根覆盖（内网镜像/自建网关——换源口径，见 GetMetarsOptions.baseUrl）。
  */
-export declare function iemCurrentsUrl(network?: string): string;
+export declare function iemCurrentsUrl(network?: string, baseUrl?: string): string;
 /**
  * Fetch IEM whole-network current observations (station/raw/coordinates passed through).
  * 拉取 IEM 整网实况观测（station/raw/坐标透传）。
@@ -112,6 +118,110 @@ export declare function getMetars(network?: string, options?: GetMetarsOptions):
  * 传 options.onUnparseable 则逐行容错——失败行跳过并逐条回调（可观测），好行照常返回。
  */
 export declare function getMetarReports(network?: string, options?: GetMetarReportsOptions): Promise<MetarReportItem[]>;
+/** aviationweather TAF 数据端点（上游无 CORS 头：浏览器直连须自建代理/镜像——baseUrl 覆盖即为此用） */
+export declare const AW_TAF_ENDPOINT = "https://aviationweather.gov/api/data/taf";
+/**
+ * One fetched TAF row: station (best-effort) and the verbatim report (continuation lines already merged).
+ * 单条 TAF 取数行：站码（best-effort）与报文原文（续行已归并）。
+ */
+export interface TafObservation {
+  /** 站码：剥 TAF/AMD/COR 电头词后的首枚 4 位码；剥不出为 ""（解析层 missing-station 兜底出声） */
+  station: string;
+  /** 报文原文（上游 raw 格式的缩进续行已并回所属报文；report.raw 语义一致——原文保真） */
+  raw: string;
+}
+/** Options for getTafs: fetch options plus the TAF endpoint-root override and the as-of date. */
+export interface GetTafsOptions {
+  /** 外部取消信号（与超时组合，任一触发即中止） */
+  signal?: AbortSignal;
+  /** 请求超时毫秒数（触发即中止并抛出超时错误） */
+  timeoutMs?: number;
+  /**
+   * TAF 端点根覆盖（缺省官方 https://aviationweather.gov/api/data/taf）：内网镜像/自建代理
+   * 只换根——?ids=&format=raw 查询串由本层拼装（换源口径，见文件头；examples 即用 /aw-taf 代理根）。
+   */
+  baseUrl?: string;
+  /**
+   * 「该时刻已发布的最新报」（上游 date 参数语义）：回看上一发布周期用（examples 报池即 date=now-4h）。
+   * Date 转 ISO；字符串原样透传（上游亦收相对形态）。
+   */
+  date?: Date | string;
+}
+/**
+ * The aviationweather TAF endpoint (raw format). ids joined as given; date serialized when present.
+ * aviationweather TAF 端点模板（format=raw）。ids 数组逗号连接；date 存在时序列化为查询参数。
+ */
+export declare function awTafUrl(ids: string | readonly string[], options?: {
+  baseUrl?: string;
+  date?: Date | string;
+}): string;
+/**
+ * Fetch aviationweather TAFs (raw format) with station extracted and continuation lines merged.
+ * 拉取 aviationweather TAF（raw 格式）：续行归并 + 站码提取的取数侧整理。
+ * 失败语义与 getMetars 同族（不静默）：timeout/network/http-error/empty-data 一律 MetarSourceError
+ * 机读码；上游对未知 ids 也返回 200 + 空体，空数据显式 throw 而非空数组静默。
+ */
+export declare function getTafs(ids: string | readonly string[], options?: GetTafsOptions): Promise<TafObservation[]>;
+/** Options for getTafReports: fetch options plus station metadata and the per-row tolerance callback. */
+export interface GetTafReportsOptions extends GetTafsOptions {
+  /** 按 icao 联表的站点元数据（TAF 端点不提供坐标——stations 是定位的唯一来源，缺省将得空数组） */
+  stations?: readonly StationRef[];
+  /** 逐行容错（缺省关闭）：传入时解析失败的行跳过并逐条回调；不传时聚合抛出（全有或全无） */
+  onUnparseable?: (failure: UnparseableReport) => void;
+  /** 紧凑模式：parseTaf 产物剥除全部 span 字段（存储场景推荐）；缺省完整模式 */
+  spans?: false;
+}
+/**
+ * A map-ready TAF item (structurally compatible with TafLayerItem's report/position/title triple).
+ * 可直接喂给地图适配器（如 addTafLayer）的预报项：{ report, position, title } 三件套。
+ */
+export interface TafReportItem {
+  /** 已解析的 TAF IR（原文经 report.raw 原样保真） */
+  report: TafReport;
+  /** 站点坐标（WGS-84 [lat, lon]；TAF 端点无坐标，来自 stations 联表） */
+  position: [number, number];
+  /** 站点提示（「ICAO 站名」；适配器缺省回落 IR 站名） */
+  title: string;
+}
+/**
+ * TAF 版的取数 → 解析 → 定位一步到位（契约沿 getMetarReports）：stations 命中的站带精确坐标与站名，
+ * 未命中跳过（TAF 端点无坐标可回落，与 getMetarReports 的无坐标跳行同规则）；解析失败两种模式
+ * （缺省聚合抛出 batch-parse-failed、传 onUnparseable 逐行容错）。报池等数据管理逻辑不进本层。
+ */
+export declare function getTafReports(ids: string | readonly string[], options?: GetTafReportsOptions): Promise<TafReportItem[]>;
+/** ogimet display_metars2.php 端点（tipo=FT＝TAF；无 CORS 头：浏览器直连须代理/镜像——baseUrl 覆盖即为此用） */
+export declare const OGIMET_TAF_ENDPOINT = "https://www.ogimet.com/display_metars2.php";
+/** ogimet 查询窗（UTC 起止） */
+export interface OgimetTafWindow {
+  readonly from: Date;
+  readonly to: Date;
+}
+export declare function ogimetTafUrl(station: string, window: OgimetTafWindow, options?: {
+  baseUrl?: string;
+}): string;
+/**
+ * ogimet 响应解析（<pre> 区）：12 位时间戳前缀行（YYYYMMDDHHmm，收报序）起新记录、无前缀行并入上一条
+ * （多行报文并单——与私有管线 parse_tafs 同协议）；# 注释/空行跳过；只收 TAF 起头报文。
+ * 站码 best-effort 取自电头（query 站名兜底）；空模板（无 <pre> 或零报文）返回空数组——
+ * 由调用方判空（ogimet 缺数常见，属正常降级而非错误面）。
+ */
+export declare function parseOgimetTafs(html: string, fallbackStation?: string): TafObservation[];
+/** Options for getTafsOgimet: fetch options plus the ogimet endpoint-root override. */
+export interface GetTafsOgimetOptions {
+  /** 外部取消信号（与超时组合，任一触发即中止） */
+  signal?: AbortSignal;
+  /** 请求超时毫秒数（触发即中止并抛出超时错误） */
+  timeoutMs?: number;
+  /** ogimet 端点根覆盖（内网镜像/自建代理；examples 走 /ogimet-taf 代理根） */
+  baseUrl?: string;
+}
+/**
+ * Fetch one station's recent TAFs from ogimet (latest + previous publication cycles).
+ * 拉取单站的 ogimet 近窗 TAF（最新与上一发布周期——报池补充线，供与 aviationweather 线合并去重）。
+ * 失败语义与 getTafs 同族（timeout/network/http-error 机读码）；空数据返回空数组而非抛错
+ * （ogimet 站点级缺数常见——它是补充线，空窗属正常降级，不静默丢整批）。
+ */
+export declare function getTafsOgimet(station: string, window: OgimetTafWindow, options?: GetTafsOgimetOptions): Promise<TafObservation[]>;
 //#endregion
 export { MetarParseError, MetarSourceError };
 //# sourceMappingURL=sources.d.ts.map

package/dist/sources.js

@@ -1,14 +1,15 @@
 import { MetarParseError, MetarParseError as MetarParseError$1, MetarSourceError, MetarSourceError as MetarSourceError$1 } from "@metweave/core";
-import { parse } from "@metweave/parser";
+import { parse, parseTaf } from "@metweave/parser";
 //#region src/sources.ts
 const IEM_BASE = "https://mesonet.agron.iastate.edu";
 /**
 * The IEM whole-network currents endpoint (CORS-open, direct browser access). Defaults to the China ASOS network (39 stations).
 * IEM 整网实况端点（CORS 全开，浏览器可直连）。缺省中国 ASOS 网（39 站）。
 * @param network - IEM network name (e.g. CN__ASOS, RU__ASOS, IA_ASOS). IEM 网络名。
+* @param baseUrl - IEM 站点根覆盖（内网镜像/自建网关——换源口径，见 GetMetarsOptions.baseUrl）。
 */
-function iemCurrentsUrl(network = "CN__ASOS") {
-	return `${IEM_BASE}/api/1/currents.json?network=${encodeURIComponent(network)}`;
+function iemCurrentsUrl(network = "CN__ASOS", baseUrl = IEM_BASE) {
+	return `${baseUrl}/api/1/currents.json?network=${encodeURIComponent(network)}`;
 }
 /** 观测记录守卫：station/raw 均须为字符串（只查键不查类型是旧洞）。 */
 function isObservation(v) {
@@ -38,7 +39,7 @@ async function getMetars(network = "CN__ASOS", options = {}) {
 	try {
 		let res;
 		try {
-			res = await fetch(iemCurrentsUrl(network), { signal: controller.signal });
+			res = await fetch(iemCurrentsUrl(network, options.baseUrl), { signal: controller.signal });
 		} catch (err) {
 			if (controller.signal.aborted) throw err;
 			const reason = err instanceof Error ? err.message : String(err);
@@ -110,7 +111,229 @@ async function getMetarReports(network = "CN__ASOS", options = {}) {
 	}
 	return items;
 }
+/** aviationweather TAF 数据端点（上游无 CORS 头：浏览器直连须自建代理/镜像——baseUrl 覆盖即为此用） */
+const AW_TAF_ENDPOINT = "https://aviationweather.gov/api/data/taf";
+/**
+* The aviationweather TAF endpoint (raw format). ids joined as given; date serialized when present.
+* aviationweather TAF 端点模板（format=raw）。ids 数组逗号连接；date 存在时序列化为查询参数。
+*/
+function awTafUrl(ids, options = {}) {
+	const idList = typeof ids === "string" ? ids : ids.join(",");
+	const params = new URLSearchParams({
+		ids: idList,
+		format: "raw"
+	});
+	const d = options.date;
+	if (d !== void 0) params.set("date", d instanceof Date ? d.toISOString() : d);
+	return `${options.baseUrl ?? "https://aviationweather.gov/api/data/taf"}?${params.toString()}`;
+}
+/** raw 文本 → 整份报文行（缩进续行并回上一份；与报池语义同源）+ best-effort 站码提取 */
+function mergeTafLines(text) {
+	const merged = [];
+	for (const line of text.split("\n")) {
+		if (line.trim() === "") continue;
+		if (/^\s/.test(line) && merged.length > 0) merged[merged.length - 1] += ` ${line.trim()}`;
+		else merged.push(line.trim());
+	}
+	return merged.map((raw) => {
+		const toks = raw.split(/\s+/);
+		let k = toks[0] === "TAF" ? 1 : 0;
+		while (toks[k] === "AMD" || toks[k] === "COR") k += 1;
+		const head = toks[k] ?? "";
+		return {
+			station: /^[A-Z0-9]{4}$/.test(head) ? head : "",
+			raw
+		};
+	});
+}
+/**
+* Fetch aviationweather TAFs (raw format) with station extracted and continuation lines merged.
+* 拉取 aviationweather TAF（raw 格式）：续行归并 + 站码提取的取数侧整理。
+* 失败语义与 getMetars 同族（不静默）：timeout/network/http-error/empty-data 一律 MetarSourceError
+* 机读码；上游对未知 ids 也返回 200 + 空体，空数据显式 throw 而非空数组静默。
+*/
+async function getTafs(ids, options = {}) {
+	const controller = new AbortController();
+	const external = options.signal;
+	const forward = () => {
+		controller.abort(external?.reason);
+	};
+	if (external !== void 0) {
+		if (external.aborted) forward();
+		else external.addEventListener("abort", forward, { once: true });
+	}
+	const timer = options.timeoutMs === void 0 ? void 0 : setTimeout(() => controller.abort(new MetarSourceError$1("timeout", "aviationweather", `aviationweather TAF 请求超时（>${options.timeoutMs}ms）`)), options.timeoutMs);
+	try {
+		let res;
+		try {
+			res = await fetch(awTafUrl(ids, options), { signal: controller.signal });
+		} catch (err) {
+			if (controller.signal.aborted) throw err;
+			const reason = err instanceof Error ? err.message : String(err);
+			throw new MetarSourceError$1("network", "aviationweather", `网络请求失败（源：aviationweather TAF）：请检查网络连通性后重试（${reason}）`, { cause: err });
+		}
+		if (!res.ok) throw new MetarSourceError$1("http-error", "aviationweather", `aviationweather TAF HTTP ${res.status}`);
+		let text;
+		try {
+			text = await res.text();
+		} catch (err) {
+			if (controller.signal.aborted) throw err;
+			const reason = err instanceof Error ? err.message : String(err);
+			throw new MetarSourceError$1("network", "aviationweather", `aviationweather TAF 响应读取失败：${reason}`, { cause: err });
+		}
+		const rows = mergeTafLines(text);
+		if (rows.length === 0) throw new MetarSourceError$1("empty-data", "aviationweather", "aviationweather TAF 返回空数据——请核对 ids 站码（如 ZBAA,ZBAD；端点 format=raw）");
+		return rows;
+	} finally {
+		if (timer !== void 0) clearTimeout(timer);
+		external?.removeEventListener("abort", forward);
+	}
+}
+/**
+* TAF 版的取数 → 解析 → 定位一步到位（契约沿 getMetarReports）：stations 命中的站带精确坐标与站名，
+* 未命中跳过（TAF 端点无坐标可回落，与 getMetarReports 的无坐标跳行同规则）；解析失败两种模式
+* （缺省聚合抛出 batch-parse-failed、传 onUnparseable 逐行容错）。报池等数据管理逻辑不进本层。
+*/
+async function getTafReports(ids, options = {}) {
+	const { stations, onUnparseable, spans, ...fetchOptions } = options;
+	const table = new Map((stations ?? []).map((s) => [s.icao, s]));
+	const observations = await getTafs(ids, fetchOptions);
+	const items = [];
+	const failures = [];
+	for (const obs of observations) try {
+		const report = parseTaf(obs.raw, spans === false ? { spans: false } : void 0);
+		const station = table.get(report.station);
+		if (station === void 0) continue;
+		items.push({
+			report,
+			position: [station.lat, station.lon],
+			title: `${report.station}${station.name ? ` ${station.name}` : ""}`
+		});
+	} catch (err) {
+		if (!(err instanceof MetarParseError$1)) throw err;
+		if (onUnparseable !== void 0) {
+			onUnparseable({
+				station: obs.station,
+				raw: obs.raw,
+				code: err.code,
+				error: err.message
+			});
+			continue;
+		}
+		failures.push(`${obs.station}: ${err.message}`);
+	}
+	if (failures.length > 0) {
+		const summary = `source=aviationweather; failures=${failures.length}; ${failures.join("; ")}`;
+		throw new MetarParseError$1("batch-parse-failed", summary, `TAF 解析失败 ${failures.length} 条（aviationweather）——${failures.slice(0, 3).join("；")}${failures.length > 3 ? "……" : ""}`);
+	}
+	return items;
+}
+/** ogimet display_metars2.php 端点（tipo=FT＝TAF；无 CORS 头：浏览器直连须代理/镜像——baseUrl 覆盖即为此用） */
+const OGIMET_TAF_ENDPOINT = "https://www.ogimet.com/display_metars2.php";
+/**
+* ogimet TAF 端点模板（配方＝私有管线 backfill_ogimet.py 同源）：tipo=FT、txt 形、
+* 服务端按 <pre> 区回 HTML（解析见 parseOgimetTafs）。免费公益服务——调用方自行节制频率。
+*/
+/** UTC 日期字段补零组（ogimet 查询串的 ano/mes/day/hora/min 族） */
+const ogimetFields = (d) => ({
+	ano: `${d.getUTCFullYear()}`,
+	mes: `${d.getUTCMonth() + 1}`.padStart(2, "0"),
+	day: `${d.getUTCDate()}`.padStart(2, "0"),
+	hora: `${d.getUTCHours()}`.padStart(2, "0"),
+	min: `${d.getUTCMinutes()}`.padStart(2, "0")
+});
+function ogimetTafUrl(station, window, options = {}) {
+	const a = ogimetFields(window.from);
+	const b = ogimetFields(window.to);
+	const qs = new URLSearchParams({
+		lang: "en",
+		lugar: station,
+		tipo: "FT",
+		ord: "DIR",
+		nil: "SI",
+		fmt: "txt",
+		ano: a.ano,
+		mes: a.mes,
+		day: a.day,
+		hora: a.hora,
+		min: a.min,
+		anof: b.ano,
+		mesf: b.mes,
+		dayf: b.day,
+		horaf: b.hora,
+		minf: b.min,
+		send: "send",
+		nohtmlo: "yes",
+		annot: "yes",
+		leng: "0"
+	});
+	return `${options.baseUrl ?? "https://www.ogimet.com/display_metars2.php"}?${qs.toString()}`;
+}
+/** 电头站码 best-effort 提取（TAF/AMD/COR 剥词；剥不出返回空串）——与 mergeTafLines 同判式（aviationweather 取数线） */
+const stationHeadOf = (raw) => {
+	const toks = raw.split(/\s+/);
+	let k = toks[0] === "TAF" ? 1 : 0;
+	while (toks[k] === "AMD" || toks[k] === "COR") k += 1;
+	const head = toks[k] ?? "";
+	return /^[A-Z0-9]{4}$/.test(head) ? head : "";
+};
+/**
+* ogimet 响应解析（<pre> 区）：12 位时间戳前缀行（YYYYMMDDHHmm，收报序）起新记录、无前缀行并入上一条
+* （多行报文并单——与私有管线 parse_tafs 同协议）；# 注释/空行跳过；只收 TAF 起头报文。
+* 站码 best-effort 取自电头（query 站名兜底）；空模板（无 <pre> 或零报文）返回空数组——
+* 由调用方判空（ogimet 缺数常见，属正常降级而非错误面）。
+*/
+function parseOgimetTafs(html, fallbackStation = "") {
+	const pre = /<pre>([\s\S]*?)<\/pre>/.exec(html);
+	if (pre === null) return [];
+	const PREFIX = /^(\d{12})\s+(.*)$/;
+	const merged = [];
+	for (const line of (pre[1] ?? "").split("\n")) {
+		const t = line.trim();
+		if (t === "" || t.startsWith("#")) continue;
+		const pm = PREFIX.exec(t);
+		if (pm !== null) merged.push(pm[2] ?? "");
+		else if (merged.length > 0) merged[merged.length - 1] += ` ${t}`;
+	}
+	return merged.filter((raw) => raw.startsWith("TAF")).map((raw) => ({
+		station: stationHeadOf(raw) || fallbackStation,
+		raw
+	}));
+}
+/**
+* Fetch one station's recent TAFs from ogimet (latest + previous publication cycles).
+* 拉取单站的 ogimet 近窗 TAF（最新与上一发布周期——报池补充线，供与 aviationweather 线合并去重）。
+* 失败语义与 getTafs 同族（timeout/network/http-error 机读码）；空数据返回空数组而非抛错
+* （ogimet 站点级缺数常见——它是补充线，空窗属正常降级，不静默丢整批）。
+*/
+async function getTafsOgimet(station, window, options = {}) {
+	const controller = new AbortController();
+	const external = options.signal;
+	const forward = () => {
+		controller.abort(external?.reason);
+	};
+	if (external !== void 0) {
+		if (external.aborted) forward();
+		else external.addEventListener("abort", forward, { once: true });
+	}
+	const timer = options.timeoutMs === void 0 ? void 0 : setTimeout(() => controller.abort(new MetarSourceError$1("timeout", "ogimet", `ogimet TAF 请求超时（>${options.timeoutMs}ms，站=${station}）`)), options.timeoutMs);
+	try {
+		let res;
+		try {
+			res = await fetch(ogimetTafUrl(station, window, options), { signal: controller.signal });
+		} catch (err) {
+			if (controller.signal.aborted) throw err;
+			const reason = err instanceof Error ? err.message : String(err);
+			throw new MetarSourceError$1("network", "ogimet", `网络请求失败（源：ogimet TAF，站=${station}）：${reason}`, { cause: err });
+		}
+		if (!res.ok) throw new MetarSourceError$1("http-error", "ogimet", `ogimet TAF HTTP ${res.status}（站=${station}）`);
+		return parseOgimetTafs(await res.text(), station);
+	} finally {
+		if (timer !== void 0) clearTimeout(timer);
+		external?.removeEventListener("abort", forward);
+	}
+}
 //#endregion
-export { MetarParseError, MetarSourceError, getMetarReports, getMetars, iemCurrentsUrl };
+export { AW_TAF_ENDPOINT, MetarParseError, MetarSourceError, OGIMET_TAF_ENDPOINT, awTafUrl, getMetarReports, getMetars, getTafReports, getTafs, getTafsOgimet, iemCurrentsUrl, ogimetTafUrl, parseOgimetTafs };
 
 //# sourceMappingURL=sources.js.map

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   * 紧凑模式：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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"}
+{"version":3,"file":"sources.js","names":["MetarSourceError","MetarParseError"],"sources":["../src/sources.ts"],"sourcesContent":["/**\n * metweave/sources — 取数 helper（伞包子路径）。双线：IEM METAR 实况 + aviationweather TAF 预报（主）+ ogimet TAF 报池补充（次）。\n *\n * 纪律：只做端点模板 + fetch + 取数侧整理（解析、定位联表）——缓存/质控/归档等\n * 数据管理逻辑永不进入开源包；核心包（core/parser/render）零网络代码。\n * 换源口径（内网的人切换到自己的数据源」指令）：两条线各留 baseUrl 覆盖位\n * （IEM＝站点根、TAF＝端点根）——内网镜像/自建网关只换根、路径与查询串由本层拼装。\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, TafReport } from \"@metweave/core\";\nimport type { MetarParseErrorCode } from \"@metweave/core\";\nimport { MetarParseError, MetarSourceError } from \"@metweave/core\";\nimport { parse, parseTaf } 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   * IEM 站点根覆盖（缺省官方 https://mesonet.agron.iastate.edu）：内网镜像/自建网关\n   * 只换根——/api/1/currents.json 路径与查询串由本层拼装（换源口径，见文件头）。\n   */\n  baseUrl?: string;\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 * @param baseUrl - IEM 站点根覆盖（内网镜像/自建网关——换源口径，见 GetMetarsOptions.baseUrl）。\n */\nexport function iemCurrentsUrl(network = \"CN__ASOS\", baseUrl = IEM_BASE): string {\n  return `${baseUrl}/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, options.baseUrl), { 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\n// ---------------------------------------------------------------- TAF 取数线（收进 sources」指令）\n\n/** aviationweather TAF 数据端点（上游无 CORS 头：浏览器直连须自建代理/镜像——baseUrl 覆盖即为此用） */\nexport const AW_TAF_ENDPOINT = \"https://aviationweather.gov/api/data/taf\";\n\n/**\n * One fetched TAF row: station (best-effort) and the verbatim report (continuation lines already merged).\n * 单条 TAF 取数行：站码（best-effort）与报文原文（续行已归并）。\n */\nexport interface TafObservation {\n  /** 站码：剥 TAF/AMD/COR 电头词后的首枚 4 位码；剥不出为 \"\"（解析层 missing-station 兜底出声） */\n  station: string;\n  /** 报文原文（上游 raw 格式的缩进续行已并回所属报文；report.raw 语义一致——原文保真） */\n  raw: string;\n}\n\n/** Options for getTafs: fetch options plus the TAF endpoint-root override and the as-of date. */\nexport interface GetTafsOptions {\n  /** 外部取消信号（与超时组合，任一触发即中止） */\n  signal?: AbortSignal;\n  /** 请求超时毫秒数（触发即中止并抛出超时错误） */\n  timeoutMs?: number;\n  /**\n   * TAF 端点根覆盖（缺省官方 https://aviationweather.gov/api/data/taf）：内网镜像/自建代理\n   * 只换根——?ids=&format=raw 查询串由本层拼装（换源口径，见文件头；examples 即用 /aw-taf 代理根）。\n   */\n  baseUrl?: string;\n  /**\n   * 「该时刻已发布的最新报」（上游 date 参数语义）：回看上一发布周期用（examples 报池即 date=now-4h）。\n   * Date 转 ISO；字符串原样透传（上游亦收相对形态）。\n   */\n  date?: Date | string;\n}\n\n/**\n * The aviationweather TAF endpoint (raw format). ids joined as given; date serialized when present.\n * aviationweather TAF 端点模板（format=raw）。ids 数组逗号连接；date 存在时序列化为查询参数。\n */\nexport function awTafUrl(\n  ids: string | readonly string[],\n  options: { baseUrl?: string; date?: Date | string } = {},\n): string {\n  const idList = typeof ids === \"string\" ? ids : ids.join(\",\");\n  const params = new URLSearchParams({ ids: idList, format: \"raw\" });\n  const d = options.date;\n  if (d !== undefined) params.set(\"date\", d instanceof Date ? d.toISOString() : d);\n  return `${options.baseUrl ?? AW_TAF_ENDPOINT}?${params.toString()}`;\n}\n\n/** raw 文本 → 整份报文行（缩进续行并回上一份；与报池语义同源）+ best-effort 站码提取 */\nfunction mergeTafLines(text: string): TafObservation[] {\n  const merged: string[] = [];\n  for (const line of text.split(\"\\n\")) {\n    if (line.trim() === \"\") continue;\n    if (/^\\s/.test(line) && merged.length > 0) merged[merged.length - 1] += ` ${line.trim()}`;\n    else merged.push(line.trim());\n  }\n  return merged.map((raw) => {\n    const toks = raw.split(/\\s+/);\n    let k = toks[0] === \"TAF\" ? 1 : 0;\n    while (toks[k] === \"AMD\" || toks[k] === \"COR\") k += 1;\n    const head = toks[k] ?? \"\";\n    return { station: /^[A-Z0-9]{4}$/.test(head) ? head : \"\", raw };\n  });\n}\n\n/**\n * Fetch aviationweather TAFs (raw format) with station extracted and continuation lines merged.\n * 拉取 aviationweather TAF（raw 格式）：续行归并 + 站码提取的取数侧整理。\n * 失败语义与 getMetars 同族（不静默）：timeout/network/http-error/empty-data 一律 MetarSourceError\n * 机读码；上游对未知 ids 也返回 200 + 空体，空数据显式 throw 而非空数组静默。\n */\nexport async function getTafs(\n  ids: string | readonly string[],\n  options: GetTafsOptions = {},\n): Promise<TafObservation[]> {\n  // 手工组合超时与外部信号（与 getMetars 同款：不依赖 AbortSignal.any，兼容 Node 20；假时钟可测）\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              new MetarSourceError(\n                \"timeout\",\n                \"aviationweather\",\n                `aviationweather TAF 请求超时（>${options.timeoutMs}ms）`,\n              ),\n            ),\n          options.timeoutMs,\n        );\n  try {\n    let res: Response;\n    try {\n      res = await fetch(awTafUrl(ids, options), { signal: controller.signal });\n    } catch (err) {\n      // 取消/超时引发的拒绝原样透传（AbortSignal 语义）；断网/DNS 包装为 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        \"aviationweather\",\n        `网络请求失败（源：aviationweather TAF）：请检查网络连通性后重试（${reason}）`,\n        { cause: err },\n      );\n    }\n    if (!res.ok) {\n      throw new MetarSourceError(\n        \"http-error\",\n        \"aviationweather\",\n        `aviationweather TAF HTTP ${res.status}`,\n      );\n    }\n    let text: string;\n    try {\n      text = await res.text();\n    } catch (err) {\n      if (controller.signal.aborted) throw err;\n      const reason = err instanceof Error ? err.message : String(err);\n      throw new MetarSourceError(\n        \"network\",\n        \"aviationweather\",\n        `aviationweather TAF 响应读取失败：${reason}`,\n        { cause: err },\n      );\n    }\n    const rows = mergeTafLines(text);\n    if (rows.length === 0) {\n      throw new MetarSourceError(\n        \"empty-data\",\n        \"aviationweather\",\n        \"aviationweather TAF 返回空数据——请核对 ids 站码（如 ZBAA,ZBAD；端点 format=raw）\",\n      );\n    }\n    return rows;\n  } finally {\n    if (timer !== undefined) clearTimeout(timer);\n    external?.removeEventListener(\"abort\", forward);\n  }\n}\n\n/** Options for getTafReports: fetch options plus station metadata and the per-row tolerance callback. */\nexport interface GetTafReportsOptions extends GetTafsOptions {\n  /** 按 icao 联表的站点元数据（TAF 端点不提供坐标——stations 是定位的唯一来源，缺省将得空数组） */\n  stations?: readonly StationRef[];\n  /** 逐行容错（缺省关闭）：传入时解析失败的行跳过并逐条回调；不传时聚合抛出（全有或全无） */\n  onUnparseable?: (failure: UnparseableReport) => void;\n  /** 紧凑模式：parseTaf 产物剥除全部 span 字段（存储场景推荐）；缺省完整模式 */\n  spans?: false;\n}\n\n/**\n * A map-ready TAF item (structurally compatible with TafLayerItem's report/position/title triple).\n * 可直接喂给地图适配器（如 addTafLayer）的预报项：{ report, position, title } 三件套。\n */\nexport interface TafReportItem {\n  /** 已解析的 TAF IR（原文经 report.raw 原样保真） */\n  report: TafReport;\n  /** 站点坐标（WGS-84 [lat, lon]；TAF 端点无坐标，来自 stations 联表） */\n  position: [number, number];\n  /** 站点提示（「ICAO 站名」；适配器缺省回落 IR 站名） */\n  title: string;\n}\n\n/**\n * TAF 版的取数 → 解析 → 定位一步到位（契约沿 getMetarReports）：stations 命中的站带精确坐标与站名，\n * 未命中跳过（TAF 端点无坐标可回落，与 getMetarReports 的无坐标跳行同规则）；解析失败两种模式\n * （缺省聚合抛出 batch-parse-failed、传 onUnparseable 逐行容错）。报池等数据管理逻辑不进本层。\n */\nexport async function getTafReports(\n  ids: string | readonly string[],\n  options: GetTafReportsOptions = {},\n): Promise<TafReportItem[]> {\n  const { stations, onUnparseable, spans, ...fetchOptions } = options;\n  const table = new Map((stations ?? []).map((s) => [s.icao, s] as const));\n  const observations = await getTafs(ids, fetchOptions);\n  const items: TafReportItem[] = [];\n  const failures: string[] = [];\n  for (const obs of observations) {\n    try {\n      const report = parseTaf(obs.raw, spans === false ? { spans: false } : undefined);\n      const station = table.get(report.station);\n      if (station === undefined) continue; // 站表未命中（端点无坐标可回落）——跳过，规则同 getMetarReports\n      items.push({\n        report,\n        position: [station.lat, station.lon],\n        title: `${report.station}${station.name ? ` ${station.name}` : \"\"}`,\n      });\n    } catch (err) {\n      // parseTaf 对字符串输入只抛 MetarParseError；其他异常属编程错误直接上抛\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    const summary = `source=aviationweather; failures=${failures.length}; ${failures.join(\"; \")}`;\n    throw new MetarParseError(\n      \"batch-parse-failed\",\n      summary,\n      `TAF 解析失败 ${failures.length} 条（aviationweather）——${failures.slice(0, 3).join(\"；\")}${failures.length > 3 ? \"……\" : \"\"}`,\n    );\n  }\n  return items;\n}\n\n// ---------------------------------------------------------------- ogimet TAF 补充线（指令：aviationweather 取最新，ogimet 取最新/次新合并补充）\n\n/** ogimet display_metars2.php 端点（tipo=FT＝TAF；无 CORS 头：浏览器直连须代理/镜像——baseUrl 覆盖即为此用） */\nexport const OGIMET_TAF_ENDPOINT = \"https://www.ogimet.com/display_metars2.php\";\n\n/** ogimet 查询窗（UTC 起止） */\nexport interface OgimetTafWindow {\n  readonly from: Date;\n  readonly to: Date;\n}\n\n/**\n * ogimet TAF 端点模板（配方＝私有管线 backfill_ogimet.py 同源）：tipo=FT、txt 形、\n * 服务端按 <pre> 区回 HTML（解析见 parseOgimetTafs）。免费公益服务——调用方自行节制频率。\n */\n/** UTC 日期字段补零组（ogimet 查询串的 ano/mes/day/hora/min 族） */\nconst ogimetFields = (\n  d: Date,\n): { ano: string; mes: string; day: string; hora: string; min: string } => ({\n  ano: `${d.getUTCFullYear()}`,\n  mes: `${d.getUTCMonth() + 1}`.padStart(2, \"0\"),\n  day: `${d.getUTCDate()}`.padStart(2, \"0\"),\n  hora: `${d.getUTCHours()}`.padStart(2, \"0\"),\n  min: `${d.getUTCMinutes()}`.padStart(2, \"0\"),\n});\n\nexport function ogimetTafUrl(\n  station: string,\n  window: OgimetTafWindow,\n  options: { baseUrl?: string } = {},\n): string {\n  const a = ogimetFields(window.from);\n  const b = ogimetFields(window.to);\n  const qs = new URLSearchParams({\n    lang: \"en\",\n    lugar: station,\n    tipo: \"FT\",\n    ord: \"DIR\",\n    nil: \"SI\",\n    fmt: \"txt\",\n    ano: a.ano,\n    mes: a.mes,\n    day: a.day,\n    hora: a.hora,\n    min: a.min,\n    anof: b.ano,\n    mesf: b.mes,\n    dayf: b.day,\n    horaf: b.hora,\n    minf: b.min,\n    send: \"send\",\n    nohtmlo: \"yes\",\n    annot: \"yes\",\n    leng: \"0\",\n  });\n  return `${options.baseUrl ?? OGIMET_TAF_ENDPOINT}?${qs.toString()}`;\n}\n\n/** 电头站码 best-effort 提取（TAF/AMD/COR 剥词；剥不出返回空串）——与 mergeTafLines 同判式（aviationweather 取数线） */\nconst stationHeadOf = (raw: string): string => {\n  const toks = raw.split(/\\s+/);\n  let k = toks[0] === \"TAF\" ? 1 : 0;\n  while (toks[k] === \"AMD\" || toks[k] === \"COR\") k += 1;\n  const head = toks[k] ?? \"\";\n  return /^[A-Z0-9]{4}$/.test(head) ? head : \"\";\n};\n\n/**\n * ogimet 响应解析（<pre> 区）：12 位时间戳前缀行（YYYYMMDDHHmm，收报序）起新记录、无前缀行并入上一条\n * （多行报文并单——与私有管线 parse_tafs 同协议）；# 注释/空行跳过；只收 TAF 起头报文。\n * 站码 best-effort 取自电头（query 站名兜底）；空模板（无 <pre> 或零报文）返回空数组——\n * 由调用方判空（ogimet 缺数常见，属正常降级而非错误面）。\n */\nexport function parseOgimetTafs(html: string, fallbackStation = \"\"): TafObservation[] {\n  const pre = /<pre>([\\s\\S]*?)<\\/pre>/.exec(html);\n  if (pre === null) return [];\n  const PREFIX = /^(\\d{12})\\s+(.*)$/;\n  const merged: string[] = [];\n  for (const line of (pre[1] ?? \"\").split(\"\\n\")) {\n    const t = line.trim();\n    if (t === \"\" || t.startsWith(\"#\")) continue;\n    const pm = PREFIX.exec(t);\n    if (pm !== null) merged.push(pm[2] ?? \"\");\n    else if (merged.length > 0) merged[merged.length - 1] += ` ${t}`;\n  }\n  return merged\n    .filter((raw) => raw.startsWith(\"TAF\"))\n    .map((raw) => ({ station: stationHeadOf(raw) || fallbackStation, raw }));\n}\n\n/** Options for getTafsOgimet: fetch options plus the ogimet endpoint-root override. */\nexport interface GetTafsOgimetOptions {\n  /** 外部取消信号（与超时组合，任一触发即中止） */\n  signal?: AbortSignal;\n  /** 请求超时毫秒数（触发即中止并抛出超时错误） */\n  timeoutMs?: number;\n  /** ogimet 端点根覆盖（内网镜像/自建代理；examples 走 /ogimet-taf 代理根） */\n  baseUrl?: string;\n}\n\n/**\n * Fetch one station's recent TAFs from ogimet (latest + previous publication cycles).\n * 拉取单站的 ogimet 近窗 TAF（最新与上一发布周期——报池补充线，供与 aviationweather 线合并去重）。\n * 失败语义与 getTafs 同族（timeout/network/http-error 机读码）；空数据返回空数组而非抛错\n * （ogimet 站点级缺数常见——它是补充线，空窗属正常降级，不静默丢整批）。\n */\nexport async function getTafsOgimet(\n  station: string,\n  window: OgimetTafWindow,\n  options: GetTafsOgimetOptions = {},\n): Promise<TafObservation[]> {\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              new MetarSourceError(\n                \"timeout\",\n                \"ogimet\",\n                `ogimet TAF 请求超时（>${options.timeoutMs}ms，站=${station}）`,\n              ),\n            ),\n          options.timeoutMs,\n        );\n  try {\n    let res: Response;\n    try {\n      res = await fetch(ogimetTafUrl(station, window, options), { signal: controller.signal });\n    } catch (err) {\n      if (controller.signal.aborted) throw err;\n      const reason = err instanceof Error ? err.message : String(err);\n      throw new MetarSourceError(\n        \"network\",\n        \"ogimet\",\n        `网络请求失败（源：ogimet TAF，站=${station}）：${reason}`,\n        { cause: err },\n      );\n    }\n    if (!res.ok) {\n      throw new MetarSourceError(\n        \"http-error\",\n        \"ogimet\",\n        `ogimet TAF HTTP ${res.status}（站=${station}）`,\n      );\n    }\n    return parseOgimetTafs(await res.text(), station);\n  } finally {\n    if (timer !== undefined) clearTimeout(timer);\n    external?.removeEventListener(\"abort\", forward);\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "metweave",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "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",
@@ -13,6 +13,10 @@
     "visualization",
     "weather"
   ],
+  "homepage": "https://github.com/yaojaro/metweave#readme",
+  "bugs": {
+    "url": "https://github.com/yaojaro/metweave/issues"
+  },
   "license": "MIT",
   "author": "YaoJaro <yaojaro@metweave.com>",
   "repository": {
@@ -27,54 +31,74 @@
   ],
   "type": "module",
   "sideEffects": false,
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "./src/index.ts",
+  "module": "./src/index.ts",
+  "types": "./src/index.ts",
   "exports": {
     ".": {
-      "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
-      },
-      "require": {
-        "types": "./dist/index.d.cts",
-        "default": "./dist/index.cjs"
-      }
+      "types": "./src/index.ts",
+      "import": "./src/index.ts",
+      "require": "./src/index.ts"
     },
     "./sources": {
-      "import": {
-        "types": "./dist/sources.d.ts",
-        "default": "./dist/sources.js"
-      },
-      "require": {
-        "types": "./dist/sources.d.cts",
-        "default": "./dist/sources.cjs"
-      }
+      "types": "./src/sources.ts",
+      "import": "./src/sources.ts",
+      "require": "./src/sources.ts"
     },
     "./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"
-      }
+      "types": "./src/stations-cn.ts",
+      "import": "./src/stations-cn.ts",
+      "require": "./src/stations-cn.ts"
     }
   },
   "publishConfig": {
+    "main": "./dist/index.cjs",
+    "module": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+      ".": {
+        "import": {
+          "types": "./dist/index.d.ts",
+          "default": "./dist/index.js"
+        },
+        "require": {
+          "types": "./dist/index.d.cts",
+          "default": "./dist/index.cjs"
+        }
+      },
+      "./sources": {
+        "import": {
+          "types": "./dist/sources.d.ts",
+          "default": "./dist/sources.js"
+        },
+        "require": {
+          "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"
+        }
+      }
+    },
     "access": "public"
   },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit"
+  },
   "dependencies": {
-    "@metweave/core": "0.1.1",
-    "@metweave/parser": "0.1.1",
-    "@metweave/render": "0.1.1"
+    "@metweave/core": "workspace:*",
+    "@metweave/parser": "workspace:*",
+    "@metweave/render": "workspace:*"
   },
   "engines": {
     "node": ">=20"
-  },
-  "scripts": {
-    "build": "tsdown",
-    "typecheck": "tsc --noEmit"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 YaoJaro
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.