@hansenexus/hud 0.1.1 → 0.3.0

package/core/api-types.d.mts

@@ -1,146 +0,0 @@
-/**
- * Response shapes of the hud hub routes (served by console under /api/hud/*,
- * thin proxies over console's src/lib clients — see the hud architecture
- * decision). Shared so panels and routes cannot drift apart.
- */
-interface HudSignozResponse {
-    ok: boolean;
-    service: string;
-    range: string;
-    /** "mock" when SIGNOZ_QUERY_URL is unset — the client generates demo data. */
-    source: "signoz" | "mock";
-    errorRate: number | null;
-    p95Latency: number | null;
-    requestCount: number | null;
-}
-interface HudCicdRun {
-    id: number;
-    name: string;
-    title: string;
-    status: string;
-    conclusion?: string | null;
-    branch?: string;
-    sha?: string;
-    url?: string;
-    startedAt?: string;
-    source: "github";
-}
-interface HudCicdDeployed {
-    image: string;
-    /** Prod image tags are the deployed commit sha (deploy-production.yml). */
-    sha: string;
-    lastGoodTag?: string;
-    ready: string;
-}
-interface HudCicdResponse {
-    ok: boolean;
-    app: string;
-    /** null when no deployment exists for the app (e.g. deploy: false apps). */
-    deployed: HudCicdDeployed | null;
-    runs: HudCicdRun[];
-    githubUnconfigured?: boolean;
-}
-/** Grabbed-element anchor — same shape as console's designReviewComments anchor. */
-interface HudAnchor {
-    selector: string;
-    label: string;
-    /** Rect in viewport percentages, so it survives viewport changes. */
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-}
-interface HudComponentHint {
-    name: string;
-    path: string;
-}
-interface HudDispatchPayload {
-    app: string;
-    env: string;
-    route: string;
-    anchor: HudAnchor;
-    /** Best-effort source guesses (route manifest / component manifest). */
-    componentHints: HudComponentHint[];
-    /** Tail of captured console warns/errors — PII-scrubbed by truncation. */
-    recentErrors: string[];
-    vitals: Record<string, number>;
-    grabbedAt: string;
-}
-type HudDispatchTarget = "docket" | "queue" | "hermes";
-interface HudDispatchRequest {
-    target: HudDispatchTarget;
-    note: string;
-    payload: HudDispatchPayload;
-}
-/**
- * A plain work order, no HUD grab attached (#424 PR3). This is what the
- * kommandant desktop cockpit sends: a board card (or a hand-typed form)
- * becomes a docket dispatch without any DOM anchor to point at. Always goes
- * through docket; there is no queue fallback for orders.
- */
-interface HudOrderDispatchRequest {
-    target: "docket";
-    order: {
-        title: string;
-        app?: string;
-        /** Comma-free strings — the docket CLI's `--criteria` splits on commas. */
-        criteria?: string[];
-        /** Extra context, written into the run dir as prompt.md. */
-        prompt?: string;
-        /** Forge issue to link: order links.issue + draft PR `Closes #N`. */
-        issue?: number;
-        /** Also spawn the headless agent. Default false: a human drives. */
-        agent?: boolean;
-    };
-}
-type HudDispatchBody = HudDispatchRequest | HudOrderDispatchRequest;
-declare function isOrderDispatch(body: HudDispatchBody): body is HudOrderDispatchRequest;
-interface HudDispatchResponse {
-    ok: boolean;
-    target: HudDispatchTarget;
-    /** docket run id, when target=docket. */
-    runId?: string;
-    /** repo-relative queue marker path, when target=queue. */
-    markerPath?: string;
-    error?: string;
-}
-interface HudBridgeInfo {
-    port: number;
-    token: string;
-}
-interface HudSessionInfo {
-    sessionId: string;
-    name?: string;
-    branch?: string;
-    toplevel?: string;
-    kind?: string;
-    /** Seconds since the registry file's mtime — the liveness signal. */
-    idleSeconds: number;
-    startedAt?: string;
-}
-/** One app-provided seed action, offered as a button in the mock/seed panel. */
-interface HudSeedDescriptor {
-    id: string;
-    label: string;
-    /** Convex function ref, `module:fn` (subdirs as `dir/module:fn`). */
-    fn: string;
-    args?: Record<string, unknown>;
-    /** Append `--local` (app runs a local `convex dev --local` backend). */
-    local?: boolean;
-    description?: string;
-}
-interface HudSeedRequest {
-    app: string;
-    fn: string;
-    args?: Record<string, unknown>;
-    local?: boolean;
-}
-interface HudSeedResponse {
-    ok: boolean;
-    fn: string;
-    /** Trimmed tail of the convex CLI output. */
-    output?: string;
-    error?: string;
-}
-
-export { type HudAnchor, type HudBridgeInfo, type HudCicdDeployed, type HudCicdResponse, type HudCicdRun, type HudComponentHint, type HudDispatchBody, type HudDispatchPayload, type HudDispatchRequest, type HudDispatchResponse, type HudDispatchTarget, type HudOrderDispatchRequest, type HudSeedDescriptor, type HudSeedRequest, type HudSeedResponse, type HudSessionInfo, type HudSignozResponse, isOrderDispatch };

package/core/api-types.js

@@ -1,9 +0,0 @@
-import"../chunk-5gtx3pza.js";
-
-// core/api-types.ts
-function isOrderDispatch(body) {
-  return "order" in body && typeof body.order?.title === "string";
-}
-export {
-  isOrderDispatch
-};

package/core/capabilities.d.mts

@@ -1,27 +0,0 @@
-import { HudEnv, HudCapability } from './types.mjs';
-import 'lucide-react';
-import 'react';
-
-/**
- * Default-deny capability matrix (see the hud plan). Client-side filtering is
- * convenience only — every server route re-checks its env, and estate calls
- * are additionally scoped by the console hub's token. Staging's
- * `auth.impersonate` is further flag-gated server-side.
- */
-declare const CAPABILITY_MATRIX: Record<HudEnv, readonly HudCapability[]>;
-/**
- * Env ladder, following `resolveDevRoutesAccess()` in @hn-monorepo/dev-routes:
- * explicit kill switch → NODE_ENV (inlined by Next, so prod bundles tree-shake
- * the dev branch) → explicit NEXT_PUBLIC_HUD_ENV (k8s overlays; k3s has no
- * VERCEL_ENV) → VERCEL_ENV heuristic → production.
- */
-declare function resolveHudEnv(): HudEnv;
-/**
- * Whether the hud renders at all. Outside development this requires the
- * explicit opt-in flag — deployed envs get the hud only when their overlay
- * turns it on (staging/preview in M6, production read-only in M7).
- */
-declare function isHudVisible(env?: HudEnv): boolean;
-declare function hasCapability(env: HudEnv, capability: HudCapability): boolean;
-
-export { CAPABILITY_MATRIX, hasCapability, isHudVisible, resolveHudEnv };

package/core/capabilities.js

@@ -1,14 +0,0 @@
-import {
-  CAPABILITY_MATRIX,
-  hasCapability,
-  isHudVisible,
-  resolveHudEnv
-} from "../chunk-vjh0d29g.js";
-import"../chunk-v086j53b.js";
-import"../chunk-5gtx3pza.js";
-export {
-  resolveHudEnv,
-  isHudVisible,
-  hasCapability,
-  CAPABILITY_MATRIX
-};

package/core/capture-buffer.d.mts

@@ -1,37 +0,0 @@
-type CaptureKind = "log" | "warn" | "error" | "fetch" | "longtask";
-interface CaptureEntry {
-    id: number;
-    ts: number;
-    kind: CaptureKind;
-    text: string;
-    status?: number;
-    durationMs?: number;
-}
-interface CaptureEntryInput {
-    kind: CaptureKind;
-    text: string;
-    status?: number;
-    durationMs?: number;
-}
-/**
- * Fixed-size ring buffer with a referentially-stable snapshot, shaped for
- * `useSyncExternalStore`: the snapshot array is replaced on every mutation
- * and reused between mutations.
- */
-declare class CaptureBuffer {
-    private entries;
-    private snapshot;
-    private listeners;
-    private nextId;
-    private readonly maxEntries;
-    constructor(maxEntries?: number);
-    push(input: CaptureEntryInput): CaptureEntry;
-    clear(): void;
-    getSnapshot: () => readonly CaptureEntry[];
-    subscribe: (listener: () => void) => (() => void);
-    private emit;
-}
-/** Shared buffer the capture patches write into and the net panel reads from. */
-declare const captureBuffer: CaptureBuffer;
-
-export { CaptureBuffer, type CaptureEntry, type CaptureEntryInput, type CaptureKind, captureBuffer };

package/core/capture-buffer.js

@@ -1,9 +0,0 @@
-import {
-  CaptureBuffer,
-  captureBuffer
-} from "../chunk-24vrg16w.js";
-import"../chunk-5gtx3pza.js";
-export {
-  captureBuffer,
-  CaptureBuffer
-};

package/core/force-state.d.mts

@@ -1,68 +0,0 @@
-/**
- * Force-state store: lets a reviewer (HUD panel) or an agent (`?__state=`)
- * render any registered state boundary as loading, empty or error without
- * faking data (PRD #2110, issue #2117).
- *
- * Development only. The only importer outside the hud is `state-boundary.tsx`,
- * which reaches this module behind a `NODE_ENV === "development"` constant, so
- * production builds drop it; `scripts/ci/assert-no-hud-in-bundle.sh` greps the
- * client chunks for FORCE_STATE_MARKER to prove it.
- */
-declare const FORCED_STATES: readonly ["loading", "empty", "error"];
-type ForcedState = (typeof FORCED_STATES)[number];
-/** `?__state=loading` forces top-level boundaries; `?__state=<id>:error` one boundary. */
-declare const FORCE_STATE_PARAM = "__state";
-/**
- * globalThis key of the store singleton, and the bundle-gate marker. Holding
- * the store on globalThis keeps one instance even if the module is evaluated
- * twice (HMR, or a second copy resolved through another node_modules path).
- */
-declare const FORCE_STATE_MARKER = "__HN_FORCE_STATE__";
-interface ForceStateParam {
-    state: ForcedState;
-    /** Boundary id the param targets; null = every top-level boundary. */
-    target: string | null;
-}
-interface StateBoundaryInfo {
-    id: string;
-    /** Id of the enclosing boundary; null for a top-level one. */
-    parentId: string | null;
-}
-interface ForceStateSnapshot {
-    boundaries: readonly StateBoundaryInfo[];
-    overrides: Readonly<Record<string, ForcedState>>;
-    param: ForceStateParam | null;
-}
-/** Parses the value of `?__state=`; anything unrecognised is ignored (null). */
-declare function parseForceStateParam(value: string | null | undefined): ForceStateParam | null;
-/** Reads the param out of a `location.search` string. */
-declare function forceStateParamFromSearch(search: string): ForceStateParam | null;
-/**
- * The state a boundary renders. A panel override for the boundary wins; else
- * the URL param applies to its target, or, untargeted, to the nearest
- * boundaries: the top-level ones. Forcing an outer boundary unmounts the
- * inner ones anyway, so the page-level state is what a screenshot wants.
- */
-declare function resolveForcedState(snapshot: ForceStateSnapshot, boundary: StateBoundaryInfo): ForcedState | null;
-type Listener = () => void;
-declare class ForceStateStore {
-    private registrations;
-    private overrides;
-    private search;
-    private snapshot;
-    private listeners;
-    getSnapshot: () => ForceStateSnapshot;
-    subscribe: (listener: Listener) => (() => void);
-    /** Registers a mounted boundary; the returned function unregisters it. Mounts are counted. */
-    register(id: string, parentId: string | null): () => void;
-    /** Forces one boundary (panel toggle); null returns it to auto. */
-    force(id: string, state: ForcedState | null): void;
-    clearOverrides(): void;
-    /** Feeds the current `location.search`; a no-op when it did not change. */
-    syncSearch(search: string): void;
-    private emit;
-}
-/** The page's store, created on first use. */
-declare function getForceStateStore(): ForceStateStore;
-
-export { FORCED_STATES, FORCE_STATE_MARKER, FORCE_STATE_PARAM, type ForceStateParam, type ForceStateSnapshot, ForceStateStore, type ForcedState, type StateBoundaryInfo, forceStateParamFromSearch, getForceStateStore, parseForceStateParam, resolveForcedState };

package/core/force-state.js

@@ -1,21 +0,0 @@
-import {
-  FORCED_STATES,
-  FORCE_STATE_MARKER,
-  FORCE_STATE_PARAM,
-  ForceStateStore,
-  forceStateParamFromSearch,
-  getForceStateStore,
-  parseForceStateParam,
-  resolveForcedState
-} from "../chunk-c5y856ad.js";
-import"../chunk-5gtx3pza.js";
-export {
-  resolveForcedState,
-  parseForceStateParam,
-  getForceStateStore,
-  forceStateParamFromSearch,
-  ForceStateStore,
-  FORCE_STATE_PARAM,
-  FORCE_STATE_MARKER,
-  FORCED_STATES
-};

package/core/mock-cookie.d.mts

@@ -1,30 +0,0 @@
-/**
- * hud-mock cookie — the runtime mock-Convex toggle.
- *
- * SSR-consistency contract: the SERVER layout reads the cookie (next/headers)
- * and passes the decision down as a `forceMock` prop to the app's
- * ConvexClientProvider. The client never re-derives it during hydration, so
- * server HTML and client render always agree. `isHudMockEnabled` is the single
- * decision function both the layout (server) and any tooling use.
- */
-declare const HUD_MOCK_COOKIE = "hud-mock";
-interface HudMockEnv {
-    /** process.env.NODE_ENV of the reading side. */
-    nodeEnv?: string;
-    /** NEXT_PUBLIC_HUD_ENABLED — the deployed-env opt-in flag. */
-    hudEnabled?: string;
-}
-/**
- * Whether the mock override is active. The cookie only counts where the hud
- * itself can exist (dev, or a deployment that explicitly opted in) — a stray
- * cookie on production without the flag must be inert.
- */
-declare function isHudMockEnabled(cookieValue: string | undefined, env: HudMockEnv): boolean;
-/** Serialized Set-Cookie/document.cookie string for the toggle. */
-declare function hudMockCookieString(enabled: boolean): string;
-/** Client-side read of the raw cookie value (panel display only, never render-gating). */
-declare function readHudMockCookie(): string | undefined;
-/** Client-side toggle. Takes effect on the next full load (the server re-reads it). */
-declare function setHudMockCookie(enabled: boolean): void;
-
-export { HUD_MOCK_COOKIE, type HudMockEnv, hudMockCookieString, isHudMockEnabled, readHudMockCookie, setHudMockCookie };

package/core/mock-cookie.js

@@ -1,15 +0,0 @@
-import {
-  HUD_MOCK_COOKIE,
-  hudMockCookieString,
-  isHudMockEnabled,
-  readHudMockCookie,
-  setHudMockCookie
-} from "../chunk-hc2g0n35.js";
-import"../chunk-5gtx3pza.js";
-export {
-  setHudMockCookie,
-  readHudMockCookie,
-  isHudMockEnabled,
-  hudMockCookieString,
-  HUD_MOCK_COOKIE
-};

package/core/types.d.mts

@@ -1,59 +0,0 @@
-import { LucideIcon } from 'lucide-react';
-import { ReactNode } from 'react';
-
-/**
- * Where the hud believes it is running. Resolved by `resolveHudEnv()` —
- * explicit `NEXT_PUBLIC_HUD_ENV` wins over heuristics because k3s deploys
- * have no `VERCEL_ENV` (staging is only detectable if the overlay says so).
- */
-type HudEnv = "development" | "preview" | "staging" | "production" | "disabled";
-/**
- * Literal the CI bundle gate greps for in every app's client chunks
- * (`scripts/ci/assert-no-hud-in-bundle.sh`). It is rendered as an attribute
- * on the hud's chrome so a bundler cannot drop it while keeping the hud, and
- * so the check has a marker that is unmistakably deliberate rather than an
- * incidental string that a refactor could rename away.
- */
-declare const HUD_BUNDLE_MARKER = "__HN_HUD_BUNDLE_MARKER__";
-declare const HUD_CAPABILITIES: readonly ["observe.app", "observe.estate", "cicd.read", "cicd.trigger", "inject.seed", "mock.toggle", "auth.impersonate", "dispatch.local", "dispatch.hermes", "variants.switch", "variants.vote", "variants.generate", "state.force"];
-type HudCapability = (typeof HUD_CAPABILITIES)[number];
-interface HudPanel {
-    id: string;
-    label: string;
-    icon: LucideIcon;
-    /** Required capability — the panel is dropped when the env's matrix denies it. */
-    capability: HudCapability;
-    content: ReactNode;
-    /** Lower sorts first in the tab bar. Default 0. */
-    order?: number;
-}
-interface HudConfig {
-    /** App slug as used in k8s/app-config.json (e.g. "console"). */
-    appSlug: string;
-    /** Toolbar display name. Working title until the naming vote lands. */
-    name?: string;
-    /** localStorage key for drawer height/tab persistence. Default `${appSlug}-hud`. */
-    storageKey?: string;
-    /** Drawer hotkey (Cmd/Ctrl+Shift+<key>). Default "h"; null disables. */
-    shortcutKey?: string | null;
-    /** Base path of the hud hub routes. Default "/api/hud" (same-origin proxy). */
-    apiBase?: string;
-    /**
-     * Source guesses for the element grabber (e.g. from the app's dev-routes
-     * or variant-preview manifest). Hints only — the dispatched session does
-     * the real lookup.
-     */
-    componentHints?: Array<{
-        name: string;
-        path: string;
-    }>;
-    /** FAB/drawer visual theme, passed through to @hn-monorepo/dev-tools. */
-    appearance?: "default" | "bauhaus";
-    /**
-     * Render the hud's own FAB (default true). Apps that already run a
-     * FloatingDockProvider set this false and register a dock item instead.
-     */
-    showFab?: boolean;
-}
-
-export { HUD_BUNDLE_MARKER, HUD_CAPABILITIES, type HudCapability, type HudConfig, type HudEnv, type HudPanel };

package/core/types.js

@@ -1,9 +0,0 @@
-import {
-  HUD_BUNDLE_MARKER,
-  HUD_CAPABILITIES
-} from "../chunk-v086j53b.js";
-import"../chunk-5gtx3pza.js";
-export {
-  HUD_CAPABILITIES,
-  HUD_BUNDLE_MARKER
-};

package/hud-provider.d.mts

@@ -1,38 +0,0 @@
-import * as react from 'react';
-import { ReactNode } from 'react';
-import { HudConfig, HudEnv, HudPanel, HudCapability } from './core/types.mjs';
-import 'lucide-react';
-
-interface HudPanelSource {
-    panels: HudPanel[];
-    /** Lower sorts first. Default 0. */
-    order?: number;
-}
-interface HudContextValue {
-    config: HudConfig;
-    env: HudEnv;
-    name: string;
-    can: (capability: HudCapability) => boolean;
-    /** Capability-filtered, order-sorted union of prop panels + registered sources. */
-    panels: HudPanel[];
-    registerSource: (id: string, source: HudPanelSource) => void;
-    unregisterSource: (id: string) => void;
-}
-interface HudProviderProps {
-    config: HudConfig;
-    env: HudEnv;
-    panels?: HudPanel[];
-    children: ReactNode;
-}
-declare function HudProvider({ config, env, panels: basePanels, children }: HudProviderProps): react.JSX.Element;
-declare function useHud(): HudContextValue;
-declare function useHudSafe(): HudContextValue | null;
-/**
- * Contribute panels from any layout/page below the provider — mirrors
- * dev-tools' `useRegisterDockItems`. Pass a memo-stable `panels` array; the
- * source is replaced on change and removed on unmount, so calling with an
- * empty array is safe (rules-of-hooks friendly).
- */
-declare function useRegisterHudPanels(id: string, panels: HudPanel[], order?: number): void;
-
-export { HudProvider, type HudProviderProps, useHud, useHudSafe, useRegisterHudPanels };

package/hud-provider.js

@@ -1,15 +0,0 @@
-import {
-  HudProvider,
-  useHud,
-  useHudSafe,
-  useRegisterHudPanels
-} from "./chunk-9hw5r9y1.js";
-import"./chunk-vjh0d29g.js";
-import"./chunk-v086j53b.js";
-import"./chunk-5gtx3pza.js";
-export {
-  useRegisterHudPanels,
-  useHudSafe,
-  useHud,
-  HudProvider
-};

package/hud.d.mts

@@ -1,15 +0,0 @@
-import * as react from 'react';
-import { HudConfig, HudPanel } from './core/types.mjs';
-import 'lucide-react';
-
-interface HudProps {
-    config: HudConfig;
-    panels?: HudPanel[];
-}
-/**
- * The hud shell: env gate → drawer state → FAB + tabbed drawer. Mount once
- * per app via a `ssr: false` dynamic import (see console's hud-loader).
- */
-declare function Hud({ config, panels }: HudProps): react.JSX.Element | null;
-
-export { Hud, type HudProps };

package/hud.js

@@ -1,18 +0,0 @@
-import {
-  Hud
-} from "./chunk-20zke7cs.js";
-import"./chunk-82nm9wcg.js";
-import"./chunk-24vrg16w.js";
-import"./chunk-yn1d38pb.js";
-import"./chunk-xezxydm3.js";
-import"./chunk-kvxve0hx.js";
-import"./chunk-6cdpasm9.js";
-import"./chunk-9hw5r9y1.js";
-import"./chunk-kyeb6qeq.js";
-import"./chunk-xztw0xyt.js";
-import"./chunk-vjh0d29g.js";
-import"./chunk-v086j53b.js";
-import"./chunk-5gtx3pza.js";
-export {
-  Hud
-};

package/index.d.mts

@@ -1,94 +0,0 @@
-import { HudBridgeInfo, HudDispatchPayload, HudAnchor, HudComponentHint } from './core/api-types.mjs';
-export { HudCicdDeployed, HudCicdResponse, HudCicdRun, HudDispatchRequest, HudDispatchResponse, HudDispatchTarget, HudSeedDescriptor, HudSeedRequest, HudSeedResponse, HudSessionInfo, HudSignozResponse } from './core/api-types.mjs';
-export { HUD_UNLOCK_COOKIE, HudAccess, hudRequiresUnlock, hudUnlockTtlMs, resolveHudAccess } from './core/access.mjs';
-export { CAPABILITY_MATRIX, hasCapability, isHudVisible, resolveHudEnv } from './core/capabilities.mjs';
-export { CaptureBuffer, CaptureEntry, CaptureKind, captureBuffer } from './core/capture-buffer.mjs';
-export { HUD_MOCK_COOKIE, hudMockCookieString, isHudMockEnabled, readHudMockCookie, setHudMockCookie } from './core/mock-cookie.mjs';
-import { HudConfig, HudEnv } from './core/types.mjs';
-export { HUD_BUNDLE_MARKER, HUD_CAPABILITIES, HudCapability, HudPanel } from './core/types.mjs';
-export { Hud, HudProps } from './hud.mjs';
-export { HudProvider, HudProviderProps, useHud, useHudSafe, useRegisterHudPanels } from './hud-provider.mjs';
-export { HudPanelMeta, hudLazyPanel } from './lazy-panel.mjs';
-export { CicdPanel } from './panels/cicd-panel.mjs';
-export { DebugInfoPanel, DebugInfoPanelProps, HudUserInfo } from './panels/debug-info-panel.mjs';
-export { DispatchPanel } from './panels/dispatch-panel.mjs';
-export { EnvInfoPanel } from './panels/env-info-panel.mjs';
-export { FeatureFlagsPanel, HudFlagDescriptor, HudFlagsAdapter } from './panels/feature-flags-panel.mjs';
-export { InfoRow, LoadingSpinner, PanelSection, ShortcutRow } from './panels/info-row.mjs';
-export { MockSeedPanel } from './panels/mock-seed-panel.mjs';
-export { NetworkConsolePanel } from './panels/network-console-panel.mjs';
-export { HudRoleAdapter, HudRoleDescriptor, RoleSwitcherPanel } from './panels/role-switcher-panel.mjs';
-export { SessionsPanel } from './panels/sessions-panel.mjs';
-export { HudTokenDescriptor, HudTokenGroup, HudTokensAdapter, TokensPanel } from './panels/tokens-panel.mjs';
-export { HudUnlockPanel, HudUnlockPanelProps, HudUnlockState, useHudUnlock } from './panels/unlock-panel.mjs';
-export { HudGenerateRequest, HudGenerateResult, HudVariantCategory, HudVariantsAdapter, VariantsPanel } from './panels/variants-panel.mjs';
-export { VitalsPanel, getVitalsSnapshot } from './panels/vitals-panel.mjs';
-import 'lucide-react';
-import 'react';
-
-declare function getBridgeInfo(apiBase: string): Promise<HudBridgeInfo | null>;
-declare function resetBridgeInfo(): void;
-declare function bridgeFetch(info: HudBridgeInfo, path: string, init?: RequestInit): Promise<Response>;
-
-declare function installCapture(): void;
-declare function uninstallCapture(): void;
-
-/**
- * Module-level grabber state. Lives outside React because the drawer (and
- * with it every panel) unmounts while grabbing — the dispatch panel closes
- * the drawer, the controller in the always-mounted shell does the DOM work,
- * and the payload must survive the round trip.
- */
-interface GrabberState {
-    mode: "idle" | "grabbing";
-    payload: HudDispatchPayload | null;
-}
-declare function getGrabberState(): GrabberState;
-declare function subscribeGrabber(listener: () => void): () => void;
-declare function startGrab(): void;
-declare function cancelGrab(): void;
-declare function completeGrab(payload: HudDispatchPayload): void;
-declare function clearGrabbedPayload(): void;
-
-/**
- * CSS-ish path from `root` down to `el` — originally console's design-comments,
- * by way of the HUD grabber. Canonical home; `@hn-monorepo/hud` re-exports it.
- */
-declare function buildAnchorSelector(el: Element, root: Element): string;
-
-/**
- * Viewport-relative anchor for a grab that is dispatched immediately.
- *
- * Correct here and only here: the payload is sent within the second, so the
- * scroll offset it was measured at is still the one on screen. Anything that
- * PERSISTS a position needs `capturePinAnchor` from
- * `@hn-monorepo/review-kit/anchor`, which stores document-relative fractions —
- * reload at a different scroll offset and these percentages point elsewhere.
- */
-declare function buildAnchor(el: Element): HudAnchor;
-/**
- * Score manifest entries against the current route + anchor label. Pure
- * token overlap — a hint, not a resolution; the dispatched session does the
- * real source lookup (console's design-review dispatch proves that works).
- */
-declare function matchComponentHints(hints: HudComponentHint[] | undefined, route: string, label: string, max?: number): HudComponentHint[];
-declare function buildDispatchPayload(input: {
-    config: HudConfig;
-    env: HudEnv;
-    anchor: HudAnchor;
-    vitals: Record<string, number>;
-}): HudDispatchPayload;
-
-interface PollState<T> {
-    data?: T;
-    error?: string;
-    loading: boolean;
-}
-/**
- * Minimal JSON polling for hud panels — deliberately not SWR to keep the
- * package dependency-light. Pauses while the tab is hidden; a redirect
- * (auth wall) or non-JSON response surfaces as a readable error.
- */
-declare function usePoll<T>(url: string | null, intervalMs?: number): PollState<T>;
-
-export { HudAnchor, HudBridgeInfo, HudComponentHint, HudConfig, HudDispatchPayload, HudEnv, bridgeFetch, buildAnchor, buildAnchorSelector, buildDispatchPayload, cancelGrab, clearGrabbedPayload, completeGrab, getBridgeInfo, getGrabberState, installCapture, matchComponentHints, resetBridgeInfo, startGrab, subscribeGrabber, uninstallCapture, usePoll };