@metweave/leaflet 0.1.2 → 0.2.0

package/dist/index.js

@@ -1,5 +1,6 @@
-import { toValues } from "@metweave/core";
-import { renderCard } from "@metweave/render";
+import { toValues, unwrap } from "@metweave/core";
+import { renderCard, renderTafCard, summarizeTafConditions } from "@metweave/render";
+import { expandTaf } from "@metweave/parser";
 //#region src/index.ts
 /**
 * leaflet 惰性装载：import 本包时不再静态加载 leaflet——peer 库是浏览器专属实现，
@@ -14,7 +15,8 @@ const ADD_METAR_LAYER_OPTION_KEYS = /* @__PURE__ */ new Set([
 	"locale",
 	"popup",
 	"card",
-	"conditionColors"
+	"conditionColors",
+	"popupOptions"
 ]);
 /**
 * tooltip 纯文本承载：Leaflet 对 string 内容走 innerHTML——宿主自传的 title 是任意串，
@@ -35,7 +37,11 @@ const escapeHtml = (text) => text.replace(/[&<>"']/g, (ch) => {
 		default: return "&#39;";
 	}
 });
-/** 四档条件色（与卡片 mw-danger/mw-caution 同族色相：灰=不明、红=差、琥珀=注意、绿=好） */
+/**
+* 四档条件色单一来源（2026-09-24 评测批2#3：图例/面板/圆点色值不一致——两套色系并存）。
+* 宿主图例与列表色点应引用本表而非自抄色值（编译期同源，显示层永不漂移）；
+* 与卡片 mw-danger/mw-caution 同族色相：灰=不明、红=差、琥珀=注意、绿=好
+*/
 const TIER_COLORS = {
 	unknown: "#8a94a0",
 	poor: "#d05656",
@@ -70,21 +76,15 @@ const PRECIP_PHENOMENA = /* @__PURE__ */ new Set([
 ]);
 /** 风速折米/秒（阵风判据统一单位：kt ×0.514444、kmh ÷3.6、mps ×1） */
 const toMps = (value, unit) => unit === "kt" ? value * .514444 : unit === "kmh" ? value / 3.6 : value;
-/**
-* 四档气象条件分级（判据本库自拟、初稿待审——显示层扫视启发式）：
-* 阈值由本库拟定，**不对应也不代表任何官方飞行天气分类；本库不提供飞行规则判定**（本期无此功能）。
-* 仅供「一眼扫视哪些站值得注意」，不得作为任何运行判据：
-* - unknown（灰）= NIL（台站无观测）或关键组全缺测（能见度与云均缺测且天气缺测/无——按可得要素无从判读）
-* - poor（红）= 能见度 < 1500 m，或 BKN/OVC 云层（含垂直能见度）云底 < 1000 ft，或天气含 TS 族（任何雷暴，含 VC 邻近）
-*   或现象含 GR/VA，或冻降水（FZ 描述符族，冻雨/冻毛毛雨），或 + 强度显著降水，或阵风 ≥ 25 m/s，或云组含 CB/TCU，或跑道关闭
-* - caution（琥珀）= 能见度 1500–5000 m（能见度分档取国内通行 1500/5000 m 口径），或 BKN/OVC 云底 1000–3000 ft，或任何降水族（RA/SN 等），
-*   或 FZ 描述符以外的结冰现象，或阵风 15–25 m/s
-* - good（绿）= 其余（含 CAVOK）
-* 缺测要素不参与限制（按可得要素判，见 conditionOf 内 unknown 判据的例外）；阈值细则随口径审定后修订。
-*/
 function conditionOf(report) {
 	if (report.nil === true) return "unknown";
-	const v = toValues(report);
+	const v = {
+		wind: unwrap(report.wind),
+		visibility: unwrap(report.visibility),
+		weather: unwrap(report.weather),
+		clouds: report.clouds,
+		runwayStates: report.runwayStates ?? []
+	};
 	const visMissing = report.visibility?.kind === "missing";
 	const elements = v.clouds?.elements ?? [];
 	const cloudsAllMissing = !report.cavok && elements.every((e) => e.heightFt.value === null && (e.kind === "vertical-visibility" || e.amount === null));
@@ -203,7 +203,10 @@ async function addMetarLayer(map, items, options = {}) {
 			if (cardOpts.locale === void 0 && options.locale !== void 0) cardOpts.locale = options.locale;
 			const stationName = item.title !== void 0 && item.title.startsWith(`${item.report.station} `) ? item.title.slice(item.report.station.length + 1) : void 0;
 			if (cardOpts.stationTitle === void 0 && stationName !== void 0) cardOpts.stationTitle = stationName;
-			marker.bindPopup(renderCard(item.report, cardOpts), { maxWidth: 420 });
+			marker.bindPopup(renderCard(item.report, cardOpts), {
+				maxWidth: 420,
+				...options.popupOptions
+			});
 			marker.on("popupopen", () => {
 				marker.closeTooltip();
 				(marker.getPopup()?.getElement()?.querySelector("a.leaflet-popup-close-button, button, [href]"))?.focus();
@@ -220,7 +223,509 @@ async function addMetarLayer(map, items, options = {}) {
 	group.addTo(map);
 	return group;
 }
+/** TAF 展开结果 → 判据输入面投影（runwayStates 恒缺省——TAF 无跑道状态语汇） */
+function asConditionInput(c, nilLike) {
+	return {
+		nil: nilLike,
+		cavok: c.cavok,
+		...c.wind !== void 0 ? { wind: {
+			kind: "value",
+			value: c.wind
+		} } : {},
+		...c.visibility !== void 0 ? { visibility: {
+			kind: "value",
+			value: c.visibility
+		} } : {},
+		...c.weather.length > 0 ? { weather: {
+			kind: "value",
+			value: c.weather
+		} } : {},
+		...c.clouds !== void 0 ? { clouds: c.clouds } : {}
+	};
+}
+/**
+* TAF 展开摘要（一行，人话优先——2026-09-24 评测批2#4：旧电码串「≥10 km · -TSRA · SCT040」
+* 对非专业是密码；现复用 @metweave/render 的 gloss 词表单一来源，tooltip/置顶提示同款）：
+* 「能见度 ≥10 km · 雷暴伴雨（飞行威胁大） · 疏云，云底约 700 米」；电码在卡内 RAW 区可查。
+*/
+function summarizeTaf(c, locale) {
+	if (c.cavok) return "CAVOK";
+	const text = summarizeTafConditions(c, locale);
+	if (text !== "") return text;
+	return locale === "en" ? "No elements" : "无要素组";
+}
+const ADD_TAF_LAYER_OPTION_KEYS = /* @__PURE__ */ new Set([
+	"locale",
+	"at",
+	"anchorDays",
+	"calendarAnchor",
+	"popup",
+	"card",
+	"popupOptions"
+]);
+/**
+* Put parsed TAF stations onto a Leaflet map as forecast markers at one instant — the four-tier
+* dot, tooltip and popup are driven by `expandTaf` (renderer layer ①: forecast-as-observation).
+* 把一组 TAF 站点按同一时刻的预报值挂上地图：四档圆点/tooltip/弹窗全部由 expandTaf 展开
+* 结果驱动（渲染层①「预报当观测渲」——判据/圆点/摘要与 METAR 侧同一条管线）。
+* 档位判据为本库自拟扫视启发式（同 conditionOf 注释）——**预报值套判据同样不得用作运行判据**，
+* tooltip/弹窗均显式标注「预报」，不与实况混淆。
+*/
+async function addTafLayer(map, items, options = {}) {
+	for (const key of Object.keys(options)) if (!ADD_TAF_LAYER_OPTION_KEYS.has(key)) throw new Error(`addTafLayer 收到未知选项 "${key}"（可用项见 AddTafLayerOptions）`);
+	const locale = options.locale ?? "zh";
+	if (locale !== "zh" && locale !== "en") throw new Error(`addTafLayer 的 locale 选项值 "${locale}" 不受支持（可用："zh" | "en"）`);
+	const L = await loadLeaflet();
+	const group = L.layerGroup();
+	await populateTafLayer(map, group, items, options, L);
+	group.addTo(map);
+	return group;
+}
+/** 常显站码标签样式（评测签派 P0-1：无站码＝「有红的看不出是谁红的」）；缩放门控类由 zoomend 维护 */
+const TAF_LAYER_STYLE_ID = "mw-taf-layer-style";
+const injectTafLayerStyle = () => {
+	if (document.getElementById(TAF_LAYER_STYLE_ID) !== null) return;
+	const style = document.createElement("style");
+	style.id = TAF_LAYER_STYLE_ID;
+	style.append(document.createTextNode(".mw-code-label { position:absolute; left:15px; top:-3px; white-space:nowrap; font:600 10px/1.4 system-ui,sans-serif; color:#2c3e50; text-shadow:0 0 3px #fff,0 0 3px #fff,0 0 3px #fff; pointer-events:none; }.mw-hide-codes .mw-code-label { display:none; }"));
+	document.head.append(style);
+};
+const codeZoomBound = /* @__PURE__ */ new WeakSet();
+/** zoom ≥ 5 常显 ICAO 码，低于则收（38 站全显互相压盖；评测签派 P0-1 的缩放分级折中） */
+const bindCodeZoom = (map) => {
+	if (codeZoomBound.has(map)) return;
+	codeZoomBound.add(map);
+	const container = map.getContainer();
+	const toggle = () => {
+		container.classList.toggle("mw-hide-codes", map.getZoom() < 5);
+	};
+	map.on("zoomend", toggle);
+	toggle();
+};
+/** 各层当前展开时刻（setTafLayerTime 换时刻不再清层重建——marker 原地 setIcon/setTooltipContent，评测工程 P2-1） */
+const tafLayerAt = /* @__PURE__ */ new WeakMap();
+/** 各层的日历月锚（2026-09-24 评测 P1 月界批）：at 连续序「自该月 1 日起」的基准月 */
+const tafLayerCalendar = /* @__PURE__ */ new WeakMap();
+/** 各层的可变 card 选项覆盖（时区单制：setTafLayerTime 带 card 即合并——切时区不清层重建、
+*  滑杆换时刻不带 card 不回退；弹窗刷新读此处而非建层闭包，已开弹窗即时随时区换内容） */
+const tafLayerCard = /* @__PURE__ */ new WeakMap();
+/** marker → 其 TafLayerItem（换时刻原地更新时的数据面） */
+const tafMarkerItems = /* @__PURE__ */ new WeakMap();
+/** marker → 弹窗内容刷新函数（复测 N1/N2：刷新不走合成 popupopen——真实打开才移焦点，刷新按当前时刻重算置顶提示） */
+const tafPopupRefresh = /* @__PURE__ */ new WeakMap();
+/** 查看时刻是否在该报文有效期外（含窗前/窗后——出窗＝灰点「预报未生效/已过期」） */
+/** 日时 → 分钟序（出窗比较用；TAF 无月，同报文语境内日号自洽） */
+const absDayHour = (d, h) => (d - 1) * 1440 + h * 60;
+/** 真实月历：某年月的天数（2026-09-24 评测 P1 月界批） */
+const daysInMonthOf = (year, month) => new Date(Date.UTC(year, month, 0)).getUTCDate();
+/** 年月 → 序数（锚距比较用） */
+const calendarIndex = (c) => c.year * 12 + (c.month - 1);
+/**
+* 单站时刻归一（2026-09-24 评测 P1 月界批）：
+* - 显式层时刻 contAt（calendarAnchor 基的连续日序，可超月长）→ 经 anchorize 换算到本报锚月；
+* - contAt 缺省（层尚无统一时刻）→ 各站自身有效期起点（已在本报锚内，原样直用，月天数按报锚真月历）。
+* 返回喂 expandTaf/tafMarkerState 的 at+daysIn，cal 供 renderTafCard 走真月历显示。
+*/
+function stationNorm(item, contAt, layerCal, fallbackDaysIn) {
+	const v = item.report.validity;
+	const ownStart = {
+		day: v?.startDay ?? 0,
+		hour: v?.startHour ?? 0,
+		minute: 0
+	};
+	const itemCal = item.monthAnchor;
+	if (contAt === void 0) return {
+		at: ownStart,
+		daysIn: itemCal !== void 0 ? daysInMonthOf(itemCal.year, itemCal.month) : fallbackDaysIn,
+		cal: itemCal
+	};
+	return anchorize(item, contAt, layerCal, fallbackDaysIn);
+}
+/**
+* 层连续序 at → 该报锚月内的归一（2026-09-24 评测 P1 月界批，跨月报池收口）：
+* item.monthAnchor 与层 calendarAnchor 都在位时，把 at 的连续日序（自层锚月 1 日起、可超月长）
+* 换算到本报锚月内的日号，并按真实月历给该月天数（供报文 validity 回绕）——月末跨月的
+* 混合报池（9 月末的在效报 + 10 月 1 日生效报）展开与显示各报正确。
+* 缺任一锚（或锚病态相差超 24 个月）时原样返回 + 层全局 anchorDays 的 %31 折回——残余近似
+* 仅显示与回绕位：报文本身无月份，无锚即无从换算；档位判读的要素合成不依赖日号显示 */
+function anchorize(item, at, layerCal, fallbackDaysIn) {
+	const itemCal = item.monthAnchor;
+	if (itemCal === void 0 || layerCal === void 0) return {
+		at,
+		daysIn: fallbackDaysIn
+	};
+	const diff = calendarIndex(itemCal) - calendarIndex(layerCal);
+	if (diff < -24 || diff > 24) return {
+		at,
+		daysIn: fallbackDaysIn
+	};
+	let firstCont = 1;
+	let y = layerCal.year;
+	let m = layerCal.month;
+	for (let i = 0; i < Math.abs(diff); i += 1) if (diff > 0) {
+		firstCont += daysInMonthOf(y, m);
+		m += 1;
+		if (m > 12) {
+			m = 1;
+			y += 1;
+		}
+	} else {
+		m -= 1;
+		if (m < 1) {
+			m = 12;
+			y -= 1;
+		}
+		firstCont -= daysInMonthOf(y, m);
+	}
+	return {
+		at: {
+			...at,
+			day: at.day - (firstCont - 1)
+		},
+		daysIn: daysInMonthOf(itemCal.year, itemCal.month),
+		cal: itemCal
+	};
+}
+const outOfValidity = (r, at) => {
+	const v = r.validity;
+	if (v === void 0 || r.nil === true || r.cancelled === true) return false;
+	const atAbs = absDayHour(at.day, at.hour) + at.minute;
+	return atAbs < absDayHour(v.startDay, v.startHour) || atAbs >= absDayHour(v.endDay < v.startDay ? v.endDay + 31 : v.endDay, v.endHour);
+};
+/** 单站展开视觉态（首建与换时刻共用——tier/摘要/提示单一来源） */
+function tafMarkerState(item, at, anchor, locale) {
+	const r = item.report;
+	const name = item.title ?? r.station;
+	const noTimeline = r.nil === true || r.cancelled === true;
+	const v = r.validity;
+	let tier = "unknown";
+	let summary = r.nil === true ? "缺报（NIL）" : r.cancelled === true ? "预报取消（CNL）" : "";
+	const notes = [];
+	if (!noTimeline && v !== void 0 && outOfValidity(r, at)) {
+		const early = absDayHour(at.day, at.hour) < absDayHour(v.startDay, v.startHour);
+		notes.push(early ? "预报尚未生效（按发布时基况显示）" : "预报已过期（按末段显示）");
+		return {
+			tier: "unknown",
+			label: `${name} · 预报${early ? "未生效" : "已过期"}`,
+			summary,
+			notes
+		};
+	}
+	if (!noTimeline && v !== void 0) {
+		const expansion = expandTaf(r, at, anchor);
+		const effective = expansion.tempo !== void 0 ? {
+			...expansion.conditions,
+			...expansion.tempo.conditions,
+			weather: expansion.tempo.conditions.weather ?? [],
+			cavok: expansion.tempo.conditions.cavok
+		} : expansion.conditions;
+		tier = conditionOf(asConditionInput(effective, false));
+		summary = summarizeTaf(effective, locale);
+		if (expansion.uncertain) notes.push(locale === "en" ? "Transition band — timing uncertain" : "过渡带（变化时刻不确定）");
+		if (expansion.tempo !== void 0) {
+			const tempoSummary = summarizeTaf(effective, locale);
+			notes.push((locale === "en" ? "TEMPO bursts: " : "TEMPO 发作可能：") + tempoSummary);
+		}
+	} else if (v !== void 0) notes.push(`有效期 ${v.raw}`);
+	return {
+		tier,
+		label: `${name} · ${locale === "en" ? "Forecast " : "预报"}${TIER_WORDS[locale][tier]}`,
+		summary,
+		notes
+	};
+}
+/** 点位 divIcon（含常显 ICAO 站码标签）与悬停 tooltip 内容 */
+function tafMarkerIcon(L, item, state) {
+	const name = item.title ?? item.report.station;
+	return {
+		icon: L.divIcon({
+			className: "mw-cond-icon",
+			html: `<span role="img" aria-label="${escapeHtml(state.label)}" class="mw-dot mw-dot-${state.tier}" style="display:inline-block;width:12px;height:12px;border-radius:50%;background:${TIER_COLORS[state.tier]};border:2px solid #fff;box-shadow:0 0 2px rgba(0,0,0,.4)"></span><span class="mw-code-label" aria-hidden="true">${escapeHtml(item.report.station)}</span>`,
+			iconSize: [14, 14],
+			iconAnchor: [7, 7]
+		}),
+		tip: tafTipContent(name, state)
+	};
+}
+function tafTipContent(name, state) {
+	const tip = document.createElement("span");
+	tip.append(textCarrier(name));
+	if (state.summary !== "") tip.append(document.createElement("br"), textCarrier(state.summary));
+	for (const n of state.notes) tip.append(document.createElement("br"), textCarrier(n));
+	return tip;
+}
+/** TAF 标记构建核心：addTafLayer 首建用（标记构建 + 常显站码 + 惰性弹窗） */
+async function populateTafLayer(map, group, items, options, L) {
+	const fallbackDaysIn = options.anchorDays ?? 31;
+	const layerCal = options.calendarAnchor;
+	const locale = options.locale ?? "zh";
+	if (layerCal !== void 0) tafLayerCalendar.set(group, layerCal);
+	tafLayerCard.set(group, options.card ?? {});
+	for (const item of items) {
+		const norm = stationNorm(item, options.at, layerCal, fallbackDaysIn);
+		const { icon, tip } = tafMarkerIcon(L, item, tafMarkerState(item, norm.at, { daysIn: norm.daysIn }, locale));
+		const marker = L.marker(item.position, { icon });
+		tafMarkerItems.set(marker, item);
+		marker.bindTooltip(tip);
+		if (options.popup ?? true) {
+			marker.bindPopup(document.createElement("div"), {
+				maxWidth: 480,
+				...options.popupOptions
+			});
+			const refresh = (popup) => {
+				const rNow = item.report;
+				const noTimelineNow = rNow.nil === true || rNow.cancelled === true;
+				const currentCont = tafLayerAt.get(group);
+				const normNow = stationNorm(item, noTimelineNow ? void 0 : currentCont, tafLayerCalendar.get(group), fallbackDaysIn);
+				const fresh = tafMarkerState(item, normNow.at, { daysIn: normNow.daysIn }, locale);
+				const cardOpts = {
+					locale,
+					raw: true,
+					...currentCont === void 0 || noTimelineNow ? {} : { at: normNow.at },
+					...tafLayerCard.get(group)
+				};
+				if (normNow.cal !== void 0) cardOpts.monthAnchor = normNow.cal;
+				if (cardOpts.stationTitle === void 0 && item.title !== void 0) {
+					const stationName = item.title.startsWith(`${rNow.station} `) ? item.title.slice(rNow.station.length + 1) : void 0;
+					if (stationName !== void 0) cardOpts.stationTitle = stationName;
+				}
+				const card = renderTafCard(rNow, cardOpts);
+				if (fresh.notes.length > 0) {
+					const lead = document.createElement("p");
+					lead.style.margin = "0 0 4px";
+					lead.className = "mw-taf-meta";
+					for (const [i, n] of fresh.notes.entries()) {
+						if (i > 0) lead.append(document.createElement("br"));
+						lead.append(textCarrier(n));
+					}
+					card.prepend(lead);
+				}
+				popup.setContent(card);
+			};
+			tafPopupRefresh.set(marker, refresh);
+			marker.on("popupopen", (e) => {
+				if (e.popup === void 0) return;
+				marker.closeTooltip();
+				refresh(e.popup);
+				(e.popup.getElement()?.querySelector("a.leaflet-popup-close-button, button, [href]"))?.focus();
+			});
+		}
+		marker.addTo(group);
+	}
+	if (!escapeBoundMaps.has(map)) {
+		escapeBoundMaps.add(map);
+		map.getContainer().addEventListener("keydown", (event) => {
+			if (event.key === "Escape") map.closePopup();
+		});
+	}
+	injectTafLayerStyle();
+	bindCodeZoom(map);
+	if (options.at !== void 0) tafLayerAt.set(group, options.at);
+}
+/**
+* 单站某时刻的档位（数据直读，2026-09-24 评测批3#14）：与地图圆点同一判据管线
+* （含出窗灰、TEMPO 发作窗升档、NIL/CNL 灰）——宿主面板/对比基准不再从 marker DOM
+* className 正则回读（状态经渲染产物回流的工程债收口），DOM 只做展示。
+* at 语义同 addTafLayer：calendarAnchor 在位时为层连续序（逐报归一），否则为报锚内日号。
+*/
+/**
+* METAR 档位判据公共面（conditionOf 薄包装，tafTierOf 同款）：实况面板/图例等消费方
+* 与圆点同一判据管线（数据直读，不从 DOM 回流——批3#14 口径）。
+*/
+function metarTierOf(report) {
+	return conditionOf(report);
+}
+/** METAR 要素摘要公共面（summarizeReport 薄包装）：「2500m +TSRA BKN030CB」式扫视摘要。 */
+function summarizeMetarConditions(report, locale) {
+	return summarizeReport(report, locale);
+}
+function tafTierOf(item, at, options = {}) {
+	const norm = stationNorm(item, at, options.calendarAnchor, options.anchorDays ?? 31);
+	return tafMarkerState(item, norm.at, { daysIn: norm.daysIn }, "zh").tier;
+}
+/**
+* Re-expand every TAF marker at a new instant — in-place icon/tooltip update, no rebuild.
+* 全图统一换时刻（评测工程 P2-1 瘦身版）：各标记原地 setIcon/setTooltipContent，不再清层重建——
+* 换时刻不销毁已开弹窗（打开中的弹窗即时换内容）、无 DOM/监听器 churn（38 站滑杆拖动不再百卡重建）。
+* 展开是纯函数、遍历同步，无 clearLayers/populate 竞态窗口（旧代际令牌机制随重建路径一并退役）。
+*/
+async function setTafLayerTime(map, layer, items, options = {}) {
+	const L = await loadLeaflet();
+	const fallbackDaysIn = options.anchorDays ?? 31;
+	const locale = options.locale ?? "zh";
+	if (options.calendarAnchor !== void 0) tafLayerCalendar.set(layer, options.calendarAnchor);
+	const at = options.at ?? tafLayerAt.get(layer) ?? {
+		day: items[0]?.report.validity?.startDay ?? 1,
+		hour: items[0]?.report.validity?.startHour ?? 0,
+		minute: 0
+	};
+	if (options.at !== void 0) tafLayerAt.set(layer, options.at);
+	if (options.card !== void 0) tafLayerCard.set(layer, {
+		...tafLayerCard.get(layer),
+		...options.card
+	});
+	const openRefresh = [];
+	layer.eachLayer((ml) => {
+		if (!(ml instanceof L.Marker)) return;
+		const marker = ml;
+		const item = tafMarkerItems.get(marker);
+		if (item === void 0) return;
+		const norm = stationNorm(item, at, tafLayerCalendar.get(layer), fallbackDaysIn);
+		const state = tafMarkerState(item, norm.at, { daysIn: norm.daysIn }, locale);
+		const { icon, tip } = tafMarkerIcon(L, item, state);
+		marker.setIcon(icon);
+		marker.setTooltipContent(tip);
+		if (marker.isPopupOpen()) openRefresh.push(marker);
+	});
+	for (const marker of openRefresh) {
+		const popup = marker.getPopup();
+		if (popup === void 0) continue;
+		tafPopupRefresh.get(marker)?.(popup);
+	}
+	return layer;
+}
+/** 时刻展示串（控件与卡片共用口径；en 无「日」字） */
+const fmtTafAt = (at, locale = "zh") => locale === "zh" ? `${String(at.day).padStart(2, "0")}日 ${String(at.hour).padStart(2, "0")}:${String(at.minute).padStart(2, "0")}Z` : `Day ${String(at.day).padStart(2, "0")} ${String(at.hour).padStart(2, "0")}:${String(at.minute).padStart(2, "0")} Z`;
+/** 控件时刻显示·本地时（时区单制）：tag+M月D日HH:MM——月位显式（2026-09-24 评测 P1 月界批）：
+*  calendarAnchor 在位时走真实月历（at 为自锚月 1 日起的连续日序，day>31 按进位恒正确、跨月不回绕）；
+*  缺席时按 31 天折回（残余近似仅显示位：无月语境无从判读真实月份，控件值本身不受影响） */
+const fmtTafZone = (at, offset, tag, cal) => {
+	if (cal !== void 0 && at.day >= 1) {
+		const z = new Date(Date.UTC(cal.year, cal.month - 1, at.day, at.hour, at.minute) + offset * 6e4);
+		return `${tag}${z.getUTCMonth() + 1}月${z.getUTCDate()}日${String(z.getUTCHours()).padStart(2, "0")}:${String(z.getUTCMinutes()).padStart(2, "0")}`;
+	}
+	const total = (at.day - 1) * 1440 + at.hour * 60 + at.minute + offset;
+	const d = Math.floor(total / 1440) % 31 + 1;
+	const h = Math.floor(total % 1440 / 60);
+	const m = total % 60;
+	return `${tag}${String(d).padStart(2, "0")}日${String(h).padStart(2, "0")}:${String(m).padStart(2, "0")}`;
+};
+/** TafExpandAt ↔ 绝对分钟序（窗/刻度格计算共用；day-1 基准使跨日差值可直接加减） */
+const tafAbsOf = (at) => (at.day - 1) * 1440 + at.hour * 60 + at.minute;
+const tafAtOfAbs = (abs) => ({
+	day: Math.floor(abs / 1440) + 1,
+	hour: Math.floor(abs % 1440 / 60),
+	minute: abs % 60
+});
+/**
+* A framework-free time-scrub control element for a TAF layer: one range input drives every
+* station's re-expansion (renderer layer ③). Host mounts it anywhere; pure DOM, no Leaflet control
+* inheritance required.
+* TAF 图层的时间滑杆控件（零框架纯 DOM）：一个 range 输入驱动全图各站重展开；宿主自行挂载定位。
+*/
+function createTafTimeControl(map, options) {
+	const step = options.stepMinutes ?? 60;
+	const locale = options.locale ?? "zh";
+	const ltOffset = options.utcOffsetMinutes ?? null;
+	const cal = options.calendarAnchor;
+	const zoneText = (at) => ltOffset !== null && locale === "zh" ? fmtTafZone(at, ltOffset, "北京时", cal) : fmtTafAt(at, locale);
+	const box = document.createElement("div");
+	box.className = "mw-taf-timectrl";
+	box.style.cssText = "display:flex;gap:8px;align-items:center;padding:6px 10px;background:#fff;border:1px solid #d8dee6;border-radius:8px;font:12px/1.4 system-ui,sans-serif;color:#1c2733";
+	const label = document.createElement("span");
+	const input = document.createElement("input");
+	input.type = "range";
+	input.min = "0";
+	input.step = "1";
+	input.setAttribute("aria-label", locale === "en" ? "forecast time" : "预报时刻");
+	const from = options.from ?? options.items.reduce((acc, it) => {
+		const v = it.report.validity;
+		if (v === void 0) return acc;
+		const cand = {
+			day: v.startDay,
+			hour: v.startHour,
+			minute: 0
+		};
+		if (acc.day === 0 && acc.hour === 0) return cand;
+		return cand.day < acc.day || cand.day === acc.day && cand.hour < acc.hour ? cand : acc;
+	}, {
+		day: 0,
+		hour: 0,
+		minute: 0
+	});
+	let toAbsMax = null;
+	for (const it of options.items) {
+		const v = it.report.validity;
+		if (v === void 0) continue;
+		const abs = ((v.endDay < v.startDay ? v.endDay + 31 : v.endDay) - 1) * 1440 + v.endHour * 60;
+		if (toAbsMax === null || abs > toAbsMax) toAbsMax = abs;
+	}
+	const fromAbs = tafAbsOf(from);
+	const toAbs = options.to !== void 0 ? tafAbsOf(options.to) : toAbsMax ?? fromAbs + 100 * step;
+	const spanSteps = Math.max(1, Math.round((toAbs - fromAbs) / step));
+	input.max = String(spanSteps);
+	const atOfValue = (value) => {
+		const base = from.day * 1440 + from.hour * 60 + from.minute + value * step;
+		return {
+			day: Math.floor(base / 1440),
+			hour: Math.floor(base % 1440 / 60),
+			minute: base % 60
+		};
+	};
+	const apply = (at) => {
+		const text = zoneText(at);
+		label.textContent = text;
+		input.setAttribute("aria-valuetext", text);
+		setTafLayerTime(map, options.layer, options.items, {
+			...options.layerOptions,
+			at
+		});
+		options.onTime?.(at);
+	};
+	let rafPending = false;
+	input.addEventListener("input", () => {
+		if (rafPending) return;
+		rafPending = true;
+		requestAnimationFrame(() => {
+			rafPending = false;
+			apply(atOfValue(Number(input.value)));
+		});
+	});
+	const idxOf = (at) => Math.max(0, Math.min(spanSteps, Math.round((at.day * 1440 + at.hour * 60 + at.minute - (from.day * 1440 + from.hour * 60 + from.minute)) / step)));
+	input.value = String(idxOf(options.initialAt ?? from));
+	apply(atOfValue(Number(input.value)));
+	box.append(input, label);
+	if (options.tickEveryMinutes !== void 0) {
+		const every = Math.max(step, options.tickEveryMinutes);
+		const first = Math.ceil((fromAbs + 1) / every) * every;
+		const total = toAbs - fromAbs;
+		const axis = document.createElement("div");
+		axis.style.cssText = "position:relative;height:15px;margin-top:4px;width:100%;font-size:10px;color:#6b7785";
+		/** 刻度短标签：整点 HH:00；展示时区 00 时＝日界 M月D日（calendarAnchor 真月历，月界批） */
+		const tickText = (at) => {
+			if (ltOffset !== null && locale === "zh") {
+				if (cal !== void 0 && at.day >= 1) {
+					const z = new Date(Date.UTC(cal.year, cal.month - 1, at.day, at.hour, at.minute) + ltOffset * 6e4);
+					return z.getUTCHours() === 0 && z.getUTCMinutes() === 0 ? `北京时${z.getUTCMonth() + 1}月${z.getUTCDate()}日` : `北京时${String(z.getUTCHours()).padStart(2, "0")}:${String(z.getUTCMinutes()).padStart(2, "0")}`;
+				}
+				const z = tafAtOfAbs(tafAbsOf(at) + ltOffset);
+				const day = (z.day - 1) % 31 + 1;
+				return z.hour === 0 && z.minute === 0 ? `北京时${String(day).padStart(2, "0")}日` : `北京时${String(z.hour).padStart(2, "0")}:${String(z.minute).padStart(2, "0")}`;
+			}
+			return at.hour === 0 && at.minute === 0 ? `${String(at.day).padStart(2, "0")}日` : `${String(at.hour).padStart(2, "0")}:${String(at.minute).padStart(2, "0")}`;
+		};
+		const addTick = (abs, anchorRight = false) => {
+			const s = document.createElement("span");
+			s.textContent = tickText(tafAtOfAbs(abs));
+			s.style.cssText = anchorRight ? "position:absolute;right:0;white-space:nowrap" : `position:absolute;left:${((abs - fromAbs) / total * 100).toFixed(3)}%;transform:translateX(-50%);white-space:nowrap`;
+			axis.append(s);
+		};
+		for (let a = first; a <= toAbs - every / 2; a += every) addTick(a);
+		addTick(toAbs, true);
+		box.append(axis);
+		return box;
+	}
+	const ticks = document.createElement("div");
+	ticks.style.cssText = "display:flex;justify-content:space-between;width:100%;font-size:10px;color:#6b7785";
+	const tickL = document.createElement("span");
+	tickL.textContent = zoneText(from);
+	const tickR = document.createElement("span");
+	tickR.textContent = zoneText(atOfValue(spanSteps));
+	ticks.append(tickL, tickR);
+	box.append(ticks);
+	return box;
+}
 //#endregion
-export { addMetarLayer };
+export { TIER_COLORS, addMetarLayer, addTafLayer, createTafTimeControl, metarTierOf, setTafLayerTime, summarizeMetarConditions, tafTierOf };
 
 //# sourceMappingURL=index.js.map