@umituz/react-native-ai-generation-content 1.13.1 → 1.15.0

package/src/presentation/types/flow-config.types.ts

@@ -0,0 +1,246 @@
+/**
+ * Flow Configuration Types
+ * Configuration system for step-by-step generation flows
+ *
+ * @package @umituz/react-native-ai-generation-content
+ */
+
+import type { StepHeaderConfig } from "@umituz/react-native-design-system";
+import type { PhotoUploadCardConfig } from "@umituz/react-native-design-system";
+
+/**
+ * Photo upload step configuration
+ */
+export interface PhotoStepConfig {
+  /** Whether this step is enabled */
+  enabled: boolean;
+  /** Step order (1, 2, 3, etc.) */
+  order: number;
+  /** Step identifier */
+  id: string;
+  /** Header configuration */
+  header?: StepHeaderConfig;
+  /** Photo upload card configuration */
+  photoCard?: PhotoUploadCardConfig;
+  /** Whether name input is required */
+  requireNameInput?: boolean;
+  /** Whether photo validation is enabled */
+  enableValidation?: boolean;
+  /** Validation type */
+  validationType?: "none" | "face-detection" | "custom";
+  /** Whether to show photo tips */
+  showPhotoTips?: boolean;
+  /** Custom validation function */
+  customValidator?: (imageUri: string) => Promise<boolean>;
+}
+
+/**
+ * Text input step configuration
+ */
+export interface TextInputStepConfig {
+  /** Whether this step is enabled */
+  enabled: boolean;
+  /** Step order */
+  order: number;
+  /** Step identifier */
+  id: string;
+  /** Header configuration */
+  header?: StepHeaderConfig;
+  /** Minimum character length */
+  minLength?: number;
+  /** Maximum character length */
+  maxLength?: number;
+  /** Placeholder text */
+  placeholder?: string;
+  /** Whether to show character counter */
+  showCharacterCount?: boolean;
+}
+
+/**
+ * Preview step configuration
+ */
+export interface PreviewStepConfig {
+  /** Whether this step is enabled */
+  enabled: boolean;
+  /** Step order */
+  order: number;
+  /** Step identifier */
+  id: string;
+  /** Header configuration */
+  header?: StepHeaderConfig;
+  /** Whether to show edit buttons */
+  allowEditing?: boolean;
+  /** Preview layout style */
+  layout?: "grid" | "list" | "carousel";
+}
+
+/**
+ * Complete flow configuration
+ */
+export interface GenerationFlowConfig {
+  /** Photo upload steps (can be 1 or multiple) */
+  photoSteps: PhotoStepConfig[];
+  /** Text input step */
+  textInputStep?: TextInputStepConfig;
+  /** Preview step */
+  previewStep?: PreviewStepConfig;
+  /** Flow behavior */
+  behavior?: {
+    /** Whether to allow going back */
+    allowBack?: boolean;
+    /** Whether to show progress indicator */
+    showProgress?: boolean;
+    /** Whether to auto-advance after photo selection */
+    autoAdvance?: boolean;
+    /** Whether to require authentication */
+    requireAuth?: boolean;
+    /** Whether to check feature gate */
+    checkFeatureGate?: boolean;
+  };
+}
+
+/**
+ * Default single photo flow configuration
+ */
+export const DEFAULT_SINGLE_PHOTO_FLOW: GenerationFlowConfig = {
+  photoSteps: [
+    {
+      enabled: true,
+      order: 1,
+      id: "photo-1",
+      header: {
+        showStepIndicator: false,
+        titleAlignment: "center",
+        titleFontSize: 28,
+        subtitleFontSize: 16,
+      },
+      photoCard: {
+        aspectRatio: 1,
+        borderRadius: 28,
+        showValidationStatus: true,
+        allowChange: true,
+        borderStyle: "dashed",
+      },
+      requireNameInput: true,
+      enableValidation: false,
+      validationType: "none",
+      showPhotoTips: true,
+    },
+  ],
+  behavior: {
+    allowBack: false,
+    showProgress: false,
+    autoAdvance: false,
+    requireAuth: false,
+    checkFeatureGate: true,
+  },
+};
+
+/**
+ * Default dual photo flow configuration
+ */
+export const DEFAULT_DUAL_PHOTO_FLOW: GenerationFlowConfig = {
+  photoSteps: [
+    {
+      enabled: true,
+      order: 1,
+      id: "partner-a",
+      header: {
+        showStepIndicator: true,
+        currentStep: 1,
+        totalSteps: 2,
+        titleAlignment: "center",
+        titleFontSize: 28,
+        subtitleFontSize: 16,
+      },
+      photoCard: {
+        aspectRatio: 1,
+        borderRadius: 28,
+        showValidationStatus: true,
+        allowChange: true,
+        borderStyle: "dashed",
+      },
+      requireNameInput: true,
+      enableValidation: false,
+      validationType: "none",
+      showPhotoTips: true,
+    },
+    {
+      enabled: true,
+      order: 2,
+      id: "partner-b",
+      header: {
+        showStepIndicator: true,
+        currentStep: 2,
+        totalSteps: 2,
+        titleAlignment: "center",
+        titleFontSize: 28,
+        subtitleFontSize: 16,
+      },
+      photoCard: {
+        aspectRatio: 1,
+        borderRadius: 28,
+        showValidationStatus: true,
+        allowChange: true,
+        borderStyle: "dashed",
+      },
+      requireNameInput: true,
+      enableValidation: false,
+      validationType: "none",
+      showPhotoTips: false,
+    },
+  ],
+  behavior: {
+    allowBack: true,
+    showProgress: true,
+    autoAdvance: false,
+    requireAuth: false,
+    checkFeatureGate: true,
+  },
+};
+
+/**
+ * Step data structure
+ */
+export interface PhotoStepData {
+  /** Step identifier */
+  id: string;
+  /** Photo URI */
+  imageUri: string | null;
+  /** Preview URL */
+  previewUrl?: string;
+  /** Name/label for this photo */
+  name?: string;
+  /** Whether validation passed */
+  isValid?: boolean;
+  /** Validation status */
+  validationStatus?: "pending" | "validating" | "valid" | "invalid";
+}
+
+/**
+ * Text input step data
+ */
+export interface TextInputStepData {
+  /** Step identifier */
+  id: string;
+  /** Text content */
+  text: string;
+  /** Whether text is valid */
+  isValid?: boolean;
+}
+
+/**
+ * Complete flow state
+ */
+export interface GenerationFlowState {
+  /** Current step index */
+  currentStepIndex: number;
+  /** Photo steps data */
+  photoSteps: PhotoStepData[];
+  /** Text input data */
+  textInput?: TextInputStepData;
+  /** Whether flow is complete */
+  isComplete: boolean;
+  /** Whether currently processing */
+  isProcessing: boolean;
+}

package/src/presentation/types/result-config.types.ts

@@ -0,0 +1,194 @@
+/**
+ * Result Preview Configuration Types
+ * Allows main apps to customize result preview appearance and behavior
+ */
+
+export interface ResultHeaderConfig {
+  showTitle?: boolean;
+  showDate?: boolean;
+  showDateIcon?: boolean;
+  titleAlignment?: "left" | "center" | "right";
+  titleFontSize?: number;
+  titleFontWeight?:
+    | "normal"
+    | "bold"
+    | "100"
+    | "200"
+    | "300"
+    | "400"
+    | "500"
+    | "600"
+    | "700"
+    | "800"
+    | "900";
+  dateBadgeStyle?: "outline" | "filled" | "minimal";
+  spacing?: {
+    marginBottom?: number;
+    titleMarginBottom?: number;
+    paddingHorizontal?: number;
+  };
+}
+
+export interface ResultImageConfig {
+  aspectRatio?: number;
+  borderRadius?: number;
+  showBadge?: boolean;
+  badgePosition?: "top-left" | "top-right" | "bottom-left" | "bottom-right";
+  badgeStyle?: "dark" | "light" | "gradient";
+  badgeIcon?: string;
+  spacing?: {
+    marginBottom?: number;
+    paddingHorizontal?: number;
+  };
+}
+
+export interface ResultStoryConfig {
+  showQuotes?: boolean;
+  textAlignment?: "left" | "center" | "right";
+  fontSize?: number;
+  fontStyle?: "normal" | "italic";
+  fontWeight?:
+    | "normal"
+    | "bold"
+    | "100"
+    | "200"
+    | "300"
+    | "400"
+    | "500"
+    | "600"
+    | "700"
+    | "800"
+    | "900";
+  borderStyle?: "outline" | "filled" | "gradient";
+  spacing?: {
+    marginBottom?: number;
+    paddingHorizontal?: number;
+    padding?: number;
+  };
+}
+
+export interface ResultActionButton {
+  enabled?: boolean;
+  label?: string;
+  icon?: string;
+  variant?: "primary" | "secondary" | "outline" | "text";
+  position?: "top" | "bottom";
+}
+
+export interface ResultActionsConfig {
+  share?: ResultActionButton;
+  save?: ResultActionButton;
+  retry?: ResultActionButton;
+  layout?: "horizontal" | "vertical" | "grid";
+  buttonSpacing?: number;
+  spacing?: {
+    paddingHorizontal?: number;
+    paddingBottom?: number;
+  };
+}
+
+export interface ResultLayoutConfig {
+  maxWidth?: number;
+  maxHeight?: string | number;
+  borderRadius?: number;
+  backgroundColor?: string;
+  scrollEnabled?: boolean;
+  contentPadding?: {
+    top?: number;
+    bottom?: number;
+    horizontal?: number;
+  };
+}
+
+/**
+ * Complete Result Preview Configuration
+ * Pass this from main app to customize all aspects of result preview
+ */
+export interface ResultConfig {
+  header?: ResultHeaderConfig;
+  image?: ResultImageConfig;
+  story?: ResultStoryConfig;
+  actions?: ResultActionsConfig;
+  layout?: ResultLayoutConfig;
+}
+
+/**
+ * Default configuration for result preview
+ * Used when no config is provided by main app
+ */
+export const DEFAULT_RESULT_CONFIG: ResultConfig = {
+  header: {
+    showTitle: true,
+    showDate: true,
+    showDateIcon: true,
+    titleAlignment: "center",
+    titleFontSize: 24,
+    titleFontWeight: "800",
+    dateBadgeStyle: "filled",
+    spacing: {
+      marginBottom: 20,
+      titleMarginBottom: 12,
+      paddingHorizontal: 24,
+    },
+  },
+  image: {
+    aspectRatio: 1,
+    borderRadius: 20,
+    showBadge: true,
+    badgePosition: "top-right",
+    badgeStyle: "dark",
+    badgeIcon: "sparkles",
+    spacing: {
+      marginBottom: 20,
+      paddingHorizontal: 20,
+    },
+  },
+  story: {
+    showQuotes: true,
+    textAlignment: "center",
+    fontSize: 14,
+    fontStyle: "italic",
+    fontWeight: "500",
+    borderStyle: "gradient",
+    spacing: {
+      marginBottom: 20,
+      paddingHorizontal: 20,
+      padding: 20,
+    },
+  },
+  actions: {
+    share: {
+      enabled: true,
+      icon: "share-social",
+      variant: "primary",
+      position: "bottom",
+    },
+    save: {
+      enabled: true,
+      icon: "download",
+      variant: "secondary",
+      position: "bottom",
+    },
+    retry: {
+      enabled: true,
+      icon: "refresh",
+      variant: "text",
+      position: "top",
+    },
+    layout: "horizontal",
+    buttonSpacing: 10,
+    spacing: {
+      paddingHorizontal: 20,
+      paddingBottom: 20,
+    },
+  },
+  layout: {
+    borderRadius: 28,
+    scrollEnabled: true,
+    contentPadding: {
+      top: 24,
+      bottom: 20,
+      horizontal: 0,
+    },
+  },
+};