@buoy-gg/console 4.0.2

package/lib/typescript/devtools/consoleFormat.d.ts

@@ -0,0 +1,29 @@
+/**
+ * consoleFormat — port of DevTools `panels/console/ConsoleFormat.ts`.
+ *
+ * Implements the WHATWG console Formatter: %s/%d/%i/%f/%o/%O/%c/%_ substitutions
+ * plus ANSI SGR (\x1B[…m) styling. Where DevTools works over V8 RemoteObjects we
+ * work over raw JS values; the substitution/ANSI logic is otherwise 1:1.
+ *
+ * Output is a flat list of tokens the row renderer consumes:
+ *  - { type: 'string', value, style? }  — text, optionally styled by %c / ANSI
+ *  - { type: 'value', value, mode }     — an object/array substitution (%o/%O)
+ *                                         or a trailing non-string argument
+ */
+import type { TextStyle } from "react-native";
+export type FormatToken = {
+    type: "string";
+    value: string;
+    style?: TextStyle;
+} | {
+    type: "value";
+    value: unknown;
+    mode: "optimal" | "generic";
+};
+/**
+ * Format a console call's arguments into renderable tokens, mirroring how the
+ * DevTools console renders a message: if the first arg is a format string it
+ * drives substitution, then any leftover args are appended (space-separated).
+ */
+export declare function formatConsoleMessage(args: unknown[]): FormatToken[];
+//# sourceMappingURL=consoleFormat.d.ts.map

package/lib/typescript/devtools/consoleFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consoleFormat.d.ts","sourceRoot":"","sources":["../../../src/devtools/consoleFormat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAA;CAAE,CAAC;AA2QnE;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,WAAW,EAAE,CAuBnE"}

package/lib/typescript/devtools/origin.d.ts

@@ -0,0 +1,39 @@
+/**
+ * origin — attributes a console call to *where it came from*, and provides the
+ * lnav-style colored connecting bracket helpers.
+ *
+ * Three independent signals (captured in the store at log time):
+ *  - **component**  — nearest owning React component (React.captureOwnerStack,
+ *    dev only; null outside render / in async callbacks)
+ *  - **function**   — the enclosing function of the call site (JS stack)
+ *  - **callSite**   — the exact `file:line` of the call site (JS stack)
+ *
+ * The view groups consecutive same-source rows and draws a colored bracket
+ * gutter (┌ │ └ ─) exactly like lnav's per-file gutter.
+ */
+export type GroupDimension = "component" | "callsite" | "function" | "off";
+export interface LogOrigin {
+    component?: string;
+    functionName?: string;
+    callSite?: string;
+    file?: string;
+    line?: number;
+}
+/** Derive the origin of a log from its captured JS stack + React owner stack. */
+export declare function parseOrigin(stack?: string, ownerStack?: string): LogOrigin | undefined;
+/**
+ * Stable key used to group consecutive rows (null = ungrouped).
+ *
+ * Each dimension falls back to the next-best signal so a row is never lumped
+ * into a single catch-all bucket: a handler-fired log (no React owner) still
+ * differentiates by its function / call site under "Component".
+ */
+export declare function sourceKey(origin: LogOrigin | undefined, dim: GroupDimension): string | null;
+/** Human label shown next to the row. */
+export declare function sourceLabel(origin: LogOrigin | undefined, dim: GroupDimension): string;
+/** Stable, readable color for a source key (bright enough for a dark surface). */
+export declare function colorForKey(key: string): string;
+export type Bracket = "top" | "mid" | "bottom" | "single";
+/** lnav gutter glyph: ┌ run-start · │ run-middle · └ run-end · ─ single. */
+export declare function bracketGlyph(bracket: Bracket): string;
+//# sourceMappingURL=origin.d.ts.map

package/lib/typescript/devtools/origin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"origin.d.ts","sourceRoot":"","sources":["../../../src/devtools/origin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,KAAK,CAAC;AAE3E,MAAM,WAAW,SAAS;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAiFD,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAgBtF;AAID;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,EAAE,GAAG,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAS3F;AAED,yCAAyC;AACzC,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,EAAE,GAAG,EAAE,cAAc,GAAG,MAAM,CAgBtF;AAUD,kFAAkF;AAClF,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED,MAAM,MAAM,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE1D,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAWrD"}

package/lib/typescript/devtools/theme.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 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.
+ */
+/**
+ * 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 declare const monoFont: string;
+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 declare const lightTheme: ConsoleColors;
+/** Dark theme (active) — matched to Buoy macOSColors, contrast-tuned. */
+export declare const darkTheme: ConsoleColors;
+/** The active console palette. */
+export declare const consoleTheme: ConsoleColors;
+/** ANSI 16-color palette (dark theme), from consoleView.css `--console-color-*`. */
+export declare const ansiColors: Record<string, string>;
+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 declare const levelStyles: Record<ConsoleLevel, LevelStyle>;
+//# sourceMappingURL=theme.d.ts.map

package/lib/typescript/devtools/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../src/devtools/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,EAAE,MAIJ,CAAC;AAEpB,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,mEAAmE;AACnE,eAAO,MAAM,UAAU,EAAE,aAkBxB,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,SAAS,EAAE,aAkBvB,CAAC;AAEF,kCAAkC;AAClC,eAAO,MAAM,YAAY,EAAE,aAAyB,CAAC;AAErD,oFAAoF;AACpF,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAiB7C,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpE,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,IAAI,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;CAC5B;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,YAAY,EAAE,UAAU,CAaxD,CAAC"}

package/lib/typescript/devtools/useConsoleController.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 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 { type Dispatch, type SetStateAction } from "react";
+import { type DisplayRow, type LayoutMode } from "./useConsoleMessages";
+import { type LevelsMask } from "./consoleFilter";
+/** 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 declare function useConsoleController(): ConsoleController;
+//# sourceMappingURL=useConsoleController.d.ts.map

package/lib/typescript/devtools/useConsoleController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConsoleController.d.ts","sourceRoot":"","sources":["../../../src/devtools/useConsoleController.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAyB,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AAClF,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,UAAU,EAChB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAC;AAGzB,oFAAoF;AACpF,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAAC;AAElD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3C,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IACnD,UAAU,EAAE,UAAU,CAAC;IACvB,aAAa,EAAE,QAAQ,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC;IACpD,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IACrD,UAAU,EAAE,UAAU,CAAC;IACvB,aAAa,EAAE,QAAQ,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC;IACpD,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,QAAQ,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACpD,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,OAAO,KAAK,IAAI,CAAC;IACtE,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,iEAAiE;IACjE,YAAY,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,oBAAoB,IAAI,iBAAiB,CAyDxD"}

package/lib/typescript/devtools/useConsoleMessages.d.ts

@@ -0,0 +1,74 @@
+/**
+ * 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 { type ConsoleLogEntry, type ConsoleLevel } from "../store/consoleLogStore";
+import { type LevelsMask } from "./consoleFilter";
+import { type GroupDimension } 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>;
+}
+export declare function useConsoleMessages(opts: BuildOptions): ConsoleMessagesResult;
+export {};
+//# sourceMappingURL=useConsoleMessages.d.ts.map

package/lib/typescript/devtools/useConsoleMessages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConsoleMessages.d.ts","sourceRoot":"","sources":["../../../src/devtools/useConsoleMessages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,YAAY,EAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAKL,KAAK,cAAc,EAEpB,MAAM,UAAU,CAAC;AAElB,yCAAyC;AACzC,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAE3D,gCAAgC;AAChC,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,eAAe,CAAC;IACvB,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,aAAa,EAAE,OAAO,CAAC;IACvB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,aAAa,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;CACnE;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC1C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,YAAY;IACpB,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,OAAO,CAAC;IACxB,iDAAiD;IACjD,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,qDAAqD;IACrD,cAAc,EAAE,cAAc,CAAC;IAC/B,sEAAsE;IACtE,UAAU,EAAE,UAAU,CAAC;IACvB,6EAA6E;IAC7E,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAwOD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,qBAAqB,CAe5E"}

package/lib/typescript/hooks/useConsoleLogs.d.ts

@@ -0,0 +1,11 @@
+import { 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 declare function useConsoleLogs(): UseConsoleLogsResult;
+//# sourceMappingURL=useConsoleLogs.d.ts.map

package/lib/typescript/hooks/useConsoleLogs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConsoleLogs.d.ts","sourceRoot":"","sources":["../../../src/hooks/useConsoleLogs.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,eAAe,EAAE,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,oBAAoB,CAQrD"}

package/lib/typescript/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @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.
+ */
+export { consoleToolPreset, createConsoleTool } from "./preset";
+export { ConsoleRoot } from "./components/ConsoleRoot";
+export { ConsoleModal } from "./components/ConsoleModal";
+export { ConsoleIcon, CONSOLE_ICON_COLOR } from "./components/ConsoleIcon";
+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";
+export { ConsoleLogList } from "./components/ConsoleLogList";
+export { useConsoleLogs } from "./hooks/useConsoleLogs";
+export type { UseConsoleLogsResult } from "./hooks/useConsoleLogs";
+export { consoleSyncAdapter } from "./sync/consoleSyncAdapter";
+export { installConsoleCapture, uninstallConsoleCapture, clearEntries, getEntries, subscribe, replaceEntries, onClear, initConsolePersistence, getPreserveLog, setPreserveLog, subscribePreserveLog, } from "./store/consoleLogStore";
+export type { ConsoleLogEntry, ConsoleLevel, ConsoleMethod, } from "./store/consoleLogStore";
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAKhE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAKvD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAG3E,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,YAAY,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG7D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAK7D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAKnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAK/D,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,YAAY,EACZ,UAAU,EACV,SAAS,EACT,cAAc,EACd,OAAO,EACP,sBAAsB,EACtB,cAAc,EACd,cAAc,EACd,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,eAAe,EACf,YAAY,EACZ,aAAa,GACd,MAAM,yBAAyB,CAAC"}

package/lib/typescript/preset.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Pre-configured Console tool for FloatingDevTools.
+ *
+ * @example
+ * ```tsx
+ * import { consoleToolPreset } from '@buoy-gg/console';
+ *
+ * <FloatingDevTools apps={[consoleToolPreset]} />
+ * ```
+ */
+import { ConsoleModal } from "./components/ConsoleModal";
+export declare const consoleToolPreset: {
+    id: string;
+    name: string;
+    description: string;
+    slot: "both";
+    icon: ({ size, color }: {
+        size: number;
+        color?: string;
+    }) => import("react").JSX.Element;
+    component: typeof ConsoleModal;
+};
+/** Create a custom Console tool configuration. */
+export declare function createConsoleTool(options?: {
+    name?: string;
+    description?: string;
+}): {
+    name: string;
+    description: string;
+    id: string;
+    slot: "both";
+    icon: ({ size, color }: {
+        size: number;
+        color?: string;
+    }) => import("react").JSX.Element;
+    component: typeof ConsoleModal;
+};
+//# sourceMappingURL=preset.d.ts.map

package/lib/typescript/preset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset.d.ts","sourceRoot":"","sources":["../../src/preset.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,eAAO,MAAM,iBAAiB;;;;;4BAKJ;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;;CAIzD,CAAC;AAEF,kDAAkD;AAClD,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO;;;;;4BAR7B;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;;EAezD"}

package/lib/typescript/store/consoleLogStore.d.ts

@@ -0,0 +1,71 @@
+/**
+ * consoleLogStore
+ *
+ * Intercepts the global `console` methods and keeps a bounded ring buffer of
+ * captured entries, modeled after Chrome DevTools' ConsoleMessage. Direct
+ * console patching is the capture path (works identically on Expo, RN CLI, and
+ * web). The DevTools-style view layer (filtering, formatting, grouping) is built
+ * on top of these raw entries.
+ *
+ * By default the buffer is in-memory only, so a JS reload starts fresh — just
+ * like the Metro/Chrome console. A "Preserve log" toggle persists the buffer to
+ * storage and restores it on the next launch (Chrome's "Preserve log").
+ */
+import { type LogOrigin } from "../devtools/origin";
+/** The console method that produced an entry. */
+export type ConsoleMethod = "log" | "info" | "warn" | "error" | "debug" | "trace" | "dir" | "table" | "assert" | "group" | "groupCollapsed" | "groupEnd";
+/** DevTools log levels (Protocol.Log.LogEntryLevel). */
+export type ConsoleLevel = "verbose" | "info" | "warning" | "error";
+export interface ConsoleLogEntry {
+    /** Monotonic id, unique per captured entry. */
+    id: number;
+    /** The console method that produced this entry. */
+    method: ConsoleMethod;
+    /** DevTools level, derived from the method. */
+    level: ConsoleLevel;
+    /** The raw arguments passed to the console method. */
+    args: unknown[];
+    /** Pre-rendered single-line text (used for filtering + the simple list). */
+    message: string;
+    /** Capture time in ms since epoch. */
+    timestamp: number;
+    /** Captured JS stack (error/warn/trace only), newest frame first. */
+    stack?: string;
+    /** Where the log came from (component / function / call site). */
+    origin?: LogOrigin;
+}
+type Listener = () => void;
+/**
+ * Patch the global console methods. Idempotent — safe to call more than once.
+ * Each patched method still forwards to the original so normal logging keeps
+ * working (Metro terminal, Chrome, native logcat/Xcode).
+ */
+export declare function installConsoleCapture(): void;
+/** Restore the original console methods. */
+export declare function uninstallConsoleCapture(): void;
+/** Subscribe to changes. Returns an unsubscribe function. */
+export declare function subscribe(listener: Listener): () => void;
+/** Current snapshot (stable reference between mutations for useSyncExternalStore). */
+export declare function getEntries(): ConsoleLogEntry[];
+/** Clear all captured entries. Fires onClear listeners (e.g. to forward the
+ * clear to a remote device when running in mirror mode). */
+export declare function clearEntries(): void;
+/** Replace the whole entry list from a remote snapshot. */
+export declare function replaceEntries(next: ConsoleLogEntry[]): void;
+/** Register a listener fired when clearEntries() is called. Returns an
+ * unsubscribe function. Used by the dashboard to forward clears to the device. */
+export declare function onClear(listener: Listener): () => void;
+/**
+ * Load the persisted preserve-log flag and, if enabled, restore the saved
+ * buffer. If disabled, drop any saved buffer so the session starts fresh.
+ * Idempotent — safe to call from ConsoleRoot on every mount.
+ */
+export declare function initConsolePersistence(): Promise<void>;
+/** Whether logs persist across reload. */
+export declare function getPreserveLog(): boolean;
+/** Toggle preserve-log. Persists the flag; saves or drops the buffer. */
+export declare function setPreserveLog(next: boolean): void;
+/** Subscribe to preserve-log changes. Returns an unsubscribe function. */
+export declare function subscribePreserveLog(listener: Listener): () => void;
+export {};
+//# sourceMappingURL=consoleLogStore.d.ts.map

package/lib/typescript/store/consoleLogStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consoleLogStore.d.ts","sourceRoot":"","sources":["../../../src/store/consoleLogStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEjE,iDAAiD;AACjD,MAAM,MAAM,aAAa,GACrB,KAAK,GACL,MAAM,GACN,MAAM,GACN,OAAO,GACP,OAAO,GACP,OAAO,GACP,KAAK,GACL,OAAO,GACP,QAAQ,GACR,OAAO,GACP,gBAAgB,GAChB,UAAU,CAAC;AAEf,wDAAwD;AACxD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,mDAAmD;IACnD,MAAM,EAAE,aAAa,CAAC;IACtB,+CAA+C;IAC/C,KAAK,EAAE,YAAY,CAAC;IACpB,sDAAsD;IACtD,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAwCD,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAyE3B;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAgB5C;AAED,4CAA4C;AAC5C,wBAAgB,uBAAuB,IAAI,IAAI,CAQ9C;AAED,6DAA6D;AAC7D,wBAAgB,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI,CAKxD;AAED,sFAAsF;AACtF,wBAAgB,UAAU,IAAI,eAAe,EAAE,CAE9C;AAED;4DAC4D;AAC5D,wBAAgB,YAAY,IAAI,IAAI,CAMnC;AAOD,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,IAAI,CAG5D;AAED;kFACkF;AAClF,wBAAgB,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI,CAKtD;AA+CD;;;;GAIG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CA4B5D;AAED,0CAA0C;AAC1C,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAOlD;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI,CAKnE"}

package/lib/typescript/store/sanitize.d.ts

@@ -0,0 +1,11 @@
+/**
+ * sanitizeArgs — deep-convert captured console arguments into JSON-safe values.
+ *
+ * Captured `args` can hold Errors, functions, bigints, symbols, and circular
+ * references. Both the external-sync snapshot (device → desktop) and the
+ * preserve-log persistence need plain JSON, so this produces a structural copy
+ * (objects/arrays preserved so they stay expandable) with cycles broken.
+ */
+/** Deep-sanitize an array of console arguments into JSON-safe values. */
+export declare function sanitizeArgs(args: unknown[]): unknown[];
+//# sourceMappingURL=sanitize.d.ts.map

package/lib/typescript/store/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../../src/store/sanitize.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA8CH,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAGvD"}

package/lib/typescript/sync/consoleSyncAdapter.d.ts

@@ -0,0 +1,30 @@
+/**
+ * consoleSyncAdapter — streams captured console entries from the device to the
+ * desktop dashboard via @buoy-gg/external-sync.
+ *
+ * Structurally matches external-sync's `ToolSyncAdapter` WITHOUT importing the
+ * package (so console has no hard dependency on external-sync, matching how the
+ * other tools' adapters are written). Auto-discovery in @buoy-gg/core picks it
+ * up by the export name and announces the "console" capability.
+ *
+ * Snapshots MUST be JSON-serializable. Captured `args` can hold Errors,
+ * functions, bigints, and circular references, so we deep-sanitize them into
+ * plain JSON values (objects/arrays preserved so they stay expandable on the
+ * dashboard).
+ */
+import { type ConsoleLogEntry } from "../store/consoleLogStore";
+interface ConsoleSnapshot {
+    entries: ConsoleLogEntry[];
+}
+export declare const consoleSyncAdapter: {
+    version: number;
+    getSnapshot(): ConsoleSnapshot;
+    subscribe(onChange: () => void): () => void;
+    actions: {
+        clearEntries(): {
+            cleared: true;
+        };
+    };
+};
+export {};
+//# sourceMappingURL=consoleSyncAdapter.d.ts.map

package/lib/typescript/sync/consoleSyncAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consoleSyncAdapter.d.ts","sourceRoot":"","sources":["../../../src/sync/consoleSyncAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,0BAA0B,CAAC;AAGlC,UAAU,eAAe;IACvB,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,eAAO,MAAM,kBAAkB;;mBAGd,eAAe;wBAQV,MAAM,IAAI,GAAG,MAAM,IAAI;;wBAKzB;YAAE,OAAO,EAAE,IAAI,CAAA;SAAE;;CAKpC,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@buoy-gg/console",
+  "version": "4.0.2",
+  "description": "console package",
+  "main": "lib/commonjs/index",
+  "module": "lib/module/index",
+  "types": "lib/typescript/index.d.ts",
+  "react-native": "src/index.tsx",
+  "source": "src/index.tsx",
+  "files": [
+    "src",
+    "lib"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "@buoy-gg/shared-ui": "4.0.2"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "devDependencies": {
+    "@types/react": "^19.1.0",
+    "@types/react-native": "^0.73.0",
+    "typescript": "~5.8.3"
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      "typescript"
+    ]
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LovesWorking/react-native-buoy.git",
+    "directory": "packages/console"
+  },
+  "bugs": {
+    "url": "https://github.com/LovesWorking/react-native-buoy/issues"
+  },
+  "homepage": "https://github.com/LovesWorking/react-native-buoy/tree/main/packages/console#readme",
+  "publishConfig": {
+    "access": "public",
+    "tag": "latest"
+  },
+  "scripts": {
+    "build": "bob build",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf lib",
+    "test": "pnpm run typecheck",
+    "postinstall": "echo \"Run pnpm build to compile this package\""
+  }
+}

package/src/components/ConsoleIcon.tsx

@@ -0,0 +1,49 @@
+import React from "react";
+import { View, Text, StyleSheet } from "react-native";
+
+/** Tool accent color (terminal green). */
+export const CONSOLE_ICON_COLOR = "#10B981";
+
+interface ConsoleIconProps {
+  size: number;
+  color?: string;
+}
+
+/**
+ * Dependency-free terminal glyph: a rounded window outline with a `>_` prompt.
+ * Rendered in the floating menu and the modal header.
+ */
+export function ConsoleIcon({ size, color = CONSOLE_ICON_COLOR }: ConsoleIconProps) {
+  return (
+    <View
+      style={[
+        styles.frame,
+        {
+          width: size,
+          height: size,
+          borderRadius: size * 0.2,
+          borderColor: color,
+        },
+      ]}
+    >
+      <Text
+        style={{
+          color,
+          fontSize: size * 0.46,
+          fontWeight: "700",
+          fontFamily: "monospace",
+        }}
+      >
+        {">_"}
+      </Text>
+    </View>
+  );
+}
+
+const styles = StyleSheet.create({
+  frame: {
+    borderWidth: 1.5,
+    alignItems: "center",
+    justifyContent: "center",
+  },
+});