@hedwigjs/devtools 0.1.0

package/dist/index.js.LICENSE.txt

@@ -0,0 +1,9 @@
+/**
+ * @license React
+ * react-jsx-runtime.production.js
+ *
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */

package/dist/inspector/attachInspector.d.ts

@@ -0,0 +1,15 @@
+import type { MessageBrokerForDevTools } from "./types";
+import type { MessageInspectorStore } from "./createInspectorStore";
+/**
+ * Attaches the inspector store to broker hooks + system events.
+ *
+ * Two channels:
+ *  - Extension hooks (useBeforeSendHook / useAfterSendHook) drive the
+ *    live user-message feed with pending → delivered/failed transitions.
+ *  - `$systemEvents` (client/subscription/bridge lifecycle) drives two
+ *    things: the aggregate Clients tab (via `refresh`) and the dedicated
+ *    System Events log (via `pushSystemEvent`).
+ *
+ * @returns Detach function that unsubscribes everything.
+ */
+export declare function attachInspector(broker: MessageBrokerForDevTools, store: MessageInspectorStore): () => void;

package/dist/inspector/createInspectorStore.d.ts

@@ -0,0 +1,21 @@
+import type { Message, RoutingResult } from "@hedwigjs/broker";
+import type { InspectorSnapshot, MessagesFilter, MessageBrokerForDevTools, SystemEventName } from "./types";
+export interface CreateInspectorStoreOptions {
+    maxEvents: number;
+}
+export declare function createInspectorStore(options: CreateInspectorStoreOptions): {
+    subscribe: (listener: () => void) => () => void;
+    getSnapshot: () => InspectorSnapshot;
+    setAttached: (value: boolean) => void;
+    onBeforeSend: (message: Readonly<Message>) => void;
+    onAfterSend: (message: Readonly<Message>, result: RoutingResult) => void;
+    clearLog: () => void;
+    setMessagesFilter: (patch: Partial<MessagesFilter>) => void;
+    clearMessagesFilter: () => void;
+    refreshClients: (broker: MessageBrokerForDevTools) => void;
+    refreshHistory: (broker: MessageBrokerForDevTools) => void;
+    refreshBridges: (broker: MessageBrokerForDevTools) => void;
+    pushSystemEvent: (name: SystemEventName, payload: unknown) => void;
+    clearSystemEvents: () => void;
+};
+export type MessageInspectorStore = ReturnType<typeof createInspectorStore>;

package/dist/inspector/matchPattern.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Glob-style topic matcher. Mirrors the broker-internal `matchPattern`
+ * so DevTools can attribute messages to bridge forward-patterns without
+ * a private import.
+ *
+ * Supported patterns:
+ * - `*`             → matches everything
+ * - `user.*`        → prefix
+ * - `*.created.v1`  → suffix
+ * - `user.*.v1`     → middle
+ * - `user.login`    → exact
+ */
+export declare function matchPattern(topic: string, pattern: string): boolean;
+export declare function matchesAnyPattern(topic: string, patterns: ReadonlyArray<string>): boolean;

package/dist/inspector/ringLog.d.ts

@@ -0,0 +1,29 @@
+import type { MessageLogEntry } from "./types";
+/**
+ * Кольцо на фиксированной ёмкости: O(1) на append при полном буфере, без копирования хвоста.
+ * Порядок `toArray()` — от старейшей записи к новейшей.
+ *
+ * Generic — используется и для сообщений, и для системных событий.
+ * Опциональный `keyOf` позволяет искать элемент по внутреннему id
+ * (нужно для двухфазной записи сообщения: pending → delivered).
+ */
+export declare function createRingBuffer<T>(capacity: number, keyOf?: (item: T) => string): {
+    push: (e: T) => void;
+    setAt: (physicalIndex: number, e: T) => void;
+    getAt: (physicalIndex: number) => T | undefined;
+    findIndexById: (id: string) => number;
+    toArray: () => T[];
+    clear: () => void;
+};
+/**
+ * Convenience factory для главного кольца сообщений — сохраняет старую
+ * сигнатуру, чтобы не переписывать call-sites одним махом.
+ */
+export declare function createMessageRingBuffer(capacity: number): {
+    push: (e: MessageLogEntry) => void;
+    setAt: (physicalIndex: number, e: MessageLogEntry) => void;
+    getAt: (physicalIndex: number) => MessageLogEntry | undefined;
+    findIndexById: (id: string) => number;
+    toArray: () => MessageLogEntry[];
+    clear: () => void;
+};

package/dist/inspector/testFixtures.d.ts

@@ -0,0 +1,4 @@
+import type { Message, RoutingResult } from "@hedwigjs/broker";
+export declare function makeTestMessage(overrides?: Partial<Message>): Message;
+export declare function makeAck(): RoutingResult;
+export declare function makeNack(): RoutingResult;

package/dist/inspector/types.d.ts

@@ -0,0 +1,165 @@
+import type { Message, RoutingResult, SubscriptionOptions, HistoryEntry, SystemEventsEmitter, Inspector } from "@hedwigjs/broker";
+/**
+ * Minimal broker contract for devtools subscription.
+ * Matches BrokerCore surface accessible without exporting the class.
+ *
+ * - `useBeforeSendHook` / `useAfterSendHook`: extension hooks the inspector uses
+ *   to record the live message feed (topic, result, latency).
+ * - `$systemEvents`: broker-internal push channel of lifecycle events
+ *   (client.*, subscription.*, bridge.*) — keeps the client tree in sync.
+ *   The `$` prefix signals this is a tooling-only API.
+ * - `inspect`: pull API for point-in-time state snapshots (clients, history,
+ *   bridges). Used for initial hydration without races.
+ */
+export interface MessageBrokerForDevTools {
+    useBeforeSendHook(hook: (message: Readonly<Message>) => {
+        allowed: true;
+    } | {
+        allowed: false;
+        message: string;
+    }): () => void;
+    useAfterSendHook(hook: (message: Readonly<Message>, result: RoutingResult) => void): () => void;
+    $systemEvents: SystemEventsEmitter<string, Record<string, any>>;
+    inspect: Inspector<string, Record<string, any>>;
+    $debug: {
+        send(source: string, topic: string, target: string, data: unknown): Promise<RoutingResult>;
+    };
+}
+export type { HistoryEntry };
+export type LogStatus = "pending" | "delivered" | "failed";
+/** multicast = broadcast to '*' (emit); unicast = targeted to a specific client (request). */
+export type MessageKind = "multicast" | "unicast";
+export interface MessageLogEntry {
+    id: string;
+    topic: string;
+    source: string;
+    target: string;
+    /** ISO timestamp */
+    createdAt: string;
+    status: LogStatus;
+    kind: MessageKind;
+    /** Number of subscribers that received this emit (undefined for unicast). */
+    subscriberCount?: number;
+    replayed?: boolean;
+    fromExternal?: boolean;
+    /** Message was fired via `broker.$debug.send` (DevTools spoof / test). */
+    synthetic?: boolean;
+    dataPreview?: string;
+    latencyMs?: number;
+    result?: {
+        status: "ACK" | "NACK";
+        reason: string;
+        message: string;
+        /** Recipient client ID — unicast only. */
+        recipientId?: string;
+        /** All recipient client IDs — multicast only. */
+        recipientIds?: string[];
+        /** Serialized return value from the handler (request-reply only). */
+        responsePreview?: string;
+    };
+}
+export interface MessagesFilter {
+    /** Text search on topic name. */
+    topic: string;
+    /** Filter by client ID (matches source or any recipient). */
+    clientId?: string;
+    /**
+     * Narrows clientId filter to sent or received messages only.
+     * Ignored when clientId is not set.
+     */
+    direction?: "sent" | "received";
+    kind?: MessageKind;
+    /** Filter by delivery result. "pending" = still in flight. */
+    result?: "ACK" | "NACK" | "pending";
+}
+export declare const EMPTY_MESSAGES_FILTER: MessagesFilter;
+/**
+ * Configuration for collapsing high-frequency same-topic bursts (e.g. SSE
+ * chunk streams) into a single expandable row so a flood of events from
+ * one source doesn't drown out everything else in the log.
+ *
+ * A group is formed when consecutive entries share the same `(topic, source)`
+ * and each pair is within `windowMs`. Groups with < `minCount` entries stay
+ * flattened as individual rows — the rollup only kicks in for real bursts.
+ */
+export interface MessagesRollupConfig {
+    /** Minimum consecutive matching entries to fold into a stream row. */
+    minCount: number;
+    /** Max gap (ms) between adjacent entries to still consider them one stream. */
+    windowMs: number;
+}
+export declare const DEFAULT_MESSAGES_ROLLUP: MessagesRollupConfig;
+/**
+ * One system event surfaced by `broker.$systemEvents`. These are broker
+ * infrastructure signals (client / subscription / bridge lifecycle) —
+ * NOT user message topics. DevTools shows them in a dedicated tab so
+ * they don't drown out (or get drowned by) the user-message feed.
+ */
+export type SystemEventName = "client.registered" | "client.unregistered" | "subscription.added" | "subscription.removed" | "subscription.rejected" | "message.rejected" | "bridge.added" | "bridge.removed";
+export interface SystemEventLogEntry {
+    /** Monotonic local id, assigned by the store on ingestion. */
+    id: string;
+    /** ISO timestamp when DevTools received the event. */
+    at: string;
+    name: SystemEventName;
+    /** Raw payload from broker — shape depends on `name`. */
+    payload: unknown;
+}
+export interface ClientSubscriptionEntry {
+    topic: string;
+    options?: SubscriptionOptions;
+    /** Unix ms of the last message received on this subscription. Null if never. */
+    lastReceivedAt: number | null;
+}
+export interface ClientEntry {
+    id: string;
+    connectedAt: number;
+    /** Unix ms of the last message sent or received by this client. Null if none. */
+    lastActiveAt: number | null;
+    /** Messages sent by this client visible in the current ring buffer. */
+    sentCount: number;
+    /** Messages received by this client visible in the current ring buffer. */
+    receivedCount: number;
+    subscriptions: ClientSubscriptionEntry[];
+}
+export interface BridgeEntry {
+    id: string;
+    forwardPatterns: ReadonlyArray<string>;
+    /**
+     * Transport class name (`WebSocket`, `SSE`, `PostMessage`,
+     * `BroadcastChannel`, or a custom class name). Populated by the broker
+     * from the transport's constructor; may be `undefined` for anonymous
+     * transports.
+     */
+    transportKind?: string;
+    /**
+     * Approx. count of local emits whose topic matches this bridge's
+     * forward patterns — i.e. messages that WOULD have been sent out
+     * through this transport. Broker doesn't expose per-bridge attribution
+     * directly, so this is a heuristic over the message log.
+     */
+    sentThroughCount: number;
+    /**
+     * Approx. count of `fromExternal=true` messages matching this bridge's
+     * forward patterns — i.e. messages injected FROM this transport. Same
+     * heuristic caveat as above.
+     */
+    receivedFromCount: number;
+}
+export interface InspectorSnapshot {
+    /** Oldest → newest order. Reverse before rendering in the log. */
+    entries: ReadonlyArray<MessageLogEntry>;
+    totalSeen: number;
+    attached: boolean;
+    clients: ReadonlyArray<ClientEntry>;
+    messagesFilter: MessagesFilter;
+    /** Current contents of the broker's replay buffer (oldest → newest). */
+    historyEntries: ReadonlyArray<HistoryEntry>;
+    /** Recent system events (oldest → newest). Ring-buffered by `maxEvents`. */
+    systemEvents: ReadonlyArray<SystemEventLogEntry>;
+    /** Registered bridges with cached forward patterns and derived counters. */
+    bridges: ReadonlyArray<BridgeEntry>;
+}
+declare function serializeDataPreview(data: unknown, maxLen?: number): string;
+declare function snapshotFrom(list: MessageLogEntry[], totalSeen: number, attached: boolean, clients: ClientEntry[], messagesFilter: MessagesFilter, historyEntries: ReadonlyArray<HistoryEntry>, systemEvents: ReadonlyArray<SystemEventLogEntry>, bridges: ReadonlyArray<BridgeEntry>): InspectorSnapshot;
+export { serializeDataPreview, snapshotFrom };

package/dist/ui/MessageBrokerDevTools.d.ts

@@ -0,0 +1,45 @@
+import type { ReactNode } from "react";
+import type { MessageBrokerForDevTools, MessagesRollupConfig } from "../inspector/types";
+import type { DevToolsPanelPosition } from "./shell/layout/panelTypes";
+import type { TopicsRegistry } from "./topicsRegistry";
+export type { DevToolsPanelPosition } from "./shell/layout/panelTypes";
+export interface MessageBrokerDevToolsProps {
+    broker: MessageBrokerForDevTools;
+    /**
+     * Каталог топиков из registry-пакета (например, `@your-org/topics-registry`).
+     * Если передан — будущие табы (Topics, Send-tester) показывают полный
+     * перечень контрактов и примеры payload'ов. Loose coupling: DevTools
+     * не зависит от конкретного registry-пакета.
+     */
+    registry?: TopicsRegistry;
+    /** Defaults to true only in development (requires DefinePlugin in the build). */
+    enabled?: boolean;
+    /** Maximum number of recent events to keep in the log. */
+    maxEvents?: number;
+    /** Default dock side for the panel (also the first value written to localStorage). */
+    defaultPosition?: DevToolsPanelPosition;
+    /**
+     * Edge on which the floating toggle button lives. Independent from the
+     * panel's position: the FAB stays a stable anchor while the panel can dock
+     * anywhere. Defaults to `"right"` — a discreet edge-attached rail that
+     * doesn't collide with typical bottom-right chat widgets.
+     */
+    fabPosition?: DevToolsPanelPosition;
+    /** localStorage key for position, active tab, and open state. */
+    storageKey?: string;
+    /** Whether the panel is open by default (when no saved state exists). */
+    defaultOpen?: boolean;
+    /** Icon for the floating toggle button. Falls back to the built-in mascot PNG. */
+    toggleIcon?: ReactNode;
+    /**
+     * Auto-collapse bursts of same-source same-topic events into stream rows
+     * in the Messages tab. Prevents streaming producers (SSE chunks,
+     * chatty polling loops) from flooding the log.
+     *
+     * - `undefined` (default) — enabled with `{ minCount: 5, windowMs: 1000 }`.
+     * - `false` — disabled, flat log for every event.
+     * - `{ minCount, windowMs }` — custom thresholds.
+     */
+    rollup?: MessagesRollupConfig | false;
+}
+export declare const MessageBrokerDevTools: ({ broker, registry, enabled, maxEvents, defaultPosition, fabPosition, storageKey, defaultOpen, toggleIcon, rollup, }: MessageBrokerDevToolsProps) => ReactNode;

package/dist/ui/components/AccordionRow/AccordionRow.d.ts

@@ -0,0 +1,13 @@
+import type { ComponentPropsWithoutRef, ReactNode } from "react";
+interface AccordionRowProps {
+    /** Collapsed content — receives `open` so it can render the chevron. */
+    summary: (open: boolean) => ReactNode;
+    /** Detail content shown when the row is expanded. */
+    children: ReactNode;
+    /** Props forwarded to the root `<div>` (e.g. className, data-*). */
+    rootProps?: ComponentPropsWithoutRef<"div"> & {
+        [key: `data-${string}`]: string | undefined;
+    };
+}
+export declare function AccordionRow({ summary, children, rootProps, }: AccordionRowProps): ReactNode;
+export {};

package/dist/ui/shell/devtoolsShell/DevToolsShell.d.ts

@@ -0,0 +1,16 @@
+import type { ReactNode } from "react";
+import type { MessageInspectorStore } from "../../../inspector/createInspectorStore";
+import type { MessageBrokerForDevTools, MessagesRollupConfig } from "../../../inspector/types";
+import type { DevToolsLayoutState, DevToolsPanelPosition, DevToolsTabId } from "../layout/panelTypes";
+export interface DevToolsShellProps {
+    store: MessageInspectorStore;
+    layout: DevToolsLayoutState;
+    messagesRollup: MessagesRollupConfig | null;
+    broker: MessageBrokerForDevTools;
+    onClose: () => void;
+    onPositionChange: (p: DevToolsPanelPosition) => void;
+    onTabChange: (t: DevToolsTabId) => void;
+    onSetSizeMain: (px: number) => void;
+    onToggleFullscreen: () => void;
+}
+export declare const DevToolsShell: ({ store, layout, messagesRollup, broker, onClose, onPositionChange, onTabChange, onSetSizeMain, onToggleFullscreen, }: DevToolsShellProps) => ReactNode;

package/dist/ui/shell/devtoolsShell/PanelResizeHandle.d.ts

@@ -0,0 +1,8 @@
+import type { ReactNode } from "react";
+import type { DevToolsPanelPosition } from "../layout/panelTypes";
+export interface PanelResizeHandleProps {
+    position: DevToolsPanelPosition;
+    onResize: (mainPx: number) => void;
+    disabled: boolean;
+}
+export declare const PanelResizeHandle: ({ position, onResize, disabled, }: PanelResizeHandleProps) => ReactNode;

package/dist/ui/shell/floatingToggleButton/FloatingToggleButton.d.ts

@@ -0,0 +1,10 @@
+import { type ReactNode } from "react";
+import type { DevToolsPanelPosition } from "../layout/panelTypes";
+export interface FloatingToggleButtonProps {
+    position: DevToolsPanelPosition;
+    attached: boolean;
+    onOpen: () => void;
+    /** Override the built-in icon (e.g. a custom img element). */
+    icon?: ReactNode;
+}
+export declare const FloatingToggleButton: ({ position, attached, onOpen, icon, }: FloatingToggleButtonProps) => ReactNode;

package/dist/ui/shell/layout/panelFrame.d.ts

@@ -0,0 +1,5 @@
+import type { DevToolsPanelPosition } from "./panelTypes";
+export declare const DEFAULT_SIZE_MAIN: Record<DevToolsPanelPosition, number>;
+export declare const MIN_SIZE_MAIN = 200;
+export declare function getMaxSizeMain(position: DevToolsPanelPosition, viewportW: number, viewportH: number): number;
+export declare function clampSizeMain(position: DevToolsPanelPosition, px: number, viewportW: number, viewportH: number): number;

package/dist/ui/shell/layout/panelTypes.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Dock side of the panel (similar to the toolbar in React Query Devtools).
+ * top/bottom — full-width panel; left/right — side column.
+ */
+export type DevToolsPanelPosition = "top" | "bottom" | "left" | "right";
+/**
+ * Tab identifiers. Add new sections here and in `renderActiveTab.tsx`.
+ */
+export type DevToolsTabId = "messages" | "clients" | "bridges" | "replay-buffer" | "system-events" | "debug";
+export interface DevToolsPreFullscreen {
+    sizeMain: number;
+    position: DevToolsPanelPosition;
+}
+export interface DevToolsLayoutState {
+    isOpen: boolean;
+    position: DevToolsPanelPosition;
+    activeTab: DevToolsTabId;
+    /** Panel occupies the full viewport; exit restores preFullscreen. */
+    isFullscreen: boolean;
+    /**
+     * Main-axis size in px: top/bottom panels use height, left/right use width.
+     */
+    sizeMain: number;
+    /**
+     * Captured on fullscreen enter; not persisted to localStorage (in-memory only while the panel is open).
+     */
+    preFullscreen: DevToolsPreFullscreen | null;
+}

package/dist/ui/shell/layout/usePanelLayoutState.d.ts

@@ -0,0 +1,16 @@
+import type { DevToolsLayoutState, DevToolsPanelPosition, DevToolsTabId } from "./panelTypes";
+export declare function usePanelLayoutState(options: {
+    storageKey?: string;
+    defaultPosition: DevToolsPanelPosition;
+    defaultOpen?: boolean;
+}): [
+    state: DevToolsLayoutState,
+    actions: {
+        setOpen: (v: boolean) => void;
+        toggle: () => void;
+        setPosition: (p: DevToolsPanelPosition) => void;
+        setActiveTab: (t: DevToolsTabId) => void;
+        setSizeMain: (px: number) => void;
+        toggleFullscreen: () => void;
+    }
+];

package/dist/ui/tabs/bridges/BridgesTab.d.ts

@@ -0,0 +1,6 @@
+import type { ReactNode } from "react";
+import type { MessageInspectorStore } from "../../../inspector/createInspectorStore";
+export interface BridgesTabProps {
+    store: MessageInspectorStore;
+}
+export declare function BridgesTab({ store }: BridgesTabProps): ReactNode;

package/dist/ui/tabs/bridges/components/BridgeRow/BridgeRow.d.ts

@@ -0,0 +1,7 @@
+import type { ReactNode } from "react";
+import type { BridgeEntry } from "../../../../../inspector/types";
+interface BridgeRowProps {
+    bridge: BridgeEntry;
+}
+export declare function BridgeRow({ bridge }: BridgeRowProps): ReactNode;
+export {};

package/dist/ui/tabs/clients/ClientsLogTab.d.ts

@@ -0,0 +1,9 @@
+import type { ReactNode } from "react";
+import type { MessageInspectorStore } from "../../../inspector/createInspectorStore";
+import type { DevToolsTabId } from "../../shell/layout/panelTypes";
+import type { TabNavigateOptions } from "../renderActiveTab";
+export interface ClientsLogTabProps {
+    store: MessageInspectorStore;
+    onNavigate: (tab: DevToolsTabId, options?: TabNavigateOptions) => void;
+}
+export declare function ClientsLogTab({ store, onNavigate }: ClientsLogTabProps): ReactNode;

package/dist/ui/tabs/clients/components/ClientCard/ClientCard.d.ts

@@ -0,0 +1,10 @@
+import type { ReactNode } from "react";
+import type { ClientEntry } from "../../../../../inspector/types";
+import type { DevToolsTabId } from "../../../../shell/layout/panelTypes";
+import type { TabNavigateOptions } from "../../../renderActiveTab";
+interface ClientCardProps {
+    client: ClientEntry;
+    onNavigate: (tab: DevToolsTabId, options?: TabNavigateOptions) => void;
+}
+export declare function ClientCard({ client, onNavigate }: ClientCardProps): ReactNode;
+export {};

package/dist/ui/tabs/clients/components/ClientDetail/ClientDetail.d.ts

@@ -0,0 +1,10 @@
+import type { ReactNode } from "react";
+import type { ClientEntry } from "../../../../../inspector/types";
+import type { DevToolsTabId } from "../../../../shell/layout/panelTypes";
+import type { TabNavigateOptions } from "../../../renderActiveTab";
+interface ClientDetailProps {
+    client: ClientEntry;
+    onNavigate: (tab: DevToolsTabId, options?: TabNavigateOptions) => void;
+}
+export declare function ClientDetail({ client, onNavigate }: ClientDetailProps): ReactNode;
+export {};

package/dist/ui/tabs/clients/components/ClientSummary/ClientSummary.d.ts

@@ -0,0 +1,11 @@
+import type { ReactNode } from "react";
+import type { ClientEntry } from "../../../../../inspector/types";
+import type { DevToolsTabId } from "../../../../shell/layout/panelTypes";
+import type { TabNavigateOptions } from "../../../renderActiveTab";
+interface ClientSummaryProps {
+    client: ClientEntry;
+    isOpen: boolean;
+    onNavigate: (tab: DevToolsTabId, options?: TabNavigateOptions) => void;
+}
+export declare function ClientSummary({ client, isOpen, onNavigate }: ClientSummaryProps): ReactNode;
+export {};

package/dist/ui/tabs/debug/DebugTab.d.ts

@@ -0,0 +1,20 @@
+import type { ReactNode } from "react";
+import type { MessageInspectorStore } from "../../../inspector/createInspectorStore";
+import type { MessageBrokerForDevTools } from "../../../inspector/types";
+export interface DebugTabProps {
+    store: MessageInspectorStore;
+    broker: MessageBrokerForDevTools;
+}
+/**
+ * Debug tab — hand-craft and send test events into the broker.
+ *
+ * Delegates to `broker.$debug.send()` under the hood (single broker
+ * primitive for both multicast and unicast — target picks the branch).
+ * The `source` field is a free string; broker doesn't touch the client
+ * registry, so impersonating a real client id is safe.
+ *
+ * Registry (if passed to <MessageBrokerDevTools />) drives topic
+ * autocomplete + example payload prefill. Without a registry the topic
+ * field is free-form and payload starts at `{}`.
+ */
+export declare function DebugTab({ store, broker }: DebugTabProps): ReactNode;

package/dist/ui/tabs/debug/components/ResultPanel/ResultPanel.d.ts

@@ -0,0 +1,12 @@
+import type { ReactNode } from "react";
+import type { RoutingResult } from "@hedwigjs/broker";
+interface ResultPanelProps {
+    result: RoutingResult;
+    mode: "multicast" | "unicast";
+}
+/**
+ * Shows the RoutingResult from broker.$debug.send — status, reason,
+ * subscribers count (multicast) or response data (unicast).
+ */
+export declare function ResultPanel({ result, mode }: ResultPanelProps): ReactNode;
+export {};

package/dist/ui/tabs/debug/components/SourcePicker/SourcePicker.d.ts

@@ -0,0 +1,20 @@
+import type { ReactNode } from "react";
+interface SourcePickerProps {
+    value: string;
+    /** Registered client ids for dropdown suggestions. */
+    suggestions: ReadonlyArray<string>;
+    onChange: (value: string) => void;
+    /** Placeholder shown when the input is empty. */
+    placeholder?: string;
+}
+/**
+ * Text input with a dropdown that opens on focus.
+ *
+ * Same interaction model as TopicPicker: pick from the list OR type a
+ * free string. Free strings are allowed on purpose — the whole point of
+ * `broker.$debug.send` is that source is an arbitrary label, not
+ * restricted to registered clients (bridges use non-client source labels
+ * like `ai-backend`, `notifications-backend`).
+ */
+export declare function SourcePicker({ value, suggestions, onChange, placeholder, }: SourcePickerProps): ReactNode;
+export {};

package/dist/ui/tabs/debug/components/TopicPicker/TopicPicker.d.ts

@@ -0,0 +1,16 @@
+import type { ReactNode } from "react";
+import type { TopicContractInfo, TopicsRegistry } from "../../../../topicsRegistry";
+interface TopicPickerProps {
+    value: string;
+    registry: TopicsRegistry | null;
+    onTextChange: (value: string) => void;
+    onPick: (contract: TopicContractInfo) => void;
+}
+/**
+ * Text input + suggestion dropdown over the topics registry. Free-form
+ * typing works even without a registry (dropdown just stays empty).
+ * Selecting an entry fires `onPick` so the parent can prefill the
+ * payload editor from `examples.happy`.
+ */
+export declare function TopicPicker({ value, registry, onTextChange, onPick, }: TopicPickerProps): ReactNode;
+export {};

package/dist/ui/tabs/definitions.d.ts

@@ -0,0 +1,9 @@
+import type { InspectorSnapshot } from "../../inspector/types";
+import type { DevToolsTabId } from "../shell/layout/panelTypes";
+export interface TabDefinition {
+    id: DevToolsTabId;
+    label: string;
+    /** Returns the badge count to show next to the tab label. Always shown when defined. */
+    getBadge?: (snapshot: InspectorSnapshot) => number;
+}
+export declare const MBDT_TAB_DEFINITIONS: ReadonlyArray<TabDefinition>;

package/dist/ui/tabs/messages/MessagesLogTab.d.ts

@@ -0,0 +1,12 @@
+import type { ReactNode } from "react";
+import type { MessageInspectorStore } from "../../../inspector/createInspectorStore";
+import type { MessagesRollupConfig } from "../../../inspector/types";
+export interface MessagesLogTabProps {
+    store: MessageInspectorStore;
+    /**
+     * Auto-rollup high-frequency same-source bursts into collapsible stream
+     * rows. Pass `null` to disable and always show a flat log.
+     */
+    rollup: MessagesRollupConfig | null;
+}
+export declare function MessagesLogTab({ store, rollup }: MessagesLogTabProps): ReactNode;

package/dist/ui/tabs/messages/components/MessageDetail/MessageDetail.d.ts

@@ -0,0 +1,7 @@
+import type { ReactNode } from "react";
+import type { MessageLogEntry } from "../../../../../inspector/types";
+interface MessageDetailProps {
+    entry: MessageLogEntry;
+}
+export declare function MessageDetail({ entry }: MessageDetailProps): ReactNode;
+export {};

package/dist/ui/tabs/messages/components/MessageRow/MessageRow.d.ts

@@ -0,0 +1,7 @@
+import type { ReactNode } from "react";
+import type { MessageLogEntry } from "../../../../../inspector/types";
+interface MessageRowProps {
+    entry: MessageLogEntry;
+}
+export declare function MessageRow({ entry }: MessageRowProps): ReactNode;
+export {};

package/dist/ui/tabs/messages/components/MessageSummary/MessageSummary.d.ts

@@ -0,0 +1,9 @@
+import type { ReactNode } from "react";
+import type { MessageLogEntry } from "../../../../../inspector/types";
+interface MessageSummaryProps {
+    entry: MessageLogEntry;
+    /** Passed by AccordionRow so the toggle reflects the current state. */
+    open: boolean;
+}
+export declare function MessageSummary({ entry, open }: MessageSummaryProps): ReactNode;
+export {};

package/dist/ui/tabs/messages/components/MessagesToolbar/MessagesToolbar.d.ts

@@ -0,0 +1,13 @@
+import type { ReactNode } from "react";
+import type { MessagesFilter } from "../../../../../inspector/types";
+interface MessagesToolbarProps {
+    filter: MessagesFilter;
+    onFilterChange: (patch: Partial<MessagesFilter>) => void;
+    onClear: () => void;
+    onClearLog: () => void;
+    visibleCount: number;
+    totalCount: number;
+    totalSeen: number;
+}
+export declare function MessagesToolbar({ filter, onFilterChange, onClear, onClearLog, visibleCount, totalCount, totalSeen, }: MessagesToolbarProps): ReactNode;
+export {};

package/dist/ui/tabs/messages/components/StreamRow/StreamRow.d.ts

@@ -0,0 +1,15 @@
+import type { ReactNode } from "react";
+import type { StreamGroup } from "../../rollup";
+interface StreamRowProps {
+    group: StreamGroup;
+}
+/**
+ * Collapsible row that stands in for a burst of same-topic messages from
+ * one source (typical for streaming producers like AI chat SSE chunks).
+ *
+ * Summary shows count + duration + latest payload preview; expanding it
+ * renders every original {@link MessageRow} inside, so no information is
+ * hidden — just deferred.
+ */
+export declare function StreamRow({ group }: StreamRowProps): ReactNode;
+export {};

package/dist/ui/tabs/messages/formatTimestamp.d.ts

@@ -0,0 +1 @@
+export declare function formatTimestamp(iso: string): string;