@mushi-mushi/web 1.2.0 → 1.3.0

package/dist/index.d.cts

@@ -21,6 +21,7 @@ declare class Mushi {
  *         user-facing ARIA / keyboard wiring.
  */
 
+type WidgetStep = 'category' | 'intent' | 'details' | 'success' | 'reports' | 'report-detail';
 interface WidgetRewardsState {
     tier: {
         slug: string;
@@ -62,12 +63,22 @@ declare class MushiWidget {
     private selectedCategory;
     private selectedIntent;
     private screenshotAttached;
+    private screenshotCapturing;
+    private screenshotError;
     private allowScreenshotRemove;
     private elementSelected;
+    private elementCapturing;
     private submitting;
+    /** Hint element injected outside the shadow DOM during element selection. */
+    private selectorHint;
     private triggerVisible;
     private triggerShrunk;
     private triggerHiddenByScroll;
+    /** Milliseconds since mount — used for the 30s first-time nudge gate. */
+    private mountedAt;
+    private nudgeShown;
+    private nudgeEl;
+    private nudgeTimer;
     private sdkFreshness;
     private reporterReports;
     private reporterComments;
@@ -104,6 +115,18 @@ declare class MushiWidget {
     setScreenshotAttached(attached: boolean): void;
     setAllowScreenshotRemove(allow: boolean): void;
     setElementSelected(selected: boolean): void;
+    setScreenshotCapturing(capturing: boolean): void;
+    setScreenshotError(failed: boolean): void;
+    setElementCapturing(capturing: boolean): void;
+    /** Hide the widget panel (but keep the host element) during element selection
+     *  so the user can click any element on the page without the panel
+     *  intercepting the event. */
+    hidePanel(): void;
+    showPanel(): void;
+    private showSelectorHint;
+    private removeSelectorHint;
+    private showNudge;
+    private removeNudge;
     setSdkFreshness(info: {
         latest: string | null;
         current: string;
@@ -154,6 +177,7 @@ declare class MushiWidget {
     private renderReportsStep;
     private renderReportDetailStep;
     private renderIntentStep;
+    private effectiveMinLength;
     private renderDetailsStep;
     /**
      * Editorial success state: 朱印-style red stamp ring with the kanji
@@ -182,6 +206,16 @@ declare class MushiWidget {
     private loadReporterReports;
     private loadReporterComments;
     private submitReporterReply;
+    getRecorderStep(): WidgetStep;
+    getRecorderTrigger(): Element | null;
+    getRecorderCategoryButton(category: MushiReportCategory): Element | null;
+    getRecorderIntentButton(label: string): Element | null;
+    getRecorderSubmitButton(): Element | null;
+    recorderClickTrigger(): void;
+    recorderSelectCategory(category: MushiReportCategory): void;
+    recorderSelectIntent(label: string): void;
+    recorderFocusDescription(): void;
+    recorderSubmit(): void;
 }
 
 interface ConsoleCapture {
@@ -204,12 +238,20 @@ interface NetworkCaptureOptions {
 declare function createNetworkCapture(options?: NetworkCaptureOptions): NetworkCapture;
 
 interface ScreenshotCapture {
-    take(): Promise<string | null>;
+    take(): Promise<ScreenshotResult>;
     updateOptions(options: ScreenshotCaptureOptions): void;
 }
 interface ScreenshotCaptureOptions {
     privacy?: MushiPrivacyConfig;
 }
+type ScreenshotResult = {
+    ok: true;
+    dataUrl: string;
+} | {
+    ok: false;
+    reason: 'tainted' | 'load-error' | 'unsupported' | 'cancelled' | 'error';
+    message?: string;
+};
 declare function createScreenshotCapture(options?: ScreenshotCaptureOptions): ScreenshotCapture;
 
 interface PerformanceCapture {
@@ -265,9 +307,17 @@ interface MushiLocale {
         descriptionPlaceholder: string;
         screenshotButton: string;
         screenshotAttached: string;
+        screenshotCapturing: string;
+        screenshotFailed: string;
         elementButton: string;
         elementSelected: string;
+        elementCapturing: string;
+        elementSelectorHint: string;
         optional: string;
+        /** Inline validation: description is below the minimum length. */
+        tooShort: string;
+        /** Example starter chips rendered above the textarea to lower the barrier. */
+        examplePrompts: string[];
     };
 }
 

package/dist/index.d.ts

@@ -21,6 +21,7 @@ declare class Mushi {
  *         user-facing ARIA / keyboard wiring.
  */
 
+type WidgetStep = 'category' | 'intent' | 'details' | 'success' | 'reports' | 'report-detail';
 interface WidgetRewardsState {
     tier: {
         slug: string;
@@ -62,12 +63,22 @@ declare class MushiWidget {
     private selectedCategory;
     private selectedIntent;
     private screenshotAttached;
+    private screenshotCapturing;
+    private screenshotError;
     private allowScreenshotRemove;
     private elementSelected;
+    private elementCapturing;
     private submitting;
+    /** Hint element injected outside the shadow DOM during element selection. */
+    private selectorHint;
     private triggerVisible;
     private triggerShrunk;
     private triggerHiddenByScroll;
+    /** Milliseconds since mount — used for the 30s first-time nudge gate. */
+    private mountedAt;
+    private nudgeShown;
+    private nudgeEl;
+    private nudgeTimer;
     private sdkFreshness;
     private reporterReports;
     private reporterComments;
@@ -104,6 +115,18 @@ declare class MushiWidget {
     setScreenshotAttached(attached: boolean): void;
     setAllowScreenshotRemove(allow: boolean): void;
     setElementSelected(selected: boolean): void;
+    setScreenshotCapturing(capturing: boolean): void;
+    setScreenshotError(failed: boolean): void;
+    setElementCapturing(capturing: boolean): void;
+    /** Hide the widget panel (but keep the host element) during element selection
+     *  so the user can click any element on the page without the panel
+     *  intercepting the event. */
+    hidePanel(): void;
+    showPanel(): void;
+    private showSelectorHint;
+    private removeSelectorHint;
+    private showNudge;
+    private removeNudge;
     setSdkFreshness(info: {
         latest: string | null;
         current: string;
@@ -154,6 +177,7 @@ declare class MushiWidget {
     private renderReportsStep;
     private renderReportDetailStep;
     private renderIntentStep;
+    private effectiveMinLength;
     private renderDetailsStep;
     /**
      * Editorial success state: 朱印-style red stamp ring with the kanji
@@ -182,6 +206,16 @@ declare class MushiWidget {
     private loadReporterReports;
     private loadReporterComments;
     private submitReporterReply;
+    getRecorderStep(): WidgetStep;
+    getRecorderTrigger(): Element | null;
+    getRecorderCategoryButton(category: MushiReportCategory): Element | null;
+    getRecorderIntentButton(label: string): Element | null;
+    getRecorderSubmitButton(): Element | null;
+    recorderClickTrigger(): void;
+    recorderSelectCategory(category: MushiReportCategory): void;
+    recorderSelectIntent(label: string): void;
+    recorderFocusDescription(): void;
+    recorderSubmit(): void;
 }
 
 interface ConsoleCapture {
@@ -204,12 +238,20 @@ interface NetworkCaptureOptions {
 declare function createNetworkCapture(options?: NetworkCaptureOptions): NetworkCapture;
 
 interface ScreenshotCapture {
-    take(): Promise<string | null>;
+    take(): Promise<ScreenshotResult>;
     updateOptions(options: ScreenshotCaptureOptions): void;
 }
 interface ScreenshotCaptureOptions {
     privacy?: MushiPrivacyConfig;
 }
+type ScreenshotResult = {
+    ok: true;
+    dataUrl: string;
+} | {
+    ok: false;
+    reason: 'tainted' | 'load-error' | 'unsupported' | 'cancelled' | 'error';
+    message?: string;
+};
 declare function createScreenshotCapture(options?: ScreenshotCaptureOptions): ScreenshotCapture;
 
 interface PerformanceCapture {
@@ -265,9 +307,17 @@ interface MushiLocale {
         descriptionPlaceholder: string;
         screenshotButton: string;
         screenshotAttached: string;
+        screenshotCapturing: string;
+        screenshotFailed: string;
         elementButton: string;
         elementSelected: string;
+        elementCapturing: string;
+        elementSelectorHint: string;
         optional: string;
+        /** Inline validation: description is below the minimum length. */
+        tooShort: string;
+        /** Example starter chips rendered above the textarea to lower the barrier. */
+        examplePrompts: string[];
     };
 }