@buoy-gg/shared-ui 7.0.33 → 7.0.34

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/stores/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,qBAAqB,GAC3B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,EACxB,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,GAC9B,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/stores/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,qBAAqB,GAC3B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,EACxB,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,GAC9B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,eAAe,EACf,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,SAAS,EACT,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,UAAU,GAChB,MAAM,aAAa,CAAC"}

package/lib/typescript/commonjs/sync/toolSyncAdapter.d.ts

@@ -0,0 +1,66 @@
+/**
+ * ToolSyncAdapter — the contract a tool implements to sync to Buoy Desktop /
+ * the MCP server, plus `createSyncAdapter`, the one way to build one.
+ *
+ * Every tool package used to declare its adapter as a bare object literal
+ * with the comment "structurally matches external-sync's ToolSyncAdapter so
+ * this package doesn't need a dependency on it". That kept the packages
+ * decoupled but left the contract unchecked: storage shipped `version: 3`
+ * while every sibling was on 2 and nothing noticed. The type now lives here,
+ * in shared (which every tool already depends on), and external-sync
+ * re-exports it — one definition, checked everywhere.
+ *
+ * `createSyncAdapter` is deliberately thin. It:
+ *  - type-checks the literal against the contract (a wrong `subscribe`
+ *    signature or a non-function action fails at compile time),
+ *  - keeps the CONCRETE `actions` type, so `adapter.actions.getChangeDetail()`
+ *    stays typed for tests and callers,
+ *  - merges several change sources into one `subscribe` (a store plus its
+ *    registry, envelopes plus drops) — the second most-copied block.
+ */
+/** A remote-invocable action. Thrown errors are reported back to the dashboard. */
+export type ToolAction = (params: unknown) => unknown | Promise<unknown>;
+/** Anything that can tell the bridge "something changed". */
+export type ChangeSource = (onChange: () => void) => () => void;
+/**
+ * The contract each dev tool implements to become remotely syncable.
+ * Works with BaseEventStore, ChangeLog, createToolStore, or any pattern
+ * exposing subscribe + getSnapshot.
+ *
+ * Payloads (snapshots and action results) must be JSON-serializable —
+ * no functions, circular references, or class instances.
+ */
+export interface ToolSyncAdapter {
+    /** Version of this tool's payload shape. Bump on breaking changes. */
+    version: number;
+    /** Current full state — sent when a dashboard starts watching or requests state. */
+    getSnapshot: () => unknown;
+    /**
+     * Fires on state changes. Only called while at least one dashboard is
+     * watching this tool; the bridge subscribes/unsubscribes on demand so
+     * stores with auto start/stop lifecycles stay idle when unwatched.
+     */
+    subscribe: ChangeSource;
+    /** Remote-invocable actions, keyed by action name. */
+    actions?: Record<string, ToolAction>;
+}
+export interface SyncAdapterDefinition<TSnapshot, TActions extends Record<string, ToolAction> | undefined> {
+    version: number;
+    getSnapshot: () => TSnapshot;
+    /** One source, or several that are merged into a single subscription. */
+    subscribe: ChangeSource | ChangeSource[];
+    actions?: TActions;
+}
+export type SyncAdapter<TSnapshot, TActions extends Record<string, ToolAction> | undefined> = {
+    version: number;
+    getSnapshot: () => TSnapshot;
+    subscribe: ChangeSource;
+} & (TActions extends undefined ? {
+    actions?: undefined;
+} : {
+    actions: TActions;
+});
+/** Subscribe to every source; the returned function unsubscribes from all. */
+export declare function mergeChangeSources(sources: ChangeSource[]): ChangeSource;
+export declare function createSyncAdapter<TSnapshot, TActions extends Record<string, ToolAction> | undefined = undefined>(definition: SyncAdapterDefinition<TSnapshot, TActions>): SyncAdapter<TSnapshot, TActions>;
+//# sourceMappingURL=toolSyncAdapter.d.ts.map

package/lib/typescript/commonjs/sync/toolSyncAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolSyncAdapter.d.ts","sourceRoot":"","sources":["../../../../src/sync/toolSyncAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,mFAAmF;AACnF,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEzE,6DAA6D;AAC7D,MAAM,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;AAEhE;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,WAAW,EAAE,MAAM,OAAO,CAAC;IAC3B;;;;OAIG;IACH,SAAS,EAAE,YAAY,CAAC;IACxB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,qBAAqB,CACpC,SAAS,EACT,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,SAAS;IAEvD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,SAAS,CAAC;IAC7B,yEAAyE;IACzE,SAAS,EAAE,YAAY,GAAG,YAAY,EAAE,CAAC;IACzC,OAAO,CAAC,EAAE,QAAQ,CAAC;CACpB;AAED,MAAM,MAAM,WAAW,CACrB,SAAS,EACT,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,SAAS,IACrD;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,SAAS,CAAC;IAC7B,SAAS,EAAE,YAAY,CAAC;CACzB,GAAG,CAAC,QAAQ,SAAS,SAAS,GAAG;IAAE,OAAO,CAAC,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAC;AAEnF,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,YAAY,CAQxE;AAED,wBAAgB,iBAAiB,CAC/B,SAAS,EACT,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,SAAS,GAAG,SAAS,EACnE,UAAU,EAAE,qBAAqB,CAAC,SAAS,EAAE,QAAQ,CAAC,GAAG,WAAW,CAAC,SAAS,EAAE,QAAQ,CAAC,CAW1F"}

package/lib/typescript/commonjs/sync/wireForm.d.ts

@@ -0,0 +1,100 @@
+/**
+ * wireForm — how a tool turns what it holds into what it may put on the wire.
+ *
+ * Every adapter that ships large values faces the same four problems, and
+ * nine of them solved each one separately:
+ *
+ *  1. A per-item cap on the snapshot stream (16 KB), with a MARKER left in
+ *     the value's place so the dashboard knows to fetch it on demand.
+ *  2. A much larger cap on that on-demand detail fetch (8 MB), with a
+ *     TRUNCATION NOTE when even that is exceeded.
+ *  3. An identity-keyed cache for the wire form, because a snapshot is
+ *     rebuilt ~5×/sec while a dashboard watches and stores never mutate a
+ *     recorded item — so converting each item once is correct and cheap.
+ *  4. For tools whose items are individually fat (console, sentry), a
+ *     newest-first walk that keeps as many items as fit a snapshot budget.
+ *
+ * Marker KEY NAMES are part of the wire protocol — Buoy Desktop and the
+ * tool stores test for `__buoyStateOnDevice`, `__buoyPayloadOnDevice`,
+ * `__buoyValueOnDevice` — so the factory builds exactly those keys.
+ */
+/** Per-item budget on the snapshot stream. Anything larger stays on-device. */
+export declare const WIRE_INLINE_LIMIT_BYTES: number;
+/**
+ * Upper bound for one on-demand detail response. Generous — this is a single
+ * explicit fetch, not a per-item stream — but still guarded so a pathological
+ * tree can't OOM the device through the reply emit.
+ */
+export declare const WIRE_DETAIL_LIMIT_BYTES: number;
+/** A frozen `{ __buoy<Kind>OnDevice: true, note }` marker. */
+export type OnDeviceMarker<K extends string> = Readonly<{
+    [P in `__buoy${K}OnDevice`]: true;
+} & {
+    note: string;
+}>;
+/**
+ * Build the sentinel a wire-form snapshot carries in place of a value that
+ * stays on the device. `kind` names the value ("State", "Payload", "Value",
+ * "Params", "Data", …) and becomes the key the reader tests for.
+ */
+export declare function onDeviceMarker<K extends string>(kind: K, note: string): OnDeviceMarker<K>;
+/** True when `value` is the on-device marker for `kind`. */
+export declare function isOnDeviceMarker(value: unknown, kind: string): boolean;
+/** The note a detail fetch returns when a single field exceeds the detail cap. */
+export declare function truncatedNote(limitBytes?: number): {
+    __buoyTruncated: true;
+    note: string;
+};
+/**
+ * The value itself if it fits `limit` (and is serializable), else `marker`.
+ * `undefined` passes through untouched: an absent field must stay absent.
+ */
+export declare function toWire<T>(value: unknown, marker: T, limit?: number): unknown;
+/** Detail-fetch cap: the value, or a truncation note when it is too big. */
+export declare function capDetail(value: unknown, limit?: number): unknown;
+/**
+ * Memoize a wire-form conversion by item identity. Correct for any store
+ * that prepends and never mutates a recorded item — the cache self-invalidates
+ * when the item is dropped from the buffer.
+ */
+export declare function memoByIdentity<T extends object, R>(convert: (item: T) => R): (item: T) => R;
+export interface WireSized<T> {
+    value: T;
+    bytes: number;
+}
+export interface NewestFittingOptions<T, W> {
+    /** Convert one item to its wire form and its byte cost. Memoize with `memoByIdentity`. */
+    toWire: (item: T) => WireSized<W>;
+    /** Snapshot byte budget. */
+    budget: number;
+    /** Bytes the envelope around the list costs (`{"entries":[]}` ≈ 16). */
+    baseBytes?: number;
+}
+/**
+ * Walk `items` (oldest-first) from the newest end, keeping every item until
+ * the budget is spent. Always keeps at least one so an over-budget newest
+ * item still reaches the dashboard as a stub rather than an empty panel.
+ * Returns oldest-first, matching the input.
+ */
+export declare function newestFitting<T, W>(items: T[], options: NewestFittingOptions<T, W>): W[];
+/**
+ * Size one wire-form item against a per-item cap, substituting a stub when it
+ * is too fat. One walk decides both "too big?" and "what does it cost".
+ */
+export declare function sizeOrStub<W>(wired: W, limit: number, stub: () => W): WireSized<W>;
+/** `(params as T | undefined) ?? {}` — the first line of every action. */
+export declare function readParams<T extends object>(params: unknown): Partial<T>;
+export type DetailResult<R extends object> = {
+    found: false;
+    reason: "missing id" | "unknown id";
+} | ({
+    found: true;
+    id: string;
+} & R);
+/**
+ * The on-demand detail action every change-log tool exposes: look one item
+ * up by id, and return its detail fields size-capped. Replaces the
+ * `missing id` / `unknown id` boilerplate copied into each adapter.
+ */
+export declare function detailByIdAction<T, R extends object>(lookup: (id: string) => T | undefined, detail: (item: T, cap: (value: unknown) => unknown) => R, limit?: number): (params?: unknown) => DetailResult<R>;
+//# sourceMappingURL=wireForm.d.ts.map

package/lib/typescript/commonjs/sync/wireForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wireForm.d.ts","sourceRoot":"","sources":["../../../../src/sync/wireForm.ts"],"names":[],"mappings":"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"}

package/lib/typescript/commonjs/tools/defineTool.d.ts

@@ -0,0 +1,100 @@
+/**
+ * defineToolPreset / createToolFactory — the typed way to declare a tool.
+ *
+ * Every tool package exports a `xToolPreset` object literal and a
+ * `createXTool(options)` factory that restates the same literal with
+ * `options?.name || default` on each field. None of the 23 presets was
+ * annotated with core's `InstalledApp`, so a preset that drifted from the
+ * contract (a bad `slot`, a missing `component`) failed at runtime in the
+ * dial, not at compile time.
+ *
+ * `ToolPreset` is that contract, declared here in shared (which every tool
+ * already depends on) and structurally identical to core's `InstalledApp`.
+ * `defineToolPreset` is an identity function that type-checks the literal;
+ * `createToolFactory` derives the `createXTool` function from the preset so
+ * the defaults live in exactly one place.
+ *
+ * Auto-discovery (core's `autoDiscoverPresets` / `autoExternalSync`) stays
+ * as hand-written `require()` blocks on purpose: Metro needs each package
+ * name as a static string lexically inside its own try, so a manifest can't
+ * replace them.
+ */
+import type { ComponentType, ReactNode } from "react";
+import type { ToolSyncAdapter } from "../sync/toolSyncAdapter";
+/** Where a tool should render within the floating menu surface. */
+export type ToolSlot = "row" | "dial" | "both";
+/** What an icon renderer receives. Mirrors core's `FloatingMenuRenderCtx`. */
+export interface ToolIconContext {
+    slot: ToolSlot;
+    size: number;
+    color?: string;
+    state?: Record<string, unknown>;
+    actions?: Record<string, (...args: any[]) => void>;
+}
+/** Declarative modal chrome for a body-only tool. Mirrors core's `ToolModalConfig`. */
+export interface ToolModalChrome {
+    title?: string;
+    subtitle?: string;
+    searchable?: boolean;
+    searchPlaceholder?: string;
+    headerActions?: ReactNode;
+    initialMode?: "bottomSheet" | "floating";
+}
+export type ToolLaunchMode = "self-modal" | "host-modal" | "inline" | "toggle-only";
+/**
+ * The shape the floating menu installs. Structurally identical to core's
+ * `InstalledApp`; declared here so tool packages can type their presets
+ * without depending on core.
+ */
+export interface ToolPreset<P extends Record<string, unknown> | undefined = Record<string, unknown> | undefined> {
+    /** Unique identifier used for persistence and settings. */
+    id: string;
+    /** Human readable name shown in accessibility labels and modal headers. */
+    name: string;
+    /** Brief description of what this tool does, shown in settings. */
+    description?: string;
+    /** A text icon, a node, or a renderer that adapts to slot and size. */
+    icon: ReactNode | ((ctx: ToolIconContext) => ReactNode);
+    /** Preferred layout slot; defaults to `"both"`. */
+    slot?: ToolSlot;
+    /** Optional accent color for the tool. */
+    color?: string;
+    /** The launched component. */
+    component: ComponentType<any>;
+    /** When set, `component` is a body rendered inside the shared modal shell. */
+    modal?: ToolModalChrome;
+    /** Sync adapter: the tool syncs to Buoy Desktop and is drivable over MCP. */
+    sync?: ToolSyncAdapter;
+    /** Props passed to the launched component. */
+    props?: P;
+    launchMode?: ToolLaunchMode;
+    /** Prevent more than one instance of this app at a time. */
+    singleton?: boolean;
+    onPress?: (actions?: Record<string, (...args: any[]) => void>) => void;
+}
+/** Identity with a type check: the literal must satisfy `ToolPreset`. */
+export declare function defineToolPreset<T extends ToolPreset<Record<string, unknown> | undefined>>(preset: T): T;
+/** The overrides every `createXTool` accepted. */
+export interface ToolPresetOverrides {
+    /** Custom tool ID. */
+    id?: string;
+    /** Tool name shown in the menu. */
+    name?: string;
+    /** Tool description. */
+    description?: string;
+}
+/**
+ * Derive `createXTool(options)` from a preset: id/name/description overrides
+ * apply on top, and `mapProps` turns tool-specific options into `props`
+ * (merged over the preset's defaults).
+ *
+ * ```ts
+ * export const createNetworkTool = createToolFactory(networkToolPreset, (o: { enableSharedModalDimensions?: boolean }) => ({
+ *   enableSharedModalDimensions: o.enableSharedModalDimensions ?? false,
+ * }));
+ * ```
+ */
+export declare function createToolFactory<T extends ToolPreset<Record<string, unknown> | undefined>, O extends object = Record<never, never>>(preset: T, mapProps?: (options: O) => Partial<NonNullable<T["props"]>>, 
+/** Last word on any other preset field (a recolored icon, say). */
+extend?: (options: O, preset: T) => Partial<T>): (options?: O & ToolPresetOverrides) => T;
+//# sourceMappingURL=defineTool.d.ts.map

package/lib/typescript/commonjs/tools/defineTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/defineTool.ts"],"names":[],"mappings":"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"}

package/lib/typescript/commonjs/ui/components/ChangeRow.d.ts

@@ -0,0 +1,52 @@
+/**
+ * ChangeRow — one recorded change in a state tool's history list.
+ *
+ * redux, zustand and jotai each drew the same row on top of `CompactRow`:
+ * a colored status word (the slice / store / atom), a sublabel ("1.2ms ·
+ * 3 keys changed"), the primary line (changed keys or a value preview), a
+ * relative timestamp, and a right-hand badge made of a mono verb (SET,
+ * WRITE, ADDITEM) plus an icon — a lightning bolt when state actually
+ * changed, a clock when the update was slow. The three copies differed
+ * only in how they computed those strings. This component owns the drawing;
+ * tools own the strings.
+ *
+ * testID convention (unchanged from the originals): `${testID}-badge`,
+ * `${testID}-change`, `${testID}-slow`, `${testID}-status`,
+ * `${testID}-sublabel`, `${testID}-keys`.
+ */
+import React, { type ReactNode } from "react";
+export interface ChangeRowProps {
+    /** Status dot + status word color (a category color or the entity's color). */
+    statusColor: string;
+    /** The status word: "Cart", "Replace", "Pending", … */
+    statusLabel: string;
+    /** Line under the status word: duration and diff summary. */
+    sublabel?: string;
+    /** The row's main line: changed keys, a preview, an action type. */
+    primaryText: string;
+    /** Capture time; rendered as a self-ticking relative time. */
+    timestamp: number;
+    /** Mono verb drawn in `statusColor` on the right: "SET", "WRITE", "ADDITEM". */
+    badgeText?: string;
+    /** Draws the ⚡ indicator (state actually changed). */
+    changed?: boolean;
+    /** Draws the 🕒 indicator instead of ⚡ (update exceeded the frame budget). */
+    slow?: boolean;
+    /**
+     * Tool-specific badge content drawn BEFORE the verb (redux's async
+     * "1/2 #3" sequence chip). When set together with `badgeText`, both render.
+     */
+    badgePrefix?: ReactNode;
+    /** Replace the whole badge. Wins over badgeText / changed / slow. */
+    customBadge?: ReactNode;
+    /**
+     * Let CompactRow draw its own plain badge with this text when there is
+     * nothing else to show (no verb, no indicator, no custom badge).
+     */
+    plainBadgeText?: string;
+    onPress?: () => void;
+    testID?: string;
+    accessibilityLabel?: string;
+}
+export declare function ChangeRow({ statusColor, statusLabel, sublabel, primaryText, timestamp, badgeText, changed, slow, badgePrefix, customBadge, plainBadgeText, onPress, testID, accessibilityLabel, }: ChangeRowProps): React.JSX.Element;
+//# sourceMappingURL=ChangeRow.d.ts.map

package/lib/typescript/commonjs/ui/components/ChangeRow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChangeRow.d.ts","sourceRoot":"","sources":["../../../../../src/ui/components/ChangeRow.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAO9C,MAAM,WAAW,cAAc;IAC7B,+EAA+E;IAC/E,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8EAA8E;IAC9E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,qEAAqE;IACrE,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,SAAS,CAAC,EACxB,WAAW,EACX,WAAW,EACX,QAAQ,EACR,WAAW,EACX,SAAS,EACT,SAAS,EACT,OAAe,EACf,IAAY,EACZ,WAAW,EACX,WAAW,EACX,cAAc,EACd,OAAO,EACP,MAAM,EACN,kBAAkB,GACnB,EAAE,cAAc,qBAiDhB"}

package/lib/typescript/commonjs/ui/components/ChipStrip.d.ts

@@ -0,0 +1,41 @@
+/**
+ * ChipStrip — a horizontally scrolling row of filter chips whose taps
+ * don't misfire while the strip is being panned.
+ *
+ * react-query drew this three times (query status, mutation status, storage
+ * type) with the same 5-point / 300 ms swipe-vs-tap discrimination. The
+ * strip and the discrimination live here; the chip is whatever the tool
+ * renders, wired through `useChipTap`.
+ */
+import { type ReactNode } from "react";
+import { type GestureResponderEvent, type StyleProp, type ViewStyle } from "react-native";
+export interface ChipTap {
+    /** Spread onto the ScrollView (or pass `scrollProps` to `ChipStrip`). */
+    scrollProps: {
+        onScrollBeginDrag: () => void;
+        onScrollEndDrag: () => void;
+        onMomentumScrollBegin: () => void;
+        onMomentumScrollEnd: () => void;
+    };
+    /** Give each chip this as `onTouchStart`. */
+    onTouchStart: (event: GestureResponderEvent) => void;
+    /** In a chip's `onPress`: run the action only when this returns true. */
+    isTap: (event?: GestureResponderEvent) => boolean;
+}
+/**
+ * Swipe-vs-tap discrimination for chips inside a horizontal ScrollView.
+ * A press that moved more than a few points, or landed while the strip was
+ * still scrolling, is a pan — not a filter toggle.
+ */
+export declare function useChipTap(): ChipTap;
+export interface ChipStripProps {
+    children: ReactNode;
+    /** From `useChipTap()`. */
+    scrollProps: ChipTap["scrollProps"];
+    /** Sentry label for the scroll view. */
+    sentryLabel?: string;
+    style?: StyleProp<ViewStyle>;
+    contentStyle?: StyleProp<ViewStyle>;
+}
+export declare function ChipStrip({ children, scrollProps, sentryLabel, style, contentStyle }: ChipStripProps): import("react").JSX.Element;
+//# sourceMappingURL=ChipStrip.d.ts.map

package/lib/typescript/commonjs/ui/components/ChipStrip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChipStrip.d.ts","sourceRoot":"","sources":["../../../../../src/ui/components/ChipStrip.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAiC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACtE,OAAO,EAIL,KAAK,qBAAqB,EAC1B,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAOtB,MAAM,WAAW,OAAO;IACtB,yEAAyE;IACzE,WAAW,EAAE;QACX,iBAAiB,EAAE,MAAM,IAAI,CAAC;QAC9B,eAAe,EAAE,MAAM,IAAI,CAAC;QAC5B,qBAAqB,EAAE,MAAM,IAAI,CAAC;QAClC,mBAAmB,EAAE,MAAM,IAAI,CAAC;KACjC,CAAC;IACF,6CAA6C;IAC7C,YAAY,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACrD,yEAAyE;IACzE,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,qBAAqB,KAAK,OAAO,CAAC;CACnD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAmCpC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,SAAS,CAAC;IACpB,2BAA2B;IAC3B,WAAW,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACpC,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,YAAY,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CACrC;AAED,wBAAgB,SAAS,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,cAAc,+BAepG"}

package/lib/typescript/commonjs/ui/components/DetailViewToggle.d.ts

@@ -0,0 +1,36 @@
+/**
+ * DetailViewToggle — the row of view cards at the top of a detail screen
+ * (ACTION · STATE · DIFF, CHANGE · STATE · DIFF, …).
+ *
+ * redux, zustand and jotai each shipped their own copy, differing only in
+ * the view keys, labels and testID prefix. The cards, the accent chrome,
+ * the disabled state (diff with nothing to compare) and the a11y contract
+ * are all one component now; tools pass their `views`.
+ */
+import React, { type ComponentType } from "react";
+export interface DetailViewOption<K extends string = string> {
+    key: K;
+    /** Uppercase short label, e.g. "ACTION". */
+    label: string;
+    /** One-line hint under the label. Omit for the compact (label-only) card. */
+    description?: string;
+    icon: ComponentType<{
+        size: number;
+        color: string;
+    }>;
+    /** Card accent when active. Default: the night accent. */
+    activeColor?: string;
+}
+export interface DetailViewToggleProps<K extends string = string> {
+    views: readonly DetailViewOption<K>[];
+    activeView: K;
+    onViewChange: (view: K) => void;
+    /** Keys that cannot be selected right now (e.g. "diff" with no previous state). */
+    disabledKeys?: readonly K[];
+    /** `${testIDPrefix}-view-${key}` on each card. */
+    testIDPrefix?: string;
+}
+declare function DetailViewToggleImpl<K extends string>({ views, activeView, onViewChange, disabledKeys, testIDPrefix, }: DetailViewToggleProps<K>): React.JSX.Element;
+export declare const DetailViewToggle: typeof DetailViewToggleImpl;
+export {};
+//# sourceMappingURL=DetailViewToggle.d.ts.map

package/lib/typescript/commonjs/ui/components/DetailViewToggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DetailViewToggle.d.ts","sourceRoot":"","sources":["../../../../../src/ui/components/DetailViewToggle.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,EAAQ,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAIxD,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACzD,GAAG,EAAE,CAAC,CAAC;IACP,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAC9D,KAAK,EAAE,SAAS,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;IACtC,UAAU,EAAE,CAAC,CAAC;IACd,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IAChC,mFAAmF;IACnF,YAAY,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC;IAC5B,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,iBAAS,oBAAoB,CAAC,CAAC,SAAS,MAAM,EAAE,EAC9C,KAAK,EACL,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,GACb,EAAE,qBAAqB,CAAC,CAAC,CAAC,qBA8D1B;AAED,eAAO,MAAM,gBAAgB,EAAiC,OAAO,oBAAoB,CAAC"}

package/lib/typescript/commonjs/ui/components/DevToolsCard.d.ts

@@ -51,6 +51,13 @@ export interface DevToolsCardProps {
     testID?: string;
     /** Accessibility label for agents / VoiceOver */
     accessibilityLabel?: string;
+    /**
+     * Collapse the card into ONE accessibility element, so its label is what a
+     * reader (or an agent, or a test) gets instead of the children's text. Only
+     * meaningful on a non-interactive card — an interactive one is already an
+     * element in its own right.
+     */
+    accessible?: boolean;
 }
-export declare function DevToolsCard({ children, onPress, onLongPress, isSelected, disabled, activeOpacity, style, contentStyle, testID, accessibilityLabel, }: DevToolsCardProps): import("react").JSX.Element;
+export declare function DevToolsCard({ children, onPress, onLongPress, isSelected, disabled, activeOpacity, style, contentStyle, testID, accessibilityLabel, accessible, }: DevToolsCardProps): import("react").JSX.Element;
 //# sourceMappingURL=DevToolsCard.d.ts.map

package/lib/typescript/commonjs/ui/components/DevToolsCard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DevToolsCard.d.ts","sourceRoot":"","sources":["../../../../../src/ui/components/DevToolsCard.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAIL,SAAS,EACT,SAAS,EACV,MAAM,cAAc,CAAC;AAGtB;;GAEG;AACH,eAAO,MAAM,uBAAuB;IAClC,yCAAyC;;IAEzC,qDAAqD;;IAErD,oCAAoC;;IAEpC,yBAAyB;;IAEzB,yDAAyD;;IAEzD,mBAAmB;;CAEX,CAAC;AAEX,MAAM,WAAW,iBAAiB;IAChC,mBAAmB;IACnB,QAAQ,EAAE,SAAS,CAAC;IACpB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,sDAAsD;IACtD,YAAY,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACpC,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,OAAO,EACP,WAAW,EACX,UAAkB,EAClB,QAAgB,EAChB,aAAmB,EACnB,KAAK,EACL,YAAY,EACZ,MAAM,EACN,kBAAkB,GACnB,EAAE,iBAAiB,+BAkCnB"}
+{"version":3,"file":"DevToolsCard.d.ts","sourceRoot":"","sources":["../../../../../src/ui/components/DevToolsCard.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAIL,SAAS,EACT,SAAS,EACV,MAAM,cAAc,CAAC;AAGtB;;GAEG;AACH,eAAO,MAAM,uBAAuB;IAClC,yCAAyC;;IAEzC,qDAAqD;;IAErD,oCAAoC;;IAEpC,yBAAyB;;IAEzB,yDAAyD;;IAEzD,mBAAmB;;CAEX,CAAC;AAEX,MAAM,WAAW,iBAAiB;IAChC,mBAAmB;IACnB,QAAQ,EAAE,SAAS,CAAC;IACpB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,sDAAsD;IACtD,YAAY,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACpC,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,OAAO,EACP,WAAW,EACX,UAAkB,EAClB,QAAgB,EAChB,aAAmB,EACnB,KAAK,EACL,YAAY,EACZ,MAAM,EACN,kBAAkB,EAClB,UAAU,GACX,EAAE,iBAAiB,+BAmCnB"}

package/lib/typescript/commonjs/ui/components/EntityFilterView.d.ts

@@ -0,0 +1,51 @@
+/**
+ * EntityFilterView — the "hide these by name" filter screen the state tools
+ * share: a list of registered entities (stores, atoms) you can tap to hide,
+ * the active name patterns with a remove ✕, an add-pattern affordance, and
+ * a how-it-works card.
+ *
+ * zustand and jotai each shipped their own copy (~370 lines apiece). The
+ * tool supplies the entities, the nouns and the testID prefix; the screen
+ * is drawn once.
+ *
+ * testID convention (unchanged from zustand's):
+ *   `${prefix}-filters-scroll`, `${prefix}-filters-${entityKey}-count`,
+ *   `${prefix}-filters-${entityKey}-${slug(name)}`, `${prefix}-filters-count`,
+ *   `${prefix}-filters-add-open`, `${prefix}-filters-add-input`,
+ *   `${prefix}-filters-chip-${slug(pattern)}`.
+ */
+export interface FilterableEntity {
+    /** The name a pattern is matched against and the label shown. */
+    name: string;
+    /** The entity's color (dot + label). */
+    color: string;
+}
+export interface EntityFilterViewProps {
+    /** Registered entities; tap one to hide it. */
+    entities: FilterableEntity[];
+    /** Active hide patterns. */
+    ignoredPatterns: Set<string>;
+    /** Tapping an active pattern removes it. */
+    onTogglePattern: (pattern: string) => void;
+    onAddPattern: (pattern: string) => void;
+    /** Plural noun in caps for the headers: "STORES", "ATOMS". */
+    entityNoun: string;
+    /** Singular noun for copy: "store", "atom". */
+    entitySingular: string;
+    /** Segment used in the per-entity testIDs: "store", "atom". */
+    entityKey: string;
+    /** testID prefix, e.g. "buoy-zustand". */
+    testIDPrefix: string;
+    /** Slug an entity name / pattern for a testID. */
+    slug: (value: string) => string;
+    /** The how-it-works paragraph. */
+    howItWorks: string;
+    /** Example bullet lines (rendered as given). */
+    examples: string[];
+    /** Optional override for the add-pattern placeholder. */
+    addPlaceholder?: string;
+    /** Shown (with `${prefix}-filters-${entityKey}s-empty`) when there are no entities. */
+    emptyMessage?: string;
+}
+export declare function EntityFilterView({ entities, ignoredPatterns, onTogglePattern, onAddPattern, entityNoun, entitySingular, entityKey, testIDPrefix, slug, howItWorks, examples, addPlaceholder, emptyMessage, }: EntityFilterViewProps): import("react").JSX.Element;
+//# sourceMappingURL=EntityFilterView.d.ts.map

package/lib/typescript/commonjs/ui/components/EntityFilterView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityFilterView.d.ts","sourceRoot":"","sources":["../../../../../src/ui/components/EntityFilterView.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AASH,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,4BAA4B;IAC5B,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B,4CAA4C;IAC5C,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,cAAc,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAChC,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uFAAuF;IACvF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAeD,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,eAAe,EACf,eAAe,EACf,YAAY,EACZ,UAAU,EACV,cAAc,EACd,SAAS,EACT,YAAY,EACZ,IAAI,EACJ,UAAU,EACV,QAAQ,EACR,cAAc,EACd,YAAY,GACb,EAAE,qBAAqB,+BA2KvB"}

package/lib/typescript/commonjs/ui/components/ExportPreview.d.ts

@@ -0,0 +1,48 @@
+/**
+ * ExportPreview — the collapsible "what will be copied" panel at the bottom
+ * of a copy-settings screen.
+ *
+ * Collapsed, it is a card: an eye icon, "Show Preview", a one-line summary
+ * ("14 events · ~12.3 KB (mock data)"), a chevron — and, when the estimated
+ * payload is big, an amber or red size warning under it. Expanded, it is a
+ * "Hide Preview" bar over whatever the tool renders (a DataViewer for JSON,
+ * a mono text block otherwise).
+ *
+ * network, events and highlight-updates each drew this (~120 lines apiece).
+ * Tools keep their own summary string, warning copy and body; the chrome
+ * and the size-threshold ladder live here.
+ */
+import type { ReactNode } from "react";
+export type SizeWarningLevel = "none" | "warning" | "danger";
+/** The two-step ladder every copy view used (thresholds differ per tool). */
+export declare function sizeWarningLevel(bytes: number, thresholds: {
+    warning: number;
+    danger: number;
+}): SizeWarningLevel;
+export interface ExportPreviewTestIDs {
+    expand?: string;
+    collapse?: string;
+    summary?: string;
+    warning?: string;
+}
+export interface ExportPreviewProps {
+    expanded: boolean;
+    onExpandedChange: (next: boolean) => void;
+    /** One line under "Show Preview": counts, size, "(mock data)". */
+    summary: string;
+    warningLevel?: SizeWarningLevel;
+    /** Copy for the warning band. Defaults name "payload". */
+    warningText?: {
+        warning: string;
+        danger: string;
+    };
+    testIDs?: ExportPreviewTestIDs;
+    /**
+     * Builds the expanded body. A function, not children, so the export text
+     * is only generated once the user asks for it — building it eagerly for
+     * a large capture is what used to crash these screens.
+     */
+    renderBody: () => ReactNode;
+}
+export declare function ExportPreview({ expanded, onExpandedChange, summary, warningLevel, warningText, testIDs, renderBody, }: ExportPreviewProps): import("react").JSX.Element;
+//# sourceMappingURL=ExportPreview.d.ts.map

package/lib/typescript/commonjs/ui/components/ExportPreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExportPreview.d.ts","sourceRoot":"","sources":["../../../../../src/ui/components/ExportPreview.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE7D,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC9C,gBAAgB,CAIlB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1C,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,0DAA0D;IAC1D,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B;;;;OAIG;IACH,UAAU,EAAE,MAAM,SAAS,CAAC;CAC7B;AAOD,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,gBAAgB,EAChB,OAAO,EACP,YAAqB,EACrB,WAA6B,EAC7B,OAAO,EACP,UAAU,GACX,EAAE,kBAAkB,+BA2DpB"}

package/lib/typescript/commonjs/ui/components/InfoRow.d.ts

@@ -0,0 +1,33 @@
+/**
+ * InfoRow — the label / value line of every detail screen.
+ *
+ * Thirteen tools hand-rolled this (redux and zustand byte-for-byte). The
+ * night-theme recipe below is theirs: 11 px, tertiary label on the left,
+ * right-aligned value that truncates in the MIDDLE so both ends of an id or
+ * a path stay readable, optional monospace, optional color.
+ *
+ * `ellipsizeMode="middle"` truncates the RENDERED text and iOS reports the
+ * truncated string back, so anything a test reads off one of these rows has
+ * to be short enough to fit on the line.
+ */
+import type { ReactNode } from "react";
+import { type StyleProp, type TextStyle, type ViewStyle } from "react-native";
+export interface InfoRowProps {
+    label: string;
+    /** A string/number is rendered as text; a node is rendered as-is. */
+    value?: string | number | ReactNode;
+    /** Override the value color (a status, a warning). */
+    valueColor?: string;
+    /** Monospace value (ids, paths, JSON fragments). */
+    mono?: boolean;
+    /** Show a small copy button for a text value. */
+    copyable?: boolean;
+    /** Lines the value may take before truncating. Default 1. */
+    numberOfLines?: number;
+    testID?: string;
+    style?: StyleProp<ViewStyle>;
+    labelStyle?: StyleProp<TextStyle>;
+    valueStyle?: StyleProp<TextStyle>;
+}
+export declare function InfoRow({ label, value, valueColor, mono, copyable, numberOfLines, testID, style, labelStyle, valueStyle, }: InfoRowProps): import("react").JSX.Element;
+//# sourceMappingURL=InfoRow.d.ts.map

package/lib/typescript/commonjs/ui/components/InfoRow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InfoRow.d.ts","sourceRoot":"","sources":["../../../../../src/ui/components/InfoRow.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAA0B,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAItG,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACpC,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,UAAU,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAClC,UAAU,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CACnC;AAED,wBAAgB,OAAO,CAAC,EACtB,KAAK,EACL,KAAK,EACL,UAAU,EACV,IAAY,EACZ,QAAgB,EAChB,aAAiB,EACjB,MAAM,EACN,KAAK,EACL,UAAU,EACV,UAAU,GACX,EAAE,YAAY,+BA6Bd"}