@codeimplants/ui-kit 1.0.0

package/src/types/reanimated.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Type definitions for react-native-reanimated with react-native-svg
+ * 
+ * This file provides proper type definitions for animated SVG components
+ * to eliminate TypeScript errors when using animatedProps.
+ */
+
+import 'react-native-reanimated';
+import { PathProps, CircleProps, RectProps, LineProps, PolygonProps } from 'react-native-svg';
+
+declare module 'react-native-reanimated' {
+  export interface AnimatedProps<P> {
+    animatedProps?: Partial<P>;
+  }
+}
+
+// Extend SVG component props to accept animatedProps
+declare module 'react-native-svg' {
+  interface PathProps {
+    animatedProps?: any;
+  }
+  
+  interface CircleProps {
+    animatedProps?: any;
+  }
+  
+  interface RectProps {
+    animatedProps?: any;
+  }
+  
+  interface LineProps {
+    animatedProps?: any;
+  }
+  
+  interface PolygonProps {
+    animatedProps?: any;
+  }
+}

package/src/types/screens.ts

@@ -0,0 +1,428 @@
+// ============================================================================
+// Screen Component Props
+// ============================================================================
+
+import type { ReactNode } from 'react';
+import type {
+  ErrorContext,
+  SupportContact,
+  ThemeColors,
+  SupportVariant,
+  SupportContactVariant,
+  RetryInfo,
+  ApiErrorType,
+  ConnectionSpeed,
+  BannerConfig,
+  PermissionType,
+  PermissionStatus,
+  UpdateType,
+  MaintenanceType,
+} from './common';
+
+/**
+ * ErrorBoundaryScreen Component Props
+ */
+export interface ErrorFallbackProps {
+  title?: string;
+  description?: string;
+  icon?: ReactNode;
+  onReset?: () => void;
+  onHome?: () => void;
+  resetButtonText?: string;
+  homeButtonText?: string;
+  support?: SupportContact;
+  supportVariant?: SupportVariant;
+  error?: Error;
+  errorContext?: Partial<ErrorContext>;
+  showErrorDetails?: boolean;
+  errorDetailsExpanded?: boolean;
+  theme?: ThemeColors;
+}
+
+/**
+ * ApiErrorScreen Component Props
+ */
+export interface ApiErrorScreenProps {
+  title?: string;
+  description?: string;
+  icon?: ReactNode;
+  iconColor?: string;
+  iconBackgroundColor?: string;
+  onRetry?: () => void;
+  onHome?: () => void;
+  retryButtonText?: string;
+  homeButtonText?: string;
+  showRetryButton?: boolean;
+  support?: SupportContact;
+  supportVariant?: SupportVariant;
+  retryInfo?: RetryInfo;
+  statusCode?: number;
+  errorCode?: string;
+  errorType?: ApiErrorType;
+  theme?: ThemeColors;
+  primaryColor?: string;
+  backgroundColor?: string;
+}
+
+/**
+ * NetworkOfflineScreen Component Props
+ */
+export interface NetworkOfflineScreenProps {
+  title?: string;
+  description?: string;
+  icon?: ReactNode;
+  showWaitingIndicator?: boolean;
+  waitingText?: string;
+  onRetry?: () => void;
+  retryButtonText?: string;
+  tips?: string[];
+  showTips?: boolean;
+  support?: SupportContact;
+  supportVariant?: SupportVariant;
+  variant?: 'fullscreen' | 'banner';
+  position?: 'top' | 'bottom';
+  theme?: ThemeColors;
+  primaryColor?: string;
+  backgroundColor?: string;
+}
+
+/**
+ * NetworkSlowConnectionScreen Component Props
+ */
+export interface NetworkSlowConnectionScreenProps {
+  title?: string;
+  description?: string;
+  icon?: ReactNode;
+  connectionSpeed?: ConnectionSpeed;
+  banner?: BannerConfig;
+  onRetry?: () => void;
+  onContinue?: () => void;
+  onDismiss?: () => void;
+  retryButtonText?: string;
+  continueButtonText?: string;
+  tips?: string[];
+  showTips?: boolean;
+  variant?: 'fullscreen' | 'banner';
+  support?: SupportContact;
+  supportVariant?: SupportVariant;
+  theme?: ThemeColors;
+  primaryColor?: string;
+  backgroundColor?: string;
+}
+
+/**
+ * ApiTimeoutScreen Component Props
+ */
+export interface ApiTimeoutScreenProps {
+  title?: string;
+  description?: string;
+  icon?: ReactNode;
+  timeoutDuration?: number;
+  onRetry?: () => void;
+  onHome?: () => void;
+  retryButtonText?: string;
+  homeButtonText?: string;
+  retryInfo?: RetryInfo;
+  support?: SupportContact;
+  supportVariant?: SupportVariant;
+  theme?: ThemeColors;
+  primaryColor?: string;
+  backgroundColor?: string;
+}
+
+/**
+ * ServerErrorScreen Component Props (5xx errors)
+ */
+export interface ServerErrorScreenProps {
+  title?: string;
+  description?: string;
+  icon?: ReactNode;
+  statusCode?: number;
+  onRetry?: () => void;
+  onHome?: () => void;
+  retryButtonText?: string;
+  homeButtonText?: string;
+  retryInfo?: RetryInfo;
+  support?: SupportContact;
+  supportVariant?: SupportContactVariant;
+  theme?: ThemeColors;
+  primaryColor?: string;
+  backgroundColor?: string;
+}
+
+/**
+ * ClientErrorScreen Component Props (4xx errors)
+ */
+export interface ClientErrorScreenProps {
+  title?: string;
+  description?: string;
+  icon?: ReactNode;
+  statusCode?: number;
+  onGoBack?: () => void;
+  onHome?: () => void;
+  goBackButtonText?: string;
+  homeButtonText?: string;
+  support?: SupportContact;
+  supportVariant?: SupportVariant;
+  theme?: ThemeColors;
+  primaryColor?: string;
+  backgroundColor?: string;
+}
+
+/**
+ * InvalidResponseScreen Component Props
+ */
+export interface InvalidResponseScreenProps {
+  title?: string;
+  description?: string;
+  icon?: ReactNode;
+  errorDetails?: string;
+  showErrorDetails?: boolean;
+  onRetry?: () => void;
+  onReportError?: () => void;
+  retryButtonText?: string;
+  reportButtonText?: string;
+  support?: SupportContact;
+  supportVariant?: SupportVariant;
+  theme?: ThemeColors;
+  primaryColor?: string;
+  backgroundColor?: string;
+}
+
+/**
+ * PermissionScreen Component Props
+ */
+export interface PermissionScreenProps {
+  permissionType?: PermissionType;
+  title?: string;
+  description?: string;
+  icon?: ReactNode;
+  reason?: string;
+  reasons?: string[];
+  showReasons?: boolean;
+  onAllow?: () => void;
+  onDeny?: () => void;
+  onOpenSettings?: () => void;
+  onSkip?: () => void;
+  allowButtonText?: string;
+  denyButtonText?: string;
+  settingsButtonText?: string;
+  skipButtonText?: string;
+  status?: PermissionStatus;
+  isOptional?: boolean;
+  theme?: ThemeColors;
+  primaryColor?: string;
+  backgroundColor?: string;
+  support?: SupportContact;
+}
+
+/**
+ * PermissionDeniedScreen Component Props
+ */
+export interface PermissionDeniedScreenProps {
+  title?: string;
+  description?: string;
+  permissionType?: PermissionType;
+  reason?: string;
+  steps?: string[];
+  onOpenSettings?: () => void;
+  onContinueWithout?: () => void;
+  settingsButtonText?: string;
+  continueButtonText?: string;
+  support?: SupportContact;
+  theme?: ThemeColors;
+  primaryColor?: string;
+  backgroundColor?: string;
+}
+
+/**
+ * MultiPermissionScreen Component Props
+ */
+export interface MultiPermissionScreenProps {
+  permissions: Array<{
+    type: PermissionType;
+    status: PermissionStatus;
+    required: boolean;
+    title?: string;
+    description?: string;
+    icon?: ReactNode;
+  }>;
+  title?: string;
+  description?: string;
+  onContinue?: () => void;
+  onOpenSettings?: () => void;
+  continueButtonText?: string;
+  settingsButtonText?: string;
+  theme?: ThemeColors;
+}
+
+/**
+ * AppUpdateScreen Component Props
+ */
+export interface AppUpdateScreenProps {
+  updateType?: UpdateType;
+  title?: string;
+  description?: string;
+  icon?: ReactNode;
+  currentVersion?: string;
+  newVersion?: string;
+  showVersionInfo?: boolean;
+  releaseNotes?: string | string[];
+  showReleaseNotes?: boolean;
+  onUpdate?: () => void;
+  onSkip?: () => void;
+  onRemindLater?: () => void;
+  updateButtonText?: string;
+  skipButtonText?: string;
+  remindLaterButtonText?: string;
+  variant?: 'fullscreen' | 'banner';
+  theme?: ThemeColors;
+  primaryColor?: string;
+}
+
+/**
+ * SoftUpdateScreen Component Props
+ */
+export interface SoftUpdateScreenProps {
+  title?: string;
+  description?: string;
+  currentVersion?: string;
+  newVersion?: string;
+  features?: string[];
+  onUpdate?: () => void;
+  onRemindLater?: () => void;
+  onSkip?: () => void;
+  updateButtonText?: string;
+  remindButtonText?: string;
+  skipButtonText?: string;
+  support?: SupportContact;
+  theme?: ThemeColors;
+  primaryColor?: string;
+  backgroundColor?: string;
+}
+
+/**
+ * OptionalUpdateScreen Component Props
+ */
+export interface OptionalUpdateScreenProps {
+  title?: string;
+  description?: string;
+  currentVersion?: string;
+  newVersion?: string;
+  features?: string[];
+  onUpdate?: () => void;
+  onMaybeLater?: () => void;
+  updateButtonText?: string;
+  laterButtonText?: string;
+  support?: SupportContact;
+  theme?: ThemeColors;
+  primaryColor?: string;
+  backgroundColor?: string;
+}
+
+/**
+ * ForceUpdateScreen Component Props
+ */
+export interface ForceUpdateScreenProps {
+  title?: string;
+  description?: string;
+  currentVersion?: string;
+  newVersion?: string;
+  features?: string[];
+  onUpdate?: () => void;
+  updateButtonText?: string;
+  support?: SupportContact;
+  theme?: ThemeColors;
+  primaryColor?: string;
+  backgroundColor?: string;
+}
+
+/**
+ * SecurityUpdateScreen Component Props
+ */
+export interface SecurityUpdateScreenProps {
+  title?: string;
+  description?: string;
+  currentVersion?: string;
+  newVersion?: string;
+  features?: Array<{
+    icon?: string;
+    title: string;
+    description?: string;
+  }>;
+  releaseNotes?: string;
+  onUpdate?: () => void;
+  updateButtonText?: string;
+  support?: SupportContact;
+  theme?: ThemeColors;
+  primaryColor?: string;
+  backgroundColor?: string;
+}
+
+/**
+ * MaintenanceScreen Component Props
+ */
+export interface MaintenanceScreenProps {
+  type?: MaintenanceType;
+  title?: string;
+  description?: string;
+  icon?: ReactNode;
+  estimatedEndTime?: Date;
+  showCountdown?: boolean;
+  onRetry?: () => void;
+  onNotifyMe?: () => void;
+  retryButtonText?: string;
+  notifyButtonText?: string;
+  support?: SupportContact;
+  supportVariant?: SupportVariant;
+  theme?: ThemeColors;
+}
+
+/**
+ * PlannedMaintenanceScreen Component Props
+ */
+export interface PlannedMaintenanceScreenProps {
+  title?: string;
+  description?: string;
+  onCheckAgain?: () => void;
+  onNotifyWhenBack?: () => void;
+  checkButtonText?: string;
+  notifyButtonText?: string;
+  support?: SupportContact;
+  theme?: ThemeColors;
+  primaryColor?: string;
+  backgroundColor?: string;
+}
+
+/**
+ * UnplannedOutageScreen Component Props
+ */
+export interface UnplannedOutageScreenProps {
+  title?: string;
+  description?: string;
+  onCheckAgain?: () => void;
+  onNotifyWhenBack?: () => void;
+  checkButtonText?: string;
+  notifyButtonText?: string;
+  support?: SupportContact;
+  theme?: ThemeColors;
+  primaryColor?: string;
+  backgroundColor?: string;
+}
+
+/**
+ * EmergencyOutageScreen Component Props
+ */
+export interface EmergencyOutageScreenProps {
+  title?: string;
+  description?: string;
+  incidentDetails?: string;
+  onCheckStatus?: () => void;
+  onGetUpdates?: () => void;
+  statusButtonText?: string;
+  updatesButtonText?: string;
+  support?: SupportContact;
+  theme?: ThemeColors;
+  primaryColor?: string;
+  backgroundColor?: string;
+}

package/src/types/support.ts

@@ -0,0 +1,23 @@
+// ============================================================================
+// Support and Adapter Types
+// ============================================================================
+
+import type { ErrorContext, SupportContact } from './common';
+
+/**
+ * Retry Handler Function Type
+ */
+export type RetryHandler = () => void | Promise<void>;
+
+/**
+ * Support Handler Function Type
+ */
+export type SupportHandler = (context?: Partial<ErrorContext>) => void;
+
+/**
+ * Support Adapter Configuration
+ */
+export interface SupportAdapterConfig {
+  support?: SupportContact;
+  errorContext?: Partial<ErrorContext>;
+}