@mushi-mushi/react-native 0.22.0 → 0.23.0

package/dist/index.d.cts

@@ -74,6 +74,42 @@ declare function getDeviceInfo(): DeviceInfo;
 /** The subset of the web `analytics` block that applies on native. */
 type RNAnalyticsConfig = Pick<MushiAnalyticsConfig, 'enabled' | 'consent' | 'flushIntervalMs' | 'propertyAllowlist'>;
 
+/**
+ * FILE: theme.ts
+ * PURPOSE: Host-adaptive theme for the RN report sheet (`widget.theme`).
+ *
+ * OVERVIEW:
+ * - Defaults are neutral: the shared washi/sumi surfaces with an INK accent,
+ *   so the sheet reads as part of the host app rather than a neon Mushi
+ *   product. The neon palette is only used by `<MushiBanner variant="neon">`.
+ * - Hosts override any token. When a host sets `accent` but not `accentFg`,
+ *   the text colour on the accent is picked for contrast (black or white).
+ *
+ * Plan 018 (docs/execplans/reporter-loop-v2.md §1.4).
+ */
+interface MushiRNTheme {
+    /** Sheet background. */
+    bg: string;
+    /** Primary text. */
+    fg: string;
+    /** Secondary text. */
+    muted: string;
+    /** Cards, inputs, chips. */
+    surface: string;
+    /** Borders and separators. */
+    border: string;
+    /** Selected chip, primary button, links. */
+    accent: string;
+    /** Text on `accent`. */
+    accentFg: string;
+    success: string;
+    error: string;
+    /** Host font family; undefined keeps the platform font. */
+    fontFamily?: string;
+    /** Corner radius for cards, inputs and buttons. */
+    radius: number;
+}
+
 interface MushiRNConfig {
     projectId: string;
     apiKey: string;
@@ -115,6 +151,13 @@ interface MushiRNConfig {
         };
         /** Poll interval (ms) for My Reports while the inbox tab is open. 0 = off (default). */
         inboxPollIntervalMs?: number;
+        /**
+         * Theme tokens for the report sheet (bg, fg, muted, surface, border,
+         * accent, accentFg, success, error, fontFamily, radius). Unset tokens
+         * use neutral system-style defaults with an ink accent; when only
+         * `accent` is set, the text on it is chosen for contrast.
+         */
+        theme?: Partial<MushiRNTheme>;
     };
     assistant?: {
         enabled?: boolean;
@@ -226,8 +269,12 @@ interface MushiRNInstance {
     }): void;
     /** List this device's reports ordered by most recent. Returns [] on failure. */
     listMyReports(): Promise<MushiReporterReport[]>;
-    /** List admin + reporter comments on a specific report. */
+    /** List admin + reporter comments on a specific report. Returns [] on failure. */
     listMyComments(reportId: string): Promise<MushiReporterComment[]>;
+    /** Like `listMyComments`, but resolves `null` when the thread could not be loaded, so a UI can offer Retry. */
+    loadMyThread(reportId: string): Promise<MushiReporterComment[] | null>;
+    /** Mark this device's unread notifications for a report as read. Resolves the number marked (0 on failure). */
+    markReportRead(reportId: string): Promise<number>;
     /** Post a reporter reply on a report thread. Returns the new comment or null on failure. */
     replyToReport(reportId: string, body: string): Promise<MushiReporterComment | null>;
     /** Record a reporter feedback signal (e.g. `confirms`, `not_fixed`) on a report. Returns the outcome or null. */
@@ -283,7 +330,9 @@ declare function useMushiWidget(): {
  * - Slide-up modal built entirely on RN built-ins (Modal, Animated, PanResponder)
  * - Conversational flow: category → description → submit → confirmation
  * - Drag-to-dismiss via PanResponder on the handle area
- * - Dark/light theme via useColorScheme
+ * - Host-adaptive theme (`widget.theme`, see ../theme.ts) over light/dark
+ * - "Your reports": statuses come from the shared core table
+ *   (`@mushi-mushi/core/reporter-ui`), so web and RN say the same thing
  *
  * DEPENDENCIES:
  * - React Native built-in APIs only (no third-party libs)
@@ -297,10 +346,14 @@ declare function useMushiWidget(): {
  * - PanResponder threshold: 80 px downward drag dismisses
  * - Animated.spring for slide-up, Animated.timing for backdrop
  * - Success confirmation auto-closes after 1.4 s
+ * - Thread loads show a skeleton, then Retry on failure; a failed reply keeps
+ *   its text and offers Retry. Opening a thread marks it read.
  *
  * NOTES:
  * - KeyboardAvoidingView wraps the sheet so the text input stays visible
  * - Categories match the web SDK: bug, slow, visual, confusing, other
+ * - accessibilityViewIsModal is iOS-only; RN's Modal is its own window on
+ *   Android, which keeps TalkBack focus inside the sheet there.
  */
 
 interface MushiBottomSheetProps {
@@ -324,6 +377,8 @@ interface MushiBottomSheetProps {
     assistantSuggestions?: string[];
     /** Poll My Reports while inbox tab is open. 0 disables polling. */
     inboxPollIntervalMs?: number;
+    /** Theme tokens (`widget.theme`); unset tokens use the neutral defaults. */
+    theme?: Partial<MushiRNTheme>;
 }
 declare const MushiBottomSheet: FC<MushiBottomSheetProps>;
 

package/dist/index.d.ts

@@ -74,6 +74,42 @@ declare function getDeviceInfo(): DeviceInfo;
 /** The subset of the web `analytics` block that applies on native. */
 type RNAnalyticsConfig = Pick<MushiAnalyticsConfig, 'enabled' | 'consent' | 'flushIntervalMs' | 'propertyAllowlist'>;
 
+/**
+ * FILE: theme.ts
+ * PURPOSE: Host-adaptive theme for the RN report sheet (`widget.theme`).
+ *
+ * OVERVIEW:
+ * - Defaults are neutral: the shared washi/sumi surfaces with an INK accent,
+ *   so the sheet reads as part of the host app rather than a neon Mushi
+ *   product. The neon palette is only used by `<MushiBanner variant="neon">`.
+ * - Hosts override any token. When a host sets `accent` but not `accentFg`,
+ *   the text colour on the accent is picked for contrast (black or white).
+ *
+ * Plan 018 (docs/execplans/reporter-loop-v2.md §1.4).
+ */
+interface MushiRNTheme {
+    /** Sheet background. */
+    bg: string;
+    /** Primary text. */
+    fg: string;
+    /** Secondary text. */
+    muted: string;
+    /** Cards, inputs, chips. */
+    surface: string;
+    /** Borders and separators. */
+    border: string;
+    /** Selected chip, primary button, links. */
+    accent: string;
+    /** Text on `accent`. */
+    accentFg: string;
+    success: string;
+    error: string;
+    /** Host font family; undefined keeps the platform font. */
+    fontFamily?: string;
+    /** Corner radius for cards, inputs and buttons. */
+    radius: number;
+}
+
 interface MushiRNConfig {
     projectId: string;
     apiKey: string;
@@ -115,6 +151,13 @@ interface MushiRNConfig {
         };
         /** Poll interval (ms) for My Reports while the inbox tab is open. 0 = off (default). */
         inboxPollIntervalMs?: number;
+        /**
+         * Theme tokens for the report sheet (bg, fg, muted, surface, border,
+         * accent, accentFg, success, error, fontFamily, radius). Unset tokens
+         * use neutral system-style defaults with an ink accent; when only
+         * `accent` is set, the text on it is chosen for contrast.
+         */
+        theme?: Partial<MushiRNTheme>;
     };
     assistant?: {
         enabled?: boolean;
@@ -226,8 +269,12 @@ interface MushiRNInstance {
     }): void;
     /** List this device's reports ordered by most recent. Returns [] on failure. */
     listMyReports(): Promise<MushiReporterReport[]>;
-    /** List admin + reporter comments on a specific report. */
+    /** List admin + reporter comments on a specific report. Returns [] on failure. */
     listMyComments(reportId: string): Promise<MushiReporterComment[]>;
+    /** Like `listMyComments`, but resolves `null` when the thread could not be loaded, so a UI can offer Retry. */
+    loadMyThread(reportId: string): Promise<MushiReporterComment[] | null>;
+    /** Mark this device's unread notifications for a report as read. Resolves the number marked (0 on failure). */
+    markReportRead(reportId: string): Promise<number>;
     /** Post a reporter reply on a report thread. Returns the new comment or null on failure. */
     replyToReport(reportId: string, body: string): Promise<MushiReporterComment | null>;
     /** Record a reporter feedback signal (e.g. `confirms`, `not_fixed`) on a report. Returns the outcome or null. */
@@ -283,7 +330,9 @@ declare function useMushiWidget(): {
  * - Slide-up modal built entirely on RN built-ins (Modal, Animated, PanResponder)
  * - Conversational flow: category → description → submit → confirmation
  * - Drag-to-dismiss via PanResponder on the handle area
- * - Dark/light theme via useColorScheme
+ * - Host-adaptive theme (`widget.theme`, see ../theme.ts) over light/dark
+ * - "Your reports": statuses come from the shared core table
+ *   (`@mushi-mushi/core/reporter-ui`), so web and RN say the same thing
  *
  * DEPENDENCIES:
  * - React Native built-in APIs only (no third-party libs)
@@ -297,10 +346,14 @@ declare function useMushiWidget(): {
  * - PanResponder threshold: 80 px downward drag dismisses
  * - Animated.spring for slide-up, Animated.timing for backdrop
  * - Success confirmation auto-closes after 1.4 s
+ * - Thread loads show a skeleton, then Retry on failure; a failed reply keeps
+ *   its text and offers Retry. Opening a thread marks it read.
  *
  * NOTES:
  * - KeyboardAvoidingView wraps the sheet so the text input stays visible
  * - Categories match the web SDK: bug, slow, visual, confusing, other
+ * - accessibilityViewIsModal is iOS-only; RN's Modal is its own window on
+ *   Android, which keeps TalkBack focus inside the sheet there.
  */
 
 interface MushiBottomSheetProps {
@@ -324,6 +377,8 @@ interface MushiBottomSheetProps {
     assistantSuggestions?: string[];
     /** Poll My Reports while inbox tab is open. 0 disables polling. */
     inboxPollIntervalMs?: number;
+    /** Theme tokens (`widget.theme`); unset tokens use the neutral defaults. */
+    theme?: Partial<MushiRNTheme>;
 }
 declare const MushiBottomSheet: FC<MushiBottomSheetProps>;