@ganeshdole/brainbox-widget 0.1.0 → 0.3.0

package/dist/lib/widget-store.d.ts

@@ -1,11 +1,20 @@
 import type { Brainbox } from "@ganeshdole/brainbox-core";
+/** What a report starts as: a marked-up screenshot, or a recording. */
+export type CaptureMode = "screenshot" | "record";
 /** Whether the widget UI is open, shared between `<BrainboxWidget />` and
  *  whoever wants to open it: a host button, `window.Brainbox.open()`. Core
  *  has no idea of "open"; that is a UI matter, so it lives here. */
 export interface WidgetStore {
     isOpen(): boolean;
     subscribe(listener: () => void): () => void;
+    /** Open on the chooser, where the user picks screenshot or recording. */
     open(): void;
+    /** Open straight into a screenshot or a recording, skipping the chooser.
+     *  For a host that offers the two choices in its own UI. */
+    start(mode: CaptureMode): void;
+    /** The mode `start()` asked for, cleared as it is read. The widget reads it
+     *  when it opens; null means show the chooser. */
+    takeStart(): CaptureMode | null;
     close(): void;
 }
 export declare function createWidgetStore(): WidgetStore;

package/dist/mount.d.ts

@@ -1,18 +1,25 @@
-import { type BrainboxOptions, type Identity } from "@ganeshdole/brainbox-core";
-import type { TriggerMode } from "@ganeshdole/brainbox-shared";
+import { type BrainboxOptions, type Identity, type ReportField } from "@ganeshdole/brainbox-core";
+import type { TriggerMode, WidgetTheme } from "@ganeshdole/brainbox-shared";
 import type { Position } from "./lib/position.ts";
+import { type CaptureMode } from "./lib/widget-store.ts";
 export interface MountOptions extends BrainboxOptions {
     trigger?: TriggerMode;
     position?: Position;
+    theme?: WidgetTheme;
 }
 /** The mounted widget, for a host with no React tree of its own. */
 export interface WidgetHandle {
+    /** Show the chooser. */
     open(): void;
+    /** Go straight into a screenshot or a recording, skipping the chooser. */
+    start(mode: CaptureMode): void;
     close(): void;
     identify(identity: Identity): void;
+    /** Replaces your app's details sent with every report. */
+    setFields(fields: ReportField[]): void;
     /** Unmount the UI, remove it from the page and destroy the instance. */
     destroy(): void;
 }
 /** Put the widget on the page. This is what the script-tag bundle calls; a
  *  React host should render `<BrainboxWidget />` instead. */
-export declare function mount({ trigger, position, ...options }: MountOptions): WidgetHandle;
+export declare function mount({ trigger, position, theme, ...options }: MountOptions): WidgetHandle;

package/dist/use-brainbox-widget.d.ts

@@ -1,6 +1,10 @@
-/** Open or close the widget from anywhere under the same provider. */
+import { type CaptureMode } from "./lib/widget-store.ts";
+/** Open or close the widget from anywhere under the same provider. `open()`
+ *  shows the chooser; `start(mode)` skips it, for a host that offers
+ *  screenshot and recording as separate choices in its own UI. */
 export declare function useBrainboxWidget(): {
     isOpen: boolean;
     open(): void;
+    start(mode: CaptureMode): void;
     close(): void;
 };

package/dist/widget.d.ts

@@ -1,4 +1,4 @@
-import type { TriggerMode } from "@ganeshdole/brainbox-shared";
+import type { TriggerMode, WidgetTheme } from "@ganeshdole/brainbox-shared";
 import type { Position } from "./lib/position.ts";
 export interface BrainboxWidgetProps {
     /** `floating` renders our launcher button; `manual` waits for
@@ -6,6 +6,8 @@ export interface BrainboxWidgetProps {
     trigger?: TriggerMode;
     /** Which corner the launcher and panels sit in. */
     position?: Position;
+    /** `dark` (default), `light`, or `system` to follow the visitor's OS. */
+    theme?: WidgetTheme;
 }
 /**
  * Brainbox's own capture UI, for a React tree that has a `<BrainboxProvider>`
@@ -13,4 +15,4 @@ export interface BrainboxWidgetProps {
  * it sits in the tree: the host's styles cannot reach it there, and no
  * ancestor's `overflow` or `transform` can trap its fixed-position panels.
  */
-export declare function BrainboxWidget({ trigger, position }: BrainboxWidgetProps): import("react").ReactPortal | null;
+export declare function BrainboxWidget({ trigger, position, theme, }: BrainboxWidgetProps): import("react").ReactPortal | null;