@plitzi/sdk-dev-tools 0.36.1 → 0.37.0

package/dist/freshness/rows.d.ts

@@ -0,0 +1,42 @@
+import { FreshnessGroup } from './useFreshnessByStore';
+/** Whether anything is rendering what a path holds, and when it is let go of if nothing starts. */
+export type PathUsage = {
+    inUse: boolean;
+    collectAt?: number;
+};
+/** What a path stands for, when the path itself is an opaque key — a query cache entry is a hash of its request. */
+export type PathDescription = {
+    label: string;
+    tags: string[];
+    usage?: PathUsage;
+};
+export type DescribePath = (group: FreshnessGroup, path: string) => PathDescription | undefined;
+export type FreshnessRowModel = {
+    /** The store and path together: two stores can hold the same path. */
+    key: string;
+    uid: string;
+    storeLabel: string;
+    path: string;
+    label: string;
+    tags: string[];
+    isStale: boolean;
+    /** How long ago it was written, e.g. `12s ago`. */
+    age: string;
+    /** `18s left` while current, `stale` once it is not. */
+    status: string;
+    /** The TTL it was written with — not what is left of it, which is what `status` says. */
+    ttl: string;
+    /** What is left of the TTL, `1` down to `0` — a bar says "half gone" in a glance that a countdown does not. */
+    progress: number;
+    /** Whether anything renders this, where that is known: only what can be let go of can be offered to. */
+    inUse?: boolean;
+    /** `forgotten in 3m 58s`, while a grace period is running. */
+    kept?: string;
+};
+/**
+ * One row per record of every store, stale ones last so what is still being served is what the panel shows first.
+ *
+ * `now` is never earlier than the newest write: the clock is a render-time snapshot, and a record written after it
+ * read as written in the future — "0s ago" and "0s left" on an answer that was never current at all.
+ */
+export declare const toRows: (groups: ReadonlyArray<FreshnessGroup>, labelOf: (group: FreshnessGroup) => string, now: number, describe?: DescribePath) => FreshnessRowModel[];

package/dist/freshness/rows.mjs

@@ -0,0 +1,29 @@
+import e from "./formatDuration.mjs";
+//#region src/freshness/rows.ts
+var t = (t, n, r, { updatedAt: i, expiresAt: a, ttl: o }, s, c) => {
+	let l = s >= a, u = Number.isFinite(a), d = "no expiry";
+	return l ? d = "stale" : u && (d = `${e(a - s)} left`), {
+		key: `${t.entry.uid}:${r}`,
+		uid: t.entry.uid,
+		storeLabel: n,
+		path: r,
+		label: c?.label ?? r,
+		tags: c?.tags ?? [],
+		isStale: l,
+		age: `${e(s - i)} ago`,
+		status: d,
+		ttl: Number.isFinite(o) ? e(o) : "∞",
+		inUse: c?.usage?.inUse,
+		kept: c?.usage?.collectAt ? `forgotten in ${e(c.usage.collectAt - s)}` : void 0,
+		progress: l ? 0 : Math.min(1, Number.isFinite(o) ? (a - s) / o : 1)
+	};
+}, n = (e, n, r, i) => {
+	let a = r;
+	for (let t of e) for (let e of Object.values(t.records)) a = Math.max(a, e.updatedAt);
+	return e.flatMap((e) => {
+		let r = n(e);
+		return Object.entries(e.records).map(([n, o]) => t(e, r, n, o, a, i?.(e, n)));
+	}).sort((e, t) => Number(e.isStale) - Number(t.isStale) || e.storeLabel.localeCompare(t.storeLabel) || e.label.localeCompare(t.label));
+};
+//#endregion
+export { n as toRows };

package/dist/freshness/useFreshnessByStore.d.ts

@@ -0,0 +1,15 @@
+import { DevStoreEntry, PathFreshness } from '@plitzi/nexus';
+export type FreshnessGroup = {
+    entry: DevStoreEntry;
+    records: Readonly<Record<string, PathFreshness>>;
+};
+/**
+ * The paths written with a TTL, across every store given — the stores that hold none are left out.
+ *
+ * Across all of them because the one holding a TTL is rarely the one being looked at: a provider's answers live in the
+ * query cache, not in the provider's own scope, and a panel that only read the picked store showed nothing unless its
+ * reader already knew where to look. Each store hands out the same records object until one changes, so the list is
+ * rebuilt only when something did.
+ */
+declare const useFreshnessByStore: (entries: ReadonlyArray<DevStoreEntry>) => ReadonlyArray<FreshnessGroup>;
+export default useFreshnessByStore;

package/dist/freshness/useFreshnessByStore.mjs

@@ -0,0 +1,20 @@
+import { useCallback as e, useRef as t, useSyncExternalStore as n } from "react";
+//#region src/freshness/useFreshnessByStore.ts
+var r = [], i = (e, t) => e.length === t.length && e.every((e, n) => e.entry === t[n].entry && e.records === t[n].records), a = (e) => Object.fromEntries(Object.entries(e).filter(([, e]) => e.ttl > 0)), o = (o) => {
+	let s = t(r), c = t(/* @__PURE__ */ new WeakMap()), l = e((e) => {
+		let t = o.map(({ store: t }) => t.watchFreshness(e));
+		return () => t.forEach((e) => e());
+	}, [o]), u = e(() => {
+		let e = o.map((e) => {
+			let t = e.store.getFreshnessRecords(), n = c.current.get(t);
+			return n || (n = a(t), c.current.set(t, n)), {
+				entry: e,
+				records: n
+			};
+		}).filter((e) => Object.keys(e.records).length > 0);
+		return i(s.current, e) || (s.current = e.length > 0 ? e : r), s.current;
+	}, [o]);
+	return n(l, u, u);
+};
+//#endregion
+export { o as default };

package/dist/freshness/useSecondsClock.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `Date.now()`, moving once a second while `active` — the finest step a countdown shows.
+ *
+ * Never earlier than `floor`: the clock is a render-time snapshot, and a value written after it read as written in
+ * the future — "0s ago" and "0s left" on an answer that was never current at all.
+ */
+declare const useSecondsClock: (active: boolean, floor?: number) => number;
+export default useSecondsClock;

package/dist/freshness/useSecondsClock.mjs

@@ -0,0 +1,12 @@
+import { useEffect as e, useState as t } from "react";
+//#region src/freshness/useSecondsClock.ts
+var n = (n, r = 0) => {
+	let [i, a] = t(() => Date.now());
+	return e(() => {
+		if (!n) return;
+		let e = setInterval(() => a(Date.now()), 1e3);
+		return () => clearInterval(e);
+	}, [n]), Math.max(i, r);
+};
+//#endregion
+export { n as default };

package/dist/scope/helpers.d.ts

@@ -9,5 +9,6 @@ export type ScopeOptionGroup = {
 };
 export declare const storeLabel: (entry: DevStoreEntry, rootKeys?: ReadonlySet<string>) => string;
 export declare const rootKeysOf: (entries: ReadonlyArray<DevStoreEntry>) => ReadonlySet<string> | undefined;
+export declare const instanceEntries: (entries: ReadonlyArray<DevStoreEntry>, instanceId: string | undefined, activeInstanceId: string | undefined) => DevStoreEntry[];
 export declare const buildScopeOptions: (entries: ReadonlyArray<DevStoreEntry>, instanceIds: ReadonlyArray<string>, activeInstanceId: string | undefined) => ScopeOptionGroup[];
 export declare const resolveSelectedUid: (entries: ReadonlyArray<DevStoreEntry>, selectedUid: string | undefined) => string | undefined;

package/dist/scope/helpers.mjs

@@ -9,15 +9,15 @@ var e = (e, t) => {
 }, n = (e) => {
 	let t = e.find((e) => e.scopeId === void 0);
 	return t ? new Set(Object.keys(t.store.getState())) : void 0;
-}, r = (e, r, i) => {
-	let a = n(e);
-	return r.map((n) => ({
+}, r = (e, t, n) => e.filter((e) => e.scopeId === t || e.scopeId === void 0 && t === n), i = (e, i, a) => {
+	let o = n(e);
+	return i.map((n) => ({
 		label: n,
-		options: e.filter((e) => e.scopeId === n || e.scopeId === void 0 && n === i).map((e) => ({
-			label: t(e, a),
+		options: r(e, n, a).map((e) => ({
+			label: t(e, o),
 			value: e.uid
 		}))
 	}));
-}, i = (e, t) => t && e.some((e) => e.uid === t) ? t : (e.find((e) => e.scopeId === void 0) ?? e.at(0))?.uid;
+}, a = (e, t) => t && e.some((e) => e.uid === t) ? t : (e.find((e) => e.scopeId === void 0) ?? e.at(0))?.uid;
 //#endregion
-export { r as buildScopeOptions, i as resolveSelectedUid, n as rootKeysOf, t as storeLabel };
+export { i as buildScopeOptions, r as instanceEntries, a as resolveSelectedUid, n as rootKeysOf, t as storeLabel };

package/dist/scope/useScope.d.ts

@@ -1,9 +1,11 @@
 import { ScopeOptionGroup } from './helpers';
-import { DevStore } from '@plitzi/nexus';
+import { DevStore, DevStoreEntry } from '@plitzi/nexus';
 export type ScopeSelector = {
     options: ScopeOptionGroup[];
     value: string | undefined;
     onSelect: (uid: string) => void;
 };
 export declare const useScopeSelector: () => ScopeSelector;
+export declare const useSelectedStoreEntry: () => DevStoreEntry | undefined;
 export declare const useSelectedStore: () => DevStore | undefined;
+export declare const useInstanceStores: () => ReadonlyArray<DevStoreEntry>;

package/dist/scope/useScope.mjs

@@ -1,26 +1,29 @@
-import { selectInstance as e, useDevInstances as t } from "../instanceRegistry.mjs";
-import { buildScopeOptions as n, resolveSelectedUid as r } from "./helpers.mjs";
-import { selectStore as i, useSelectedStoreUid as a } from "./storeSelection.mjs";
-import o from "./useDevStores.mjs";
-import { useCallback as s, useMemo as c } from "react";
+import { buildScopeOptions as e, instanceEntries as t, resolveSelectedUid as n } from "./helpers.mjs";
+import { selectInstance as r, useDevInstances as i } from "../instanceRegistry.mjs";
+import { selectStore as a, useSelectedStoreUid as o } from "./storeSelection.mjs";
+import s from "./useDevStores.mjs";
+import { useCallback as c, useMemo as l } from "react";
 //#region src/scope/useScope.ts
-var l = () => {
-	let l = o(), { instanceIds: u, selectedId: d } = t(), f = a();
+var u = () => {
+	let t = s(), { instanceIds: u, selectedId: d } = i(), f = o();
 	return {
-		options: c(() => n(l, u, d), [
-			l,
+		options: l(() => e(t, u, d), [
+			t,
 			u,
 			d
 		]),
-		value: c(() => r(l, f), [l, f]),
-		onSelect: s((t) => {
-			let n = l.find((e) => e.uid === t);
-			n?.scopeId && e(n.scopeId), i(t);
-		}, [l])
+		value: l(() => n(t, f), [t, f]),
+		onSelect: c((e) => {
+			let n = t.find((t) => t.uid === e);
+			n?.scopeId && r(n.scopeId), a(e);
+		}, [t])
 	};
-}, u = () => {
-	let e = o(), t = a(), n = c(() => r(e, t), [e, t]);
-	return c(() => e.find((e) => e.uid === n)?.store, [e, n]);
+}, d = () => {
+	let e = s(), t = o(), r = l(() => n(e, t), [e, t]);
+	return l(() => e.find((e) => e.uid === r), [e, r]);
+}, f = () => d()?.store, p = () => {
+	let e = s(), { selectedId: n } = i();
+	return l(() => t(e, n, n), [e, n]);
 };
 //#endregion
-export { l as useScopeSelector, u as useSelectedStore };
+export { p as useInstanceStores, u as useScopeSelector, f as useSelectedStore, d as useSelectedStoreEntry };

package/dist/useRegisterQueriesStore.mjs

@@ -1,10 +1,10 @@
 import { useEffect as e } from "react";
-import { registerDevStore as t } from "@plitzi/nexus";
-import { queryCache as n } from "@plitzi/sdk-shared/queries";
+import { queryCache as t } from "@plitzi/sdk-shared/queries";
+import { registerDevStore as n } from "@plitzi/nexus";
 //#region src/useRegisterQueriesStore.ts
 var r = (r, i) => {
 	e(() => {
-		if (r) return t(n.store, i, "Queries");
+		if (r) return n(t.store, i, "Queries");
 	}, [r, i]);
 };
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plitzi/sdk-dev-tools",
-  "version": "0.36.1",
+  "version": "0.37.0",
   "license": "AGPL-3.0",
   "files": [
     "dist"
@@ -18,6 +18,10 @@
       "types": "./dist/DevToolsContextProvider.d.ts",
       "import": "./dist/DevToolsContextProvider.mjs"
     },
+    "./DevToolsRoot": {
+      "types": "./dist/DevToolsRoot.d.ts",
+      "import": "./dist/DevToolsRoot.mjs"
+    },
     "./components/DevToolsIndicator": {
       "types": "./dist/components/DevToolsIndicator/index.d.ts",
       "import": "./dist/components/DevToolsIndicator/index.mjs"
@@ -118,18 +122,6 @@
       "types": "./dist/components/DevToolsPanel/tabs/ActionsViewer/components/FlowTimeline/index.d.ts",
       "import": "./dist/components/DevToolsPanel/tabs/ActionsViewer/components/FlowTimeline/index.mjs"
     },
-    "./components/DevToolsPanel/tabs/ActionsViewer/components/PayloadView": {
-      "types": "./dist/components/DevToolsPanel/tabs/ActionsViewer/components/PayloadView/index.d.ts",
-      "import": "./dist/components/DevToolsPanel/tabs/ActionsViewer/components/PayloadView/index.mjs"
-    },
-    "./components/DevToolsPanel/tabs/ActionsViewer/components/PayloadView/PayloadView": {
-      "types": "./dist/components/DevToolsPanel/tabs/ActionsViewer/components/PayloadView/PayloadView.d.ts",
-      "import": "./dist/components/DevToolsPanel/tabs/ActionsViewer/components/PayloadView/PayloadView.mjs"
-    },
-    "./components/DevToolsPanel/tabs/ActionsViewer/components/PayloadView/index": {
-      "types": "./dist/components/DevToolsPanel/tabs/ActionsViewer/components/PayloadView/index.d.ts",
-      "import": "./dist/components/DevToolsPanel/tabs/ActionsViewer/components/PayloadView/index.mjs"
-    },
     "./components/DevToolsPanel/tabs/ActionsViewer/components/RunDetail": {
       "types": "./dist/components/DevToolsPanel/tabs/ActionsViewer/components/RunDetail/index.d.ts",
       "import": "./dist/components/DevToolsPanel/tabs/ActionsViewer/components/RunDetail/index.mjs"
@@ -186,6 +178,30 @@
       "types": "./dist/components/DevToolsPanel/tabs/ActionsViewer/index.d.ts",
       "import": "./dist/components/DevToolsPanel/tabs/ActionsViewer/index.mjs"
     },
+    "./components/DevToolsPanel/tabs/CacheViewer": {
+      "types": "./dist/components/DevToolsPanel/tabs/CacheViewer/index.d.ts",
+      "import": "./dist/components/DevToolsPanel/tabs/CacheViewer/index.mjs"
+    },
+    "./components/DevToolsPanel/tabs/CacheViewer/CacheViewer": {
+      "types": "./dist/components/DevToolsPanel/tabs/CacheViewer/CacheViewer.d.ts",
+      "import": "./dist/components/DevToolsPanel/tabs/CacheViewer/CacheViewer.mjs"
+    },
+    "./components/DevToolsPanel/tabs/CacheViewer/components/CacheRow": {
+      "types": "./dist/components/DevToolsPanel/tabs/CacheViewer/components/CacheRow/index.d.ts",
+      "import": "./dist/components/DevToolsPanel/tabs/CacheViewer/components/CacheRow/index.mjs"
+    },
+    "./components/DevToolsPanel/tabs/CacheViewer/components/CacheRow/CacheRow": {
+      "types": "./dist/components/DevToolsPanel/tabs/CacheViewer/components/CacheRow/CacheRow.d.ts",
+      "import": "./dist/components/DevToolsPanel/tabs/CacheViewer/components/CacheRow/CacheRow.mjs"
+    },
+    "./components/DevToolsPanel/tabs/CacheViewer/components/CacheRow/index": {
+      "types": "./dist/components/DevToolsPanel/tabs/CacheViewer/components/CacheRow/index.d.ts",
+      "import": "./dist/components/DevToolsPanel/tabs/CacheViewer/components/CacheRow/index.mjs"
+    },
+    "./components/DevToolsPanel/tabs/CacheViewer/index": {
+      "types": "./dist/components/DevToolsPanel/tabs/CacheViewer/index.d.ts",
+      "import": "./dist/components/DevToolsPanel/tabs/CacheViewer/index.mjs"
+    },
     "./components/DevToolsPanel/tabs/ElementsViewer": {
       "types": "./dist/components/DevToolsPanel/tabs/ElementsViewer/index.d.ts",
       "import": "./dist/components/DevToolsPanel/tabs/ElementsViewer/index.mjs"
@@ -478,38 +494,26 @@
       "types": "./dist/components/DevToolsPanel/tabs/StoreViewer/StoreViewer.d.ts",
       "import": "./dist/components/DevToolsPanel/tabs/StoreViewer/StoreViewer.mjs"
     },
-    "./components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel": {
-      "types": "./dist/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/index.d.ts",
-      "import": "./dist/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/index.mjs"
-    },
-    "./components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/FreshnessPanel": {
-      "types": "./dist/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/FreshnessPanel.d.ts",
-      "import": "./dist/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/FreshnessPanel.mjs"
-    },
-    "./components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/components/FreshnessRow": {
-      "types": "./dist/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/components/FreshnessRow/index.d.ts",
-      "import": "./dist/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/components/FreshnessRow/index.mjs"
-    },
-    "./components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/components/FreshnessRow/FreshnessRow": {
-      "types": "./dist/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/components/FreshnessRow/FreshnessRow.d.ts",
-      "import": "./dist/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/components/FreshnessRow/FreshnessRow.mjs"
+    "./components/DevToolsPanel/tabs/StoreViewer/components/FreshnessMark": {
+      "types": "./dist/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessMark/index.d.ts",
+      "import": "./dist/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessMark/index.mjs"
     },
-    "./components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/components/FreshnessRow/index": {
-      "types": "./dist/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/components/FreshnessRow/index.d.ts",
-      "import": "./dist/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/components/FreshnessRow/index.mjs"
+    "./components/DevToolsPanel/tabs/StoreViewer/components/FreshnessMark/FreshnessMark": {
+      "types": "./dist/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessMark/FreshnessMark.d.ts",
+      "import": "./dist/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessMark/FreshnessMark.mjs"
     },
-    "./components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/helpers": {
-      "types": "./dist/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/helpers.d.ts",
-      "import": "./dist/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/helpers.mjs"
-    },
-    "./components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/index": {
-      "types": "./dist/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/index.d.ts",
-      "import": "./dist/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/index.mjs"
+    "./components/DevToolsPanel/tabs/StoreViewer/components/FreshnessMark/index": {
+      "types": "./dist/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessMark/index.d.ts",
+      "import": "./dist/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessMark/index.mjs"
     },
     "./components/DevToolsPanel/tabs/StoreViewer/helpers/mapFunctionValues": {
       "types": "./dist/components/DevToolsPanel/tabs/StoreViewer/helpers/mapFunctionValues.d.ts",
       "import": "./dist/components/DevToolsPanel/tabs/StoreViewer/helpers/mapFunctionValues.mjs"
     },
+    "./components/DevToolsPanel/tabs/StoreViewer/helpers/renderFreshnessKey": {
+      "types": "./dist/components/DevToolsPanel/tabs/StoreViewer/helpers/renderFreshnessKey.d.ts",
+      "import": "./dist/components/DevToolsPanel/tabs/StoreViewer/helpers/renderFreshnessKey.mjs"
+    },
     "./components/DevToolsPanel/tabs/StoreViewer/helpers/renderFunctionValue": {
       "types": "./dist/components/DevToolsPanel/tabs/StoreViewer/helpers/renderFunctionValue.d.ts",
       "import": "./dist/components/DevToolsPanel/tabs/StoreViewer/helpers/renderFunctionValue.mjs"
@@ -734,6 +738,46 @@
       "types": "./dist/components/List/index.d.ts",
       "import": "./dist/components/List/index.mjs"
     },
+    "./components/PayloadView": {
+      "types": "./dist/components/PayloadView/index.d.ts",
+      "import": "./dist/components/PayloadView/index.mjs"
+    },
+    "./components/PayloadView/PayloadView": {
+      "types": "./dist/components/PayloadView/PayloadView.d.ts",
+      "import": "./dist/components/PayloadView/PayloadView.mjs"
+    },
+    "./components/PayloadView/index": {
+      "types": "./dist/components/PayloadView/index.d.ts",
+      "import": "./dist/components/PayloadView/index.mjs"
+    },
+    "./freshness": {
+      "types": "./dist/freshness/index.d.ts",
+      "import": "./dist/freshness/index.mjs"
+    },
+    "./freshness/describeQueryPath": {
+      "types": "./dist/freshness/describeQueryPath.d.ts",
+      "import": "./dist/freshness/describeQueryPath.mjs"
+    },
+    "./freshness/formatDuration": {
+      "types": "./dist/freshness/formatDuration.d.ts",
+      "import": "./dist/freshness/formatDuration.mjs"
+    },
+    "./freshness/index": {
+      "types": "./dist/freshness/index.d.ts",
+      "import": "./dist/freshness/index.mjs"
+    },
+    "./freshness/rows": {
+      "types": "./dist/freshness/rows.d.ts",
+      "import": "./dist/freshness/rows.mjs"
+    },
+    "./freshness/useFreshnessByStore": {
+      "types": "./dist/freshness/useFreshnessByStore.d.ts",
+      "import": "./dist/freshness/useFreshnessByStore.mjs"
+    },
+    "./freshness/useSecondsClock": {
+      "types": "./dist/freshness/useSecondsClock.d.ts",
+      "import": "./dist/freshness/useSecondsClock.mjs"
+    },
     "./index": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs"
@@ -754,10 +798,6 @@
       "types": "./dist/scope/useDevStores.d.ts",
       "import": "./dist/scope/useDevStores.mjs"
     },
-    "./scope/useFreshnessRecords": {
-      "types": "./dist/scope/useFreshnessRecords.d.ts",
-      "import": "./dist/scope/useFreshnessRecords.mjs"
-    },
     "./scope/useScope": {
       "types": "./dist/scope/useScope.d.ts",
       "import": "./dist/scope/useScope.mjs"
@@ -793,24 +833,24 @@
   "devDependencies": {
     "@testing-library/react": "^16.3.3",
     "eslint": "^9.39.5",
-    "jsdom": "^30.0.1",
+    "jsdom": "^30.1.0",
     "react": "^19.3.0",
     "react-dom": "^19.3.0",
     "typescript": "^6.0.3",
     "vite": "^8.3.0",
-    "vitest": "^5.0.0"
+    "vitest": "^5.0.1"
   },
   "peerDependencies": {
     "react": "^19",
     "react-dom": "^19"
   },
   "dependencies": {
-    "@plitzi/nexus": "^1.2.0",
+    "@plitzi/nexus": "^1.2.2",
     "@plitzi/plitzi-ui": "^1.6.21",
-    "@plitzi/sdk-navigation": "0.36.1",
-    "@plitzi/sdk-schema": "0.36.1",
-    "@plitzi/sdk-shared": "0.36.1",
-    "@plitzi/sdk-style": "0.36.1",
+    "@plitzi/sdk-navigation": "0.37.0",
+    "@plitzi/sdk-schema": "0.37.0",
+    "@plitzi/sdk-shared": "0.37.0",
+    "@plitzi/sdk-style": "0.37.0",
     "@uiw/react-json-view": "^2.0.0-alpha.43",
     "clsx": "^2.1.1"
   }

package/dist/components/DevToolsPanel/tabs/ActionsViewer/components/PayloadView/PayloadView.d.ts

@@ -1,6 +0,0 @@
-export type PayloadViewProps = {
-    value: unknown;
-};
-/** What a run was given, answered, or streamed — the same reader the Store tab uses, so it reads the same. */
-declare const PayloadView: ({ value }: PayloadViewProps) => import("react").JSX.Element;
-export default PayloadView;

package/dist/components/DevToolsPanel/tabs/ActionsViewer/components/PayloadView/index.mjs

@@ -1,5 +0,0 @@
-import e from "./PayloadView.mjs";
-//#region src/components/DevToolsPanel/tabs/ActionsViewer/components/PayloadView/index.ts
-var t = e;
-//#endregion
-export { t as default };

package/dist/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/FreshnessPanel.d.ts

@@ -1,11 +0,0 @@
-import { DevStore } from '@plitzi/nexus';
-export type FreshnessPanelProps = {
-    store: DevStore | undefined;
-};
-/**
- * The paths of the selected store that were written with a TTL: how old each one is, how long it has left, and a
- * way to expire it — which is how a developer checks that whatever depends on it refreshes. Absent for a store that
- * holds none, so it costs nothing to look at the others.
- */
-declare const FreshnessPanel: ({ store }: FreshnessPanelProps) => import("react").JSX.Element | null;
-export default FreshnessPanel;

package/dist/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/FreshnessPanel.mjs

@@ -1,49 +0,0 @@
-import e from "./components/FreshnessRow/index.mjs";
-import { toRows as t } from "./helpers.mjs";
-import n from "../../../../../../scope/useFreshnessRecords.mjs";
-import { useCallback as r, useEffect as i, useMemo as a, useState as o } from "react";
-import { jsx as s, jsxs as c } from "react/jsx-runtime";
-//#region src/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/FreshnessPanel.tsx
-var l = ({ store: l }) => {
-	let u = n(l), d = Object.keys(u).length, [f, p] = o(() => Date.now());
-	i(() => l?.watchFreshness(() => p(Date.now())), [l]), i(() => {
-		if (d === 0) return;
-		let e = setInterval(() => p(Date.now()), 1e3);
-		return () => clearInterval(e);
-	}, [d]);
-	let m = a(() => t(u, f), [u, f]), h = r((e) => {
-		l?.expire(e);
-	}, [l]), g = r(() => {
-		l?.expire();
-	}, [l]);
-	return d === 0 ? null : /* @__PURE__ */ c("div", {
-		className: "shrink-0 border-b border-zinc-200 text-[11px] dark:border-zinc-800",
-		children: [/* @__PURE__ */ c("div", {
-			className: "flex items-center gap-2 px-2 py-1",
-			children: [
-				/* @__PURE__ */ s("span", {
-					className: "font-medium text-zinc-600 dark:text-zinc-300",
-					children: "TTL"
-				}),
-				/* @__PURE__ */ s("span", {
-					className: "text-zinc-400 tabular-nums dark:text-zinc-500",
-					children: d
-				}),
-				/* @__PURE__ */ s("button", {
-					className: "ml-auto cursor-pointer rounded px-1.5 text-violet-600 hover:bg-violet-500/15 dark:text-violet-300",
-					onClick: g,
-					title: "Mark every path stale now",
-					children: "Expire all"
-				})
-			]
-		}), /* @__PURE__ */ s("ul", {
-			className: "max-h-40 overflow-auto pb-1",
-			children: m.map((t) => /* @__PURE__ */ s(e, {
-				row: t,
-				onExpire: h
-			}, t.path))
-		})]
-	});
-};
-//#endregion
-export { l as default };

package/dist/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/components/FreshnessRow/FreshnessRow.d.ts

@@ -1,7 +0,0 @@
-import { FreshnessRowModel } from '../../helpers';
-export type FreshnessRowProps = {
-    row: FreshnessRowModel;
-    onExpire: (path: string) => void;
-};
-declare const FreshnessRow: ({ row, onExpire }: FreshnessRowProps) => import("react").JSX.Element;
-export default FreshnessRow;

package/dist/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/components/FreshnessRow/FreshnessRow.mjs

@@ -1,43 +0,0 @@
-import e from "clsx";
-import { useCallback as t } from "react";
-import { jsx as n, jsxs as r } from "react/jsx-runtime";
-//#region src/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/components/FreshnessRow/FreshnessRow.tsx
-var i = ({ row: i, onExpire: a }) => {
-	let o = t(() => a(i.path), [a, i.path]);
-	return /* @__PURE__ */ r("li", {
-		className: "flex items-center gap-2 px-2 py-0.5",
-		children: [
-			/* @__PURE__ */ n("span", {
-				className: e("h-1.5 w-1.5 shrink-0 rounded-full", i.isStale ? "bg-zinc-400" : "bg-emerald-500"),
-				title: i.isStale ? "Stale" : "Current"
-			}),
-			/* @__PURE__ */ n("span", {
-				className: "min-w-0 grow truncate font-mono text-zinc-700 dark:text-zinc-200",
-				title: i.path,
-				children: i.path
-			}),
-			/* @__PURE__ */ n("span", {
-				className: "shrink-0 text-zinc-400 tabular-nums dark:text-zinc-500",
-				title: "Written",
-				children: i.age
-			}),
-			/* @__PURE__ */ r("span", {
-				className: "shrink-0 text-zinc-400 tabular-nums dark:text-zinc-500",
-				title: "TTL",
-				children: ["ttl ", i.ttl]
-			}),
-			/* @__PURE__ */ n("span", {
-				className: e("w-20 shrink-0 text-right tabular-nums", i.isStale ? "text-zinc-400 dark:text-zinc-500" : "text-emerald-600 dark:text-emerald-400"),
-				children: i.status
-			}),
-			/* @__PURE__ */ n("button", {
-				className: "shrink-0 cursor-pointer rounded px-1.5 text-violet-600 hover:bg-violet-500/15 dark:text-violet-300",
-				onClick: o,
-				title: "Mark stale now — anything listening refreshes it",
-				children: "Expire"
-			})
-		]
-	});
-};
-//#endregion
-export { i as default };

package/dist/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/components/FreshnessRow/index.d.ts

@@ -1,3 +0,0 @@
-import { default as FreshnessRow } from './FreshnessRow';
-export * from './FreshnessRow';
-export default FreshnessRow;

package/dist/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/components/FreshnessRow/index.mjs

@@ -1,5 +0,0 @@
-import e from "./FreshnessRow.mjs";
-//#region src/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/components/FreshnessRow/index.ts
-var t = e;
-//#endregion
-export { t as default };

package/dist/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/helpers.d.ts

@@ -1,14 +0,0 @@
-import { PathFreshness } from '@plitzi/nexus';
-export type FreshnessRowModel = {
-    path: string;
-    isStale: boolean;
-    /** How long ago it was written, e.g. `12s ago`. */
-    age: string;
-    /** `18s left` while current, `stale` once it is not. */
-    status: string;
-    /** The TTL it was written with, or what was left of it when an `expire` cut it short. */
-    ttl: string;
-};
-export declare const formatDuration: (ms: number) => string;
-/** One row per record, stale ones last so what is still being served is what the panel shows first. */
-export declare const toRows: (records: Readonly<Record<string, PathFreshness>>, now: number) => FreshnessRowModel[];

package/dist/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/helpers.mjs

@@ -1,18 +0,0 @@
-//#region src/components/DevToolsPanel/tabs/StoreViewer/components/FreshnessPanel/helpers.ts
-var e = (e) => {
-	let t = Math.max(0, Math.round(e / 1e3));
-	if (t < 60) return `${t}s`;
-	let n = Math.floor(t / 60);
-	return n < 60 ? `${n}m ${t % 60}s` : `${Math.floor(n / 60)}h ${n % 60}m`;
-}, t = (t, n) => Object.entries(t).map(([t, { updatedAt: r, expiresAt: i }]) => {
-	let a = n >= i, o = Number.isFinite(i), s = "no expiry";
-	return a ? s = "stale" : o && (s = `${e(i - n)} left`), {
-		path: t,
-		isStale: a,
-		age: `${e(n - r)} ago`,
-		status: s,
-		ttl: o ? e(i - r) : "∞"
-	};
-}).sort((e, t) => Number(e.isStale) - Number(t.isStale) || e.path.localeCompare(t.path));
-//#endregion
-export { e as formatDuration, t as toRows };