pi-deepseek-tariff 0.3.1 → 0.3.3

package/README.md

@@ -10,7 +10,7 @@ A [pi](https://pi.dev) extension that shows the current **DeepSeek API tariff wi
 DeepSeek charges double during peak hours, so knowing the current window is worth real money.
 
 ```
-● DeepSeek Off-peak for 11h 59m          ← footer line, always visible
+◷ deepseek OFF-PEAK → 11h 59m          ← footer line, always visible
 
 Now OFF-PEAK
 Computer: 14:43:52 26-10-2026(MSK) | UTC: 2026-10-26 11:43
@@ -38,7 +38,7 @@ Commands: /dsp on|off|refresh|en|ru · /dsp footer on|off
 pi install npm:pi-deepseek-tariff
 
 # from git: tags mirror the npm versions, so pin whichever you want
-pi install git:github.com/valderan/pi-deepseek-tariff@v0.3.0
+pi install git:github.com/valderan/pi-deepseek-tariff@v0.3.3
 
 # local checkout, for development
 git clone git@github.com:valderan/pi-deepseek-tariff.git
@@ -62,16 +62,18 @@ Then run `/dsp`. Afterwards `pi list`, `pi update --extensions`, `pi remove …`
 | `/dsp en` / `ru` | switch the panel language (persisted) |
 | `/dsp footer on` / `off` (or `/dsp footeron` / `footeroff`) | show or hide the footer line (persisted) |
 
+Type `/dsp ` and press Tab: the arguments above are offered as completions, with a short description each (`/dsp footer <Tab>` completes `on` and `off`).
+
 ## What it does
 
-- **Footer line** — one compact status line: `● DeepSeek Off-peak for 11h 59m`, or `● DeepSeek Peak for 1h 40m` during peak. The text is always yellow and only the dot changes colour — green for off-peak, red for peak. Shown only while a DeepSeek model is active; `/dsp footer off` hides it for good.
+- **Footer line** — one compact status line: `◷ deepseek OFF-PEAK → 11h 59m`, or `◷ deepseek PEAK → 1h 40m` during peak. The clock glyph leads the line and takes the state colour — green for off-peak, red for peak — and the tariff word next to it is coloured the same way. The brand is written lowercase in DeepSeek blue (`#4175E6`), the countdown uses the theme accent. Shown only while a DeepSeek model is active; `/dsp footer off` hides it for good.
 
-  Russian looks like `● DeepSeek Обычный ещё 11ч 59м` / `● DeepSeek Пиковый ещё 1ч 40м`.
+  The tariff is spelled `PEAK` / `OFF-PEAK` in English regardless of the panel language; only the countdown units are localized, so Russian reads `◷ deepseek OFF-PEAK → 11ч 59м`.
 
   Pi renders every extension status on a single footer line, joined alphabetically, so the segment is kept short.
 - **Peak rules** — DeepSeek defines peak as `01:00-04:00` and `06:00-10:00` **UTC, Monday to Friday**; weekends and Chinese public holidays are off-peak all day.
 - **Local time everywhere** — the UTC clock comes from the machine clock, so peak windows, weekday labels and countdowns are rendered in *your* zone (`(MSK)`, `(UTC-04:00)`, …). Weekday labels shift with the zone: at UTC−4 the windows land on Sun–Thu.
-- **Prices** — parsed from `api-docs.deepseek.com/quick_start/pricing/`: cache hit, cache miss and output per model, plus the Search & Fetch request rates. The tariff in effect is highlighted.
+- **Prices** — parsed from `api-docs.deepseek.com/quick_start/pricing/`: cache hit, cache miss and output per model, plus the Search & Fetch request rates. The tariff in effect is highlighted, and the `DeepSeek` word in the `DeepSeek prices:` label keeps the same brand blue as the footer.
 - **Caching** — the page is parsed at most once per `pricingTtlHours` (default 6), and the result is cached on disk, so restarts stay offline. `PI_OFFLINE` disables network access entirely and the panel falls back to built-in values.
 
 ## Configuration
@@ -134,11 +136,11 @@ the commit whose `package.json` says `X.Y.Z`, and npm publishes that same versio
 
 ```bash
 # 1. bump package.json, add a CHANGELOG entry, commit
-npm version 0.3.2 --no-git-tag-version     # or edit by hand
-git commit -am "chore: release 0.3.2"
+npm version 0.3.3 --no-git-tag-version     # or edit by hand
+git commit -am "chore: release 0.3.3"
 
 # 2. tag the release commit and push
-git tag -a v0.3.2 -m v0.3.2
+git tag -a v0.3.3 -m v0.3.3
 git push origin main --tags
 
 # 3. publish the tag to npm (2FA prompt, or --otp=123456)
@@ -149,7 +151,7 @@ npm publish --access public
 Check the result:
 
 ```bash
-npm view pi-deepseek-tariff dist-tags    # { latest: '0.3.2' }
+npm view pi-deepseek-tariff dist-tags    # { latest: '0.3.3' }
 npm view pi-deepseek-tariff versions
 ```
 
@@ -157,7 +159,7 @@ npm view pi-deepseek-tariff versions
 `NPM_TOKEN` secret is configured; with trusted publishing enabled on npmjs.com the
 token is not needed at all and the build is signed with provenance.
 
-Tags are pinnable with `pi install git:…@v0.3.2`. Published versions show up in the
+Tags are pinnable with `pi install git:…@v0.3.3`. Published versions show up in the
 [pi package gallery](https://pi.dev/packages) through the `pi-package` keyword.
 
 ## Changelog

package/extensions/deepseek-peak.ts

@@ -166,11 +166,37 @@ export default function deepseekPeak(pi: ExtensionAPI) {
 		render(ctx);
 	};
 
+	// Tab completion for the documented arguments, so `/dsp <TAB>` lists what the
+	// handler actually accepts instead of leaving them buried in the README.
+	const ARGUMENTS = [
+		{ value: "on", label: "on", description: "Show the panel · Показать панель" },
+		{ value: "off", label: "off", description: "Hide the panel · Скрыть панель" },
+		{ value: "refresh", label: "refresh", description: "Re-parse prices now · Обновить цены сейчас" },
+		{ value: "en", label: "en", description: "Panel language: English · Язык панели: английский" },
+		{ value: "ru", label: "ru", description: "Panel language: Russian · Язык панели: русский" },
+		{ value: "footer", label: "footer", description: "Footer line: on|off · Строка футера: on|off" },
+	];
+	const FOOTER_ARGUMENTS = ARGUMENTS.filter((item) => item.value === "on" || item.value === "off");
+
+	const getArgumentCompletions = (prefix: string) => {
+		const words = prefix.trimStart().split(/\s+/);
+		if (words.length > 2) return null;
+		const [head, tail] = words;
+		if (head === undefined || head === "") return ARGUMENTS;
+		if (tail === undefined) {
+			const matches = ARGUMENTS.filter((item) => item.value.startsWith(head.toLowerCase()));
+			return matches.length > 0 ? matches : null;
+		}
+		if (head.toLowerCase() !== "footer") return null;
+		const matches = FOOTER_ARGUMENTS.filter((item) => item.value.startsWith(tail.toLowerCase()));
+		return matches.length > 0 ? matches : null;
+	};
+
 	const description = "DeepSeek peak/off-peak panel · Панель DeepSeek peak/off-peak";
 	// `/dsp` is the short form; `deepseek-peek` accepts the spelling people reach
 	// for when they type "peak" wrong, so the command still resolves.
 	for (const name of ["deepseek-peak", "dsp", "deepseek-peek"]) {
-		pi.registerCommand(name, { description, handler: commandHandler });
+		pi.registerCommand(name, { description, handler: commandHandler, getArgumentCompletions });
 	}
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-deepseek-tariff",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "DeepSeek peak/off-peak tariff panel for pi: local clock, next window, live per-model prices and Search & Fetch rates",
   "keywords": [
     "pi-package",

package/src/i18n.ts

@@ -23,6 +23,8 @@ type Strings = {
 	nextIn: (duration: string) => string;
 	and: string;
 	prices: string;
+	/** The product name inside `prices`, rendered in the DeepSeek blue instead of the label token. */
+	pricesBrand: string;
 	pricesState: (state: string) => string;
 	activeModel: string;
 	peakWindows: (zone: string) => string;
@@ -34,6 +36,7 @@ type Strings = {
 	sourceBuiltin: string;
 	requestPricing: string;
 	commands: string;
+	/** Footer line — the state is always written in English (PEAK / OFF-PEAK), in every language. */
 	statusBrand: string;
 	statusPeak: string;
 	statusOffPeak: string;
@@ -53,6 +56,7 @@ export const STRINGS: Record<Lang, Strings> = {
 		nextIn: (duration) => `in ${duration}`,
 		and: "and",
 		prices: "DeepSeek prices:",
+		pricesBrand: "DeepSeek",
 		pricesState: (state) => `$ per 1M tokens, active: ${state}`,
 		activeModel: "← active",
 		peakWindows: (zone) => `Peak windows (${zone}):`,
@@ -64,10 +68,10 @@ export const STRINGS: Record<Lang, Strings> = {
 		sourceBuiltin: "built-in values (page unavailable)",
 		requestPricing: "Search & Fetch:",
 		commands: "Commands:",
-		statusBrand: "DeepSeek",
-		statusPeak: "Peak",
-		statusOffPeak: "Off-peak",
-		statusFor: (duration) => `for ${duration}`,
+		statusBrand: "deepseek",
+		statusPeak: "PEAK",
+		statusOffPeak: "OFF-PEAK",
+		statusFor: (duration) => `\u2192 ${duration}`,
 		locale: "en-GB",
 		hourUnit: "h",
 		minuteUnit: "m",
@@ -81,6 +85,7 @@ export const STRINGS: Record<Lang, Strings> = {
 		nextIn: (duration) => `через ${duration}`,
 		and: "и",
 		prices: "Цены DeepSeek:",
+		pricesBrand: "DeepSeek",
 		pricesState: (state) => `$ за 1M токенов, активен ${state}`,
 		activeModel: "← активна",
 		peakWindows: (zone) => `Окна peak (${zone}):`,
@@ -92,10 +97,10 @@ export const STRINGS: Record<Lang, Strings> = {
 		sourceBuiltin: "встроенные значения (страница недоступна)",
 		requestPricing: "Search & Fetch:",
 		commands: "Команды:",
-		statusBrand: "DeepSeek",
-		statusPeak: "Пиковый",
-		statusOffPeak: "Обычный",
-		statusFor: (duration) => `ещё ${duration}`,
+		statusBrand: "deepseek",
+		statusPeak: "PEAK",
+		statusOffPeak: "OFF-PEAK",
+		statusFor: (duration) => `\u2192 ${duration}`,
 		locale: "ru-RU",
 		hourUnit: "ч",
 		minuteUnit: "м",

package/src/view.ts

@@ -1,11 +1,14 @@
 /**
  * Presentation: the footer status line and the panel body.
  *
- * Colors follow the pi theme: labels in the warning token, values in the text
- * token, active rows bold, inactive rows dim.
+ * Colors follow the pi theme: the footer clock and the tariff word share the
+ * state token (green off-peak, red peak), the countdown uses the accent token,
+ * and only the brand keeps a fixed colour. The panel below the editor keeps the
+ * warning/text pairing.
  */
 
 import type { Theme } from "@earendil-works/pi-coding-agent";
+import { parseColor } from "@earendil-works/pi-tui";
 import type { Config } from "./config.ts";
 import { localizeUnit, STRINGS, type Lang } from "./i18n.ts";
 import type { Pricing, RequestPricing } from "./pricing.ts";
@@ -26,6 +29,12 @@ import {
 /** Placeholder for a full-width rule; the renderer expands it to the panel width. */
 export const SEPARATOR = "\u0000rule";
 
+/** Footer clock: one cell wide, so the segment stays short on the shared status line. */
+const CLOCK = "\u25F7"; // ◷
+
+/** DeepSeek brand blue. Fixed in every theme: it is the product colour, not a theme role. */
+const BRAND_BLUE = parseColor("#4175E6");
+
 /** "Search & Fetch" value: a shared price is printed once. */
 export function requestPricingText(entries: RequestPricing[], lang: Lang): string | undefined {
 	if (entries.length === 0) return undefined;
@@ -54,9 +63,12 @@ export function requestPricingText(entries: RequestPricing[], lang: Lang): strin
 }
 
 /**
- * Compact footer line: a coloured dot plus always-yellow text, for example
- * "● DeepSeek Off-peak for 11h 59m" or "● DeepSeek Peak for 1h 40m".
- * Only the dot changes colour, so the line reads calmly in both states.
+ * Compact footer line: a state-coloured clock, the brand name in DeepSeek blue,
+ * the tariff in English and the countdown in the theme accent — for example
+ * "◷ deepseek OFF-PEAK → 11h 59m" or "◷ deepseek PEAK → 1h 40m".
+ *
+ * The clock carries the state colour, so the line stays legible without a
+ * separate status dot; the duration keeps the panel language units.
  */
 export function statusText(theme: Theme, config: Config, lang: Lang, pricing: Pricing): string {
 	void pricing;
@@ -64,10 +76,25 @@ export function statusText(theme: Theme, config: Config, lang: Lang, pricing: Pr
 	const now = new Date();
 	const peak = isPeak(now, config.holidays);
 	const next = nextTransition(now, config.holidays);
-	const dot = theme.fg(peak ? "error" : "success", "●");
-	const label = peak ? text.statusPeak : text.statusOffPeak;
+	const state = peak ? "error" : "success";
 	const duration = humanize(next.getTime() - now.getTime(), lang);
-	return `${dot} ${theme.fg("warning", `${text.statusBrand} ${label} ${text.statusFor(duration)}`)}`;
+	const clock = theme.fg(state, CLOCK);
+	const brand = theme.style(text.statusBrand, { fg: BRAND_BLUE });
+	const label = theme.fg(state, peak ? text.statusPeak : text.statusOffPeak);
+	return `${clock} ${brand} ${label} ${theme.fg("accent", text.statusFor(duration))}`;
+}
+
+/**
+ * Colour the product name inside a panel label without splitting the string in
+ * i18n: the label stays one translatable line, only the brand word is swapped to
+ * the DeepSeek blue. Falls back to `rest(label)` when the name is missing.
+ */
+function brandLabel(theme: Theme, label: string, brand: string, rest: (value: string) => string): string {
+	const at = label.indexOf(brand);
+	if (at < 0) return rest(label);
+	const head = rest(label.slice(0, at));
+	const tail = rest(label.slice(at + brand.length));
+	return `${head}${theme.style(brand, { fg: BRAND_BLUE })}${tail}`;
 }
 
 export function panelLines(
@@ -111,7 +138,7 @@ export function panelLines(
 	);
 
 	// 4. Model prices with the active tariff highlighted.
-	lines.push(`${yellow(text.prices)} ${white(text.pricesState(state))}`);
+	lines.push(`${brandLabel(theme, text.prices, text.pricesBrand, yellow)} ${white(text.pricesState(state))}`);
 	const value = (amount: number) => amount.toFixed(4).padStart(8);
 	for (const [name, model] of Object.entries(pricing.models)) {
 		const id = `${config.providerPrefix}${name}`;