pi-mega-compact 0.8.11 → 0.8.14

package/extensions/dashboard-client/src/utils/format.ts

@@ -0,0 +1,85 @@
+/**
+ * dashboard-client/src/utils/format.ts — shared formatting helpers.
+ *
+ * Mirrors the format functions from the old static dashboard (html.ts)
+ * so the React rewrite shows identical values.
+ */
+
+/** Format bytes as KiB/MiB/B (matches html.ts fmtBytes). */
+export function fmtBytes(b: number | null | undefined): string {
+	const n = b ?? 0;
+	if (n >= 1_048_576) return `${(n / 1_048_576).toFixed(1)} MiB`;
+	if (n >= 1024) return `${(n / 1024).toFixed(1)} KiB`;
+	return `${n} B`;
+}
+
+/** Format seconds as h/m/s/ms (matches html.ts fmtSec). */
+export function fmtSec(s: number | null | undefined): string {
+	const n = s ?? 0;
+	if (n >= 3600) return `${(n / 3600).toFixed(1)}h`;
+	if (n >= 60) return `${Math.round(n / 60)}m`;
+	if (n >= 1) return `${n.toFixed(1)}s`;
+	return `${Math.round(n * 1000)}ms`;
+}
+
+/**
+ * Display a 0–1 fraction as a percentage string.
+ * Uses one decimal place below 10%, rounded above (matches html.ts pct logic).
+ */
+export function fmtPctFromFraction(
+	v: number | null | undefined,
+): string {
+	const n = v ?? 0;
+	const pct = n * 100;
+	if (pct >= 10) return `${Math.round(pct)}%`;
+	return `${pct.toFixed(1)}%`;
+}
+
+/** Round a 0–1 fraction to a one-decimal percentage (for trophy values). */
+export function fmtPct(v: number | null | undefined): string {
+	const n = v ?? 0;
+	return `${Math.round(n * 10) / 10}%`;
+}
+
+/** Format milliseconds (matches html.ts fmtMs). */
+export function fmtMs(v: number | null | undefined): string {
+	if (v == null) return "\u2014";
+	return v >= 100 ? `${Math.round(v)}ms` : `${v.toFixed(1)}ms`;
+}
+
+/** Format a number with fixed decimals or em-dash for null (matches fmtNum). */
+export function fmtNum(
+	v: number | null | undefined,
+	dec: number,
+): string {
+	if (v == null || typeof v !== "number") return "\u2014";
+	return v.toFixed(dec);
+}
+
+/** Collapse an array of numbers into a range string or single value. */
+export function collapseNum(samples: number[]): string {
+	if (samples.length === 0) return "\u2014";
+	const lo = Math.min(...samples);
+	const hi = Math.max(...samples);
+	if (lo === hi) return lo.toLocaleString();
+	return `${lo.toLocaleString()}\u2013${hi.toLocaleString()}`;
+}
+
+/** Collapse an array of rates into a range string or single value. */
+export function collapseRate(samples: number[]): string {
+	if (samples.length === 0) return "\u2014";
+	const lo = Math.min(...samples);
+	const hi = Math.max(...samples);
+	if (lo === hi) return `$${lo.toFixed(6)}`;
+	return `$${lo.toFixed(6)}\u2013$${hi.toFixed(6)}`;
+}
+
+/** Format a date string or null as locale string or em-dash. */
+export function fmtDate(ts: string | number | null | undefined): string {
+	if (!ts) return "\u2014";
+	try {
+		return new Date(ts).toLocaleString();
+	} catch {
+		return "\u2014";
+	}
+}

package/extensions/dashboard-client/src/utils/types.ts

@@ -0,0 +1,27 @@
+/**
+ * dashboard-client/src/utils/types.ts — local extended types.
+ *
+ * The runtime snapshot (mega-dashboard.ts) includes fields not present in
+ * the A1 SnapshotResponse contract (e.g. config.tierPct). This file adds
+ * those fields in a type-safe way without using `any`.
+ */
+
+import type { SnapshotResponse } from "@contracts";
+
+/**
+ * SnapshotResponse extended with runtime-only fields.
+ * These fields are emitted by the server but absent from the contract.
+ */
+export interface RuntimeSnapshot extends SnapshotResponse {
+	config: SnapshotResponse["config"] & {
+		/** Tier percentage as a 0–1 fraction (runtime-only, not in contract). */
+		tierPct?: number;
+	};
+}
+
+/** Actual flat game-state shape from the server (not the nested contract). */
+export interface DashboardGameState {
+	game_mode_on: boolean;
+	theme: string;
+	tui_display_mode: "full" | "minimal";
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-mega-compact",
-  "version": "0.8.11",
+  "version": "0.8.14",
   "description": "Layered, local, vector-backed context compressor for pi — supersede/collapse/cluster compaction with deduped inline recall.",
   "type": "module",
   "license": "BSD-2-Clause",
@@ -25,6 +25,7 @@
   "files": [
     "dist",
     "extensions",
+    "extensions/dashboard-client/dist",
     "src",
     "README.md",
     "LICENSE"
@@ -46,7 +47,7 @@
     "test": "npm run build && node scripts/run-tests.mjs",
     "guardrails": "python3 scripts/regression_check.py --all || node scripts/guardrails-scan.mjs || node scripts/semantic-scan.mjs",
     "precommit": "bash .claude/hooks/pre-commit.sh",
-    "prepublishOnly": "npm run build",
+    "prepublishOnly": "npm run build && npm run build:dashboard",
     "postinstall": "npm rebuild @mongodb-js/zstd || true"
   },
   "peerDependencies": {