@umituz/react-native-ai-generation-content 1.23.4 → 1.24.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-ai-generation-content",
-  "version": "1.23.4",
+  "version": "1.24.1",
   "description": "Provider-agnostic AI generation orchestration for React Native with result preview components",
   "main": "src/index.ts",
   "types": "src/index.ts",
@@ -10,7 +10,8 @@
     "./content-moderation": "./src/domains/content-moderation/index.ts",
     "./creations": "./src/domains/creations/index.ts",
     "./face-detection": "./src/domains/face-detection/index.ts",
-    "./feature-background": "./src/domains/feature-background/index.ts"
+    "./feature-background": "./src/domains/feature-background/index.ts",
+    "./wizard": "./src/domains/wizard/index.ts"
   },
   "files": [
     "src"

package/src/domain/entities/step-config.types.ts

@@ -0,0 +1,133 @@
+/**
+ * Dynamic Step Configuration Types
+ * Configuration-driven wizard flow system
+ */
+
+import type { StepType } from "./flow-config.types";
+
+/**
+ * Photo Upload Step Config
+ */
+export interface PhotoUploadStepConfig {
+  readonly id: string;
+  readonly label?: string; // "First Partner", "Your Photo", etc.
+  readonly titleKey?: string;
+  readonly subtitleKey?: string;
+  readonly showFaceDetection?: boolean;
+  readonly showNameInput?: boolean;
+  readonly showPhotoTips?: boolean;
+  readonly required?: boolean;
+}
+
+/**
+ * Text Input Step Config
+ */
+export interface TextInputStepConfig {
+  readonly id: string;
+  readonly titleKey?: string;
+  readonly placeholderKey?: string;
+  readonly minLength?: number;
+  readonly maxLength?: number;
+  readonly required?: boolean;
+}
+
+/**
+ * Style Selection Step Config
+ */
+export interface StyleSelectionStepConfig {
+  readonly id: string;
+  readonly titleKey?: string;
+  readonly styles: readonly string[]; // style IDs
+  readonly required?: boolean;
+}
+
+/**
+ * Duration Selection Step Config
+ */
+export interface DurationSelectionStepConfig {
+  readonly id: string;
+  readonly titleKey?: string;
+  readonly durations: readonly number[]; // seconds
+  readonly defaultDuration?: number;
+  readonly required?: boolean;
+}
+
+/**
+ * Next Step Decision Function
+ * Evaluates current state and determines next step
+ */
+export type NextStepDecision = (context: {
+  readonly values: Record<string, unknown>;
+  readonly currentStepId: string;
+  readonly completedSteps: readonly string[];
+}) => string | null;
+
+/**
+ * Step Definition with Configuration
+ */
+export interface DynamicStepDefinition {
+  readonly id: string;
+  readonly type: StepType;
+  readonly enabled?: boolean;
+  readonly required?: boolean;
+  readonly config?:
+    | PhotoUploadStepConfig
+    | TextInputStepConfig
+    | StyleSelectionStepConfig
+    | DurationSelectionStepConfig
+    | Record<string, unknown>;
+  readonly nextStep?: string | NextStepDecision;
+  readonly skipIf?: (context: { readonly values: Record<string, unknown> }) => boolean;
+}
+
+/**
+ * Feature Flow Configuration
+ * Defines complete flow for a feature/scenario
+ */
+export interface FeatureFlowConfig {
+  readonly id: string;
+  readonly name: string;
+  readonly steps: readonly DynamicStepDefinition[];
+  readonly initialStepId?: string;
+  readonly onComplete?: (data: Record<string, unknown>) => void | Promise<void>;
+}
+
+/**
+ * Scenario Step Configuration
+ * Simplified config for scenario-based flows
+ */
+export interface ScenarioStepConfig {
+  readonly photoUploads?: {
+    readonly count: number;
+    readonly labels?: readonly string[];
+    readonly showFaceDetection?: boolean;
+    readonly showNameInput?: boolean;
+  };
+  readonly textInput?: {
+    readonly enabled: boolean;
+    readonly required?: boolean;
+    readonly minLength?: number;
+    readonly maxLength?: number;
+  };
+  readonly styleSelection?: {
+    readonly enabled: boolean;
+    readonly required?: boolean;
+    readonly styles?: readonly string[];
+  };
+  readonly durationSelection?: {
+    readonly enabled: boolean;
+    readonly required?: boolean;
+    readonly durations?: readonly number[];
+  };
+}
+
+/**
+ * Step Builder Result
+ */
+export interface BuiltStep {
+  readonly id: string;
+  readonly type: StepType;
+  readonly config: Record<string, unknown>;
+  readonly required: boolean;
+  readonly nextStep?: string | NextStepDecision;
+}

package/src/domains/scenarios/configs/wizard-configs.ts

@@ -0,0 +1,187 @@
+/**
+ * Wizard Configurations for ALL Scenarios
+ * Each scenario defines its wizard flow here
+ * NO feature-specific code - just configs!
+ */
+
+import type { WizardFeatureConfig } from "../../wizard/domain/entities/wizard-config.types";
+
+/**
+ * COUPLE SCENARIOS - 2 Photo Uploads
+ * romantic-kiss, ai-hug, couple-future, couple-ai-baby, etc.
+ */
+const createCoupleWizardConfig = (scenarioId: string): WizardFeatureConfig => ({
+  id: scenarioId,
+  name: scenarioId,
+  steps: [
+    {
+      id: "photo_a",
+      type: "photo_upload",
+      label: "First Partner",
+      titleKey: `${scenarioId}.partnerA.title`,
+      subtitleKey: `${scenarioId}.partnerA.subtitle`,
+      showFaceDetection: true,
+      showPhotoTips: true,
+      required: true,
+    },
+    {
+      id: "photo_b",
+      type: "photo_upload",
+      label: "Second Partner",
+      titleKey: `${scenarioId}.partnerB.title`,
+      subtitleKey: `${scenarioId}.partnerB.subtitle`,
+      showFaceDetection: true,
+      showPhotoTips: true,
+      required: true,
+    },
+  ],
+});
+
+/**
+ * SINGLE PHOTO SCENARIOS
+ * image-to-video, face-swap (source), etc.
+ */
+const createSinglePhotoWizardConfig = (
+  scenarioId: string,
+  options?: {
+    requireStyle?: boolean;
+    requireDuration?: boolean;
+  },
+): WizardFeatureConfig => {
+  const steps: WizardFeatureConfig["steps"] = [
+    {
+      id: "photo",
+      type: "photo_upload",
+      label: "Your Photo",
+      titleKey: `${scenarioId}.photo.title`,
+      subtitleKey: `${scenarioId}.photo.subtitle`,
+      showFaceDetection: false,
+      showPhotoTips: true,
+      required: true,
+    },
+  ];
+
+  // Add style selection if needed
+  if (options?.requireStyle) {
+    steps.push({
+      id: "style_selection",
+      type: "selection",
+      selectionType: "style",
+      titleKey: `${scenarioId}.style.title`,
+      subtitleKey: `${scenarioId}.style.subtitle`,
+      options: [], // Filled by feature
+      required: true,
+    });
+  }
+
+  // Add duration selection if needed
+  if (options?.requireDuration) {
+    steps.push({
+      id: "duration_selection",
+      type: "selection",
+      selectionType: "duration",
+      titleKey: `${scenarioId}.duration.title`,
+      subtitleKey: `${scenarioId}.duration.subtitle`,
+      options: [
+        { id: "5s", label: "5 seconds", value: 5 },
+        { id: "10s", label: "10 seconds", value: 10 },
+        { id: "15s", label: "15 seconds", value: 15 },
+      ],
+      required: true,
+    });
+  }
+
+  return {
+    id: scenarioId,
+    name: scenarioId,
+    steps,
+  };
+};
+
+/**
+ * TEXT-TO-VIDEO SCENARIOS
+ */
+const createTextToVideoWizardConfig = (scenarioId: string): WizardFeatureConfig => ({
+  id: scenarioId,
+  name: scenarioId,
+  steps: [
+    {
+      id: "text_input",
+      type: "text_input",
+      titleKey: `${scenarioId}.prompt.title`,
+      subtitleKey: `${scenarioId}.prompt.subtitle`,
+      placeholderKey: `${scenarioId}.prompt.placeholder`,
+      minLength: 10,
+      maxLength: 500,
+      multiline: true,
+      required: true,
+    },
+    {
+      id: "style_selection",
+      type: "selection",
+      selectionType: "style",
+      titleKey: `${scenarioId}.style.title`,
+      options: [], // Filled by feature
+      required: true,
+    },
+    {
+      id: "duration_selection",
+      type: "selection",
+      selectionType: "duration",
+      titleKey: `${scenarioId}.duration.title`,
+      options: [
+        { id: "5s", label: "5 seconds", value: 5 },
+        { id: "10s", label: "10 seconds", value: 10 },
+      ],
+      required: true,
+    },
+  ],
+});
+
+/**
+ * SCENARIO WIZARD CONFIG REGISTRY
+ * Maps scenario ID to wizard config
+ */
+export const SCENARIO_WIZARD_CONFIGS: Record<string, WizardFeatureConfig> = {
+  // COUPLE SCENARIOS (2 photos)
+  "romantic-kiss": createCoupleWizardConfig("romantic-kiss"),
+  "ai-hug": createCoupleWizardConfig("ai-hug"),
+  "couple-future-40": createCoupleWizardConfig("couple-future-40"),
+  "couple-future-50": createCoupleWizardConfig("couple-future-50"),
+  "couple-future-60": createCoupleWizardConfig("couple-future-60"),
+  "couple-future-70": createCoupleWizardConfig("couple-future-70"),
+  "couple-future-80": createCoupleWizardConfig("couple-future-80"),
+  "couple-ai-baby": createCoupleWizardConfig("couple-ai-baby"),
+
+  // SINGLE PHOTO SCENARIOS
+  "image-to-video": createSinglePhotoWizardConfig("image-to-video", {
+    requireStyle: true,
+    requireDuration: true,
+  }),
+  "face-swap": createSinglePhotoWizardConfig("face-swap"),
+  "anime-selfie": createSinglePhotoWizardConfig("anime-selfie"),
+
+  // TEXT-TO-VIDEO SCENARIOS
+  "text-to-video": createTextToVideoWizardConfig("text-to-video"),
+};
+
+/**
+ * Get wizard config for a scenario
+ */
+export const getScenarioWizardConfig = (scenarioId: string): WizardFeatureConfig | null => {
+  return SCENARIO_WIZARD_CONFIGS[scenarioId] || null;
+};
+
+/**
+ * Check if scenario has wizard config
+ */
+export const hasWizardConfig = (scenarioId: string): boolean => {
+  return scenarioId in SCENARIO_WIZARD_CONFIGS;
+};
+
+/**
+ * Get all scenario IDs with wizard configs
+ */
+export const getConfiguredScenarioIds = (): string[] => {
+  return Object.keys(SCENARIO_WIZARD_CONFIGS);
+};

package/src/domains/scenarios/index.ts

@@ -13,3 +13,11 @@ export { SCENARIOS } from "./infrastructure/ScenariosData";
 
 // Utils
 export { createStoryTemplate } from "./infrastructure/utils/scenario-utils";
+
+// Wizard Configurations - Each scenario's wizard flow
+export {
+  SCENARIO_WIZARD_CONFIGS,
+  getScenarioWizardConfig,
+  hasWizardConfig,
+  getConfiguredScenarioIds,
+} from "./configs/wizard-configs";

package/src/domains/wizard/domain/entities/wizard-config.types.ts

@@ -0,0 +1,214 @@
+/**
+ * Wizard Configuration Types
+ * Generic, feature-agnostic wizard configuration system
+ *
+ * All features use these same types - NO feature-specific wizards!
+ */
+
+import type { StepType } from "../../../../domain/entities/flow-config.types";
+
+/**
+ * Generic Step Configuration
+ * Base interface for all step configs
+ */
+export interface BaseStepConfig {
+  readonly id: string;
+  readonly type: StepType | string;
+  readonly enabled?: boolean;
+  readonly required?: boolean;
+  readonly titleKey?: string;
+  readonly subtitleKey?: string;
+}
+
+/**
+ * Photo Upload Step Configuration
+ * Used by ANY feature that needs photo uploads (couple, face-swap, image-to-video, etc.)
+ */
+export interface PhotoUploadStepConfig extends BaseStepConfig {
+  readonly type: "photo_upload";
+  readonly label?: string; // "Partner A", "Your Photo", etc.
+  readonly showFaceDetection?: boolean;
+  readonly showNameInput?: boolean;
+  readonly showPhotoTips?: boolean;
+  readonly maxFileSizeMB?: number;
+}
+
+/**
+ * Text Input Step Configuration
+ * Used by text-to-video, prompt-based features, etc.
+ */
+export interface TextInputStepConfig extends BaseStepConfig {
+  readonly type: "text_input";
+  readonly placeholderKey?: string;
+  readonly minLength?: number;
+  readonly maxLength?: number;
+  readonly multiline?: boolean;
+}
+
+/**
+ * Selection Step Configuration
+ * Generic selection (style, duration, aspect ratio, etc.)
+ */
+export interface SelectionStepConfig extends BaseStepConfig {
+  readonly type: "selection";
+  readonly selectionType: "style" | "duration" | "aspect_ratio" | "quality" | "custom";
+  readonly options: readonly {
+    readonly id: string;
+    readonly label: string;
+    readonly icon?: string;
+    readonly value: unknown;
+  }[];
+  readonly multiSelect?: boolean;
+  readonly defaultValue?: string | string[];
+}
+
+/**
+ * Preview Step Configuration
+ * Shows preview before generation (scenario preview, settings review, etc.)
+ */
+export interface PreviewStepConfig extends BaseStepConfig {
+  readonly type: "preview";
+  readonly previewType: "scenario" | "settings" | "custom";
+  readonly showContinueButton?: boolean;
+}
+
+/**
+ * Union of all step config types
+ */
+export type WizardStepConfig =
+  | PhotoUploadStepConfig
+  | TextInputStepConfig
+  | SelectionStepConfig
+  | PreviewStepConfig
+  | BaseStepConfig;
+
+/**
+ * Feature Flow Configuration
+ * Each feature (image-to-video, face-swap, couple-future, etc.) provides this
+ */
+export interface WizardFeatureConfig {
+  readonly id: string;
+  readonly name: string;
+  readonly steps: readonly WizardStepConfig[];
+  readonly translations?: {
+    readonly [key: string]: string | Record<string, string>;
+  };
+}
+
+/**
+ * Scenario-based Configuration Builder
+ * Shorthand for common patterns (couple scenarios, single photo, etc.)
+ */
+export interface ScenarioBasedConfig {
+  readonly photoCount?: number; // 0, 1, 2, etc.
+  readonly photoLabels?: readonly string[];
+  readonly requireText?: boolean;
+  readonly requireStyleSelection?: boolean;
+  readonly requireDurationSelection?: boolean;
+  readonly customSteps?: readonly WizardStepConfig[];
+}
+
+/**
+ * Build wizard config from scenario shorthand
+ */
+export const buildWizardConfigFromScenario = (
+  scenarioId: string,
+  config: ScenarioBasedConfig,
+): WizardFeatureConfig => {
+  const steps: WizardStepConfig[] = [];
+
+  // Add photo upload steps (dynamic count!)
+  if (config.photoCount && config.photoCount > 0) {
+    for (let i = 0; i < config.photoCount; i++) {
+      steps.push({
+        id: `photo_${i}`,
+        type: "photo_upload",
+        label: config.photoLabels?.[i] || `Photo ${i + 1}`,
+        showFaceDetection: true,
+        showPhotoTips: true,
+        required: true,
+      });
+    }
+  }
+
+  // Add text input
+  if (config.requireText) {
+    steps.push({
+      id: "text_input",
+      type: "text_input",
+      required: true,
+      minLength: 10,
+      maxLength: 500,
+    });
+  }
+
+  // Add style selection
+  if (config.requireStyleSelection) {
+    steps.push({
+      id: "style_selection",
+      type: "selection",
+      selectionType: "style",
+      options: [], // Provided by feature
+      required: true,
+    });
+  }
+
+  // Add duration selection
+  if (config.requireDurationSelection) {
+    steps.push({
+      id: "duration_selection",
+      type: "selection",
+      selectionType: "duration",
+      options: [
+        { id: "5s", label: "5 seconds", value: 5 },
+        { id: "10s", label: "10 seconds", value: 10 },
+        { id: "15s", label: "15 seconds", value: 15 },
+      ],
+      required: true,
+    });
+  }
+
+  // Add custom steps
+  if (config.customSteps) {
+    steps.push(...config.customSteps);
+  }
+
+  return {
+    id: scenarioId,
+    name: scenarioId,
+    steps,
+  };
+};
+
+/**
+ * Pre-configured scenarios for common use cases
+ */
+export const WIZARD_PRESETS = {
+  // Couple/Partner features (2 photos)
+  COUPLE: {
+    photoCount: 2,
+    photoLabels: ["First Partner", "Second Partner"],
+  },
+
+  // Single photo features
+  SINGLE_PHOTO: {
+    photoCount: 1,
+    photoLabels: ["Your Photo"],
+    requireStyleSelection: true,
+    requireDurationSelection: true,
+  },
+
+  // Text-only features
+  TEXT_ONLY: {
+    photoCount: 0,
+    requireText: true,
+    requireStyleSelection: true,
+    requireDurationSelection: true,
+  },
+
+  // Face swap (2 photos, specific requirements)
+  FACE_SWAP: {
+    photoCount: 2,
+    photoLabels: ["Source Face", "Target Face"],
+  },
+} as const;

package/src/domains/wizard/index.ts

@@ -0,0 +1,62 @@
+/**
+ * Wizard Domain - Public API
+ * Generic, configuration-driven wizard system
+ * Works for ALL features - NO feature-specific code!
+ */
+
+// Domain Entities - Configuration Types
+export type {
+  BaseStepConfig,
+  PhotoUploadStepConfig,
+  TextInputStepConfig,
+  SelectionStepConfig,
+  PreviewStepConfig,
+  WizardStepConfig,
+  WizardFeatureConfig,
+  ScenarioBasedConfig,
+} from "./domain/entities/wizard-config.types";
+
+export { buildWizardConfigFromScenario, WIZARD_PRESETS } from "./domain/entities/wizard-config.types";
+
+// Infrastructure - Builders
+export {
+  buildFlowStepsFromWizard,
+  getPhotoUploadCount,
+  getStepConfig,
+  quickBuildWizard,
+} from "./infrastructure/builders/dynamic-step-builder";
+
+// Infrastructure - Renderers
+export { renderStep } from "./infrastructure/renderers/step-renderer";
+export type { StepRendererProps } from "./infrastructure/renderers/step-renderer";
+
+// Presentation - Components
+export { GenericWizardFlow } from "./presentation/components/GenericWizardFlow";
+export type { GenericWizardFlowProps } from "./presentation/components/GenericWizardFlow";
+
+// Presentation - Steps
+export { PhotoUploadStep } from "./presentation/steps/PhotoUploadStep";
+export type { PhotoUploadStepProps } from "./presentation/steps/PhotoUploadStep";
+
+export { TextInputStep } from "./presentation/steps/TextInputStep";
+export type { TextInputStepProps } from "./presentation/steps/TextInputStep";
+
+export { SelectionStep } from "./presentation/steps/SelectionStep";
+export type { SelectionStepProps } from "./presentation/steps/SelectionStep";
+
+// Presentation - Screens
+export { GenericPhotoUploadScreen } from "./presentation/screens/GenericPhotoUploadScreen";
+export type {
+  PhotoUploadScreenProps,
+  PhotoUploadScreenConfig,
+  PhotoUploadScreenTranslations,
+} from "./presentation/screens/GenericPhotoUploadScreen";
+
+// Presentation - Hooks
+export { usePhotoUploadState } from "./presentation/hooks/usePhotoUploadState";
+export type {
+  UsePhotoUploadStateProps,
+  UsePhotoUploadStateReturn,
+  PhotoUploadConfig,
+  PhotoUploadTranslations,
+} from "./presentation/hooks/usePhotoUploadState";