@codeimplants/ui-kit 1.0.0

package/dist/types/screens.d.ts

@@ -0,0 +1,390 @@
+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/dist/types/screens.js

@@ -0,0 +1,4 @@
+// ============================================================================
+// Screen Component Props
+// ============================================================================
+export {};

package/dist/types/support.d.ts

@@ -0,0 +1,16 @@
+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>;
+}

package/dist/types/support.js

@@ -0,0 +1,4 @@
+// ============================================================================
+// Support and Adapter Types
+// ============================================================================
+export {};