tuiweather 0.3.4 → 0.4.0

package/README.md

@@ -16,7 +16,9 @@ Keyboard-driven terminal weather app: Dark Sky-style rain nowcasting, hourly and
 
 ## Install
 
-Requires Node.js >= 26.4.0 to run. Install globally with npm:
+Requires Node.js to run: the package declares `engines.node >= 20`, and the command-line
+paths (`--version`, `--help`, `--one-line`) work on any such Node; the interactive TUI
+needs Node >= 26.4.0, enforced at runtime by the launcher. Install globally with npm:
 
 ```sh
 npm install --global tuiweather
@@ -28,7 +30,20 @@ or with the Bun package manager:
 bun install --global tuiweather
 ```
 
-Standalone binaries for macOS and Linux are attached to each [GitHub release](https://github.com/brndnsh-labs/tuiweather/releases).
+or run without installing:
+
+```sh
+npx tuiweather --version
+bunx tuiweather --version
+```
+
+Standalone binaries for macOS, Linux, and Windows (x64) are attached to each [GitHub release](https://github.com/brndnsh-labs/tuiweather/releases). On Windows (no Node or Bun required), in cmd.exe or any shell with `curl.exe` on PATH:
+
+```sh
+curl.exe -Lo tuiweather-windows-x64.tar.gz https://github.com/brndnsh-labs/tuiweather/releases/latest/download/tuiweather-windows-x64.tar.gz
+tar -xzf tuiweather-windows-x64.tar.gz
+.\tuiweather.exe --version
+```
 
 ### macOS Gatekeeper
 
@@ -43,8 +58,9 @@ xattr -d com.apple.quarantine /path/to/tuiweather
 Run `tuiweather` with no arguments for the full TUI.
 
 On the first run, tuiweather opens a short keyboard tour, asks for metric or imperial units, and
-lets you search for your first location. The completed setup is written atomically to the normal
-config path before weather data loads.
+lets you search for your first location. Press `s` on the welcome step to skip for now and see the
+empty main view, or `o` from the help overlay to re-run setup later. The completed setup is written
+atomically to the normal config path before weather data loads.
 
 Use `tuiweather --help` for command-line options and `tuiweather --version` to print the installed version.
 
@@ -63,7 +79,8 @@ Use `tuiweather --help` for command-line options and `tuiweather --version` to p
 | `J` / `K` | Move focused location down/up in sidebar order (lg tier) |
 | `↑` / `↓` | Scroll the main panel when content overflows |
 | `?` | Toggle help overlay |
-| `esc` | Clear sidebar focus if set; otherwise close help overlay or quit |
+| `o` | Re-run setup (from help overlay) |
+| `esc` | Clear sidebar focus if set; otherwise close the help overlay |
 | `q` | Quit |
 
 While the search overlay is open it owns the keyboard: type to search, up/down to move the cursor, enter to add the highlighted result, esc to cancel. Number, focus, and reorder keys are ignored while the search input is focused (same as `d`/`r`).
@@ -125,10 +142,11 @@ bell. The bell depends on the minute-level nowcast, which is Open-Meteo only: un
 Config lives at `~/.config/tuiweather/config.toml` (respects `XDG_CONFIG_HOME`). Every field is optional unless marked required; unknown fields are ignored.
 
 ```toml
-schema_version = 3
+schema_version = 4
 time_format = "auto"
 refresh_minutes = 10
 theme = "auto"
+ink = "auto"
 provider = "openmeteo"
 daily_days = 7
 hourly_hours = 24
@@ -155,24 +173,26 @@ longitude = -122.6765
 
 | Field | Type | Default | Constraints |
 | --- | --- | --- | --- |
-| `schema_version` | integer | `3` | Required; currently always `3`. Version 1 and 2 files are migrated in place on load |
+| `schema_version` | integer | `4` | Required; currently always `4`. Version 1, 2, and 3 files are migrated in place on load |
 | `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 |
+| `reduced_motion` | boolean | `false` | Replace the animated loading spinner with a static indicator |
+| `theme` | `day` / `night` / `auto` | `"auto"` | Accent palette; `auto` follows the location's sunrise/sunset. Text ink adapts via `ink` |
+| `ink` | `auto` / `light` / `dark` | `"auto"` | Terminal ink override; `auto` detects the background via an OSC query (300ms timeout, fallback dark), `light`/`dark` skips detection and uses that ink directly |
 | `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 |
-| `units.temp` | `metric` / `imperial` | legacy `units` | Display unit for temperatures |
-| `units.wind` | `metric` / `imperial` | legacy `units` | Display unit for wind speed and visibility |
-| `units.precip` | `metric` / `imperial` | legacy `units` | Display unit for precipitation amounts |
-| `units.pressure` | `metric` / `imperial` | legacy `units` | Display unit for pressure; `metric` → hPa (rounded), `imperial` → inHg to 2 decimals; defaults via legacy `units` |
+| `units.temp` | `metric` / `imperial` | legacy `units`, else `imperial` | Display unit for temperatures |
+| `units.wind` | `metric` / `imperial` | legacy `units`, else `imperial` | Display unit for wind speed and visibility |
+| `units.precip` | `metric` / `imperial` | legacy `units`, else `imperial` | Display unit for precipitation amounts |
+| `units.pressure` | `metric` / `imperial` | legacy `units`, else `imperial` | Display unit for pressure; `metric` → hPa (rounded), `imperial` → inHg to 2 decimals; falls back to `imperial` when unset |
 | `panels.nowcast` | boolean | `true` | Show/hide the nowcast banner |
 | `panels.details` | boolean | `true` | Show/hide the details grid |
 | `panels.hourly` | boolean | `true` | Show/hide the hourly strip |
 | `panels.daily` | boolean | `true` | Show/hide the daily list |
 
-Each `[units]` field can be set independently, so mixed display such as °C temperatures with mph wind works everywhere including one-line mode. The legacy top-level `units = "metric" | "imperial"` scalar is still accepted and acts as the fallback for any `[units]` field you omit; because TOML forbids a key and table with the same name, saved configs contain either the scalar (uniform prefs) or the full `[units]` table (mixed prefs), never both.
+Each `[units]` field can be set independently, so mixed display such as °C temperatures with mph wind works everywhere including one-line mode. The legacy top-level `units = "metric" | "imperial"` scalar is still accepted and acts as the fallback for any `[units]` field you omit; when neither the field nor the legacy scalar is set, the unit falls back to `imperial`. Because TOML forbids a key and table with the same name, saved configs contain either the scalar (uniform prefs) or the full `[units]` table (mixed prefs), never both.
 
 Each `[[locations]]` entry:
 

package/bin/tuiweather.js

@@ -1,2 +1,39 @@
-#!/usr/bin/env -S node --experimental-ffi --disable-warning=ExperimentalWarning
-import "../dist/index.js";
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+
+const FFI_FLAGS = ["--experimental-ffi", "--disable-warning=ExperimentalWarning"];
+const FFI_MIN_NODE = [26, 4, 0];
+
+function nodeAtLeast(min) {
+  const parts = process.versions.node.split(".").map(Number);
+  for (let i = 0; i < min.length; i++) {
+    const have = parts[i] ?? 0;
+    if (have !== min[i]) return have > min[i];
+  }
+  return true;
+}
+
+const underBun = Boolean(process.versions.bun);
+const hasFlags = FFI_FLAGS.every((flag) => process.execArgv.includes(flag));
+
+if (underBun || hasFlags || !nodeAtLeast(FFI_MIN_NODE)) {
+  await import("../dist/index.js");
+} else {
+  const script = fileURLToPath(new URL("../dist/index.js", import.meta.url));
+  const child = spawnSync(process.execPath, [...FFI_FLAGS, script, ...process.argv.slice(2)], {
+    stdio: "inherit",
+  });
+  if (child.error) {
+    console.error(child.error.message);
+    process.exitCode = 1;
+  } else if (child.signal) {
+    try {
+      process.kill(process.pid, child.signal);
+    } catch {
+      process.exitCode = child.status ?? 1;
+    }
+  } else {
+    process.exitCode = child.status ?? 1;
+  }
+}