@buoy-gg/console 4.0.2

package/src/devtools/theme.ts

@@ -0,0 +1,137 @@
+/**
+ * Console palette — a dark theme matched to Buoy's shared design tokens
+ * (`macOSColors` in @buoy-gg/shared-ui) so the console reads as part of the
+ * tool suite, tuned for contrast per WCAG AA:
+ *   - body text  #F5F5F7 on #0A0A0C   ≈ 17:1
+ *   - secondary  #A1A1A6 on #0A0A0C   ≈ 7:1
+ *   - links      #40CCFF on #0A0A0C   ≈ 9:1
+ *   - dividers / nesting guides lightened to ~#3A3A40 so lines are clearly
+ *     visible against the near-black surface.
+ * The light values (the exact DevTools light tokens) are kept for a future
+ * toggle.
+ */
+
+import { Platform } from "react-native";
+
+/**
+ * Monospace font. On the desktop dashboard (react-native-web) the generic
+ * `"monospace"` resolves to a thin, poorly-hinted browser default that's hard
+ * to read at small sizes — so we use a curated mono stack there. Native (mobile)
+ * keeps its system monospace, which already renders well.
+ */
+export const monoFont: string =
+  Platform.select({
+    web: 'ui-monospace, "SF Mono", "SFMono-Regular", Menlo, Monaco, "Cascadia Code", "Roboto Mono", Consolas, "Liberation Mono", monospace',
+    default: "monospace",
+  }) ?? "monospace";
+
+export interface ConsoleColors {
+  baseContainer: string;
+  surfaceError: string;
+  surfaceYellow: string;
+  divider: string;
+  inputBackground: string;
+  menuBackground: string;
+  onSurface: string;
+  onSurfaceYellow: string;
+  onErrorContainer: string;
+  tokenSubtle: string;
+  primary: string;
+  valueNumber: string;
+  valueString: string;
+  valueBigint: string;
+  valueNode: string;
+  valueNullish: string;
+  valuePreview: string;
+}
+
+/** Light theme (active) — resolved DevTools light-theme tokens. */
+export const lightTheme: ConsoleColors = {
+  baseContainer: "#ffffff", // --sys-color-cdt-base-container (neutral99 ≈ white)
+  surfaceError: "#fceaea", // --sys-color-surface-error  rgb(252 235 235)
+  surfaceYellow: "#fef6d5", // --sys-color-surface-yellow rgb(254 246 213)
+  divider: "#e8eaed", // --sys-color-divider (primary90, lightened for contrast)
+  inputBackground: "#f1f3f4",
+  menuBackground: "#ffffff",
+  onSurface: "#1f1f1f", // neutral10
+  onSurfaceYellow: "#3e2f00", // yellow20
+  onErrorContainer: "#410e0b", // error10
+  tokenSubtle: "#757575", // neutral50
+  primary: "#0b57d0", // primary40 (links)
+  valueNumber: "#0842a0", // token-attribute-value (blue30)
+  valueString: "#c5221f", // token-property-special (error50, slightly deepened)
+  valueBigint: "#146c2e", // token-comment (green40)
+  valueNode: "#1f1f1f", // token-variable (= on-surface)
+  valueNullish: "rgba(31,31,31,0.5)", // state-disabled
+  valuePreview: "rgba(31,31,31,0.62)",
+};
+
+/** Dark theme (active) — matched to Buoy macOSColors, contrast-tuned. */
+export const darkTheme: ConsoleColors = {
+  baseContainer: "#0A0A0C", // macOSColors.background.base
+  surfaceError: "rgba(255,69,58,0.15)", // semantic.errorBackground
+  surfaceYellow: "rgba(255,235,59,0.13)", // semantic.warningBackground
+  divider: "#3A3A40", // lightened from border.default (#2D2D2F) for visible lines
+  inputBackground: "#26262A", // background.input
+  menuBackground: "#1A1A1C", // background.card
+  onSurface: "#F5F5F7", // text.primary  (~17:1)
+  onSurfaceYellow: "#FFE9A3", // light warm yellow on dark warning row
+  onErrorContainer: "#FFB4AB", // light red on dark error row
+  tokenSubtle: "#A1A1A6", // text.secondary (~7:1 — timestamps, previews)
+  primary: "#40CCFF", // semantic.infoLight (links, ~9:1)
+  valueNumber: "#FF9F1C", // orange (number + boolean)
+  valueString: "#7EE787", // green (string/regexp/symbol)
+  valueBigint: "#A1A1A6", // muted (bigint)
+  valueNode: "#F5F5F7", // default text (DOM node / variable)
+  valueNullish: "#8E8E93", // text.muted (null/undefined)
+  valuePreview: "#A1A1A6", // object preview (italic)
+};
+
+/** The active console palette. */
+export const consoleTheme: ConsoleColors = darkTheme;
+
+/** ANSI 16-color palette (dark theme), from consoleView.css `--console-color-*`. */
+export const ansiColors: Record<string, string> = {
+  black: "#000",
+  red: "rgb(237 78 76)",
+  green: "rgb(1 200 1)",
+  yellow: "rgb(210 192 87)",
+  blue: "rgb(39 116 240)",
+  magenta: "rgb(161 66 244)",
+  cyan: "rgb(18 181 203)",
+  gray: "rgb(207 208 208)",
+  darkgray: "rgb(137 137 137)",
+  lightred: "rgb(242 139 130)",
+  lightgreen: "rgb(161 247 181)",
+  lightyellow: "rgb(221 251 85)",
+  lightblue: "rgb(102 157 246)",
+  lightmagenta: "rgb(214 112 214)",
+  lightcyan: "rgb(132 240 255)",
+  white: "#fff",
+};
+
+export type ConsoleLevel = "verbose" | "info" | "warning" | "error";
+
+export interface LevelStyle {
+  /** Row background (undefined = base container). */
+  background?: string;
+  /** Message text color. */
+  text: string;
+  /** Material icon name analog (rendered as a glyph). */
+  icon?: "warning" | "error";
+}
+
+export const levelStyles: Record<ConsoleLevel, LevelStyle> = {
+  verbose: { text: consoleTheme.tokenSubtle },
+  info: { text: consoleTheme.onSurface },
+  warning: {
+    background: consoleTheme.surfaceYellow,
+    text: consoleTheme.onSurfaceYellow,
+    icon: "warning",
+  },
+  error: {
+    background: consoleTheme.surfaceError,
+    text: consoleTheme.onErrorContainer,
+    icon: "error",
+  },
+};

package/src/devtools/useConsoleController.ts

@@ -0,0 +1,104 @@
+/**
+ * useConsoleController — owns all Console view state so the header and the body
+ * can be composed separately (the shared ModalHeader pattern: controls live in
+ * the modal header's `customContent`, the list/sub-views live in the body).
+ */
+
+import { useCallback, useState, type Dispatch, type SetStateAction } from "react";
+import {
+  useConsoleMessages,
+  type DisplayRow,
+  type LayoutMode,
+} from "./useConsoleMessages";
+import {
+  DEFAULT_LEVELS,
+  levelMenuSummary,
+  type LevelsMask,
+} from "./consoleFilter";
+import { clearEntries } from "../store/consoleLogStore";
+
+/** Which screen the modal body shows (list, or the back-navigable filters page). */
+export type ConsoleViewState = "list" | "filters";
+
+export interface ConsoleController {
+  query: string;
+  setQuery: Dispatch<SetStateAction<string>>;
+  searchActive: boolean;
+  setSearchActive: Dispatch<SetStateAction<boolean>>;
+  levelsMask: LevelsMask;
+  setLevelsMask: Dispatch<SetStateAction<LevelsMask>>;
+  showTimestamps: boolean;
+  setShowTimestamps: Dispatch<SetStateAction<boolean>>;
+  layoutMode: LayoutMode;
+  setLayoutMode: Dispatch<SetStateAction<LayoutMode>>;
+  view: ConsoleViewState;
+  setView: Dispatch<SetStateAction<ConsoleViewState>>;
+  rows: DisplayRow[];
+  hiddenCount: number;
+  onToggleGroup: (groupId: number, currentlyCollapsed: boolean) => void;
+  onToggleCluster: (key: string) => void;
+  clear: () => void;
+  /** Level menu summary ("Default levels" / "Errors only" / …). */
+  levelSummary: string;
+  /** Whether the level mask differs from all/default (drives the active tint). */
+  isLevelCustom: boolean;
+}
+
+export function useConsoleController(): ConsoleController {
+  const [query, setQuery] = useState("");
+  const [searchActive, setSearchActive] = useState(false);
+  const [levelsMask, setLevelsMask] = useState<LevelsMask>({ ...DEFAULT_LEVELS });
+  const [showTimestamps, setShowTimestamps] = useState(false);
+  const [collapsedOverrides, setCollapsedOverrides] = useState<Record<number, boolean>>({});
+  const [layoutMode, setLayoutMode] = useState<LayoutMode>("chrono");
+  const [view, setView] = useState<ConsoleViewState>("list");
+  const [clusterExpanded, setClusterExpanded] = useState<Record<string, boolean>>({});
+
+  const { rows, hiddenCount } = useConsoleMessages({
+    levelsMask,
+    query,
+    showTimestamps,
+    collapsedOverrides,
+    groupDimension: "function",
+    layoutMode,
+    clusterExpanded,
+  });
+
+  const onToggleGroup = useCallback((groupId: number, currentlyCollapsed: boolean) => {
+    setCollapsedOverrides((prev) => ({ ...prev, [groupId]: !currentlyCollapsed }));
+  }, []);
+
+  const onToggleCluster = useCallback((key: string) => {
+    setClusterExpanded((prev) => ({ ...prev, [key]: !(prev[key] ?? false) }));
+  }, []);
+
+  const clear = useCallback(() => {
+    clearEntries();
+    setCollapsedOverrides({});
+  }, []);
+
+  const levelSummary = levelMenuSummary(levelsMask);
+  const isLevelCustom = levelSummary !== "All levels" && levelSummary !== "Default levels";
+
+  return {
+    query,
+    setQuery,
+    searchActive,
+    setSearchActive,
+    levelsMask,
+    setLevelsMask,
+    showTimestamps,
+    setShowTimestamps,
+    layoutMode,
+    setLayoutMode,
+    view,
+    setView,
+    rows,
+    hiddenCount,
+    onToggleGroup,
+    onToggleCluster,
+    clear,
+    levelSummary,
+    isLevelCustom,
+  };
+}

package/src/devtools/useConsoleMessages.ts

@@ -0,0 +1,337 @@
+/**
+ * useConsoleMessages — derives the displayed row model from raw captured
+ * entries, mirroring DevTools `ConsoleView.updateMessageList`:
+ *
+ *  - level + text filtering (consoleFilter)
+ *  - consecutive-identical collapse into a repeat-count badge (when timestamps
+ *    are off, matching `tryToCollapseMessages`)
+ *  - console.group / groupCollapsed nesting + collapse/expand
+ *
+ * Returns the visible rows plus the count of messages hidden by filters
+ * ("N hidden"), and per-level totals for the toolbar.
+ */
+
+import { useMemo, useSyncExternalStore } from "react";
+import {
+  subscribe,
+  getEntries,
+  type ConsoleLogEntry,
+  type ConsoleLevel,
+} from "../store/consoleLogStore";
+import {
+  parseFilterQuery,
+  shouldBeVisible,
+  type LevelsMask,
+} from "./consoleFilter";
+import {
+  sourceKey,
+  sourceLabel,
+  colorForKey,
+  bracketGlyph,
+  type GroupDimension,
+  type Bracket,
+} from "./origin";
+
+/** How the origin gutter is laid out. */
+export type LayoutMode = "chrono" | "swimlane" | "cluster";
+
+/** One swimlane gutter cell. */
+export interface LaneCell {
+  glyph: string;
+  color?: string;
+}
+
+export interface DisplayRow {
+  key: string;
+  entry: ConsoleLogEntry;
+  /** Group-nesting indentation level. */
+  depth: number;
+  /** >1 when consecutive identical messages were collapsed. */
+  repeatCount: number;
+  /** True for console.group / groupCollapsed header rows. */
+  isGroupHeader: boolean;
+  /** For headers: the group id (the start entry's id). */
+  groupId?: number;
+  /** For headers: whether the group is currently collapsed. */
+  groupCollapsed?: boolean;
+  /** The grouping key for this row's origin (per the active dimension). */
+  sourceKey?: string | null;
+  /** lnav-style single-column gutter glyph (┌ │ └ ─) — chrono/cluster modes. */
+  bracketGlyph?: string;
+  /** Multi-column swimlane gutter cells — swimlane mode. */
+  lanes?: LaneCell[];
+  /** Color for this row's origin bracket + label. */
+  originColor?: string;
+  /** Human label for the row's origin (component / function / call site). */
+  originLabel?: string;
+  /** Set on the synthetic header of a collapsed/large cluster (Grouped mode). */
+  clusterHeader?: { key: string; count: number; expanded: boolean };
+}
+
+export interface ConsoleMessagesResult {
+  rows: DisplayRow[];
+  hiddenCount: number;
+  levelCounts: Record<ConsoleLevel, number>;
+  totalCount: number;
+}
+
+interface BuildOptions {
+  levelsMask: LevelsMask;
+  query: string;
+  showTimestamps: boolean;
+  /** groupId → user-overridden collapsed state. */
+  collapsedOverrides: Record<number, boolean>;
+  /** Which origin dimension to group/color rows by. */
+  groupDimension: GroupDimension;
+  /** Gutter layout: chronological brackets, swimlanes, or clustered. */
+  layoutMode: LayoutMode;
+  /** Grouped mode: which large clusters the user has expanded (key → true). */
+  clusterExpanded: Record<string, boolean>;
+}
+
+const MAX_LANES = 5;
+
+/** Grouped mode collapses any source cluster larger than this into a header. */
+const CLUSTER_THRESHOLD = 5;
+
+/** First pass: tag each row with its origin source key, color, and label. */
+function computeSourceInfo(rows: DisplayRow[], dim: GroupDimension): void {
+  for (const row of rows) {
+    const key = sourceKey(row.entry.origin, dim);
+    row.sourceKey = key;
+    row.originColor = key ? colorForKey(key) : undefined;
+    row.originLabel = dim === "off" ? undefined : sourceLabel(row.entry.origin, dim);
+  }
+}
+
+/** lnav single-column gutter: bracket consecutive same-source runs. */
+function attachContiguousBrackets(rows: DisplayRow[]): void {
+  for (let i = 0; i < rows.length; i++) {
+    const key = rows[i].sourceKey;
+    if (key == null) {
+      rows[i].bracketGlyph = undefined;
+      continue;
+    }
+    const sameAsPrev = i > 0 && rows[i - 1].sourceKey === key;
+    const sameAsNext = i < rows.length - 1 && rows[i + 1].sourceKey === key;
+    const bracket: Bracket =
+      !sameAsPrev && !sameAsNext
+        ? "single"
+        : !sameAsPrev
+          ? "top"
+          : !sameAsNext
+            ? "bottom"
+            : "mid";
+    rows[i].bracketGlyph = bracketGlyph(bracket);
+  }
+}
+
+/**
+ * Re-order rows so all rows of one source are contiguous (groups ordered by
+ * first appearance, chronological within each). Clusters larger than
+ * CLUSTER_THRESHOLD collapse into a single expandable header (Chrome-style),
+ * unless the user has expanded that cluster.
+ */
+function clusterRows(rows: DisplayRow[], expanded: Record<string, boolean>): DisplayRow[] {
+  const order: string[] = [];
+  const groups = new Map<string, DisplayRow[]>();
+  for (const r of rows) {
+    const k = r.sourceKey ?? "—";
+    let g = groups.get(k);
+    if (!g) {
+      g = [];
+      groups.set(k, g);
+      order.push(k);
+    }
+    g.push(r);
+  }
+
+  const out: DisplayRow[] = [];
+  for (const k of order) {
+    const group = groups.get(k)!;
+    for (const r of group) r.depth = 0; // clustering ignores console.group nesting
+
+    const isLarge = group.length > CLUSTER_THRESHOLD;
+    const isExpanded = expanded[k] ?? false;
+
+    if (isLarge) {
+      out.push({
+        key: `cluster:${k}`,
+        entry: group[0].entry,
+        depth: 0,
+        repeatCount: 1,
+        isGroupHeader: false,
+        sourceKey: k,
+        originColor: group[0].originColor,
+        originLabel: group[0].originLabel,
+        clusterHeader: { key: k, count: group.length, expanded: isExpanded },
+      });
+      if (!isExpanded) continue;
+    }
+
+    group.forEach((r, i) => {
+      const single = group.length === 1;
+      const bracket: Bracket = single
+        ? "single"
+        : i === 0
+          ? "top"
+          : i === group.length - 1
+            ? "bottom"
+            : "mid";
+      r.bracketGlyph = bracketGlyph(bracket);
+      out.push(r);
+    });
+  }
+  return out;
+}
+
+/** Git-graph swimlanes: each source gets a continuous vertical track so its
+ * line stays unbroken when other sources interrupt it. */
+function attachSwimlanes(rows: DisplayRow[]): void {
+  const first = new Map<string, number>();
+  const last = new Map<string, number>();
+  rows.forEach((r, i) => {
+    const k = r.sourceKey;
+    if (k == null) return;
+    if (!first.has(k)) first.set(k, i);
+    last.set(k, i);
+  });
+
+  // Assign each source a lane, reusing a lane once its occupant's run ended.
+  const sources = [...first.keys()].sort((a, b) => first.get(a)! - first.get(b)!);
+  const laneOf = new Map<string, number>();
+  const laneEnd: number[] = [];
+  for (const s of sources) {
+    let lane = laneEnd.findIndex((end) => end < first.get(s)!);
+    if (lane === -1) {
+      lane = laneEnd.length < MAX_LANES ? laneEnd.length : MAX_LANES - 1;
+      if (lane >= laneEnd.length) laneEnd.push(0);
+    }
+    laneOf.set(s, lane);
+    laneEnd[lane] = Math.max(laneEnd[lane] ?? 0, last.get(s)!);
+  }
+  const laneCount = Math.max(1, Math.min(laneEnd.length, MAX_LANES));
+
+  rows.forEach((r, i) => {
+    const cells: LaneCell[] = Array.from({ length: laneCount }, () => ({ glyph: " " }));
+    for (const s of sources) {
+      const lane = laneOf.get(s)!;
+      if (lane >= laneCount) continue;
+      if (i >= first.get(s)! && i <= last.get(s)!) {
+        cells[lane] = { glyph: r.sourceKey === s ? "●" : "│", color: colorForKey(s) };
+      }
+    }
+    r.lanes = cells;
+  });
+}
+
+interface OpenGroup {
+  id: number;
+  collapsed: boolean;
+}
+
+const GROUP_STARTS = new Set(["group", "groupCollapsed"]);
+
+function buildDisplayRows(
+  entries: ConsoleLogEntry[],
+  opts: BuildOptions
+): ConsoleMessagesResult {
+  const { levelsMask, query, showTimestamps, collapsedOverrides } = opts;
+  const parsed = parseFilterQuery(query.trim());
+
+  const rows: DisplayRow[] = [];
+  const levelCounts: Record<ConsoleLevel, number> = {
+    verbose: 0,
+    info: 0,
+    warning: 0,
+    error: 0,
+  };
+  let hiddenCount = 0;
+  const stack: OpenGroup[] = [];
+
+  const anyAncestorCollapsed = () => stack.some((g) => g.collapsed);
+
+  for (const entry of entries) {
+    levelCounts[entry.level]++;
+
+    if (entry.method === "groupEnd") {
+      stack.pop();
+      continue;
+    }
+
+    const isHeader = GROUP_STARTS.has(entry.method);
+    const hiddenByGroup = anyAncestorCollapsed();
+    const passesFilter = shouldBeVisible(entry, levelsMask, parsed);
+
+    if (!passesFilter) {
+      hiddenCount++;
+    } else if (!hiddenByGroup) {
+      // Repeat-count collapse: only when timestamps are hidden and the previous
+      // visible row is an identical, non-header message at the same depth.
+      const prev = rows[rows.length - 1];
+      if (
+        !showTimestamps &&
+        !isHeader &&
+        prev &&
+        !prev.isGroupHeader &&
+        prev.depth === stack.length &&
+        prev.entry.method === entry.method &&
+        prev.entry.message === entry.message
+      ) {
+        prev.repeatCount++;
+      } else {
+        rows.push({
+          key: String(entry.id),
+          entry,
+          depth: stack.length,
+          repeatCount: 1,
+          isGroupHeader: isHeader,
+          groupId: isHeader ? entry.id : undefined,
+          groupCollapsed: undefined,
+        });
+      }
+    }
+
+    if (isHeader) {
+      const defaultCollapsed = entry.method === "groupCollapsed";
+      const collapsed = collapsedOverrides[entry.id] ?? defaultCollapsed;
+      // Record the collapse state on the just-pushed header row (if visible).
+      const headerRow = rows[rows.length - 1];
+      if (headerRow && headerRow.groupId === entry.id) {
+        headerRow.groupCollapsed = collapsed;
+      }
+      stack.push({ id: entry.id, collapsed: collapsed || hiddenByGroup });
+    }
+  }
+
+  computeSourceInfo(rows, opts.groupDimension);
+  let finalRows = rows;
+  if (opts.groupDimension !== "off") {
+    if (opts.layoutMode === "cluster") {
+      finalRows = clusterRows(rows, opts.clusterExpanded);
+    } else if (opts.layoutMode === "swimlane") {
+      attachSwimlanes(rows);
+    } else {
+      attachContiguousBrackets(rows);
+    }
+  }
+
+  return { rows: finalRows, hiddenCount, levelCounts, totalCount: entries.length };
+}
+
+export function useConsoleMessages(opts: BuildOptions): ConsoleMessagesResult {
+  const entries = useSyncExternalStore(subscribe, getEntries, getEntries);
+  return useMemo(
+    () => buildDisplayRows(entries, opts),
+    [
+      entries,
+      opts.levelsMask,
+      opts.query,
+      opts.showTimestamps,
+      opts.collapsedOverrides,
+      opts.groupDimension,
+      opts.layoutMode,
+      opts.clusterExpanded,
+    ]
+  );
+}

package/src/hooks/useConsoleLogs.ts

@@ -0,0 +1,26 @@
+import { useSyncExternalStore, useEffect } from "react";
+import {
+  subscribe,
+  getEntries,
+  installConsoleCapture,
+  type ConsoleLogEntry,
+} from "../store/consoleLogStore";
+
+export interface UseConsoleLogsResult {
+  logs: ConsoleLogEntry[];
+}
+
+/**
+ * Subscribe to captured console logs. Installs the console interceptor on mount
+ * (idempotent) and re-renders whenever a new entry is captured or the buffer is
+ * cleared.
+ */
+export function useConsoleLogs(): UseConsoleLogsResult {
+  useEffect(() => {
+    installConsoleCapture();
+  }, []);
+
+  const logs = useSyncExternalStore(subscribe, getEntries, getEntries);
+
+  return { logs };
+}

package/src/index.tsx

@@ -0,0 +1,69 @@
+/**
+ * @buoy-gg/console
+ *
+ * Captures global `console.*` output and renders it as a Buoy devtool.
+ *
+ * This is the BASIC version: direct console patching + a flat list, used to
+ * verify the capture pipeline end to end. Next step is a 1:1 port of Chrome
+ * DevTools' console view.
+ */
+
+// =============================================================================
+// PRESET (Primary entry point — pass to <FloatingDevTools apps={[...]} />)
+// =============================================================================
+export { consoleToolPreset, createConsoleTool } from "./preset";
+
+// =============================================================================
+// ROOT (Mount once at app root to capture logs from startup)
+// =============================================================================
+export { ConsoleRoot } from "./components/ConsoleRoot";
+
+// =============================================================================
+// COMPONENTS
+// =============================================================================
+export { ConsoleModal } from "./components/ConsoleModal";
+export { ConsoleIcon, CONSOLE_ICON_COLOR } from "./components/ConsoleIcon";
+
+// DevTools-style console panel (the 1:1 Chrome console port)
+export { ConsoleView } from "./devtools/ConsoleView";
+export { ConsoleMessageRow } from "./devtools/ConsoleMessageRow";
+export { ConsoleValue } from "./devtools/ConsoleValue";
+export { useConsoleMessages } from "./devtools/useConsoleMessages";
+export type { DisplayRow, ConsoleMessagesResult } from "./devtools/useConsoleMessages";
+export { consoleTheme, levelStyles } from "./devtools/theme";
+
+// Basic flat list (kept for simple/embedded use)
+export { ConsoleLogList } from "./components/ConsoleLogList";
+
+// =============================================================================
+// HOOK
+// =============================================================================
+export { useConsoleLogs } from "./hooks/useConsoleLogs";
+export type { UseConsoleLogsResult } from "./hooks/useConsoleLogs";
+
+// =============================================================================
+// EXTERNAL SYNC (device → desktop dashboard)
+// =============================================================================
+export { consoleSyncAdapter } from "./sync/consoleSyncAdapter";
+
+// =============================================================================
+// CAPTURE STORE (install/teardown + types)
+// =============================================================================
+export {
+  installConsoleCapture,
+  uninstallConsoleCapture,
+  clearEntries,
+  getEntries,
+  subscribe,
+  replaceEntries,
+  onClear,
+  initConsolePersistence,
+  getPreserveLog,
+  setPreserveLog,
+  subscribePreserveLog,
+} from "./store/consoleLogStore";
+export type {
+  ConsoleLogEntry,
+  ConsoleLevel,
+  ConsoleMethod,
+} from "./store/consoleLogStore";