tuiweather 0.3.0 → 0.3.1

package/README.md

@@ -4,7 +4,7 @@ Keyboard-driven terminal weather app: Dark Sky-style rain nowcasting, hourly and
 
 ## Features
 
-- **Rain nowcast** — minute-level "umbrella in N min" warnings derived from 15-minute precipitation buckets
+- **Rain nowcast** — minute-level "umbrella in N min" warnings derived from 15-minute precipitation buckets (Open-Meteo only; NWS has no minute-level precipitation feed — the nowcast panel hides and the watch bell stays inactive under `provider = "nws"`, nothing renders a false "Dry")
 - **Hourly + daily forecast** — sparkline temperature strip, emoji condition icons, precipitation probabilities, and (md+ widths) a UV/humidity/visibility summary row
 - **Location search** — type `/`, search the Open-Meteo geocoder, enter to add; locations persist to config
 - **Guided first run** — choose units and find a location without editing a config file
@@ -113,7 +113,9 @@ tuiweather watch --location seattle
 
 Each poll prints the one-line status (prefixed with the location label). The bell rings only on a
 dry → wet transition, not on every poll. Rain already in progress when the watch starts does not
-bell. Desktop notifications are a planned follow-up.
+bell. The bell depends on the minute-level nowcast, which is Open-Meteo only: under
+`provider = "nws"` the nowcast panel hides and the bell stays inactive — nothing renders a false
+"Dry". Desktop notifications are a planned follow-up.
 
 ## Configuration
 
@@ -154,7 +156,7 @@ longitude = -122.6765
 | `time_format` | `12h` / `24h` / `auto` | `"auto"` | `auto` picks 12h when temperature units are imperial, else 24h |
 | `refresh_minutes` | integer | `10` | Minimum `1` |
 | `theme` | `day` / `night` / `auto` | `"auto"` | Accent palette; `auto` follows the location's sunrise/sunset. Text ink always adapts to your terminal's background |
-| `provider` | `openmeteo` / `nws` | `"openmeteo"` | Weather data source; NWS air quality is not provided |
+| `provider` | `openmeteo` / `nws` | `"openmeteo"` | Weather data source. Open-Meteo is the default full-feature experience; NWS is the official US source fallback — works: conditions, temperatures, precipitation probabilities; goes quiet: minute-level nowcast (panel hides, watch bell inactive), hourly/daily precip amounts (blank bars/chips), air quality |
 | `daily_days` | integer | `7` | `1`–`16` forecast days |
 | `hourly_hours` | integer | `24` | `12`–`48` forecast hours |
 | `default_location` | string | none | Must match a `[[locations]]` slug |

package/dist/index.js

@@ -71422,7 +71422,7 @@ function peakProbability(points) {
 }
 function sliceUpcoming(points, nowUtc, max) {
   const nowMs = Date.parse(nowUtc);
-  const upcoming = points.filter((p) => Date.parse(p.timeUtc) >= nowMs);
+  const upcoming = points.filter((p) => Date.parse(p.timeUtc) > nowMs);
   return upcoming.slice(0, Math.max(0, max));
 }
 function seriesWidthFor(pointCount, width) {
@@ -71714,6 +71714,8 @@ function sortedBuckets(f) {
   })).sort((a, b2) => a.startMs - b2.startMs);
 }
 function deriveNowcast(f, nowUtc) {
+  if (!f.hasMinutePrecip)
+    return { kind: "unavailable" };
   const nowMs = Date.parse(nowUtc);
   const buckets = sortedBuckets(f);
   const first = buckets[0];
@@ -71778,6 +71780,8 @@ function describeNowcast(n) {
   switch (n.kind) {
     case "dry":
       return "Dry";
+    case "unavailable":
+      return "Nowcast unavailable";
     case "starting": {
       const word = INTENSITY_WORD[n.intensity];
       return n.startsInMin < 1 ? `${word} starting any minute` : `${word} starting in ${n.startsInMin} min`;
@@ -71812,6 +71816,8 @@ var NowcastBanner = import_react23.memo(function NowcastBanner2({
   nowUtc
 }) {
   const palette = usePalette();
+  if (nowcast.kind === "unavailable")
+    return null;
   if (nowcast.kind === "dry") {
     if (hideWhenDry)
       return null;
@@ -71857,9 +71863,7 @@ function errorMessage(e) {
   return e instanceof Error ? e.message : String(e);
 }
 function truncateTo(text, width) {
-  if (text.length <= width)
-    return text;
-  return `${text.slice(0, Math.max(0, width - 1))}\u2026`;
+  return truncateCells(text, width);
 }
 function slugifyCandidate(name, admin1, countryCode) {
   const raw = `${name}${admin1 ? `-${admin1}` : ""}-${countryCode ?? ""}`;
@@ -71879,7 +71883,7 @@ function buildLocationEntry(result, existingSlugs) {
   const label = region.length > 0 ? `${result.name}, ${region}` : result.name;
   return {
     slug: uniqueSlug(slugifyCandidate(result.name, result.admin1, result.country_code), existingSlugs),
-    label: (label.length > 0 ? label : "unnamed").slice(0, 80),
+    label: truncateCells(label.length > 0 ? label : "unnamed", 80),
     latitude: result.latitude,
     longitude: result.longitude
   };
@@ -71895,10 +71899,11 @@ function regionText(result) {
 function resultLine(result, selected, width) {
   const right = formatCoords(result.latitude, result.longitude);
   const leftRaw = `${result.name} \xB7 ${regionText(result)}`;
-  const avail = Math.max(0, width - 2 - right.length);
-  const left = truncateTo(leftRaw, avail).padEnd(avail);
   const prefix = selected ? "\u203A" : " ";
-  return `${prefix} ${left}${right}`.slice(0, width);
+  const avail = Math.max(0, width - displayWidth(prefix) - 1 - displayWidth(right));
+  const left = truncateTo(leftRaw, avail);
+  const padded = `${left}${" ".repeat(Math.max(0, avail - displayWidth(left)))}`;
+  return `${prefix} ${padded}${right}`;
 }
 function LocationPicker({
   searchLocations,
@@ -90905,22 +90910,17 @@ var HINTS_FULL = "/ search \xB7 r refresh \xB7 d del\xD72 \xB7 u units \xB7 [ ]
 var HINTS_MD = "/ search \xB7 r refresh \xB7 d del\xD72 \xB7 \u2191\u2193 scroll \xB7 ? help \xB7 q quit";
 var HINTS_SM = "r refresh \xB7 \u2191\u2193 scroll \xB7 ? help \xB7 q quit";
 var HINTS_XS = "r u ? q";
-function footerText(tier) {
-  if (tier === "xs")
-    return HINTS_XS;
-  if (tier === "sm")
-    return HINTS_SM;
-  if (tier === "md")
-    return HINTS_MD;
-  return HINTS_FULL;
+function footerText(tier, width) {
+  const hints = tier === "xs" ? HINTS_XS : tier === "sm" ? HINTS_SM : tier === "md" ? HINTS_MD : HINTS_FULL;
+  return truncateCells(hints, Math.max(1, width - 3));
 }
-function Footer({ tier }) {
+function Footer({ tier, width }) {
   const palette = usePalette();
   return /* @__PURE__ */ import_jsx_dev_runtime2.jsxDEV("box", {
     flexDirection: "row",
     children: /* @__PURE__ */ import_jsx_dev_runtime2.jsxDEV("text", {
       fg: palette.fgDim,
-      children: footerText(tier)
+      children: footerText(tier, width)
     }, undefined, false, undefined, this)
   }, undefined, false, undefined, this);
 }
@@ -90951,18 +90951,20 @@ function Header({
   tier,
   fetchedAtMs,
   stale = false,
-  nowMs = Date.now()
+  nowMs = Date.now(),
+  width
 }) {
   const palette = usePalette();
   if (tier === "sm" || tier === "xs") {
     const clock = clockUtc !== undefined ? formatClock(clockUtc, utcOffsetSeconds, timeFormat) : "--:--";
     const date5 = tier === "sm" && clockUtc !== undefined ? formatDayDate(clockUtc, utcOffsetSeconds, "short") : undefined;
     const line = [label, date5, clock].filter((part) => part !== undefined).join(" \xB7 ");
+    const clipped = width === undefined ? line : truncateCells(line, Math.max(1, width - 1));
     return /* @__PURE__ */ import_jsx_dev_runtime2.jsxDEV("box", {
       flexDirection: "row",
       children: /* @__PURE__ */ import_jsx_dev_runtime2.jsxDEV("text", {
         fg: palette.fg,
-        children: line
+        children: clipped
       }, undefined, false, undefined, this)
     }, undefined, false, undefined, this);
   }
@@ -91100,21 +91102,19 @@ function Spinner() {
     children: SPINNER_FRAMES[frame] ?? "|"
   }, undefined, false, undefined, this);
 }
-function truncate(text, width) {
-  if (text.length <= width)
-    return text;
-  return `${text.slice(0, Math.max(0, width - 1))}\u2026`;
+function deleteArmLine(label, width) {
+  const line = `press d again to delete ${label}`;
+  const budget = width === undefined ? displayWidth(line) : Math.max(0, width - 1);
+  return truncateCells(line, budget);
 }
 function StatusArea({ loading, error: error61, stale, deleteArm, width }) {
   const palette = usePalette();
   if (deleteArm !== undefined) {
-    const line = `press d again to delete ${deleteArm.label}`;
-    const budget = width === undefined ? line.length : Math.max(0, width - 1);
     return /* @__PURE__ */ import_jsx_dev_runtime2.jsxDEV("box", {
       flexDirection: "row",
       children: /* @__PURE__ */ import_jsx_dev_runtime2.jsxDEV("text", {
         fg: palette.warn,
-        children: truncate(line, budget)
+        children: deleteArmLine(deleteArm.label, width)
       }, undefined, false, undefined, this)
     }, undefined, false, undefined, this);
   }
@@ -92702,6 +92702,7 @@ var geocodingResponseSchema = exports_external.object({
 // src/lib/providers/openmeteo/geocoding.ts
 var GEOCODING_ENDPOINT = "https://geocoding-api.open-meteo.com/v1/search";
 var TIMEOUT_MS = 1e4;
+var NAME_MAX_CELLS = 120;
 function buildGeocodingUrl(query, count = 8) {
   const params = new URLSearchParams({
     name: query,
@@ -92720,7 +92721,17 @@ function parseGeocodingResponse(body) {
   if (!parsed.success) {
     throw new ProviderError("openmeteo geocoding response failed schema validation", "openmeteo", parsed.error);
   }
-  return parsed.data.results ?? [];
+  const results = parsed.data.results ?? [];
+  for (const r of results) {
+    r.name = sanitizeText(r.name, NAME_MAX_CELLS);
+    if (r.country !== undefined)
+      r.country = sanitizeText(r.country, NAME_MAX_CELLS);
+    if (r.admin1 !== undefined)
+      r.admin1 = sanitizeText(r.admin1, NAME_MAX_CELLS);
+    if (r.admin2 !== undefined)
+      r.admin2 = sanitizeText(r.admin2, NAME_MAX_CELLS);
+  }
+  return results;
 }
 async function searchLocations(query, count = 8) {
   let res;
@@ -92746,6 +92757,64 @@ async function searchLocations(query, count = 8) {
   }
   return parseGeocodingResponse(body);
 }
+// package.json
+var package_default2 = {
+  name: "tuiweather",
+  version: "0.3.1",
+  description: "Keyboard-driven terminal weather app powered by Open-Meteo",
+  license: "MIT",
+  type: "module",
+  bin: {
+    tuiweather: "bin/tuiweather.js"
+  },
+  files: [
+    "bin",
+    "dist"
+  ],
+  repository: {
+    type: "git",
+    url: "git+https://github.com/brndnsh-labs/tuiweather.git"
+  },
+  homepage: "https://github.com/brndnsh-labs/tuiweather#readme",
+  bugs: "https://github.com/brndnsh-labs/tuiweather/issues",
+  keywords: [
+    "tui",
+    "weather",
+    "terminal",
+    "cli",
+    "open-meteo",
+    "forecast"
+  ],
+  publishConfig: {
+    access: "public"
+  },
+  engines: {
+    bun: ">=1.3.0"
+  },
+  scripts: {
+    dev: "bun run src/index.tsx",
+    build: "bun build ./src/index.tsx --outdir dist --target bun --external '@opentui/core-*'",
+    typecheck: "tsc --noEmit",
+    lint: "biome check .",
+    fmt: "biome check --write .",
+    test: "bun test",
+    prepublishOnly: "bun run typecheck && bun run lint && bun run test && bun run build"
+  },
+  dependencies: {
+    "@opentui/core": "^0.5.9",
+    "@opentui/react": "^0.5.9",
+    react: "^19.2.8",
+    "smol-toml": "^1.8.0",
+    zod: "4.5.2",
+    zustand: "^5.0.15"
+  },
+  devDependencies: {
+    "@biomejs/biome": "^2.5.11",
+    "@types/bun": "^1.4.0",
+    "@types/react": "^19.2.18",
+    typescript: "^7.0.2"
+  }
+};
 
 // src/lib/providers/nws/conditions.ts
 var NWS_ICON_CODES = {
@@ -93049,6 +93118,7 @@ function normalizeNwsForecast(data, location, window2) {
     utcOffsetSeconds,
     fetchedAtUtc: new Date().toISOString(),
     current: normalizeCurrent(data.obs),
+    hasMinutePrecip: false,
     minutely15: [],
     hourly: normalizeHourly(data.hourly, window2?.forecastHours),
     daily: normalizeDaily(data.daily, window2?.forecastDays)
@@ -93127,8 +93197,9 @@ var nwsProblemSchema = exports_external.object({
 
 // src/lib/providers/nws/client.ts
 var NWS_PROVIDER_ID = "nws";
-var NWS_USER_AGENT = "tuiweather/0.1 (github.com/brndnsh-labs/tuiweather)";
+var NWS_USER_AGENT = `tuiweather/${package_default2.version} (github.com/brndnsh-labs/tuiweather)`;
 var API_ROOT = "https://api.weather.gov";
+var ALLOWED_HOST = new URL(API_ROOT).host;
 var TIMEOUT_MS2 = 1e4;
 var MAX_DETAIL_CHARS = 200;
 var NWS_HEADERS = {
@@ -93146,6 +93217,15 @@ function problemDetail(body) {
   return detail === undefined ? undefined : sanitizeText(detail, MAX_DETAIL_CHARS);
 }
 async function getJson(url2, label) {
+  let target;
+  try {
+    target = new URL(url2);
+  } catch {
+    throw new ProviderError(`nws ${label} url is not absolute`, NWS_PROVIDER_ID);
+  }
+  if (target.protocol !== "https:" || target.host !== ALLOWED_HOST) {
+    throw new ProviderError(`nws ${label} url host rejected`, NWS_PROVIDER_ID);
+  }
   let res;
   try {
     res = await fetch(url2, { headers: NWS_HEADERS, signal: AbortSignal.timeout(TIMEOUT_MS2) });
@@ -93403,6 +93483,7 @@ function normalizeForecast(data, locationOverride) {
     utcOffsetSeconds: data.utc_offset_seconds,
     fetchedAtUtc: new Date().toISOString(),
     current,
+    hasMinutePrecip: true,
     minutely15,
     hourly,
     daily
@@ -93611,6 +93692,7 @@ var normalizedForecastSchema = exports_external.object({
   utcOffsetSeconds: exports_external.number(),
   fetchedAtUtc: exports_external.string(),
   current: currentObsSchema,
+  hasMinutePrecip: exports_external.boolean(),
   minutely15: exports_external.array(precipIntervalSchema),
   hourly: exports_external.array(hourlyPointSchema),
   daily: exports_external.array(dailyPointSchema)
@@ -93779,6 +93861,11 @@ var DEFAULT_REFRESH_TIMERS = {
   },
   clearInterval: (handle) => timersClearInterval(handle)
 };
+var REFRESH_LOOP_MARGIN_MS = 30000;
+var MIN_REFRESH_LOOP_PERIOD_MS = 60000;
+function refreshLoopPeriodMs(refreshMinutes) {
+  return Math.max(MIN_REFRESH_LOOP_PERIOD_MS, refreshMinutes * 60000 - REFRESH_LOOP_MARGIN_MS);
+}
 var defaultFetcher = (location, opts) => cachedForecast(selectProvider(opts.provider ?? "openmeteo"), location, {
   maxAgeMinutes: opts.maxAgeMinutes,
   window: opts.window
@@ -93842,7 +93929,7 @@ function createStoreInstance(deps = prodDeps()) {
         if (slug === null)
           return;
         get().loadForecast(slug);
-      }, get().config.refresh_minutes * 60000);
+      }, refreshLoopPeriodMs(get().config.refresh_minutes));
     }
     function launchAirQuality(slug, location, provider) {
       (async () => {
@@ -94169,7 +94256,8 @@ function estimateMainContentRows(input2) {
   if (panels.details === true && Number.isFinite(sunriseMs) && Number.isFinite(sunsetMs) && sunsetMs > sunriseMs && width - 1 >= DAYLIGHT_MIN_WIDTH - 1) {
     sections.push(1);
   }
-  if (tier !== "lg" && panels.nowcast && deriveNowcast(forecast, nowUtc).kind !== "dry") {
+  const nowcastKind = deriveNowcast(forecast, nowUtc).kind;
+  if (tier !== "lg" && panels.nowcast && nowcastKind !== "dry" && nowcastKind !== "unavailable") {
     sections.push(NOWCAST_BANNER_ROWS);
   }
   const hourlyRows = hourlyRowsFor(tier, width, forecast, panels, nowUtc);
@@ -94188,9 +94276,9 @@ function truncateTo4(text, width) {
 function clampLine(label, width) {
   if (width <= 1)
     return "";
-  if (label.length <= width - 2)
+  if (displayWidth(label) <= width - 2)
     return `${label} \u2026`;
-  return `${label.slice(0, width - 1)}\u2026`;
+  return `${truncateCells(label, width - 2)} \u2026`;
 }
 function XsChips({
   forecast,
@@ -94466,7 +94554,8 @@ function App(props = {}) {
     tier: tier === "lg" || tier === "md" ? undefined : tier,
     fetchedAtMs: entry?.fetchedAtMs,
     stale,
-    nowMs
+    nowMs,
+    width: viewport.width
   }, undefined, false, undefined, this);
   const staleBadge = stale && !loading && error61 === undefined;
   const status = /* @__PURE__ */ import_jsx_dev_runtime2.jsxDEV(StatusArea, {
@@ -94476,8 +94565,10 @@ function App(props = {}) {
     deleteArm: deleteArmed ? { label } : undefined,
     width: viewport.width
   }, undefined, false, undefined, this);
+  const footerColumnWidth = tier === "lg" ? viewport.width - SIDEBAR_WIDTH : viewport.width;
   const footer = /* @__PURE__ */ import_jsx_dev_runtime2.jsxDEV(Footer, {
-    tier
+    tier,
+    width: footerColumnWidth
   }, undefined, false, undefined, this);
   const mainWidth = tier === "lg" ? viewport.width - SIDEBAR_WIDTH - 4 : viewport.width - 4;
   const forecastVisible = forecast !== undefined && !helpOpen && !overlayOpen;
@@ -94643,6 +94734,7 @@ function nowcastSegment(forecast, nowUtc) {
   const nowcast = deriveNowcast(forecast, nowUtc);
   switch (nowcast.kind) {
     case "dry":
+    case "unavailable":
       return "";
     case "starting":
       return `\u2602 in ${nowcast.startsInMin}min`;
@@ -94686,7 +94778,9 @@ function buildJsonLine(forecast, location, prefs, nowUtc) {
 
 // src/app/watch.ts
 function shouldBell(prev, next) {
-  return prev.kind === "dry" && next.kind !== "dry";
+  if (prev.kind !== "dry")
+    return false;
+  return next.kind === "starting" || next.kind === "ongoing" || next.kind === "stopping";
 }
 async function runWatch(opts) {
   const nowUtcFn = opts.nowUtc ?? (() => new Date().toISOString());
@@ -94714,64 +94808,6 @@ async function runWatch(opts) {
   }
   return polls;
 }
-// package.json
-var package_default2 = {
-  name: "tuiweather",
-  version: "0.3.0",
-  description: "Keyboard-driven terminal weather app powered by Open-Meteo",
-  license: "MIT",
-  type: "module",
-  bin: {
-    tuiweather: "bin/tuiweather.js"
-  },
-  files: [
-    "bin",
-    "dist"
-  ],
-  repository: {
-    type: "git",
-    url: "git+https://github.com/brndnsh-labs/tuiweather.git"
-  },
-  homepage: "https://github.com/brndnsh-labs/tuiweather#readme",
-  bugs: "https://github.com/brndnsh-labs/tuiweather/issues",
-  keywords: [
-    "tui",
-    "weather",
-    "terminal",
-    "cli",
-    "open-meteo",
-    "forecast"
-  ],
-  publishConfig: {
-    access: "public"
-  },
-  engines: {
-    bun: ">=1.3.0"
-  },
-  scripts: {
-    dev: "bun run src/index.tsx",
-    build: "bun build ./src/index.tsx --outdir dist --target bun --external '@opentui/core-*'",
-    typecheck: "tsc --noEmit",
-    lint: "biome check .",
-    fmt: "biome check --write .",
-    test: "bun test",
-    prepublishOnly: "bun run typecheck && bun run lint && bun run test && bun run build"
-  },
-  dependencies: {
-    "@opentui/core": "^0.5.9",
-    "@opentui/react": "^0.5.9",
-    react: "^19.2.8",
-    "smol-toml": "^1.8.0",
-    zod: "4.5.2",
-    zustand: "^5.0.15"
-  },
-  devDependencies: {
-    "@biomejs/biome": "^2.5.11",
-    "@types/bun": "^1.4.0",
-    "@types/react": "^19.2.18",
-    typescript: "^7.0.2"
-  }
-};
 
 // src/cli.ts
 class UsageError extends Error {
@@ -94994,7 +95030,7 @@ async function runWatchCli(args) {
   const provider = selectProvider(config2.provider);
   const prefs = resolveDisplayPrefs(config2);
   const maxAgeMinutes = args.interval ?? config2.refresh_minutes;
-  const intervalMs = maxAgeMinutes * 60000;
+  const intervalMs = refreshLoopPeriodMs(maxAgeMinutes);
   const fetcher = () => cachedForecast(provider, { latitude, longitude }, { maxAgeMinutes });
   const write = (text) => process.stdout.write(text);
   const sleep2 = (ms) => new Promise((resolve3) => setTimeout(resolve3, ms));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tuiweather",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Keyboard-driven terminal weather app powered by Open-Meteo",
   "license": "MIT",
   "type": "module",