@shellapps/experience-react 1.1.0 → 1.3.0

package/dist/index.d.mts

@@ -35,6 +35,22 @@ declare class ErrorBoundary extends React__default.Component<ErrorBoundaryProps,
     render(): string | number | boolean | Iterable<React__default.ReactNode> | react_jsx_runtime.JSX.Element | null | undefined;
 }
 
+interface FeedbackButtonProps {
+    /** Position of the floating button */
+    position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
+    /** Custom button label */
+    label?: string;
+    /** Button colour */
+    color?: string;
+    /** Hide the floating button (use exp.openFeedback() instead) */
+    hidden?: boolean;
+    /** API endpoint base URL */
+    apiUrl?: string;
+    /** Auth token for user endpoints */
+    authToken?: string;
+}
+declare function FeedbackButton({ position, label, color, hidden, apiUrl, authToken, }: FeedbackButtonProps): react_jsx_runtime.JSX.Element;
+
 declare function useExperience(): _shellapps_experience.Experience;
 declare function useTrack(): {
     track: (eventName: string, metadata?: Record<string, string>) => void;
@@ -48,15 +64,24 @@ interface TranslationResult {
     locales: Array<{
         code: string;
         name: string;
+        progress?: number;
     }>;
+    isLoading: boolean;
 }
 /**
- * Translation hook — stub implementation for EXP-5.
- * Currently returns the key with interpolation support.
- * Will fetch from the Experience API when translations are implemented.
+ * Translation hook for the Experience Platform.
+ *
+ * Fetches translations from the Experience API, caches in memory + localStorage,
+ * and provides `t()` for interpolation and `setLocale()` for switching.
+ *
+ * Usage:
+ * ```tsx
+ * const { t, locale, setLocale, locales } = useTranslation();
+ * return <h1>{t('greeting', { name: 'Alex' })}</h1>;
+ * ```
  */
 declare function useTranslation(): TranslationResult;
 
 declare const ExperienceContext: React.Context<Experience | null>;
 
-export { ErrorBoundary, ExperienceContext, ExperienceProvider, type ExperienceProviderProps, useExperience, useFlag, useTrack, useTranslation };
+export { ErrorBoundary, ExperienceContext, ExperienceProvider, type ExperienceProviderProps, FeedbackButton, useExperience, useFlag, useTrack, useTranslation };

package/dist/index.d.ts

@@ -35,6 +35,22 @@ declare class ErrorBoundary extends React__default.Component<ErrorBoundaryProps,
     render(): string | number | boolean | Iterable<React__default.ReactNode> | react_jsx_runtime.JSX.Element | null | undefined;
 }
 
+interface FeedbackButtonProps {
+    /** Position of the floating button */
+    position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
+    /** Custom button label */
+    label?: string;
+    /** Button colour */
+    color?: string;
+    /** Hide the floating button (use exp.openFeedback() instead) */
+    hidden?: boolean;
+    /** API endpoint base URL */
+    apiUrl?: string;
+    /** Auth token for user endpoints */
+    authToken?: string;
+}
+declare function FeedbackButton({ position, label, color, hidden, apiUrl, authToken, }: FeedbackButtonProps): react_jsx_runtime.JSX.Element;
+
 declare function useExperience(): _shellapps_experience.Experience;
 declare function useTrack(): {
     track: (eventName: string, metadata?: Record<string, string>) => void;
@@ -48,15 +64,24 @@ interface TranslationResult {
     locales: Array<{
         code: string;
         name: string;
+        progress?: number;
     }>;
+    isLoading: boolean;
 }
 /**
- * Translation hook — stub implementation for EXP-5.
- * Currently returns the key with interpolation support.
- * Will fetch from the Experience API when translations are implemented.
+ * Translation hook for the Experience Platform.
+ *
+ * Fetches translations from the Experience API, caches in memory + localStorage,
+ * and provides `t()` for interpolation and `setLocale()` for switching.
+ *
+ * Usage:
+ * ```tsx
+ * const { t, locale, setLocale, locales } = useTranslation();
+ * return <h1>{t('greeting', { name: 'Alex' })}</h1>;
+ * ```
  */
 declare function useTranslation(): TranslationResult;
 
 declare const ExperienceContext: React.Context<Experience | null>;
 
-export { ErrorBoundary, ExperienceContext, ExperienceProvider, type ExperienceProviderProps, useExperience, useFlag, useTrack, useTranslation };
+export { ErrorBoundary, ExperienceContext, ExperienceProvider, type ExperienceProviderProps, FeedbackButton, useExperience, useFlag, useTrack, useTranslation };