@hansenexus/hud 0.1.0 → 0.2.0

package/package.json

@@ -1,153 +1,62 @@
 {
   "name": "@hansenexus/hud",
-  "version": "0.1.0",
-  "description": "Dev HUD for React apps: drawer, panels, capability-gated access.",
+  "version": "0.2.0",
+  "description": "Modular dev HUD for React apps: status pill, floating panels, element grabber, plugin API.",
   "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hansenexus/hud.git"
+  },
+  "workspaces": [
+    ".",
+    "playground"
+  ],
   "files": [
-    "**/*.js",
-    "**/*.d.mts",
+    "dist",
     "README.md",
     "LICENSE"
   ],
-  "type": "module",
-  "sideEffects": false,
   "exports": {
     ".": {
-      "types": "./index.d.mts",
-      "import": "./index.js"
-    },
-    "./hud": {
-      "types": "./hud.d.mts",
-      "import": "./hud.js"
-    },
-    "./hud-provider": {
-      "types": "./hud-provider.d.mts",
-      "import": "./hud-provider.js"
-    },
-    "./lazy-panel": {
-      "types": "./lazy-panel.d.mts",
-      "import": "./lazy-panel.js"
-    },
-    "./state-boundary": {
-      "types": "./state-boundary.d.mts",
-      "import": "./state-boundary.js"
-    },
-    "./core/mock-cookie": {
-      "types": "./core/mock-cookie.d.mts",
-      "import": "./core/mock-cookie.js"
-    },
-    "./core/api-types": {
-      "types": "./core/api-types.d.mts",
-      "import": "./core/api-types.js"
-    },
-    "./core/capabilities": {
-      "types": "./core/capabilities.d.mts",
-      "import": "./core/capabilities.js"
-    },
-    "./core/capture-buffer": {
-      "types": "./core/capture-buffer.d.mts",
-      "import": "./core/capture-buffer.js"
-    },
-    "./core/types": {
-      "types": "./core/types.d.mts",
-      "import": "./core/types.js"
-    },
-    "./core/access": {
-      "types": "./core/access.d.mts",
-      "import": "./core/access.js"
-    },
-    "./core/force-state": {
-      "types": "./core/force-state.d.mts",
-      "import": "./core/force-state.js"
-    },
-    "./panels/tokens-panel": {
-      "types": "./panels/tokens-panel.d.mts",
-      "import": "./panels/tokens-panel.js"
-    },
-    "./panels/force-state-panel": {
-      "types": "./panels/force-state-panel.d.mts",
-      "import": "./panels/force-state-panel.js"
-    },
-    "./panels/role-switcher-panel": {
-      "types": "./panels/role-switcher-panel.d.mts",
-      "import": "./panels/role-switcher-panel.js"
-    },
-    "./panels/debug-info-panel": {
-      "types": "./panels/debug-info-panel.d.mts",
-      "import": "./panels/debug-info-panel.js"
-    },
-    "./panels/sessions-panel": {
-      "types": "./panels/sessions-panel.d.mts",
-      "import": "./panels/sessions-panel.js"
-    },
-    "./panels/network-console-panel": {
-      "types": "./panels/network-console-panel.d.mts",
-      "import": "./panels/network-console-panel.js"
-    },
-    "./panels/feature-flags-panel": {
-      "types": "./panels/feature-flags-panel.d.mts",
-      "import": "./panels/feature-flags-panel.js"
-    },
-    "./panels/mock-seed-panel": {
-      "types": "./panels/mock-seed-panel.d.mts",
-      "import": "./panels/mock-seed-panel.js"
-    },
-    "./panels/vitals-panel": {
-      "types": "./panels/vitals-panel.d.mts",
-      "import": "./panels/vitals-panel.js"
-    },
-    "./panels/info-row": {
-      "types": "./panels/info-row.d.mts",
-      "import": "./panels/info-row.js"
-    },
-    "./panels/cicd-panel": {
-      "types": "./panels/cicd-panel.d.mts",
-      "import": "./panels/cicd-panel.js"
-    },
-    "./panels/variants-panel": {
-      "types": "./panels/variants-panel.d.mts",
-      "import": "./panels/variants-panel.js"
-    },
-    "./panels/unlock-panel": {
-      "types": "./panels/unlock-panel.d.mts",
-      "import": "./panels/unlock-panel.js"
-    },
-    "./panels/env-info-panel": {
-      "types": "./panels/env-info-panel.d.mts",
-      "import": "./panels/env-info-panel.js"
-    },
-    "./panels/dispatch-panel": {
-      "types": "./panels/dispatch-panel.d.mts",
-      "import": "./panels/dispatch-panel.js"
-    },
-    "./server/guard": {
-      "types": "./server/guard.d.mts",
-      "import": "./server/guard.js"
-    },
-    "./server/unlock": {
-      "types": "./server/unlock.d.mts",
-      "import": "./server/unlock.js"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
     }
   },
+  "sideEffects": false,
+  "scripts": {
+    "dev": "bun run --cwd playground dev",
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check .",
+    "format": "biome check --write .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "check": "bun run lint && bun run typecheck && bun run test && bun run build && bun run check:pack",
+    "changeset": "changeset",
+    "version-packages": "changeset version",
+    "check:pack": "bun scripts/check-pack.ts"
+  },
   "dependencies": {
-    "@radix-ui/react-slot": "^1.2.4",
-    "@radix-ui/react-switch": "^1.2.6",
-    "@radix-ui/react-tooltip": "^1.2.8",
-    "class-variance-authority": "^0.7.1",
-    "clsx": "^2.1.1",
-    "lucide-react": "^0.563.0",
-    "motion": "^12.29.2",
-    "tailwind-merge": "^3.4.0",
-    "web-vitals": "^5.2.0"
+    "web-vitals": "^6.2.3"
   },
   "peerDependencies": {
-    "next": ">=15",
-    "react": "^19.2.0",
-    "react-dom": "^19.2.0"
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
   },
-  "peerDependenciesMeta": {
-    "next": {
-      "optional": true
-    }
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.15",
+    "@changesets/changelog-github": "^1.0.1",
+    "@changesets/cli": "^3.0.3",
+    "@testing-library/react": "^16.3.3",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "jsdom": "^30.1.2",
+    "tsdown": "^0.23.0",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.3"
+  },
+  "publishConfig": {
+    "access": "public"
   }
 }

package/chunk-0cj8dkk7.js

@@ -1,127 +0,0 @@
-import {
-  useHud
-} from "./chunk-wspz08q7.js";
-import {
-  InfoRow,
-  PanelSection,
-  ShortcutRow
-} from "./chunk-kyeb6qeq.js";
-import {
-  Badge
-} from "./chunk-xztw0xyt.js";
-import {
-  CAPABILITY_MATRIX
-} from "./chunk-babjpqkb.js";
-import {
-  HUD_CAPABILITIES
-} from "./chunk-v086j53b.js";
-
-// panels/env-info-panel.tsx
-import { Boxes, Info, Monitor, ShieldCheck } from "lucide-react";
-import { version as reactVersion } from "react";
-import { jsx, jsxs } from "react/jsx-runtime";
-"use client";
-function EnvInfoPanel() {
-  const { config, env, can } = useHud();
-  return /* @__PURE__ */ jsxs("div", {
-    className: "space-y-4",
-    children: [
-      /* @__PURE__ */ jsxs(PanelSection, {
-        icon: Boxes,
-        title: "App",
-        children: [
-          /* @__PURE__ */ jsx(InfoRow, {
-            label: "App",
-            value: config.appSlug
-          }),
-          /* @__PURE__ */ jsxs("div", {
-            className: "flex items-center justify-between px-2 py-1",
-            children: [
-              /* @__PURE__ */ jsx("span", {
-                className: "text-[10px] text-muted-foreground",
-                children: "hud env"
-              }),
-              /* @__PURE__ */ jsx(Badge, {
-                variant: "outline",
-                className: "h-4 px-1.5 font-mono text-[10px] uppercase",
-                children: env
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsx(InfoRow, {
-            label: "Origin",
-            value: typeof window !== "undefined" ? window.location.origin : "—",
-            copyable: true
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsxs(PanelSection, {
-        icon: Monitor,
-        title: "Build",
-        children: [
-          /* @__PURE__ */ jsx(InfoRow, {
-            label: "NODE_ENV",
-            value: "production"
-          }),
-          /* @__PURE__ */ jsx(InfoRow, {
-            label: "React",
-            value: reactVersion
-          }),
-          /* @__PURE__ */ jsx(InfoRow, {
-            label: "Convex URL",
-            value: process.env.NEXT_PUBLIC_CONVEX_URL ?? "not set",
-            copyable: true
-          }),
-          /* @__PURE__ */ jsx(InfoRow, {
-            label: "App URL",
-            value: process.env.NEXT_PUBLIC_APP_URL ?? "not set"
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsxs(PanelSection, {
-        icon: ShieldCheck,
-        title: `Capabilities · ${env}`,
-        children: [
-          /* @__PURE__ */ jsx("div", {
-            className: "grid grid-cols-2 gap-x-4",
-            children: HUD_CAPABILITIES.map((capability) => {
-              const granted = can(capability);
-              return /* @__PURE__ */ jsxs("div", {
-                className: "flex items-center justify-between px-2 py-0.5",
-                title: granted ? undefined : `denied in ${env} (see CAPABILITY_MATRIX in core/capabilities.ts)`,
-                children: [
-                  /* @__PURE__ */ jsx("span", {
-                    className: `font-mono text-[10px] ${granted ? "" : "text-muted-foreground/50 line-through"}`,
-                    children: capability
-                  }),
-                  /* @__PURE__ */ jsx("span", {
-                    className: `h-1.5 w-1.5 rounded-full ${granted ? "bg-emerald-500" : "bg-muted-foreground/20"}`
-                  })
-                ]
-              }, capability);
-            })
-          }),
-          /* @__PURE__ */ jsxs("p", {
-            className: "px-2 text-[10px] text-muted-foreground/60",
-            children: [
-              CAPABILITY_MATRIX[env].length,
-              "/",
-              HUD_CAPABILITIES.length,
-              " granted — default deny, server routes re-check independently."
-            ]
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsx(PanelSection, {
-        icon: Info,
-        title: "Shortcuts",
-        children: /* @__PURE__ */ jsx(ShortcutRow, {
-          keys: ["⌘", "⇧", "H"],
-          label: "Toggle hud"
-        })
-      })
-    ]
-  });
-}
-
-export { EnvInfoPanel };

package/chunk-1atxwdhw.js

@@ -1,48 +0,0 @@
-import {
-  HUD_UNLOCK_COOKIE,
-  hudRequiresUnlock,
-  hudUnlockTtlMs,
-  readCookie,
-  resolveHudAccess,
-  verifyHudUnlockToken
-} from "./chunk-r06bpmy6.js";
-import {
-  hasCapability,
-  isHudVisible,
-  resolveHudEnv
-} from "./chunk-babjpqkb.js";
-
-// server/guard.ts
-async function checkHudRequest(request, capability) {
-  const env = resolveHudEnv();
-  if (!isHudVisible(env)) {
-    return { ok: false, status: 404, error: "not found" };
-  }
-  if (!hasCapability(env, capability)) {
-    return { ok: false, status: 403, error: `capability ${capability} is denied in ${env}` };
-  }
-  const access = resolveHudAccess(env);
-  if (!hudRequiresUnlock(access)) {
-    return { ok: true, env };
-  }
-  const password = process.env.HUD_ACCESS_PASSWORD;
-  if (!password) {
-    return { ok: false, status: 401, error: "hud unlock is not configured" };
-  }
-  const token = readCookie(request.headers.get("cookie"), HUD_UNLOCK_COOKIE);
-  const unlocked = await verifyHudUnlockToken(token, password, { ttlMs: hudUnlockTtlMs(access) });
-  if (!unlocked) {
-    return { ok: false, status: 401, error: "hud is locked" };
-  }
-  return { ok: true, env };
-}
-async function isHudRequestUnlocked(request) {
-  const access = resolveHudAccess();
-  if (!hudRequiresUnlock(access))
-    return true;
-  const password = process.env.HUD_ACCESS_PASSWORD;
-  const token = readCookie(request.headers.get("cookie"), HUD_UNLOCK_COOKIE);
-  return verifyHudUnlockToken(token, password, { ttlMs: hudUnlockTtlMs(access) });
-}
-
-export { checkHudRequest, isHudRequestUnlocked };

package/chunk-24vrg16w.js

@@ -1,39 +0,0 @@
-// core/capture-buffer.ts
-class CaptureBuffer {
-  entries = [];
-  snapshot = [];
-  listeners = new Set;
-  nextId = 1;
-  maxEntries;
-  constructor(maxEntries = 500) {
-    this.maxEntries = maxEntries;
-  }
-  push(input) {
-    const entry = { id: this.nextId++, ts: Date.now(), ...input };
-    this.entries.push(entry);
-    if (this.entries.length > this.maxEntries) {
-      this.entries.splice(0, this.entries.length - this.maxEntries);
-    }
-    this.emit();
-    return entry;
-  }
-  clear() {
-    if (this.entries.length === 0)
-      return;
-    this.entries = [];
-    this.emit();
-  }
-  getSnapshot = () => this.snapshot;
-  subscribe = (listener) => {
-    this.listeners.add(listener);
-    return () => this.listeners.delete(listener);
-  };
-  emit() {
-    this.snapshot = [...this.entries];
-    for (const listener of this.listeners)
-      listener();
-  }
-}
-var captureBuffer = new CaptureBuffer(500);
-
-export { CaptureBuffer, captureBuffer };

package/chunk-3j9sm249.js

@@ -1,26 +0,0 @@
-import {
-  LoadingSpinner
-} from "./chunk-kyeb6qeq.js";
-import {
-  hasCapability,
-  resolveHudEnv
-} from "./chunk-babjpqkb.js";
-
-// lazy-panel.tsx
-import { lazy, Suspense } from "react";
-import { jsx } from "react/jsx-runtime";
-"use client";
-function hudLazyPanel(meta, load, env = resolveHudEnv()) {
-  if (!hasCapability(env, meta.capability))
-    return null;
-  const Panel = lazy(async () => ({ default: await load() }));
-  return {
-    ...meta,
-    content: /* @__PURE__ */ jsx(Suspense, {
-      fallback: /* @__PURE__ */ jsx(LoadingSpinner, {}),
-      children: /* @__PURE__ */ jsx(Panel, {})
-    })
-  };
-}
-
-export { hudLazyPanel };

package/chunk-50pq4sg6.js

@@ -1,41 +0,0 @@
-// bridge-client.ts
-var cached;
-async function getBridgeInfo(apiBase) {
-  if (cached !== undefined)
-    return cached;
-  try {
-    const res = await fetch(`${apiBase}/bridge-info`, {
-      headers: { "x-hud-internal": "1" }
-    });
-    if (!res.ok) {
-      cached = null;
-      return null;
-    }
-    const info = await res.json();
-    const health = await fetch(`http://127.0.0.1:${info.port}/health`, {
-      headers: { "x-hud-internal": "1" },
-      signal: AbortSignal.timeout(1500)
-    }).catch(() => null);
-    cached = health?.ok ? info : null;
-    return cached;
-  } catch {
-    cached = null;
-    return null;
-  }
-}
-function resetBridgeInfo() {
-  cached = undefined;
-}
-async function bridgeFetch(info, path, init) {
-  return fetch(`http://127.0.0.1:${info.port}${path}`, {
-    ...init,
-    headers: {
-      ...init?.headers,
-      Authorization: `Bearer ${info.token}`,
-      "x-hud-internal": "1",
-      ...init?.body ? { "Content-Type": "application/json" } : {}
-    }
-  });
-}
-
-export { getBridgeInfo, resetBridgeInfo, bridgeFetch };

package/chunk-5gtx3pza.js

@@ -1,9 +0,0 @@
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined")
-    return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-
-export { __require };