@kidli1412/dsh-token-heatmap 0.4.1 → 0.4.2

package/README.md

@@ -31,10 +31,10 @@ GitHub 风格自然年热力图：覆盖所选自然年 1月–12月（`‹ 2026
 
 ### 卡片设置 / In-card settings
 
-![⚙ 设置面板](docs/卡片设置面板.jpg)
+![⚙ 悬浮设置面板](docs/卡片设置面板.jpg)
 
-- ⚙️ **设置就在卡片上**：点标题行最右端的 **⚙**（`刷新 [⚙]`）在卡片底部展开设置面板，再点一次、点面板的 **×**、按 **Esc**、或把焦点移出面板都会收起。**插件不再往 DSH 设置（设置 → 插件 → 插件配置）里注册任何卡片**，所以那里看不到本插件。
-- **配色方案**：六个色板按钮，**点击即时生效**（不需要"保存"）；**默认视图**：年 / 月，决定新会话页面首次打开时显示哪个视图（当次会话手动切换只影响当前页面）。
+- ⚙️ **设置就在卡片上**：点标题行最右端的 **⚙**（`刷新 [⚙]`）弹出**悬浮设置面板** —— 位置在 ⚙ 正上方 8px、水平居中对齐、贴边留 12px，超出视口会自动钳制；点面板外的任意位置、按 **Esc**、或再点一次 ⚙ 都会收起。**插件不再往 DSH 设置（设置 → 插件 → 插件配置）里注册任何卡片**，所以那里看不到本插件。
+- **配色方案**：六个色板按钮，**点击即时生效**（不需要"保存"）；**默认视图**：年 / 月，决定新会话页面首次打开时显示哪个视图（当次会话手动切换只影响当前页面）。面板底部是阈值图例（悬停看各档范围）与一行说明。
 - 写入失败时面板底部会红字提示"保存失败，已回到服务端的值"（settings scope 复核后回滚乐观值）。
 - 配置经 `token-heatmap` settings namespace 持久化到 `<DSH_HOME>/settings.yaml`（0.1.1 及更早版本存在 `<DSH_HOME>/storages/token-heatmap-config.json` 的旧配置会在启动时自动迁移）。
 
@@ -91,6 +91,7 @@ dsh plugin --profile web remove @kidli1412/dsh-token-heatmap
 - **0.4.0（设置搬进卡片）**：不再注册官方 `settings.plugin.item` 插槽——设置页（设置 → 插件 → 插件配置）里不再有本插件的卡片，配色与默认视图改在卡片自己的 ⚙ 面板里改，**点击即时生效**（去掉了草稿/保存/放弃那套）。Host 侧 `settings.register("token-heatmap", schema)` 保留：它是 settings.yaml 的校验与持久化管道，与 UI 卡片无关（官方 `settings` 服务的 `get`/`update` 只对已注册 namespace 生效）。升级只影响设置入口位置，已有配置不动。
 
 - **0.4.1（fork 会话不再重复计入父会话用量）**：DSH 的 fork 子会话（header `isSeeded=true`）日志以父会话事件的完整复制开头，其前 `inheritedEventCount` 个事件是**父会话**的 usage（父会话折叠时已计入）。此前折叠从 seq 0 读整份日志，同一批 token 被计两次——实测 2026-09-14 由 8.34 亿虚增到 13.15 亿。现在三条折叠路径（`collectUsage` 的 live 折叠、`session/event` 实时监听、stored 日志读取）都从 fork 切点开始：live 会话用官方 `session.inheritedEventCount`；stored 日志用最后一个带 `data.inherited === true` 的 `session/end-seed` 的 `seq + 1`（未打标记的 `session/end-seed` 是 compaction 边界，不算切点，与 `dsh-session-format-v2-to-v3` 的切点推导一致）。**resume 不是 fork**：`isSeeded=false` 的会话种子是它自己的历史，仍整份折叠。缓存格式版本提升到 2，旧缓存（可能含重复计入的天数）会被丢弃重建；父会话日志不可得的极端情况下会少计而非多计。
+- **0.4.2（设置改成悬浮面板）**：⚙ 面板从"卡片底部的内嵌条"改为**悬浮面板**——portal 到 `document.body`、`position:fixed`，锚在 ⚙ 上方 8px 且水平居中对齐，按视口钳制（12px 边距），关闭方式为点外部/Esc/再点 ⚙；表面沿用 DSH 原生弹层 token（`--dsw-specific-menu` + `--dsw-elevation-prominent`，配合 `--dsw-elevation-stroke-color` 的发丝边），与底部统计 pill 的弹层一致。为此客户端 bundle 新增 `require("react-dom")`（原生的 `createPortal`），DSH 的模块图里 react-dom 一直存在，旧宿主不受影响。
 
 ## License
 

package/lib/client.js

@@ -37,6 +37,9 @@ window.__ModuleLoader__.load({
 
 		let react = require("react");
 		let react_jsx_runtime = require("react/jsx-runtime");
+		// Only for the settings panel, which is PORTALED to document.body so the
+		// card's own box can never clip it (the pattern the stat pills use).
+		let reactDom = require("react-dom");
 
 		//#region css
 		const css = [
@@ -88,23 +91,23 @@ window.__ModuleLoader__.load({
 			".thm_error{color:var(--dsw-alias-state-error-primary);background:var(--dsw-alias-interactive-bg-hover-danger);border-radius:8px;padding:7px 8px;font-size:11px;line-height:16px;display:flex;justify-content:space-between;align-items:center;gap:8px}",
 			".thm_retry{color:inherit;font:inherit;cursor:pointer;background:0 0;border:none;flex:none;padding:0}",
 			".thm_loading{color:var(--dsw-alias-label-tertiary);font-size:11px;line-height:16px;padding:6px 2px}",
-			// In-card settings panel (⚙ at the row's right end) — the card
-			// configures itself; nothing registers into 设置 → 插件 → 插件配置.
+			// The ⚙ at the row's right end opens a floating pill panel — the
+			// card configures itself; nothing registers into 设置 → 插件 → 插件配置.
 			".thm_gear{cursor:pointer;color:var(--dsw-alias-label-tertiary);background:0 0;border:none;border-radius:6px;align-items:center;padding:2px 4px;display:inline-flex}",
 			".thm_gear:hover{color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-interactive-bg-hover)}",
 			".thm_gear[data-active=true]{color:var(--dsw-alias-label-primary);background:var(--dsw-alias-interactive-bg-hover)}",
-			// The panel is an inset surface on the card: the light theme resolves
-			// every bg-layer token to the same white, so the fill is a translucent
-			// gray that reads as a nested surface in both themes.
-			".thm_panel{box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);background:rgba(128,128,128,.08);border-radius:12px;flex-direction:column;gap:10px;margin-top:2px;padding:10px 12px 12px;display:flex}",
-			".thm_panelHead{align-items:center;gap:8px;display:flex}",
-			".thm_panelTitle{color:var(--dsw-alias-label-primary);flex:1;font-size:12px;font-weight:600;line-height:18px}",
-			".thm_panelClose{cursor:pointer;color:var(--dsw-alias-label-tertiary);background:0 0;border:none;border-radius:4px;flex:none;padding:0 5px;font-size:16px;line-height:20px}",
-			".thm_panelClose:hover{color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-interactive-bg-hover)}",
+			// The settings panel mirrors DSH's own pill dialogs: portaled to
+			// document.body, position:fixed (so the card can never clip it),
+			// measure-then-place above the ⚙ and clamped to the viewport, with
+			// the shipped dialog surface + elevation tokens.
+			".thm_panel{position:fixed;z-index:1100;box-sizing:border-box;background:var(--dsw-specific-menu,#fff);--dsw-elevation-stroke-color:var(--dsw-alias-border-l1);width:400px;max-width:calc(100vw - 24px);box-shadow:var(--dsw-elevation-prominent,0 8px 32px rgba(0,0,0,.16));color:var(--dsw-alias-label-secondary);cursor:default;border:0;border-radius:12px;padding:16px;font-size:12px;line-height:18px;text-align:left;font-weight:400}",
+			".thm_panelHead{color:var(--dsw-alias-label-primary);justify-content:space-between;align-items:center;gap:16px;margin-bottom:8px;font-weight:500;display:flex}",
+			".thm_panelTitleLabel{align-items:center;gap:6px;display:inline-flex}",
+			".thm_panelTitleLabel svg{flex:none;width:14px;height:14px}",
+			".thm_panelRule{border-top:.5px solid var(--dsw-alias-border-l2);margin-bottom:12px}",
 			".thm_group{flex-direction:column;gap:5px;display:flex}",
+			".thm_group+.thm_group{margin-top:14px}",
 			".thm_groupLabel{color:var(--dsw-alias-label-tertiary);font-size:11px;line-height:16px}",
-			".thm_hint{color:var(--dsw-alias-label-caption);font-size:10px;line-height:14px}",
-			".thm_hintError{color:var(--dsw-alias-state-error-primary)}",
 			".thm_swatches{flex-wrap:wrap;gap:6px;display:flex}",
 			".thm_swatch{cursor:pointer;align-items:center;gap:6px;border:1px solid var(--dsw-alias-border-l2);background:0 0;border-radius:6px;padding:3px 8px;font:inherit;display:flex}",
 			".thm_swatch:hover{border-color:var(--dsw-alias-label-dimmed)}",
@@ -115,7 +118,11 @@ window.__ModuleLoader__.load({
 			".thm_seg{border:1px solid var(--dsw-alias-border-l2);border-radius:8px;align-items:center;display:inline-flex;overflow:hidden;width:max-content}",
 			".thm_segBtn{cursor:pointer;color:var(--dsw-alias-label-tertiary);background:0 0;border:none;padding:1px 10px;font:inherit;font-size:11px;line-height:18px}",
 			".thm_segBtn:hover{color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-interactive-bg-hover)}",
-			".thm_segBtn[data-active=true]{color:var(--dsw-alias-label-primary);background:var(--dsw-alias-interactive-bg-hover);font-weight:600}"
+			".thm_segBtn[data-active=true]{color:var(--dsw-alias-label-primary);background:var(--dsw-alias-interactive-bg-hover);font-weight:600}",
+			".thm_panelFoot{border-top:.5px solid var(--dsw-alias-border-l2);margin-top:14px;padding-top:10px}",
+			".thm_footLegend{align-items:center;gap:3px;font-size:10px;line-height:14px;display:flex;color:var(--dsw-alias-label-tertiary)}",
+			".thm_footRule{color:var(--dsw-alias-label-caption);margin-top:6px;font-size:10px;line-height:14px}",
+			".thm_footError{color:var(--dsw-alias-state-error-primary);margin-top:6px;font-size:10px;line-height:14px}"
 		].join("");
 		const tagId = "@kidli1412/dsh-token-heatmap/TokenHeatmap.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
@@ -162,12 +169,14 @@ window.__ModuleLoader__.load({
 			gear: "thm_gear",
 			settingsPanel: "thm_panel",
 			panelHead: "thm_panelHead",
-			panelTitle: "thm_panelTitle",
-			panelClose: "thm_panelClose",
+			panelTitleLabel: "thm_panelTitleLabel",
+			panelRule: "thm_panelRule",
+			panelFoot: "thm_panelFoot",
+			footLegend: "thm_footLegend",
+			footRule: "thm_footRule",
+			footError: "thm_footError",
 			settingsGroup: "thm_group",
 			settingsGroupLabel: "thm_groupLabel",
-			settingsHint: "thm_hint",
-			settingsHintError: "thm_hintError",
 			settingsSwatches: "thm_swatches",
 			settingsSwatch: "thm_swatch",
 			settingsSwatchCells: "thm_swatchCells",
@@ -217,7 +226,7 @@ window.__ModuleLoader__.load({
 			settingsRed: "红色",
 			settingsPurple: "紫色",
 			settingsTeal: "青色",
-			settingsPaletteHint: "颜色按每天 token 数的绝对阈值分档：{levels}。",
+			settingsThresholdNote: "颜色按每天 token 数的绝对阈值分档（悬停图例看各档范围）。",
 			settingsSaveFailed: "保存失败，已回到服务端的值，请重试。",
 			settingsExpand: "展开设置",
 			settingsCollapse: "收起设置"
@@ -258,7 +267,7 @@ window.__ModuleLoader__.load({
 			settingsRed: "Red",
 			settingsPurple: "Purple",
 			settingsTeal: "Teal",
-			settingsPaletteHint: "Colors follow absolute per-day token thresholds: {levels}.",
+			settingsThresholdNote: "Colors follow absolute per-day token thresholds (hover the legend for each range).",
 			settingsSaveFailed: "Save failed; the server value was restored.",
 			settingsExpand: "Show settings",
 			settingsCollapse: "Hide settings"
@@ -606,16 +615,30 @@ window.__ModuleLoader__.load({
 			// Month-view cursor (`YYYY-MM`); initialised from the current month
 			// and re-anchored when it would fall outside the navigable bounds.
 			const [monthCursor, setMonthCursor] = react.useState(() => monthKey(Date.now()));
-			// In-card settings panel (⚙ at the row's right end); the card
-			// configures itself here instead of living in 设置 → 插件 → 插件配置.
+			// The ⚙ at the row's right end opens the floating settings panel;
+			// the card configures itself here instead of living in
+			// 设置 → 插件 → 插件配置. The panel is PORTALED to document.body and
+			// anchored to this button, so the open state lives here with it.
+			const gearRef = react.useRef(null);
 			const [settingsOpen, setSettingsOpen] = react.useState(false);
 			react.useEffect(() => {
 				if (!settingsOpen) return;
 				const onKeyDown = (event) => {
 					if (event.key === "Escape") setSettingsOpen(false);
 				};
+				const onPointerDown = (event) => {
+					const gear = gearRef.current;
+					if (gear !== null && gear.contains(event.target)) return;
+					const panel = document.querySelector(`.${S.settingsPanel}`);
+					if (panel !== null && panel.contains(event.target)) return;
+					setSettingsOpen(false);
+				};
 				document.addEventListener("keydown", onKeyDown);
-				return () => document.removeEventListener("keydown", onKeyDown);
+				document.addEventListener("pointerdown", onPointerDown, true);
+				return () => {
+					document.removeEventListener("keydown", onKeyDown);
+					document.removeEventListener("pointerdown", onPointerDown, true);
+				};
 			}, [settingsOpen]);
 			const loaderRef = react.useRef(null);
 			if (loaderRef.current === null) loaderRef.current = createLoader();
@@ -805,16 +828,19 @@ window.__ModuleLoader__.load({
 									onClick: load,
 									children: dict("refresh")
 								}),
-								// The setting button owns the row's right end; the ‹ ›
-								// stepper and the view switch sit left of it, the
-								// stepper next to the stats it moves through.
+								// The ⚙ owns the row's right end; the ‹ › stepper
+								// and the view switch sit left of it, the stepper
+								// next to the stats it moves through. This button is
+								// also the settings panel's anchor.
 								react_jsx_runtime.jsx("button", {
 									type: "button",
+									ref: gearRef,
 									className: S.gear,
 									"data-active": settingsOpen,
+									"aria-haspopup": "dialog",
 									"aria-expanded": settingsOpen,
-									"aria-label": dict("settingsTitle"),
-									title: dict("settingsTitle"),
+									"aria-label": dict(settingsOpen ? "settingsCollapse" : "settingsExpand"),
+									title: dict(settingsOpen ? "settingsCollapse" : "settingsExpand"),
 									onClick: () => setSettingsOpen(!settingsOpen),
 									children: react_jsx_runtime.jsx("svg", {
 										width: 14,
@@ -933,6 +959,8 @@ window.__ModuleLoader__.load({
 							store: configStore,
 							palette,
 							translate,
+							legend: levelLegend,
+							anchor: gearRef.current,
 							onClose: () => setSettingsOpen(false)
 						}) : null
 					]
@@ -948,10 +976,45 @@ window.__ModuleLoader__.load({
 		//#endregion
 
 		//#region TokenHeatmapInlineSettings
+		/** Distance between the ⚙ and the panel's bottom edge (native dialog spec). */
+		const PANEL_GAP = 8;
+		/** Viewport margin the placement clamp keeps (native dialog spec). */
+		const PANEL_MARGIN = 12;
+
+		/**
+		 * Place the floating panel above its ⚙ trigger, clamped to the viewport —
+		 * the same measure-then-place flow (and the same 8px gap / 12px margin)
+		 * the built-in stat dialogs use. The panel is `position:fixed` and lives
+		 * in `document.body`, so the card can never clip it.
+		 * @param trigger - the ⚙ button the panel is anchored to.
+		 * @param panel - the `position:fixed` panel element.
+		 */
+		function placePanel(trigger, panel) {
+			const anchor = trigger.getBoundingClientRect();
+			const width = panel.offsetWidth;
+			const height = panel.offsetHeight;
+			if (width === 0 || height === 0) return;
+			const viewportWidth = window.innerWidth;
+			const viewportHeight = window.innerHeight;
+			const left = Math.min(
+				Math.max(PANEL_MARGIN, anchor.left + anchor.width / 2 - width / 2),
+				Math.max(PANEL_MARGIN, viewportWidth - width - PANEL_MARGIN)
+			);
+			let top = anchor.top - height - PANEL_GAP;
+			if (top < PANEL_MARGIN) top = Math.min(anchor.bottom + PANEL_GAP, viewportHeight - height - PANEL_MARGIN);
+			panel.style.left = `${Math.round(left)}px`;
+			panel.style.top = `${Math.round(Math.max(PANEL_MARGIN, top))}px`;
+			panel.style.visibility = "visible";
+		}
+
 		/**
-		 * The card's own settings panel: 配色方案 and 默认视图, edited where the
-		 * card lives instead of inside 设置 → 插件 → 插件配置 (this plugin no
-		 * longer registers into the `settings.plugin.item` seat).
+		 * The card's settings panel: 配色方案 and 默认视图, edited from the card
+		 * itself instead of inside 设置 → 插件 → 插件配置 (this plugin no longer
+		 * registers into the `settings.plugin.item` seat).
+		 *
+		 * It is PORTALED to `document.body` (the card's own box can never clip
+		 * it) and anchored to the ⚙ through `anchor`; the owner closes it on
+		 * outside pointerdown and Escape, so this component only draws.
 		 *
 		 * Every control applies immediately through the bound settings scope —
 		 * there is no draft/save step, so the component owns only a local save
@@ -964,9 +1027,12 @@ window.__ModuleLoader__.load({
 		 * @param props.store - config store (set writes through the scope).
 		 * @param props.palette - active palette (level 0..4 → css color).
 		 * @param props.translate - interpolation helper for translated labels.
-		 * @param props.onClose - collapse the panel (the × button).
+		 * @param props.legend - level labels for the palette footnote.
+		 * @param props.anchor - the ⚙ button the panel is placed against.
+		 * @param props.onClose - collapse the panel.
 		 */
-		function TokenHeatmapInlineSettings({ dict, config, store, palette, translate, onClose }) {
+		function TokenHeatmapInlineSettings({ dict, config, store, palette, translate, legend, anchor, onClose }) {
+			const panelRef = react.useRef(null);
 			const [saveFailed, setSaveFailed] = react.useState(false);
 			const schemes = Object.keys(COLOR_SCHEMES);
 			// Optimistic local echo: the settings scope only reports the new value
@@ -974,6 +1040,26 @@ window.__ModuleLoader__.load({
 			const [pending, setPending] = react.useState({});
 			const scheme = pending.colorScheme ?? config.colorScheme;
 			const defaultView = pending.defaultView ?? config.defaultView;
+			// Place before paint (and again when the palette reflows the panel):
+			// the trigger's box is only meaningful once the card is laid out.
+			react.useLayoutEffect(() => {
+				const panel = panelRef.current;
+				if (panel === null || anchor === null || anchor === void 0) return;
+				placePanel(anchor, panel);
+			});
+			react.useEffect(() => {
+				const replace = () => {
+					const panel = panelRef.current;
+					if (panel === null || anchor === null || anchor === void 0) return;
+					placePanel(anchor, panel);
+				};
+				window.addEventListener("resize", replace);
+				window.addEventListener("scroll", replace, true);
+				return () => {
+					window.removeEventListener("resize", replace);
+					window.removeEventListener("scroll", replace, true);
+				};
+			}, [anchor]);
 			const commit = async (patch) => {
 				setPending((current) => ({ ...current, ...patch }));
 				setSaveFailed(false);
@@ -990,28 +1076,43 @@ window.__ModuleLoader__.load({
 				if (value !== defaultView) commit({ defaultView: value });
 			};
 			const labelOf = (name) => dict(`settings${name[0].toUpperCase()}${name.slice(1)}`);
-			return react_jsx_runtime.jsxs("div", {
+			const title = dict("settingsTitle");
+			const panel = react_jsx_runtime.jsxs("div", {
+				ref: panelRef,
 				className: S.settingsPanel,
-				// Escape and "focus left the panel" both collapse it, so the
-				// panel never lingers behind an unrelated interaction.
-				onBlur: (event) => {
-					if (!event.currentTarget.contains(event.relatedTarget)) onClose();
-				},
+				role: "dialog",
+				"aria-label": title,
+				// Nothing may paint at the viewport origin before placement runs.
+				style: { visibility: "hidden" },
 				children: [
 					react_jsx_runtime.jsxs("div", {
 						className: S.panelHead,
 						children: [
-							react_jsx_runtime.jsx("span", { className: S.panelTitle, children: dict("settingsTitle") }),
-							react_jsx_runtime.jsx("button", {
-								type: "button",
-								className: S.panelClose,
-								"aria-label": dict("settingsCollapse"),
-								title: dict("settingsCollapse"),
-								onClick: onClose,
-								children: "\u00d7"
+							react_jsx_runtime.jsxs("span", {
+								className: S.panelTitleLabel,
+								children: [
+									react_jsx_runtime.jsxs("svg", {
+										width: 14,
+										height: 14,
+										viewBox: "0 0 24 24",
+										fill: "none",
+										stroke: "currentColor",
+										"stroke-width": 2,
+										"stroke-linecap": "round",
+										"stroke-linejoin": "round",
+										"aria-hidden": "true",
+										children: [
+											react_jsx_runtime.jsx("circle", { cx: 12, cy: 12, r: 9 }),
+											react_jsx_runtime.jsx("path", { d: "M12 11v5" }),
+											react_jsx_runtime.jsx("path", { d: "M12 8h.01" })
+										]
+									}),
+									react_jsx_runtime.jsx("span", { children: title })
+								]
 							})
 						]
 					}),
+					react_jsx_runtime.jsx("div", { className: S.panelRule, "aria-hidden": "true" }),
 					react_jsx_runtime.jsxs("div", {
 						className: S.settingsGroup,
 						children: [
@@ -1058,21 +1159,36 @@ window.__ModuleLoader__.load({
 									onClick: () => chooseView(mode),
 									children: dict(mode === "month" ? "viewMonth" : "viewYear")
 								}, mode))
-							}),
-							react_jsx_runtime.jsx("span", {
-								className: S.settingsHint,
-								children: dict("settingsDefaultViewHint")
 							})
 						]
 					}),
-					react_jsx_runtime.jsx("span", {
-						className: saveFailed ? `${S.settingsHint} ${S.settingsHintError}` : S.settingsHint,
-						children: saveFailed
-							? dict("settingsSaveFailed")
-							: translate("settingsPaletteHint", { levels: uiDict().levelLegend.join(" / ") })
+					react_jsx_runtime.jsxs("div", {
+						className: S.panelFoot,
+						children: [
+							react_jsx_runtime.jsxs("div", {
+								className: S.footLegend,
+								children: [
+									dict("less"),
+									...palette.map((color, level) => react_jsx_runtime.jsx("span", {
+										className: S.legendCell,
+										style: { background: color },
+										title: legend[level] ?? ""
+									}, `foot-${level}`)),
+									dict("more")
+								]
+							}),
+							saveFailed ? react_jsx_runtime.jsx("div", {
+								className: S.footError,
+								children: dict("settingsSaveFailed")
+							}) : react_jsx_runtime.jsx("div", {
+								className: S.footRule,
+								children: dict("settingsThresholdNote")
+							})
+						]
 					})
 				]
 			});
+			return reactDom.createPortal(panel, document.body);
 		}
 		//#endregion
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kidli1412/dsh-token-heatmap",
-  "version": "0.4.1",
-  "description": "DSH web plugin: GitHub-style daily token-usage heatmap on the new-session screen with switchable year/month views and six color schemes. The card configures itself (⚙ palette + default view) — no DSH settings card — and shows today / this-month / all-time totals.",
+  "version": "0.4.2",
+  "description": "DSH web plugin: GitHub-style daily token-usage heatmap on the new-session screen with switchable year/month views and six color schemes. The card configures itself through a floating ⚙ panel (palette + default view) — no DSH settings card — and shows today / this-month / all-time totals.",
   "type": "module",
   "main": "lib/index.js",
   "exports": {