@x-otto/plugin-weather 0.1.0-alpha.5 → 0.1.0-alpha.6

package/README.md

@@ -8,7 +8,7 @@ Provides a single `get_weather` tool that fetches current weather and a 3-day fo
 
 This plugin contributes two things:
 
-1. **Tool** (`get_weather`) — Geocodes a city name, fetches the 7-day forecast from Open-Meteo, and returns structured data with current conditions + 3-day summary.
+1. **Tool** (`get_weather`) — Geocodes a city name, fetches the 3-day forecast from Open-Meteo, and returns structured data with current conditions + 3-day summary.
 2. **Renderer** — A terminal card renderer (`matcher.toolName: "get_weather"`) that formats the tool result as a pretty TUI card with temperature, description, and forecast details.
 
 The tool returns both a plain-text summary (for the conversation stream) and structured `details` (for the renderer to consume without string parsing).

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@x-otto/plugin-weather",
-  "version": "0.1.0-alpha.5",
+  "version": "0.1.0-alpha.6",
   "private": false,
   "description": "Weather forecast plugin — get_weather tool (Open-Meteo, no API key) + terminal card renderer",
   "devDependencies": {
-    "@x-otto/interchange": "0.1.0-alpha.4"
+    "@x-otto/interchange": "0.1.0-alpha.8"
   },
   "type": "module",
   "files": [
@@ -12,6 +12,8 @@
     "README.md",
     "plugin.ts",
     "src",
+    "renderers",
+    "renderers-dist",
     "plugin-dist"
   ],
   "publishConfig": {
@@ -20,7 +22,7 @@
     "tag": "alpha"
   },
   "dependencies": {
-    "@x-otto/plugin": "0.1.0-alpha.5"
+    "@x-otto/plugin": "0.1.0-alpha.8"
   },
   "scripts": {
     "typecheck": "tsc --noEmit",

package/plugin-dist/meta.json

@@ -1 +1 @@
-{"apiVersion":1,"compilerVersion":"0.1.0-alpha.6","sourceHash":"bed185533d663b69a36b881d8540349deb90b100fa4b51dc2adafa0b8baec44a"}
+{"apiVersion":1,"compilerVersion":"0.1.0-alpha.8","sourceHash":"77c57e232f4a06a5f27a09c936273f194f49cbbd4655c0e53eeca6a79c6c2748"}

package/renderers/weather.ts

@@ -0,0 +1,155 @@
+/**
+ * weather.ts —— `get_weather` 工具结果的终端卡片渲染器（RFC-105 D6 渲染器型）。
+ *
+ * 签名：`(message: unknown, columns: number) => string[]`，与 `renderMessageLines` 同构
+ * （`@x-otto/tui` 消息级渲染的原生货币是 ANSI 字符串数组，见 `plugin-renderer-registry.ts`）。
+ * `message` 是完整 `ToolResultMessage`，`details` 字段携带 `plugin.ts` 产出的结构化
+ * `WeatherData`（同 `src/types.ts` 定义，两侧手动保持字段一致，编译产物各自独立无法共享类型）。
+ *
+ * fail-soft：`details` 缺失/形状不符时返回空数组（宿主 `tryRenderWithPlugins` 视为
+ * "未接管"，回退默认文本渲染，见 R6），不抛异常。
+ */
+
+/**
+ * ANSI 24-bit 色常量 —— 插件独立产物无法 import @x-otto/tui THEME 常量，此处硬编码
+ * 与 TUI 设计语言语义角色对齐的值：
+ *   - panelBorder / inactive = #9498B8（注释蓝灰，TUI 统一面板边框色与次级文本色）
+ *   - warning = #E5C07B（One-Dark 语法黄色，用于极端天气提示）
+ *
+ * 配色只出现一次（这里），后续渲染全部引用常量名而非裸值。
+ *
+ * RFC-303 M3（T303-09）：三个常量此前均是空 CSI 前缀（`${CSI}` 缺少真正的 SGR 参数
+ * 与结尾 `m`），拼接后产出畸形转义序列——终端不解析为颜色，而是原样打印或静默吞掉，
+ * 8 处消费点全部无色输出。旧版测试（`renderer.test.ts`）只断言 `toContain('\x1b[')`，
+ * 对这个具体值恒真，是本仓已知的恒绿测试盲区（经历过两轮 review 未被发现）。已按上述
+ * 声明的语义色值补齐 24-bit ANSI 前景色（`\x1b[38;2;R;G;Bm`）：panelBorder/inactive
+ * = rgb(148,152,184)，warning = rgb(229,192,123)。
+ */
+const CSI = '\x1b['
+const RESET = `${CSI}0m`
+const ANSI_BORDER = `${CSI}38;2;148;152;184m`
+const ANSI_INACTIVE = `${CSI}38;2;148;152;184m`
+const ANSI_WARNING = `${CSI}38;2;229;192;123m`
+
+/** 单位常量（终局 review 补齐，避免裸字面量散布多处）。 */
+const TEMP_UNIT = '°C'
+const WIND_SPEED_UNIT = 'km/h'
+
+/** 检测极端天气描述，命中时渲染行使用 warning 色。 */
+function isSevereWeather(desc: string): boolean {
+  return /thunderstorm|heavy|violent/i.test(desc)
+}
+
+interface WeatherRenderData {
+  city: string
+  country?: string
+  current: {
+    temperature: number
+    humidity: number
+    windSpeed: number
+    description: string
+    icon: string
+  }
+  forecast: Array<{
+    date: string
+    tempMax: number
+    tempMin: number
+    description: string
+    icon: string
+  }>
+}
+
+const CARD_WIDTH_MIN = 30
+
+function isWeatherData(value: unknown): value is WeatherRenderData {
+  if (!value || typeof value !== 'object') return false
+  const v = value as Record<string, unknown>
+  return typeof v.city === 'string' && v.city.length > 0 && typeof v.current === 'object' && Array.isArray(v.forecast)
+}
+
+/**
+ * 简化版终端显示宽度估算（emoji/CJK 等宽字符按 2 列计，其余按 1 列计）。不追求
+ * Unicode 规范级精确（如变体选择符/ZWJ 序列的精确 grapheme 聚类），够本卡片对齐场景使用——
+ * 独立轻量插件不引入 `string-width`（纯 ESM + 完整 Unicode 数据表，对一个渲染函数是重依赖）。
+ */
+function displayWidth(text: string): number {
+  let width = 0
+  for (const ch of text) {
+    const code = ch.codePointAt(0) ?? 0
+    // 变体选择符（U+FE0F 等）零宽——不单独占列，只是修饰前一个字符的呈现形式
+    // （如 ☀️ = U+2600 + U+FE0F，作为两个独立 code point 被 for...of 拆开）。
+    if (code === 0xfe0f || code === 0xfe0e) continue
+    // CJK 统一表意文字/标点、韩文音节、日文假名，以及 emoji 常见区段（misc symbols/
+    // dingbats/emoticons/transport/supplemental symbols）均按全角(2列)计。
+    const isWide =
+      (code >= 0x1100 && code <= 0x115f) || // Hangul Jamo
+      (code >= 0x2e80 && code <= 0xa4cf) || // CJK Radicals ~ Yi
+      (code >= 0xac00 && code <= 0xd7a3) || // Hangul Syllables
+      (code >= 0xf900 && code <= 0xfaff) || // CJK Compatibility Ideographs
+      (code >= 0xff00 && code <= 0xff60) || // Fullwidth Forms
+      (code >= 0x2600 && code <= 0x27bf) || // Misc symbols / Dingbats（含 ☀️☁️⛅ 等）
+      (code >= 0x1f300 && code <= 0x1fadf) // emoji 主区段
+    width += isWide ? 2 : 1
+  }
+  return width
+}
+
+/** 补齐到目标显示宽度；超长则截断（按 code point 逐步剪短直到显示宽度不超）。 */
+function pad(text: string, width: number): string {
+  let w = displayWidth(text)
+  if (w <= width) return text + ' '.repeat(width - w)
+  let out = text
+  while (w > width && out.length > 0) {
+    out = [...out].slice(0, -1).join('')
+    w = displayWidth(out)
+  }
+  return out
+}
+
+export default function renderWeatherCard(message: unknown, columns: number): string[] {
+  const m = message as Record<string, unknown>
+  const details = m.details
+  if (!isWeatherData(details)) return []
+
+  // Nav 风格无竖线，宽度 = 内容宽度（不需扣 2 列边框裕量）
+  const width = Math.max(CARD_WIDTH_MIN, Math.min(columns, 40))
+
+  const location = details.country ? `${details.city}, ${details.country}` : details.city
+  const out: string[] = []
+
+  // 顶部横线 — nav 风格（仅上下单线，无左/右竖线），panelBorder 色
+  out.push(`${ANSI_BORDER}${'─'.repeat(width)}${RESET}`)
+
+  // 城市/国家（默认终端色）
+  out.push(pad(location, width))
+
+  // 温度 + 描述（默认终端色；极端天气整行 warning 色）
+  const currentLine = `${details.current.icon}  ${details.current.temperature}${TEMP_UNIT}  ${details.current.description}`
+  if (isSevereWeather(details.current.description)) {
+    out.push(`${ANSI_WARNING}${pad(currentLine, width)}${RESET}`)
+  } else {
+    out.push(pad(currentLine, width))
+  }
+
+  // 湿度 + 风速 — 次级色（THEME.inactive = #9498B8）
+  const weatherLine = `💧 ${details.current.humidity}%  💨 ${details.current.windSpeed} ${WIND_SPEED_UNIT}`
+  out.push(`${ANSI_INACTIVE}${pad(weatherLine, width)}${RESET}`)
+
+  // 分隔横线 — nav 风格
+  out.push(`${ANSI_BORDER}${'─'.repeat(width)}${RESET}`)
+
+  // 预报行（极端天气行 warning 色）
+  for (const day of details.forecast) {
+    const line = `${day.date}  ${day.icon} ${day.tempMin}° / ${day.tempMax}°  ${day.description}`
+    if (isSevereWeather(day.description)) {
+      out.push(`${ANSI_WARNING}${pad(line, width)}${RESET}`)
+    } else {
+      out.push(pad(line, width))
+    }
+  }
+
+  // 底部横线
+  out.push(`${ANSI_BORDER}${'─'.repeat(width)}${RESET}`)
+
+  return out
+}

package/renderers-dist/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/renderers-dist/weather.js

@@ -0,0 +1,96 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// extensions/plugin-weather/renderers/weather.ts
+var weather_exports = {};
+__export(weather_exports, {
+  default: () => renderWeatherCard
+});
+module.exports = __toCommonJS(weather_exports);
+var CSI = "\x1B[";
+var RESET = `${CSI}0m`;
+var ANSI_BORDER = `${CSI}38;2;148;152;184m`;
+var ANSI_INACTIVE = `${CSI}38;2;148;152;184m`;
+var ANSI_WARNING = `${CSI}38;2;229;192;123m`;
+var TEMP_UNIT = "\xB0C";
+var WIND_SPEED_UNIT = "km/h";
+function isSevereWeather(desc) {
+  return /thunderstorm|heavy|violent/i.test(desc);
+}
+var CARD_WIDTH_MIN = 30;
+function isWeatherData(value) {
+  if (!value || typeof value !== "object") return false;
+  const v = value;
+  return typeof v.city === "string" && v.city.length > 0 && typeof v.current === "object" && Array.isArray(v.forecast);
+}
+function displayWidth(text) {
+  let width = 0;
+  for (const ch of text) {
+    const code = ch.codePointAt(0) ?? 0;
+    if (code === 65039 || code === 65038) continue;
+    const isWide = code >= 4352 && code <= 4447 || // Hangul Jamo
+    code >= 11904 && code <= 42191 || // CJK Radicals ~ Yi
+    code >= 44032 && code <= 55203 || // Hangul Syllables
+    code >= 63744 && code <= 64255 || // CJK Compatibility Ideographs
+    code >= 65280 && code <= 65376 || // Fullwidth Forms
+    code >= 9728 && code <= 10175 || // Misc symbols / Dingbats（含 ☀️☁️⛅ 等）
+    code >= 127744 && code <= 129759;
+    width += isWide ? 2 : 1;
+  }
+  return width;
+}
+function pad(text, width) {
+  let w = displayWidth(text);
+  if (w <= width) return text + " ".repeat(width - w);
+  let out = text;
+  while (w > width && out.length > 0) {
+    out = [...out].slice(0, -1).join("");
+    w = displayWidth(out);
+  }
+  return out;
+}
+function renderWeatherCard(message, columns) {
+  const m = message;
+  const details = m.details;
+  if (!isWeatherData(details)) return [];
+  const width = Math.max(CARD_WIDTH_MIN, Math.min(columns, 40));
+  const location = details.country ? `${details.city}, ${details.country}` : details.city;
+  const out = [];
+  out.push(`${ANSI_BORDER}${"\u2500".repeat(width)}${RESET}`);
+  out.push(pad(location, width));
+  const currentLine = `${details.current.icon}  ${details.current.temperature}${TEMP_UNIT}  ${details.current.description}`;
+  if (isSevereWeather(details.current.description)) {
+    out.push(`${ANSI_WARNING}${pad(currentLine, width)}${RESET}`);
+  } else {
+    out.push(pad(currentLine, width));
+  }
+  const weatherLine = `\u{1F4A7} ${details.current.humidity}%  \u{1F4A8} ${details.current.windSpeed} ${WIND_SPEED_UNIT}`;
+  out.push(`${ANSI_INACTIVE}${pad(weatherLine, width)}${RESET}`);
+  out.push(`${ANSI_BORDER}${"\u2500".repeat(width)}${RESET}`);
+  for (const day of details.forecast) {
+    const line = `${day.date}  ${day.icon} ${day.tempMin}\xB0 / ${day.tempMax}\xB0  ${day.description}`;
+    if (isSevereWeather(day.description)) {
+      out.push(`${ANSI_WARNING}${pad(line, width)}${RESET}`);
+    } else {
+      out.push(pad(line, width));
+    }
+  }
+  out.push(`${ANSI_BORDER}${"\u2500".repeat(width)}${RESET}`);
+  return out;
+}