@linxiraos/pi-stats 1.4.0 → 1.4.2

package/dist/types/client/app/LanguageToggle.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Topbar language switch: EN ⇄ 中文. The label shows the language the click
+ * will install (the dashboard is already in the other one), and the choice is
+ * remembered in localStorage so a reload keeps it over the host's injected
+ * locale.
+ */
+export declare function LanguageToggle(): import("react").JSX.Element;

package/dist/types/client/i18n/index.d.ts

@@ -1,12 +1,20 @@
 import { type MessageKey } from "./messages/en.js";
 import type { StatsLocale, TranslationParams } from "./types.js";
-/** The locale the dashboard renders in. Fixed at boot; there is no in-page switcher. */
+/** The locale the dashboard renders in. */
 export declare function getLocale(): StatsLocale;
+/** Subscribe to runtime switches (the topbar toggle); returns the unsubscribe. */
+export declare function subscribeLocale(listener: () => void): () => void;
 /** Install a locale by tag (`zh`, `zh-CN`, `zh-Hans`; anything else is English). */
 export declare function setLocale(tag: string | undefined | null): StatsLocale;
 /**
- * The locale to boot with: the host's language when `zetacode stats` injected it,
- * then the browser's own preference, then English.
+ * The user's explicit pick from the topbar: install it, remember it, and
+ * re-render every subscriber.
+ */
+export declare function setUserLocale(tag: string): StatsLocale;
+/**
+ * The locale to boot with: an explicit topbar choice, then the host's language
+ * when `zetacode stats` injected it, then the browser's own preference, then
+ * English.
  */
 export declare function resolveInitialLocale(): StatsLocale;
 /**

package/dist/types/client/i18n/messages/common.d.ts

@@ -77,6 +77,8 @@ export declare const common: {
         readonly "shell.light-theme": "Light theme";
         readonly "shell.range-suffix": "range";
         readonly "shell.jump-hint": "then letter to jump";
+        readonly "shell.language": "Language";
+        readonly "shell.switch-language": "Switch dashboard language";
     };
     readonly "zh-CN": {
         readonly "common.provider": "服务商";
@@ -149,5 +151,7 @@ export declare const common: {
         readonly "shell.light-theme": "浅色主题";
         readonly "shell.range-suffix": "范围";
         readonly "shell.jump-hint": "再按字母跳转";
+        readonly "shell.language": "语言";
+        readonly "shell.switch-language": "切换仪表盘语言";
     };
 };

package/dist/types/client/i18n/messages/en.d.ts

@@ -88,6 +88,8 @@ export declare const enMessages: {
     readonly "shell.light-theme": "Light theme";
     readonly "shell.range-suffix": "range";
     readonly "shell.jump-hint": "then letter to jump";
+    readonly "shell.language": "Language";
+    readonly "shell.switch-language": "Switch dashboard language";
     readonly "overview.title": "Overview";
     readonly "overview.description": "Everything zeta did across your sessions in {window}.";
     readonly "overview.api-equivalent-cost": "API-equivalent cost";
@@ -753,6 +755,8 @@ export declare const enLocale: {
         readonly "shell.light-theme": "Light theme";
         readonly "shell.range-suffix": "range";
         readonly "shell.jump-hint": "then letter to jump";
+        readonly "shell.language": "Language";
+        readonly "shell.switch-language": "Switch dashboard language";
         readonly "overview.title": "Overview";
         readonly "overview.description": "Everything zeta did across your sessions in {window}.";
         readonly "overview.api-equivalent-cost": "API-equivalent cost";

package/dist/types/client/i18n/messages/zh-CN.d.ts

@@ -9,5 +9,5 @@ export declare const zhCNMessages: Partial<Record<MessageKey, string>>;
 /** The Simplified Chinese locale pack. */
 export declare const zhCNLocale: {
     readonly id: "zh-CN";
-    readonly messages: Partial<Record<"common.aborted" | "common.average" | "common.cache-read" | "common.cache-write" | "common.cancel" | "common.close" | "common.copied" | "common.copy" | "common.cost" | "common.duration" | "common.entry-id" | "common.error" | "common.error-rate" | "common.failed" | "common.filter" | "common.input" | "common.model" | "common.models" | "common.no-data-in-range" | "common.nothing-here-yet" | "common.other-n" | "common.output" | "common.output-message" | "common.output-tokens-per-second" | "common.pages" | "common.premium" | "common.premium-requests" | "common.project" | "common.provider" | "common.providers" | "common.range-1h" | "common.range-24h" | "common.range-30d" | "common.range-7d" | "common.range-90d" | "common.range-all" | "common.request" | "common.request-id" | "common.requests" | "common.root" | "common.session-entry" | "common.share" | "common.show-more" | "common.started" | "common.time-range" | "common.tokens" | "common.tokens-per-second" | "common.total" | "common.unknown" | "common.window-1h" | "common.window-24h" | "common.window-30d" | "common.window-7d" | "common.window-90d" | "common.window-all" | "costs.active-days-n" | "costs.active-days-one" | "costs.all-priced" | "costs.api-equivalent-estimate" | "costs.api-estimate-title" | "costs.average-per-day" | "costs.average-per-day-title" | "costs.by-component" | "costs.by-model" | "costs.by-model-description" | "costs.daily-by-component" | "costs.daily-by-model" | "costs.daily-estimate" | "costs.description" | "costs.empty-hint" | "costs.estimate" | "costs.estimate-by-component" | "costs.estimate-title" | "costs.no-priced-usage" | "costs.no-usage-in-range" | "costs.nothing-priced-yet" | "costs.per-priced-request" | "costs.per-priced-request-title" | "costs.per-request" | "costs.per-request-title" | "costs.priced-n" | "costs.requests-n" | "costs.split" | "costs.split-by" | "costs.split-title" | "costs.title" | "costs.top-model" | "costs.top-model-hint" | "costs.unpriced" | "costs.unpriced-column-title" | "costs.unpriced-hint" | "costs.unpriced-note-n" | "costs.unpriced-note-one" | "costs.unpriced-requests" | "costs.unpriced-title" | "costs.where-it-went" | "errors.affected-models" | "errors.by-model" | "errors.by-model-description" | "errors.cost-hint" | "errors.description" | "errors.empty-all-succeeded" | "errors.empty-no-affected-models" | "errors.empty-no-failures" | "errors.error-signatures" | "errors.failures" | "errors.filtered-of-total" | "errors.footer" | "errors.group-meta" | "errors.hint-in-window" | "errors.hint-latest-loaded" | "errors.last-failure" | "errors.last-seen" | "errors.load-latest" | "errors.loading" | "errors.loading-failures" | "errors.more-models" | "errors.no-match" | "errors.no-match-hint" | "errors.none-in-window" | "errors.open-latest" | "errors.search-placeholder" | "errors.signature" | "errors.signatures" | "errors.signatures-card-description" | "errors.signatures-hint" | "errors.signatures-top" | "errors.title" | "errors.unknown-error" | "errors.when" | "frustration.all-classes" | "frustration.all-judged" | "frustration.angry" | "frustration.angry-title" | "frustration.annoyed" | "frustration.annoyed-title" | "frustration.at-assistant" | "frustration.at-assistant-title" | "frustration.by-model" | "frustration.by-model-description" | "frustration.cancel-run" | "frustration.cancelled" | "frustration.cancelling" | "frustration.classify" | "frustration.column-judged" | "frustration.column-mean" | "frustration.column-messages" | "frustration.column-model-ids" | "frustration.column-session" | "frustration.column-tool-errors" | "frustration.column-turns" | "frustration.cost-so-far" | "frustration.coverage-hint" | "frustration.coverage-unscored" | "frustration.description" | "frustration.done" | "frustration.elapsed" | "frustration.estimate-note" | "frustration.estimated-cost" | "frustration.estimating" | "frustration.every-model-class" | "frustration.failed" | "frustration.failed-n" | "frustration.failed-suffix" | "frustration.hatch-title" | "frustration.hide-regex-title" | "frustration.in-flight" | "frustration.in-time" | "frustration.include-small" | "frustration.input-tokens" | "frustration.judge-coverage" | "frustration.judge-coverage-title" | "frustration.judge-description" | "frustration.judge-model" | "frustration.judge-panel" | "frustration.judge-running" | "frustration.judge-with" | "frustration.last-run-cancelled" | "frustration.last-run-done" | "frustration.last-run-failed" | "frustration.legend-angry" | "frustration.legend-annoyed-any" | "frustration.legend-assistant" | "frustration.legend-hatched" | "frustration.legend-hatched-run" | "frustration.legend-hue" | "frustration.legend-other" | "frustration.legend-trend" | "frustration.messages-n" | "frustration.messages-progress" | "frustration.model-breakdown" | "frustration.model-breakdown-title" | "frustration.model-by-model" | "frustration.model-by-model-description" | "frustration.model-class" | "frustration.model-hedge" | "frustration.model-hedge-title" | "frustration.model-hint-mean" | "frustration.model-legend-breakdown" | "frustration.model-mean" | "frustration.model-mean-title" | "frustration.model-no-turns" | "frustration.model-over-time" | "frustration.model-over-time-description" | "frustration.model-rambling" | "frustration.model-rambling-title" | "frustration.model-restatement" | "frustration.model-restatement-title" | "frustration.model-self-blame" | "frustration.model-self-blame-title" | "frustration.model-sessions" | "frustration.model-sessions-description" | "frustration.model-side-description" | "frustration.model-side-title" | "frustration.model-spiral" | "frustration.model-spiral-title" | "frustration.model-table-description" | "frustration.model-table-title" | "frustration.model-try-longer-range" | "frustration.model-turns" | "frustration.model-turns-title" | "frustration.model-unscored-line" | "frustration.model-versions" | "frustration.mostly-regex" | "frustration.no-messages" | "frustration.no-model-match" | "frustration.no-run-yet" | "frustration.not-run-yet" | "frustration.proceed" | "frustration.prose-chars" | "frustration.quote-title" | "frustration.regex-badge" | "frustration.regex-only" | "frustration.row-mostly-regex" | "frustration.run-cancelled-after" | "frustration.run-cancelled-line" | "frustration.run-done-line" | "frustration.run-failed-after" | "frustration.run-failed-line" | "frustration.run-judged" | "frustration.running" | "frustration.small-models-title" | "frustration.stack-relation" | "frustration.starting" | "frustration.table-description" | "frustration.title" | "frustration.try-longer-range" | "frustration.turns-n" | "frustration.unclassified" | "frustration.unjudged-messages" | "frustration.unknown-error" | "frustration.unscored-line" | "frustration.user-messages" | "frustration.user-messages-title" | "gain.all-projects" | "gain.by-source" | "gain.by-source-description" | "gain.cumulative" | "gain.description" | "gain.description-scoped" | "gain.empty-hint-all" | "gain.empty-hint-longer-range" | "gain.empty-title" | "gain.empty-title-scoped" | "gain.hits" | "gain.reduction" | "gain.reduction-title" | "gain.reduction-unknown" | "gain.saved-bytes" | "gain.saved-per-day" | "gain.saved-per-hit" | "gain.saved-tokens" | "gain.savings-over-time" | "gain.savings-over-time-description" | "gain.source" | "gain.title" | "models.across-providers" | "models.across-providers-one" | "models.all-models" | "models.api-cost" | "models.api-cost-title" | "models.avg-duration" | "models.avg-ttft" | "models.bucket-5m" | "models.bucket-day" | "models.bucket-hour" | "models.cache-rate" | "models.cache-savings" | "models.cache-title" | "models.cost-title" | "models.count-desc" | "models.efficiency" | "models.empty-hint" | "models.empty-title" | "models.errors" | "models.failed-n" | "models.first-last-seen" | "models.latency" | "models.most-used" | "models.most-used-hint" | "models.no-samples-hint" | "models.no-samples-title" | "models.performance-per-bucket" | "models.request-share" | "models.share-desc" | "models.share-mode-aria" | "models.subtitle" | "models.table-desc" | "models.tok-per-second" | "models.tokens-title" | "models.tps-title" | "models.trend" | "models.trend-title" | "models.ttft" | "models.ttft-title" | "models.uncached-input" | "models.unpriced-n" | "models.used" | "nav.activity" | "nav.breadcrumb-stats" | "nav.costs" | "nav.dashboard" | "nav.errors" | "nav.frustration" | "nav.gain" | "nav.insights" | "nav.models" | "nav.open-navigation" | "nav.overview" | "nav.pages" | "nav.projects" | "nav.providers" | "nav.requests" | "nav.tools" | "nav.traces" | "nav.usage" | "overview.activity" | "overview.advisor" | "overview.all-requests" | "overview.api-cost-title" | "overview.api-equivalent" | "overview.api-equivalent-cost" | "overview.avg-latency" | "overview.avg-ttft" | "overview.by-agent" | "overview.cache-rate" | "overview.cache-rate-title" | "overview.cache-saved" | "overview.conversation-tokens" | "overview.description" | "overview.failed-n" | "overview.latest-requests" | "overview.latest-requests-description" | "overview.main-agent" | "overview.ok" | "overview.output-n" | "overview.per-5m" | "overview.per-day" | "overview.per-hour" | "overview.requests-short" | "overview.status" | "overview.subagents" | "overview.succeeded" | "overview.succeeded-n" | "overview.title" | "overview.token-mix" | "overview.token-mix-description" | "overview.tokens-title" | "overview.uncached-input" | "overview.unpriced-n" | "overview.when" | "projects.api-equivalent-cost" | "projects.api-equivalent-cost-hint" | "projects.api-equivalent-cost-rates" | "projects.avg-duration" | "projects.cache-rate" | "projects.cache-rate-hint" | "projects.cache-rate-hint-all" | "projects.cache-savings" | "projects.cache-savings-hint" | "projects.conversation-tokens" | "projects.conversation-tokens-hint" | "projects.description" | "projects.empty-no-folders" | "projects.empty-no-match" | "projects.empty-only-temporary" | "projects.errors" | "projects.failed-n" | "projects.filter-placeholder" | "projects.folder" | "projects.folders" | "projects.folders-n" | "projects.folders-of-n" | "projects.hide-temporary" | "projects.hide-temporary-hint" | "projects.hint-longer-range" | "projects.hint-temporary-hidden" | "projects.last-active" | "projects.share-of-cost" | "projects.share-of-requests" | "projects.temp" | "projects.temporary-n" | "projects.title" | "projects.top-by-cost" | "projects.top-by-cost-description" | "projects.top-by-requests" | "projects.top-by-requests-description" | "projects.unpriced-n" | "providers.account" | "providers.accounts" | "providers.accounts-needed" | "providers.accounts-needed-title" | "providers.accounts-title" | "providers.all-providers" | "providers.api-cost-title" | "providers.api-equivalent-cost" | "providers.bucket-5m" | "providers.bucket-day" | "providers.bucket-hour" | "providers.burn" | "providers.burn-description" | "providers.burn-estimate-description" | "providers.cost-title" | "providers.description" | "providers.exhausted" | "providers.exhausted-n" | "providers.exhaustions" | "providers.exhaustions-title" | "providers.failed-n" | "providers.high" | "providers.hours-description" | "providers.ideal-accounts" | "providers.latest-used" | "providers.models-title" | "providers.most-tokens" | "providers.no-activity-in-range" | "providers.no-provider-activity" | "providers.no-reading" | "providers.no-requests-in-range" | "providers.no-snapshots-in-range" | "providers.no-utilization-readings" | "providers.peak-burn-hours" | "providers.peak-hours-description" | "providers.peak-in-range" | "providers.peak-utilization" | "providers.peak-utilization-title" | "providers.premium-title" | "providers.recorded" | "providers.resets" | "providers.resets-title" | "providers.share-title" | "providers.snapshot-hint" | "providers.snapshots" | "providers.status" | "providers.subscription-windows" | "providers.subscription-windows-description" | "providers.succeeded-n" | "providers.tokens-peak-hour" | "providers.tokens-per-window" | "providers.tokens-per-window-title" | "providers.tokens-title" | "providers.too-little-consumed" | "providers.totals" | "providers.totals-description" | "providers.totals-description-unpriced-n" | "providers.totals-description-unpriced-one" | "providers.tps-title" | "providers.unpriced-n" | "providers.utilization" | "providers.utilization-description" | "providers.utilization-description-plain" | "providers.window" | "providers.windows-burned" | "providers.windows-burned-title" | "requests.api-equivalent-cost" | "requests.cache-read-title" | "requests.cache-write" | "requests.cost-estimate" | "requests.cost-hint" | "requests.description" | "requests.empty-in-window" | "requests.empty-no-match" | "requests.empty-no-match-hint" | "requests.failed-hint" | "requests.footer" | "requests.load-latest" | "requests.loading" | "requests.log-count-in-window" | "requests.log-count-latest" | "requests.log-loading" | "requests.log-title" | "requests.median-duration" | "requests.median-ttft" | "requests.none-in-window" | "requests.p95" | "requests.search-placeholder" | "requests.since" | "requests.status" | "requests.status-all" | "requests.tokens-hint" | "requests.ttft" | "requests.ttft-hint" | "requests.uncached-input" | "requests.unpriced-n" | "requests.when" | "shell.building-rollups" | "shell.dark-theme" | "shell.indexing" | "shell.ingesting" | "shell.jump-hint" | "shell.just-now" | "shell.light-theme" | "shell.live" | "shell.lost-connection" | "shell.range-suffix" | "shell.reconnecting" | "shell.sync-failed" | "shell.sync-now" | "shell.syncing" | "shell.system-theme" | "tools.all-tools" | "tools.api-equivalent" | "tools.args" | "tools.args-chars-title" | "tools.attr-cost" | "tools.attr-tokens" | "tools.attributed-cost" | "tools.attributed-tokens" | "tools.attribution-estimate" | "tools.attribution-note" | "tools.avg-args-per-call" | "tools.avg-result-per-call" | "tools.bucket-5m" | "tools.bucket-day" | "tools.bucket-hour" | "tools.by-tool" | "tools.by-tool-and-model" | "tools.by-tool-and-model-description" | "tools.by-tool-description" | "tools.call-arguments" | "tools.calls" | "tools.calls-over-time" | "tools.chars" | "tools.chart-description" | "tools.clear-tool-filter" | "tools.description" | "tools.distinct-tools" | "tools.error-rate-title" | "tools.errors" | "tools.errors-over-time" | "tools.errors-title" | "tools.failed-n" | "tools.filter-by-tool" | "tools.last-used" | "tools.most-used" | "tools.no-calls-to-tool" | "tools.no-tool-calls" | "tools.no-tool-errors" | "tools.result" | "tools.result-chars-title" | "tools.result-per-call" | "tools.result-per-call-title" | "tools.result-text" | "tools.share-of-calls" | "tools.share-of-cost" | "tools.share-of-tokens" | "tools.succeeded-n" | "tools.title" | "tools.tokens-output" | "tools.tool" | "tools.tool-calls" | "tools.trend" | "tools.trend-title" | "tools.unpriced-requests-n" | "trace.agent" | "trace.agents" | "trace.args" | "trace.avg" | "trace.axis-mode" | "trace.background" | "trace.bg" | "trace.calls" | "trace.canvas-aria" | "trace.collapse-all" | "trace.collapse-track" | "trace.compress-idle" | "trace.copy-json" | "trace.description" | "trace.empty-hint" | "trace.empty-title" | "trace.error-message" | "trace.errors" | "trace.expand-all" | "trace.expand-track" | "trace.failed-n" | "trace.filter-placeholder" | "trace.idle" | "trace.io-cached" | "trace.load-failed" | "trace.max" | "trace.minimap-aria" | "trace.mode-calls-title" | "trace.mode-time-title" | "trace.mode-turns-title" | "trace.model-time" | "trace.most-recent" | "trace.most-recent-filtered" | "trace.next-match" | "trace.no-matching-events" | "trace.no-matching-hint" | "trace.no-matching-title" | "trace.of-wall" | "trace.open-child-track" | "trace.previous-match" | "trace.raw-entry" | "trace.refresh" | "trace.search-placeholder" | "trace.session" | "trace.sessions" | "trace.start" | "trace.stop-reason" | "trace.task" | "trace.text" | "trace.thinking" | "trace.timeline" | "trace.timeline-hint" | "trace.title" | "trace.tok" | "trace.tool" | "trace.tool-aggregates" | "trace.tool-aggregates-desc" | "trace.tool-calls-n" | "trace.tool-time" | "trace.tools" | "trace.track" | "trace.transcript" | "trace.transcript-description" | "trace.ttft" | "trace.turns" | "trace.unterminated" | "trace.wall-time" | "ui.api" | "ui.delta-new" | "ui.json" | "ui.open-trace" | "ui.retry" | "ui.section-cost" | "ui.section-identity" | "ui.section-timing" | "ui.session-file" | "ui.show-fewer" | "ui.stats-row" | "ui.status-ok" | "ui.stop-reason" | "ui.table-shown-of" | "ui.time-to-first-token" | "ui.trace" | "ui.uncached-input", string>>;
+    readonly messages: Partial<Record<"common.aborted" | "common.average" | "common.cache-read" | "common.cache-write" | "common.cancel" | "common.close" | "common.copied" | "common.copy" | "common.cost" | "common.duration" | "common.entry-id" | "common.error" | "common.error-rate" | "common.failed" | "common.filter" | "common.input" | "common.model" | "common.models" | "common.no-data-in-range" | "common.nothing-here-yet" | "common.other-n" | "common.output" | "common.output-message" | "common.output-tokens-per-second" | "common.pages" | "common.premium" | "common.premium-requests" | "common.project" | "common.provider" | "common.providers" | "common.range-1h" | "common.range-24h" | "common.range-30d" | "common.range-7d" | "common.range-90d" | "common.range-all" | "common.request" | "common.request-id" | "common.requests" | "common.root" | "common.session-entry" | "common.share" | "common.show-more" | "common.started" | "common.time-range" | "common.tokens" | "common.tokens-per-second" | "common.total" | "common.unknown" | "common.window-1h" | "common.window-24h" | "common.window-30d" | "common.window-7d" | "common.window-90d" | "common.window-all" | "costs.active-days-n" | "costs.active-days-one" | "costs.all-priced" | "costs.api-equivalent-estimate" | "costs.api-estimate-title" | "costs.average-per-day" | "costs.average-per-day-title" | "costs.by-component" | "costs.by-model" | "costs.by-model-description" | "costs.daily-by-component" | "costs.daily-by-model" | "costs.daily-estimate" | "costs.description" | "costs.empty-hint" | "costs.estimate" | "costs.estimate-by-component" | "costs.estimate-title" | "costs.no-priced-usage" | "costs.no-usage-in-range" | "costs.nothing-priced-yet" | "costs.per-priced-request" | "costs.per-priced-request-title" | "costs.per-request" | "costs.per-request-title" | "costs.priced-n" | "costs.requests-n" | "costs.split" | "costs.split-by" | "costs.split-title" | "costs.title" | "costs.top-model" | "costs.top-model-hint" | "costs.unpriced" | "costs.unpriced-column-title" | "costs.unpriced-hint" | "costs.unpriced-note-n" | "costs.unpriced-note-one" | "costs.unpriced-requests" | "costs.unpriced-title" | "costs.where-it-went" | "errors.affected-models" | "errors.by-model" | "errors.by-model-description" | "errors.cost-hint" | "errors.description" | "errors.empty-all-succeeded" | "errors.empty-no-affected-models" | "errors.empty-no-failures" | "errors.error-signatures" | "errors.failures" | "errors.filtered-of-total" | "errors.footer" | "errors.group-meta" | "errors.hint-in-window" | "errors.hint-latest-loaded" | "errors.last-failure" | "errors.last-seen" | "errors.load-latest" | "errors.loading" | "errors.loading-failures" | "errors.more-models" | "errors.no-match" | "errors.no-match-hint" | "errors.none-in-window" | "errors.open-latest" | "errors.search-placeholder" | "errors.signature" | "errors.signatures" | "errors.signatures-card-description" | "errors.signatures-hint" | "errors.signatures-top" | "errors.title" | "errors.unknown-error" | "errors.when" | "frustration.all-classes" | "frustration.all-judged" | "frustration.angry" | "frustration.angry-title" | "frustration.annoyed" | "frustration.annoyed-title" | "frustration.at-assistant" | "frustration.at-assistant-title" | "frustration.by-model" | "frustration.by-model-description" | "frustration.cancel-run" | "frustration.cancelled" | "frustration.cancelling" | "frustration.classify" | "frustration.column-judged" | "frustration.column-mean" | "frustration.column-messages" | "frustration.column-model-ids" | "frustration.column-session" | "frustration.column-tool-errors" | "frustration.column-turns" | "frustration.cost-so-far" | "frustration.coverage-hint" | "frustration.coverage-unscored" | "frustration.description" | "frustration.done" | "frustration.elapsed" | "frustration.estimate-note" | "frustration.estimated-cost" | "frustration.estimating" | "frustration.every-model-class" | "frustration.failed" | "frustration.failed-n" | "frustration.failed-suffix" | "frustration.hatch-title" | "frustration.hide-regex-title" | "frustration.in-flight" | "frustration.in-time" | "frustration.include-small" | "frustration.input-tokens" | "frustration.judge-coverage" | "frustration.judge-coverage-title" | "frustration.judge-description" | "frustration.judge-model" | "frustration.judge-panel" | "frustration.judge-running" | "frustration.judge-with" | "frustration.last-run-cancelled" | "frustration.last-run-done" | "frustration.last-run-failed" | "frustration.legend-angry" | "frustration.legend-annoyed-any" | "frustration.legend-assistant" | "frustration.legend-hatched" | "frustration.legend-hatched-run" | "frustration.legend-hue" | "frustration.legend-other" | "frustration.legend-trend" | "frustration.messages-n" | "frustration.messages-progress" | "frustration.model-breakdown" | "frustration.model-breakdown-title" | "frustration.model-by-model" | "frustration.model-by-model-description" | "frustration.model-class" | "frustration.model-hedge" | "frustration.model-hedge-title" | "frustration.model-hint-mean" | "frustration.model-legend-breakdown" | "frustration.model-mean" | "frustration.model-mean-title" | "frustration.model-no-turns" | "frustration.model-over-time" | "frustration.model-over-time-description" | "frustration.model-rambling" | "frustration.model-rambling-title" | "frustration.model-restatement" | "frustration.model-restatement-title" | "frustration.model-self-blame" | "frustration.model-self-blame-title" | "frustration.model-sessions" | "frustration.model-sessions-description" | "frustration.model-side-description" | "frustration.model-side-title" | "frustration.model-spiral" | "frustration.model-spiral-title" | "frustration.model-table-description" | "frustration.model-table-title" | "frustration.model-try-longer-range" | "frustration.model-turns" | "frustration.model-turns-title" | "frustration.model-unscored-line" | "frustration.model-versions" | "frustration.mostly-regex" | "frustration.no-messages" | "frustration.no-model-match" | "frustration.no-run-yet" | "frustration.not-run-yet" | "frustration.proceed" | "frustration.prose-chars" | "frustration.quote-title" | "frustration.regex-badge" | "frustration.regex-only" | "frustration.row-mostly-regex" | "frustration.run-cancelled-after" | "frustration.run-cancelled-line" | "frustration.run-done-line" | "frustration.run-failed-after" | "frustration.run-failed-line" | "frustration.run-judged" | "frustration.running" | "frustration.small-models-title" | "frustration.stack-relation" | "frustration.starting" | "frustration.table-description" | "frustration.title" | "frustration.try-longer-range" | "frustration.turns-n" | "frustration.unclassified" | "frustration.unjudged-messages" | "frustration.unknown-error" | "frustration.unscored-line" | "frustration.user-messages" | "frustration.user-messages-title" | "gain.all-projects" | "gain.by-source" | "gain.by-source-description" | "gain.cumulative" | "gain.description" | "gain.description-scoped" | "gain.empty-hint-all" | "gain.empty-hint-longer-range" | "gain.empty-title" | "gain.empty-title-scoped" | "gain.hits" | "gain.reduction" | "gain.reduction-title" | "gain.reduction-unknown" | "gain.saved-bytes" | "gain.saved-per-day" | "gain.saved-per-hit" | "gain.saved-tokens" | "gain.savings-over-time" | "gain.savings-over-time-description" | "gain.source" | "gain.title" | "models.across-providers" | "models.across-providers-one" | "models.all-models" | "models.api-cost" | "models.api-cost-title" | "models.avg-duration" | "models.avg-ttft" | "models.bucket-5m" | "models.bucket-day" | "models.bucket-hour" | "models.cache-rate" | "models.cache-savings" | "models.cache-title" | "models.cost-title" | "models.count-desc" | "models.efficiency" | "models.empty-hint" | "models.empty-title" | "models.errors" | "models.failed-n" | "models.first-last-seen" | "models.latency" | "models.most-used" | "models.most-used-hint" | "models.no-samples-hint" | "models.no-samples-title" | "models.performance-per-bucket" | "models.request-share" | "models.share-desc" | "models.share-mode-aria" | "models.subtitle" | "models.table-desc" | "models.tok-per-second" | "models.tokens-title" | "models.tps-title" | "models.trend" | "models.trend-title" | "models.ttft" | "models.ttft-title" | "models.uncached-input" | "models.unpriced-n" | "models.used" | "nav.activity" | "nav.breadcrumb-stats" | "nav.costs" | "nav.dashboard" | "nav.errors" | "nav.frustration" | "nav.gain" | "nav.insights" | "nav.models" | "nav.open-navigation" | "nav.overview" | "nav.pages" | "nav.projects" | "nav.providers" | "nav.requests" | "nav.tools" | "nav.traces" | "nav.usage" | "overview.activity" | "overview.advisor" | "overview.all-requests" | "overview.api-cost-title" | "overview.api-equivalent" | "overview.api-equivalent-cost" | "overview.avg-latency" | "overview.avg-ttft" | "overview.by-agent" | "overview.cache-rate" | "overview.cache-rate-title" | "overview.cache-saved" | "overview.conversation-tokens" | "overview.description" | "overview.failed-n" | "overview.latest-requests" | "overview.latest-requests-description" | "overview.main-agent" | "overview.ok" | "overview.output-n" | "overview.per-5m" | "overview.per-day" | "overview.per-hour" | "overview.requests-short" | "overview.status" | "overview.subagents" | "overview.succeeded" | "overview.succeeded-n" | "overview.title" | "overview.token-mix" | "overview.token-mix-description" | "overview.tokens-title" | "overview.uncached-input" | "overview.unpriced-n" | "overview.when" | "projects.api-equivalent-cost" | "projects.api-equivalent-cost-hint" | "projects.api-equivalent-cost-rates" | "projects.avg-duration" | "projects.cache-rate" | "projects.cache-rate-hint" | "projects.cache-rate-hint-all" | "projects.cache-savings" | "projects.cache-savings-hint" | "projects.conversation-tokens" | "projects.conversation-tokens-hint" | "projects.description" | "projects.empty-no-folders" | "projects.empty-no-match" | "projects.empty-only-temporary" | "projects.errors" | "projects.failed-n" | "projects.filter-placeholder" | "projects.folder" | "projects.folders" | "projects.folders-n" | "projects.folders-of-n" | "projects.hide-temporary" | "projects.hide-temporary-hint" | "projects.hint-longer-range" | "projects.hint-temporary-hidden" | "projects.last-active" | "projects.share-of-cost" | "projects.share-of-requests" | "projects.temp" | "projects.temporary-n" | "projects.title" | "projects.top-by-cost" | "projects.top-by-cost-description" | "projects.top-by-requests" | "projects.top-by-requests-description" | "projects.unpriced-n" | "providers.account" | "providers.accounts" | "providers.accounts-needed" | "providers.accounts-needed-title" | "providers.accounts-title" | "providers.all-providers" | "providers.api-cost-title" | "providers.api-equivalent-cost" | "providers.bucket-5m" | "providers.bucket-day" | "providers.bucket-hour" | "providers.burn" | "providers.burn-description" | "providers.burn-estimate-description" | "providers.cost-title" | "providers.description" | "providers.exhausted" | "providers.exhausted-n" | "providers.exhaustions" | "providers.exhaustions-title" | "providers.failed-n" | "providers.high" | "providers.hours-description" | "providers.ideal-accounts" | "providers.latest-used" | "providers.models-title" | "providers.most-tokens" | "providers.no-activity-in-range" | "providers.no-provider-activity" | "providers.no-reading" | "providers.no-requests-in-range" | "providers.no-snapshots-in-range" | "providers.no-utilization-readings" | "providers.peak-burn-hours" | "providers.peak-hours-description" | "providers.peak-in-range" | "providers.peak-utilization" | "providers.peak-utilization-title" | "providers.premium-title" | "providers.recorded" | "providers.resets" | "providers.resets-title" | "providers.share-title" | "providers.snapshot-hint" | "providers.snapshots" | "providers.status" | "providers.subscription-windows" | "providers.subscription-windows-description" | "providers.succeeded-n" | "providers.tokens-peak-hour" | "providers.tokens-per-window" | "providers.tokens-per-window-title" | "providers.tokens-title" | "providers.too-little-consumed" | "providers.totals" | "providers.totals-description" | "providers.totals-description-unpriced-n" | "providers.totals-description-unpriced-one" | "providers.tps-title" | "providers.unpriced-n" | "providers.utilization" | "providers.utilization-description" | "providers.utilization-description-plain" | "providers.window" | "providers.windows-burned" | "providers.windows-burned-title" | "requests.api-equivalent-cost" | "requests.cache-read-title" | "requests.cache-write" | "requests.cost-estimate" | "requests.cost-hint" | "requests.description" | "requests.empty-in-window" | "requests.empty-no-match" | "requests.empty-no-match-hint" | "requests.failed-hint" | "requests.footer" | "requests.load-latest" | "requests.loading" | "requests.log-count-in-window" | "requests.log-count-latest" | "requests.log-loading" | "requests.log-title" | "requests.median-duration" | "requests.median-ttft" | "requests.none-in-window" | "requests.p95" | "requests.search-placeholder" | "requests.since" | "requests.status" | "requests.status-all" | "requests.tokens-hint" | "requests.ttft" | "requests.ttft-hint" | "requests.uncached-input" | "requests.unpriced-n" | "requests.when" | "shell.building-rollups" | "shell.dark-theme" | "shell.indexing" | "shell.ingesting" | "shell.jump-hint" | "shell.just-now" | "shell.language" | "shell.light-theme" | "shell.live" | "shell.lost-connection" | "shell.range-suffix" | "shell.reconnecting" | "shell.switch-language" | "shell.sync-failed" | "shell.sync-now" | "shell.syncing" | "shell.system-theme" | "tools.all-tools" | "tools.api-equivalent" | "tools.args" | "tools.args-chars-title" | "tools.attr-cost" | "tools.attr-tokens" | "tools.attributed-cost" | "tools.attributed-tokens" | "tools.attribution-estimate" | "tools.attribution-note" | "tools.avg-args-per-call" | "tools.avg-result-per-call" | "tools.bucket-5m" | "tools.bucket-day" | "tools.bucket-hour" | "tools.by-tool" | "tools.by-tool-and-model" | "tools.by-tool-and-model-description" | "tools.by-tool-description" | "tools.call-arguments" | "tools.calls" | "tools.calls-over-time" | "tools.chars" | "tools.chart-description" | "tools.clear-tool-filter" | "tools.description" | "tools.distinct-tools" | "tools.error-rate-title" | "tools.errors" | "tools.errors-over-time" | "tools.errors-title" | "tools.failed-n" | "tools.filter-by-tool" | "tools.last-used" | "tools.most-used" | "tools.no-calls-to-tool" | "tools.no-tool-calls" | "tools.no-tool-errors" | "tools.result" | "tools.result-chars-title" | "tools.result-per-call" | "tools.result-per-call-title" | "tools.result-text" | "tools.share-of-calls" | "tools.share-of-cost" | "tools.share-of-tokens" | "tools.succeeded-n" | "tools.title" | "tools.tokens-output" | "tools.tool" | "tools.tool-calls" | "tools.trend" | "tools.trend-title" | "tools.unpriced-requests-n" | "trace.agent" | "trace.agents" | "trace.args" | "trace.avg" | "trace.axis-mode" | "trace.background" | "trace.bg" | "trace.calls" | "trace.canvas-aria" | "trace.collapse-all" | "trace.collapse-track" | "trace.compress-idle" | "trace.copy-json" | "trace.description" | "trace.empty-hint" | "trace.empty-title" | "trace.error-message" | "trace.errors" | "trace.expand-all" | "trace.expand-track" | "trace.failed-n" | "trace.filter-placeholder" | "trace.idle" | "trace.io-cached" | "trace.load-failed" | "trace.max" | "trace.minimap-aria" | "trace.mode-calls-title" | "trace.mode-time-title" | "trace.mode-turns-title" | "trace.model-time" | "trace.most-recent" | "trace.most-recent-filtered" | "trace.next-match" | "trace.no-matching-events" | "trace.no-matching-hint" | "trace.no-matching-title" | "trace.of-wall" | "trace.open-child-track" | "trace.previous-match" | "trace.raw-entry" | "trace.refresh" | "trace.search-placeholder" | "trace.session" | "trace.sessions" | "trace.start" | "trace.stop-reason" | "trace.task" | "trace.text" | "trace.thinking" | "trace.timeline" | "trace.timeline-hint" | "trace.title" | "trace.tok" | "trace.tool" | "trace.tool-aggregates" | "trace.tool-aggregates-desc" | "trace.tool-calls-n" | "trace.tool-time" | "trace.tools" | "trace.track" | "trace.transcript" | "trace.transcript-description" | "trace.ttft" | "trace.turns" | "trace.unterminated" | "trace.wall-time" | "ui.api" | "ui.delta-new" | "ui.json" | "ui.open-trace" | "ui.retry" | "ui.section-cost" | "ui.section-identity" | "ui.section-timing" | "ui.session-file" | "ui.show-fewer" | "ui.stats-row" | "ui.status-ok" | "ui.stop-reason" | "ui.table-shown-of" | "ui.time-to-first-token" | "ui.trace" | "ui.uncached-input", string>>;
 };

package/dist/types/client/i18n/useLocale.d.ts

@@ -0,0 +1,7 @@
+import { type StatsLocale } from "./index.js";
+/**
+ * Subscribe a component to the active locale. `t()` reads the module-level
+ * catalogue, so a component that renders translated copy must call this —
+ * the topbar switch re-renders subscribers, and everything under them.
+ */
+export declare function useLocale(): StatsLocale;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@linxiraos/pi-stats",
-	"version": "1.4.0",
+	"version": "1.4.2",
 	"description": "Local observability dashboard for omp AI usage statistics",
 	"homepage": "https://linxira-os.github.io/zeta/",
 	"author": "Linxira-OS",
@@ -39,9 +39,9 @@
 		"fmt": "oxfmt --no-error-on-unmatched-pattern 'src/**/*.{ts,tsx}' '{test,bench,examples,scripts}/**/*.ts' '*.ts'"
 	},
 	"dependencies": {
-		"@linxiraos/pi-ai": "1.4.0",
-		"@linxiraos/pi-catalog": "1.4.0",
-		"@linxiraos/pi-utils": "1.4.0",
+		"@linxiraos/pi-ai": "1.4.2",
+		"@linxiraos/pi-catalog": "1.4.2",
+		"@linxiraos/pi-utils": "1.4.2",
 		"lucide-react": "^1.24.0",
 		"react": "19.2.7",
 		"react-dom": "19.2.7"

package/src/client/App.tsx

@@ -1,6 +1,7 @@
 import { useCallback, useRef, useState } from "react";
 import type { DashboardSection } from "./app/nav";
 import { Shell } from "./app/Shell";
+import { useLocale } from "./i18n/useLocale";
 import { LiveProvider } from "./data/live";
 import { useHashRoute } from "./data/useHashRoute";
 import {
@@ -27,6 +28,9 @@ export default function App() {
 }
 
 function Dashboard() {
+	// A topbar language switch re-renders the whole tree: translated copy is
+	// read through `t()` at render time, including the mounted-but-hidden pages.
+	useLocale();
 	const { section, setSection, range, setRange, session, setSession } = useHashRoute();
 	const [selectedRequestId, setSelectedRequestId] = useState<number | null>(null);
 	// Stable identity so the drawer's effects don't tear down on every render.

package/src/client/app/LanguageToggle.tsx

@@ -0,0 +1,30 @@
+import { Languages } from "lucide-react";
+import { setUserLocale, t } from "../i18n";
+import { useLocale } from "../i18n/useLocale";
+
+/**
+ * Topbar language switch: EN ⇄ 中文. The label shows the language the click
+ * will install (the dashboard is already in the other one), and the choice is
+ * remembered in localStorage so a reload keeps it over the host's injected
+ * locale.
+ */
+export function LanguageToggle() {
+	const locale = useLocale();
+	const next = locale === "en" ? "zh-CN" : "en";
+	const label = locale === "en" ? "中文" : "EN";
+
+	return (
+		<button
+			type="button"
+			className="btn"
+			data-variant="ghost"
+			data-locale-toggle={locale}
+			onClick={() => setUserLocale(next)}
+			aria-label={t("shell.switch-language")}
+			title={`${t("shell.language")}: ${label}`}
+		>
+			<Languages size={15} />
+			<span className="topbar-locale-label">{label}</span>
+		</button>
+	);
+}

package/src/client/app/Shell.tsx

@@ -2,9 +2,11 @@ import { Menu } from "lucide-react";
 import { type ReactNode, useEffect, useState } from "react";
 import { rangeMeta, TIME_RANGES } from "../data/range";
 import { t } from "../i18n";
+import { useLocale } from "../i18n/useLocale";
 import { useLiveStatus } from "../data/live";
 import type { TimeRange } from "../types";
 import { Segmented } from "../ui";
+import { LanguageToggle } from "./LanguageToggle";
 import { LiveChip } from "./LiveChip";
 import { type DashboardSection, NAV } from "./nav";
 import { ThemeToggle } from "./ThemeToggle";
@@ -17,18 +19,20 @@ export interface ShellProps {
 	children: ReactNode;
 }
 
-const RANGE_OPTIONS = TIME_RANGES.map((range, i) => ({
-	value: range,
-	label: t(rangeMeta(range).labelKey),
-	title: `${t(rangeMeta(range).windowKey)} (${i + 1})`,
-}));
-
 /**
  * Fixed glass topbar + naked sidebar framing one inset content panel. Owns
  * the global keyboard shortcuts: `1`–`6` pick a range, `g` then a letter jumps
  * to a page.
  */
 export function Shell({ section, onSectionChange, range, onRangeChange, children }: ShellProps) {
+	// Range labels are translated copy, so they are rebuilt on a locale switch
+	// instead of being frozen in a module-level table.
+	useLocale();
+	const rangeOptions = TIME_RANGES.map((range, i) => ({
+		value: range,
+		label: t(rangeMeta(range).labelKey),
+		title: `${t(rangeMeta(range).windowKey)} (${i + 1})`,
+	}));
 	const [menuOpen, setMenuOpen] = useState(false);
 	const scrolled = useScrolled();
 	const { sync } = useLiveStatus();
@@ -87,11 +91,12 @@ export function Shell({ section, onSectionChange, range, onRangeChange, children
 						<LiveChip />
 					</span>
 					<Segmented
-						options={RANGE_OPTIONS}
+						options={rangeOptions}
 						value={range}
 						onChange={onRangeChange}
 						aria-label={t("common.time-range")}
 					/>
+					<LanguageToggle />
 					<ThemeToggle />
 				</div>
 				{progress !== undefined && (

package/src/client/app/ThemeToggle.tsx

@@ -1,6 +1,7 @@
 import { type LucideIcon, Monitor, Moon, Sun } from "lucide-react";
 import { type ThemePreference, useThemePreference } from "../useSystemTheme";
 import { t } from "../i18n";
+import { useLocale } from "../i18n/useLocale";
 
 const NEXT_PREFERENCE: Record<ThemePreference, ThemePreference> = {
 	system: "light",
@@ -8,22 +9,24 @@ const NEXT_PREFERENCE: Record<ThemePreference, ThemePreference> = {
 	dark: "system",
 };
 
+const PREFERENCE_LABEL_KEY = {
+	system: "shell.system-theme",
+	light: "shell.light-theme",
+	dark: "shell.dark-theme",
+} as const;
+
 const PREFERENCE_ICON: Record<ThemePreference, LucideIcon> = {
 	system: Monitor,
 	light: Sun,
 	dark: Moon,
 };
 
-const PREFERENCE_LABEL: Record<ThemePreference, string> = {
-	system: t("shell.system-theme"),
-	light: t("shell.light-theme"),
-	dark: t("shell.dark-theme"),
-};
-
 /** Cycles system → light → dark. */
 export function ThemeToggle() {
+	useLocale();
 	const { preference, setPreference } = useThemePreference();
 	const Icon = PREFERENCE_ICON[preference];
+	const label = t(PREFERENCE_LABEL_KEY[preference]);
 
 	return (
 		<button
@@ -32,8 +35,8 @@ export function ThemeToggle() {
 			data-variant="ghost"
 			data-icon="true"
 			onClick={() => setPreference(NEXT_PREFERENCE[preference])}
-			aria-label={`${PREFERENCE_LABEL[preference]} (click to switch)`}
-			title={`${PREFERENCE_LABEL[preference]} — click to switch`}
+			aria-label={`${label} (click to switch)`}
+			title={`${label} — click to switch`}
 		>
 			<Icon size={15} />
 		</button>

package/src/client/i18n/index.ts

@@ -11,19 +11,32 @@ function injectedLocale(): string | undefined {
 
 const messages: MessagesByLocale = { en: enLocale.messages, "zh-CN": zhCNLocale.messages };
 
+/** Local override written by the in-page switcher; survives reloads. */
+const LOCALE_STORAGE_KEY = "zeta.stats.locale";
+
+const localeListeners = new Set<() => void>();
+
 let activeLocale: StatsLocale = "en";
 
 // Resolve once at module load. Every `t()` caller imports this module first, so
-// the host language the server injected into `<head>` (or the browser's own
-// preference) is already in effect by the time a component module is evaluated
-// — including module-level label tables such as the range selector's.
+// the stored choice, the host language the server injected into `<head>`, or
+// the browser's own preference is already in effect by the time a component
+// module is evaluated.
 resolveInitialLocale();
 
-/** The locale the dashboard renders in. Fixed at boot; there is no in-page switcher. */
+/** The locale the dashboard renders in. */
 export function getLocale(): StatsLocale {
 	return activeLocale;
 }
 
+/** Subscribe to runtime switches (the topbar toggle); returns the unsubscribe. */
+export function subscribeLocale(listener: () => void): () => void {
+	localeListeners.add(listener);
+	return () => {
+		localeListeners.delete(listener);
+	};
+}
+
 /** Install a locale by tag (`zh`, `zh-CN`, `zh-Hans`; anything else is English). */
 export function setLocale(tag: string | undefined | null): StatsLocale {
 	activeLocale = resolveLocaleTag(tag);
@@ -31,10 +44,40 @@ export function setLocale(tag: string | undefined | null): StatsLocale {
 }
 
 /**
- * The locale to boot with: the host's language when `zetacode stats` injected it,
- * then the browser's own preference, then English.
+ * The user's explicit pick from the topbar: install it, remember it, and
+ * re-render every subscriber.
+ */
+export function setUserLocale(tag: string): StatsLocale {
+	const next = setLocale(tag);
+	try {
+		globalThis.localStorage?.setItem(LOCALE_STORAGE_KEY, next);
+	} catch {
+		// Private-mode storage denial only costs the choice at next reload.
+	}
+	for (const listener of [...localeListeners]) listener();
+	return next;
+}
+
+/** A stored topbar choice, when it still parses as a supported locale. */
+function storedLocale(): StatsLocale | undefined {
+	try {
+		const raw = globalThis.localStorage?.getItem(LOCALE_STORAGE_KEY);
+		if (!raw) return undefined;
+		const resolved = resolveLocaleTag(raw);
+		return resolved === "en" || resolved === "zh-CN" ? resolved : undefined;
+	} catch {
+		return undefined;
+	}
+}
+
+/**
+ * The locale to boot with: an explicit topbar choice, then the host's language
+ * when `zetacode stats` injected it, then the browser's own preference, then
+ * English.
  */
 export function resolveInitialLocale(): StatsLocale {
+	const stored = storedLocale();
+	if (stored) return setLocale(stored);
 	const injected = injectedLocale();
 	if (injected) return setLocale(injected);
 	if (typeof navigator === "undefined") return "en";

package/src/client/i18n/messages/common.ts

@@ -81,6 +81,8 @@ export const common = {
 		"shell.light-theme": "Light theme",
 		"shell.range-suffix": "range",
 		"shell.jump-hint": "then letter to jump",
+		"shell.language": "Language",
+		"shell.switch-language": "Switch dashboard language",
 	},
 	"zh-CN": {
 		"common.provider": "服务商",
@@ -153,5 +155,7 @@ export const common = {
 		"shell.light-theme": "浅色主题",
 		"shell.range-suffix": "范围",
 		"shell.jump-hint": "再按字母跳转",
+		"shell.language": "语言",
+		"shell.switch-language": "切换仪表盘语言",
 	},
 } as const;

package/src/client/i18n/useLocale.ts

@@ -0,0 +1,11 @@
+import { useSyncExternalStore } from "react";
+import { getLocale, subscribeLocale, type StatsLocale } from "./index";
+
+/**
+ * Subscribe a component to the active locale. `t()` reads the module-level
+ * catalogue, so a component that renders translated copy must call this —
+ * the topbar switch re-renders subscribers, and everything under them.
+ */
+export function useLocale(): StatsLocale {
+	return useSyncExternalStore(subscribeLocale, getLocale, getLocale);
+}

package/src/client/routes/ProvidersRoute.tsx

@@ -68,8 +68,6 @@ const TOKEN_MIX = [
 	{ key: "output", label: t("common.output"), color: "var(--chart-secondary)" },
 ] as const;
 
-const SNAPSHOT_HINT = t("providers.snapshot-hint");
-
 interface WindowRef {
 	provider: string;
 	windowKey: string;
@@ -608,7 +606,7 @@ function WindowInsightsTable({
 			limit={12}
 			selectedKey={selected ? `${selected.provider}::${selected.windowKey}` : null}
 			onRowClick={i => onSelect({ provider: i.provider, windowKey: i.windowKey })}
-			empty={<EmptyState title={t("providers.no-snapshots-in-range")} hint={SNAPSHOT_HINT} />}
+			empty={<EmptyState title={t("providers.no-snapshots-in-range")} hint={t("providers.snapshot-hint")} />}
 		/>
 	);
 }
@@ -882,7 +880,7 @@ function WindowUtilizationCard({
 			{insights === null ? (
 				<ChartSkeleton height={260} />
 			) : selected === null ? (
-				<EmptyState title={t("providers.no-snapshots-in-range")} hint={SNAPSHOT_HINT} />
+				<EmptyState title={t("providers.no-snapshots-in-range")} hint={t("providers.snapshot-hint")} />
 			) : (
 				<QueryView query={accounts} skeleton={<ChartSkeleton height={260} />}>
 					{() =>

package/src/client/routes/ToolsRoute.tsx

@@ -52,8 +52,6 @@ const METRIC_OPTIONS = [
 /** Tools stacked individually in the calls chart; the rest fold into "Other". */
 const TOP_TOOLS = 6;
 
-const ATTRIBUTION_NOTE = t("tools.attribution-note");
-
 /** Bucket granularity label for the calls chart description. */
 function bucketUnit(bucketMs: number): string {
 	if (bucketMs < 3_600_000) return t("tools.bucket-5m");
@@ -108,13 +106,13 @@ export function ToolsRoute({ active, range }: ToolsRouteProps) {
 								/>
 								<Stat
 									label={t("tools.attributed-tokens")}
-									title={ATTRIBUTION_NOTE}
+									title={t("tools.attribution-note")}
 									value={formatCompact(Math.round(totals.tokens))}
 									hint={t("tools.tokens-output", { tokens: formatCompact(Math.round(totals.output)) })}
 								/>
 								<Stat
 									label={t("tools.attributed-cost")}
-									title={t("tools.attribution-estimate", { note: ATTRIBUTION_NOTE })}
+									title={t("tools.attribution-estimate", { note: t("tools.attribution-note") })}
 									value={formatEstimatedCost(totals.cost, totals.unpriced)}
 									hint={
 										totals.unpriced > 0
@@ -195,7 +193,7 @@ export function ToolsRoute({ active, range }: ToolsRouteProps) {
 			<Card
 				index={2}
 				title={t("tools.by-tool")}
-				description={t("tools.by-tool-description", { note: ATTRIBUTION_NOTE })}
+				description={t("tools.by-tool-description", { note: t("tools.attribution-note") })}
 				flush
 				stale={tools.stale}
 			>
@@ -432,7 +430,7 @@ function buildToolColumns(
 		{
 			key: "tokens",
 			header: t("tools.attr-tokens"),
-			title: ATTRIBUTION_NOTE,
+			title: t("tools.attribution-note"),
 			align: "right",
 			sort: row => row.totalTokensShare,
 			render: row => (
@@ -445,7 +443,7 @@ function buildToolColumns(
 		{
 			key: "cost",
 			header: t("tools.attr-cost"),
-			title: t("tools.attribution-estimate", { note: ATTRIBUTION_NOTE }),
+			title: t("tools.attribution-estimate", { note: t("tools.attribution-note") }),
 			align: "right",
 			sort: row => row.costShare,
 			render: row => (
@@ -549,7 +547,7 @@ function ToolModelTable({
 			{
 				key: "tokens",
 				header: t("tools.attr-tokens"),
-				title: ATTRIBUTION_NOTE,
+				title: t("tools.attribution-note"),
 				align: "right",
 				sort: row => row.totalTokensShare,
 				render: row => <span className="num">{formatCompact(Math.round(row.totalTokensShare))}</span>,
@@ -557,7 +555,7 @@ function ToolModelTable({
 			{
 				key: "cost",
 				header: t("tools.attr-cost"),
-				title: t("tools.attribution-estimate", { note: ATTRIBUTION_NOTE }),
+				title: t("tools.attribution-estimate", { note: t("tools.attribution-note") }),
 				align: "right",
 				sort: row => row.costShare,
 				render: row => <span className="num">{formatEstimatedCost(row.costShare, row.unpricedRequestsShare)}</span>,

package/src/client/styles.css

@@ -460,6 +460,19 @@ kbd {
 	gap: 8px;
 }
 
+/* Language switch: icon plus the language a click installs. */
+.btn .topbar-locale-label {
+	font-size: 12px;
+	font-weight: 600;
+	letter-spacing: 0.02em;
+}
+
+@media (max-width: 640px) {
+	.btn .topbar-locale-label {
+		display: none;
+	}
+}
+
 @media (min-width: 901px) {
 	.btn.topbar-menu {
 		display: none;

package/src/index.ts

@@ -1,7 +1,13 @@
 #!/usr/bin/env bun
 
 import { parseArgs } from "node:util";
-import { formatDuration, formatNumber, formatPercent, normalizePremiumRequests } from "@linxiraos/pi-utils";
+import {
+	formatDuration,
+	formatNumber,
+	formatPercent,
+	normalizePremiumRequests,
+	ZETA_STATS_PORT,
+} from "@linxiraos/pi-utils";
 import chalk from "@linxiraos/pi-utils/chalk";
 import { formatErrorRate } from "./client/data/formatters";
 import { getDashboardStats, getTotalMessageCount, syncAllSessions } from "./aggregator";
@@ -108,7 +114,7 @@ export function parseStandaloneStatsArgs(args: string[]): StandaloneStatsArgs {
 	const { values } = parseArgs({
 		args,
 		options: {
-			port: { type: "string", short: "p", default: "3847" },
+			port: { type: "string", short: "p", default: String(ZETA_STATS_PORT) },
 			host: { type: "string", default: "127.0.0.1" },
 			json: { type: "boolean", short: "j", default: false },
 			sync: { type: "boolean", short: "s", default: false },
@@ -117,7 +123,7 @@ export function parseStandaloneStatsArgs(args: string[]): StandaloneStatsArgs {
 		allowPositionals: true,
 	});
 	return {
-		port: parseInt(values.port || "3847", 10),
+		port: parseInt(values.port || String(ZETA_STATS_PORT), 10),
 		host: values.host || "127.0.0.1",
 		json: values.json ?? false,
 		sync: values.sync ?? false,
@@ -139,7 +145,7 @@ Usage:
   zeta-stats [options]
 
 Options:
-  -p, --port <port>  Port for the dashboard server (default: 3847)
+  -p, --port <port>  Port for the dashboard server (default: ${ZETA_STATS_PORT})
   --host <host>       Host to bind (default: 127.0.0.1)
   -j, --json         Output stats as JSON and exit
   -s, --sync         Sync session files and show summary