@mushi-mushi/react-native 0.19.2 → 0.20.0

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ReactNode, FC, ReactElement } from 'react';
-import { MushiRewardsConfig, MushiPageContext, MushiBreadcrumb, MushiReporterReport, MushiReporterComment, MushiHallOfFameEntry, MushiTierResult, MushiReputationResult } from '@mushi-mushi/core';
+import { MushiRewardsConfig, MushiPageContext, MushiBreadcrumb, MushiReporterReport, MushiReporterComment, MushiHallOfFameEntry, MushiTierResult, MushiReputationResult, MushiAssistantReply } from '@mushi-mushi/core';
 export { MushiHallOfFameEntry, MushiReporterComment, MushiReporterReport } from '@mushi-mushi/core';
 
 interface ConsoleEntry {
@@ -58,7 +58,7 @@ interface MushiRNConfig {
         onFixStatusChanged?: (reportId: string, status: string) => void;
     };
     widget?: {
-        trigger?: 'shake' | 'button' | 'both' | 'manual' | 'auto' | 'edge-tab' | 'hidden' | 'attach';
+        trigger?: 'shake' | 'button' | 'both' | 'manual' | 'auto' | 'banner' | 'edge-tab' | 'hidden' | 'attach';
         shakeThreshold?: number;
         buttonPosition?: 'bottom-right' | 'bottom-left';
         inset?: {
@@ -76,6 +76,19 @@ interface MushiRNConfig {
          * - `false` — hide the caption (preview + remove still show).
          */
         screenshotSensitiveHint?: boolean | string;
+        /** Banner strip when trigger is `banner` (web parity). */
+        banner?: {
+            message?: string;
+            label?: string;
+        };
+        /** Poll interval (ms) for My Reports while the inbox tab is open. 0 = off (default). */
+        inboxPollIntervalMs?: number;
+    };
+    assistant?: {
+        enabled?: boolean;
+        label?: string;
+        greeting?: string;
+        suggestions?: string[];
     };
     capture?: {
         console?: boolean;
@@ -177,6 +190,10 @@ interface MushiRNInstance {
     getTier(): Promise<MushiTierResult | null>;
     /** Returns the current user's reputation + point totals. */
     getReputation(): Promise<MushiReputationResult | null>;
+    /** Open the sheet on the Ask tab when assistant is enabled. */
+    openAssistant(): void;
+    /** One assistant turn — uses published page context when available. */
+    askAssistant(message: string, threadId?: string | null): Promise<MushiAssistantReply | null>;
 }
 declare function MushiProvider({ children, config: configProp, ...barePropConfig }: MushiRNConfig & {
     children: ReactNode;
@@ -228,6 +245,8 @@ declare function useMushiWidget(): {
 interface MushiBottomSheetProps {
     visible: boolean;
     onClose: () => void;
+    /** Tab to select when the sheet opens (controlled by MushiProvider). */
+    preferredTab?: 'report' | 'inbox' | 'assistant';
     /** Base64 data-URI of the screenshot captured before the sheet opened. Optional. */
     screenshotDataUrl?: string;
     /** Called when the user removes the attached screenshot. */
@@ -237,6 +256,13 @@ interface MushiBottomSheetProps {
      * Resolved by the provider from `widget.screenshotSensitiveHint`.
      */
     screenshotSensitiveHint?: string | null;
+    /** When true, renders an Ask tab with page-aware assistant (web parity). */
+    assistantEnabled?: boolean;
+    assistantLabel?: string;
+    assistantGreeting?: string;
+    assistantSuggestions?: string[];
+    /** Poll My Reports while inbox tab is open. 0 disables polling. */
+    inboxPollIntervalMs?: number;
 }
 declare const MushiBottomSheet: FC<MushiBottomSheetProps>;
 
@@ -275,6 +301,33 @@ interface MushiFloatingButtonProps {
 }
 declare const MushiFloatingButton: FC<MushiFloatingButtonProps>;
 
+/**
+ * FILE: MushiBanner.tsx
+ * PURPOSE: Native bottom strip launcher — parity with web `trigger: 'banner'`.
+ *
+ * OVERVIEW:
+ * - Fixed neon strip using shared MUSHI_BANNER_NEON tokens from @mushi-mushi/core
+ * - Tap opens the report sheet; optional dismiss hides until next cold start
+ * - Reports layout height so Capacitor/RN hosts can pad content (banner-offset contract)
+ *
+ * DEPENDENCIES:
+ * - @mushi-mushi/core (MUSHI_BANNER_NEON, MUSHI_COPY, MUSHI_GEOMETRY)
+ *
+ * USAGE:
+ * - Rendered by MushiProvider when widget.trigger === 'banner'
+ */
+
+interface MushiBannerProps {
+    onPress: () => void;
+    onDismiss?: () => void;
+    message?: string;
+    label?: string;
+    /** Fires with measured banner height (px) for host safe-area / inset padding. */
+    onLayoutHeight?: (height: number) => void;
+}
+declare const MUSHI_BANNER_DEFAULT_HEIGHT: 36;
+declare const MushiBanner: FC<MushiBannerProps>;
+
 interface MushiTriggerProps {
     /** A single React Native element that accepts `onPress`. */
     children: ReactElement<{
@@ -333,4 +386,4 @@ declare class AsyncStorageQueue {
     private getAsyncStorage;
 }
 
-export { AsyncStorageQueue, type ConsoleEntry, type DeviceInfo, MushiBottomSheet, type MushiBottomSheetProps, MushiFloatingButton, type MushiFloatingButtonProps, MushiProvider, type MushiRNConfig, type MushiRNInstance, MushiTrigger, type MushiTriggerProps, type NavigationEntry, type NetworkEntry, getDeviceInfo, setupConsoleCapture, setupNetworkCapture, useMushi, useMushiReport, useMushiWidget, useNavigationCapture };
+export { AsyncStorageQueue, type ConsoleEntry, type DeviceInfo, MUSHI_BANNER_DEFAULT_HEIGHT, MushiBanner, type MushiBannerProps, MushiBottomSheet, type MushiBottomSheetProps, MushiFloatingButton, type MushiFloatingButtonProps, MushiProvider, type MushiRNConfig, type MushiRNInstance, MushiTrigger, type MushiTriggerProps, type NavigationEntry, type NetworkEntry, getDeviceInfo, setupConsoleCapture, setupNetworkCapture, useMushi, useMushiReport, useMushiWidget, useNavigationCapture };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ReactNode, FC, ReactElement } from 'react';
-import { MushiRewardsConfig, MushiPageContext, MushiBreadcrumb, MushiReporterReport, MushiReporterComment, MushiHallOfFameEntry, MushiTierResult, MushiReputationResult } from '@mushi-mushi/core';
+import { MushiRewardsConfig, MushiPageContext, MushiBreadcrumb, MushiReporterReport, MushiReporterComment, MushiHallOfFameEntry, MushiTierResult, MushiReputationResult, MushiAssistantReply } from '@mushi-mushi/core';
 export { MushiHallOfFameEntry, MushiReporterComment, MushiReporterReport } from '@mushi-mushi/core';
 
 interface ConsoleEntry {
@@ -58,7 +58,7 @@ interface MushiRNConfig {
         onFixStatusChanged?: (reportId: string, status: string) => void;
     };
     widget?: {
-        trigger?: 'shake' | 'button' | 'both' | 'manual' | 'auto' | 'edge-tab' | 'hidden' | 'attach';
+        trigger?: 'shake' | 'button' | 'both' | 'manual' | 'auto' | 'banner' | 'edge-tab' | 'hidden' | 'attach';
         shakeThreshold?: number;
         buttonPosition?: 'bottom-right' | 'bottom-left';
         inset?: {
@@ -76,6 +76,19 @@ interface MushiRNConfig {
          * - `false` — hide the caption (preview + remove still show).
          */
         screenshotSensitiveHint?: boolean | string;
+        /** Banner strip when trigger is `banner` (web parity). */
+        banner?: {
+            message?: string;
+            label?: string;
+        };
+        /** Poll interval (ms) for My Reports while the inbox tab is open. 0 = off (default). */
+        inboxPollIntervalMs?: number;
+    };
+    assistant?: {
+        enabled?: boolean;
+        label?: string;
+        greeting?: string;
+        suggestions?: string[];
     };
     capture?: {
         console?: boolean;
@@ -177,6 +190,10 @@ interface MushiRNInstance {
     getTier(): Promise<MushiTierResult | null>;
     /** Returns the current user's reputation + point totals. */
     getReputation(): Promise<MushiReputationResult | null>;
+    /** Open the sheet on the Ask tab when assistant is enabled. */
+    openAssistant(): void;
+    /** One assistant turn — uses published page context when available. */
+    askAssistant(message: string, threadId?: string | null): Promise<MushiAssistantReply | null>;
 }
 declare function MushiProvider({ children, config: configProp, ...barePropConfig }: MushiRNConfig & {
     children: ReactNode;
@@ -228,6 +245,8 @@ declare function useMushiWidget(): {
 interface MushiBottomSheetProps {
     visible: boolean;
     onClose: () => void;
+    /** Tab to select when the sheet opens (controlled by MushiProvider). */
+    preferredTab?: 'report' | 'inbox' | 'assistant';
     /** Base64 data-URI of the screenshot captured before the sheet opened. Optional. */
     screenshotDataUrl?: string;
     /** Called when the user removes the attached screenshot. */
@@ -237,6 +256,13 @@ interface MushiBottomSheetProps {
      * Resolved by the provider from `widget.screenshotSensitiveHint`.
      */
     screenshotSensitiveHint?: string | null;
+    /** When true, renders an Ask tab with page-aware assistant (web parity). */
+    assistantEnabled?: boolean;
+    assistantLabel?: string;
+    assistantGreeting?: string;
+    assistantSuggestions?: string[];
+    /** Poll My Reports while inbox tab is open. 0 disables polling. */
+    inboxPollIntervalMs?: number;
 }
 declare const MushiBottomSheet: FC<MushiBottomSheetProps>;
 
@@ -275,6 +301,33 @@ interface MushiFloatingButtonProps {
 }
 declare const MushiFloatingButton: FC<MushiFloatingButtonProps>;
 
+/**
+ * FILE: MushiBanner.tsx
+ * PURPOSE: Native bottom strip launcher — parity with web `trigger: 'banner'`.
+ *
+ * OVERVIEW:
+ * - Fixed neon strip using shared MUSHI_BANNER_NEON tokens from @mushi-mushi/core
+ * - Tap opens the report sheet; optional dismiss hides until next cold start
+ * - Reports layout height so Capacitor/RN hosts can pad content (banner-offset contract)
+ *
+ * DEPENDENCIES:
+ * - @mushi-mushi/core (MUSHI_BANNER_NEON, MUSHI_COPY, MUSHI_GEOMETRY)
+ *
+ * USAGE:
+ * - Rendered by MushiProvider when widget.trigger === 'banner'
+ */
+
+interface MushiBannerProps {
+    onPress: () => void;
+    onDismiss?: () => void;
+    message?: string;
+    label?: string;
+    /** Fires with measured banner height (px) for host safe-area / inset padding. */
+    onLayoutHeight?: (height: number) => void;
+}
+declare const MUSHI_BANNER_DEFAULT_HEIGHT: 36;
+declare const MushiBanner: FC<MushiBannerProps>;
+
 interface MushiTriggerProps {
     /** A single React Native element that accepts `onPress`. */
     children: ReactElement<{
@@ -333,4 +386,4 @@ declare class AsyncStorageQueue {
     private getAsyncStorage;
 }
 
-export { AsyncStorageQueue, type ConsoleEntry, type DeviceInfo, MushiBottomSheet, type MushiBottomSheetProps, MushiFloatingButton, type MushiFloatingButtonProps, MushiProvider, type MushiRNConfig, type MushiRNInstance, MushiTrigger, type MushiTriggerProps, type NavigationEntry, type NetworkEntry, getDeviceInfo, setupConsoleCapture, setupNetworkCapture, useMushi, useMushiReport, useMushiWidget, useNavigationCapture };
+export { AsyncStorageQueue, type ConsoleEntry, type DeviceInfo, MUSHI_BANNER_DEFAULT_HEIGHT, MushiBanner, type MushiBannerProps, MushiBottomSheet, type MushiBottomSheetProps, MushiFloatingButton, type MushiFloatingButtonProps, MushiProvider, type MushiRNConfig, type MushiRNInstance, MushiTrigger, type MushiTriggerProps, type NavigationEntry, type NetworkEntry, getDeviceInfo, setupConsoleCapture, setupNetworkCapture, useMushi, useMushiReport, useMushiWidget, useNavigationCapture };