@umituz/react-native-ai-generation-content 1.26.2 → 1.26.4

package/src/features/anime-selfie/presentation/components/index.ts

@@ -1,2 +0,0 @@
-export { AnimeSelfieFeature } from "./AnimeSelfieFeature";
-export type { AnimeSelfieFeatureProps } from "./AnimeSelfieFeature";

package/src/features/anime-selfie/presentation/hooks/index.ts

@@ -1,9 +0,0 @@
-/**
- * Anime Selfie Presentation Hooks Index
- */
-
-export { useAnimeSelfieFeature } from "./useAnimeSelfieFeature";
-export type {
-  UseAnimeSelfieFeatureProps,
-  UseAnimeSelfieFeatureReturn,
-} from "./useAnimeSelfieFeature";

package/src/features/anime-selfie/presentation/hooks/useAnimeSelfieFeature.ts

@@ -1,59 +0,0 @@
-/**
- * useAnimeSelfieFeature Hook
- * Uses base single image hook for anime selfie transformation
- * Uses centralized orchestrator for credit/error handling
- */
-
-import { useMemo } from "react";
-import {
-  useSingleImageFeature,
-  type BaseSingleImageHookReturn,
-} from "../../../image-to-image";
-import type { AlertMessages } from "../../../../presentation/hooks/generation";
-import { createAnimeSelfiePrompt } from "../../../../domains/prompts";
-import type { AnimeSelfieFeatureConfig } from "../../domain/types";
-
-export interface UseAnimeSelfieFeatureProps {
-  config: AnimeSelfieFeatureConfig;
-  onSelectImage: () => Promise<string | null>;
-  onSaveImage: (imageUrl: string) => Promise<void>;
-  onBeforeProcess?: () => Promise<boolean>;
-}
-
-export interface UseAnimeSelfieFeatureOptions {
-  /** Alert messages for error handling */
-  alertMessages?: AlertMessages;
-  /** User ID for credit operations */
-  userId?: string;
-  /** Callback when credits are exhausted */
-  onCreditsExhausted?: () => void;
-}
-
-export type UseAnimeSelfieFeatureReturn = BaseSingleImageHookReturn;
-
-export function useAnimeSelfieFeature(
-  props: UseAnimeSelfieFeatureProps,
-  options?: UseAnimeSelfieFeatureOptions,
-): UseAnimeSelfieFeatureReturn {
-  const { config, onSelectImage, onSaveImage, onBeforeProcess } = props;
-
-  const promptConfig = useMemo(
-    () => createAnimeSelfiePrompt(config.defaultStyle),
-    [config.defaultStyle],
-  );
-
-  // Cast config to any to bypass strict type checking while maintaining runtime behavior
-  return useSingleImageFeature(
-    { config: config as never, onSelectImage, onSaveImage, onBeforeProcess },
-    {
-      buildInput: (imageBase64) => ({
-        imageBase64,
-        prompt: promptConfig.prompt,
-        options: {
-          guidance_scale: promptConfig.guidance_scale,
-        },
-      }),
-      ...options,
-    },
-  );
-}

package/src/features/anime-selfie/presentation/index.ts

@@ -1,6 +0,0 @@
-/**
- * Anime Selfie Presentation Index
- */
-
-export * from "./hooks";
-export * from "./components";

package/src/features/couple-future/README.md

@@ -1,445 +0,0 @@
-# Couple Future Feature
-
-Generate images showing couples in future scenarios using AI.
-
-## 📍 Import Path
-
-```typescript
-import { useCoupleFutureGeneration } from '@umituz/react-native-ai-generation-content';
-```
-
-**Location**: `src/features/couple-future/`
-
-## 🎯 Feature Purpose
-
-Create AI-generated images showing couples in various future scenarios including wedding day, old age, anniversary celebrations, and family moments. Features natural aging progression and high-quality facial matching for heartwarming results.
-
----
-
-## 📋 Usage Strategy
-
-### When to Use This Feature
-
-✅ **Use Cases:**
-- Creating fun future predictions with partners
-- Generating anniversary content
-- Social media couple content
-- Creative romantic projects
-- Gift ideas for couples
-
-❌ **When NOT to Use:**
-- Non-consensual image generation
-- Misleading or deceptive content
-- Harassment or bullying
-- Commercial use without permissions
-
-### Implementation Strategy
-
-1. **Select TWO photos** (person 1 and person 2)
-2. **Choose future scenario** (wedding, old-age, anniversary, family)
-3. **Validate both photos** before generation
-4. **Generate future image** with progress tracking
-5. **Preview result** and offer regeneration
-6. **Save or share** final image
-
----
-
-## ⚠️ Critical Rules (MUST FOLLOW)
-
-### 1. Image Requirements
-- **MUST** provide TWO distinct images (person 1 + person 2)
-- **MUST** contain at least one visible person in each image
-- **MUST** use high-quality images (min 512x512 recommended)
-- **MUST** ensure faces are clearly visible
-- **MUST NOT** use images with no detectable people
-
-### 2. Configuration
-- **MUST** provide valid `userId` for tracking
-- **MUST** specify `scenario` (wedding, old-age, anniversary, family)
-- **MUST** implement `onError` callback
-- **MUST** implement `onSelectPerson1` and `onSelectPerson2` callbacks
-- **MUST** handle both images being selected before processing
-
-### 3. State Management
-- **MUST** check `isReady` before enabling generate button
-- **MUST** verify both images are selected
-- **MUST** handle `isProcessing` state to prevent duplicate requests
-- **MUST** display `error` state to users
-- **MUST** implement proper cleanup on unmount
-
-### 4. Performance
-- **MUST** limit image size (<10MB each)
-- **MUST** compress images before processing
-- **MUST** implement loading indicators during processing
-- **MUST** cache results locally
-- **MUST NOT** generate multiple futures simultaneously
-
-### 5. Ethics & Privacy
-- **MUST** obtain consent from people whose photos are used
-- **MUST** provide clear usage terms
-- **MUST** implement content moderation
-- **MUST** prevent malicious use cases
-- **MUST** log processing for audit trail
-
----
-
-## 🚫 Prohibitions (MUST AVOID)
-
-### Strictly Forbidden
-
-❌ **NEVER** do the following:
-
-1. **No Single Image**
-   - Always requires TWO images (person 1 + person 2)
-   - Never attempt with missing image
-
-2. **No Non-Consensual Generation**
-   - Always obtain permission from subjects
-   - Never generate futures without consent
-   - Implement age verification for minors
-
-3. **No Malicious Use**
-   - Never use for harassment or bullying
-   - Never create misleading content
-   - Never use for deception
-
-4. **No Unhandled Errors**
-   - Never ignore generation failures
-   - Always handle detection errors gracefully
-   - Provide clear error messages
-
-5. **No Memory Leaks**
-   - Never store large images in state unnecessarily
-   - Always cleanup image references on unmount
-   - Implement proper image disposal
-
-6. **No Blocked UI**
-   - Never process without user confirmation
-   - Always show progress indicator
-   - Never block main thread with image processing
-
-7. **No Missing Context**
-   - Never confuse which person is which
-   - Always provide clear UI labels
-   - Show preview before processing
-
----
-
-## 🤖 AI Agent Directions
-
-### For AI Code Generation Tools
-
-When using this feature with AI code generation tools, follow these guidelines:
-
-#### Prompt Template for AI Agents
-
-```
-You are implementing a couple future generation feature using @umituz/react-native-ai-generation-content.
-
-REQUIREMENTS:
-1. Import from: @umituz/react-native-ai-generation-content
-2. Use the useCoupleFutureGeneration hook
-3. Require TWO images (person 1 + person 2)
-4. Implement dual image selection UI
-5. Select future scenario (wedding, old-age, anniversary, family)
-6. Validate both images before generation
-7. Add confirmation dialog before generation
-8. Handle long processing times with progress
-9. Implement proper error handling
-10. Implement cleanup on unmount
-
-CRITICAL RULES:
-- MUST obtain consent from subjects
-- MUST validate both images before processing
-- MUST provide clear UI for person 1 vs person 2
-- MUST handle generation errors gracefully
-- MUST prevent malicious use cases
-- MUST implement content moderation
-- NEVER process without user confirmation
-
-CONFIGURATION:
-- Provide valid userId (string)
-- Set scenario: 'wedding' | 'old-age' | 'anniversary' | 'family'
-- Set preserveFaces: boolean (maintain facial features)
-- Set enhanceQuality: boolean (enhance output quality)
-- Implement onSelectPerson1 callback
-- Implement onSelectPerson2 callback
-- Implement onSaveResult callback
-- Configure callbacks: onProcessingStart, onProcessingComplete, onError
-
-SCENARIOS:
-- wedding: Couples on their wedding day
-- old-age: The couple as elderly
-- anniversary: Celebrating an anniversary
-- family: The couple with a family
-
-OPTIONS:
-- preserveFaces: Maintain facial features (default: true)
-- enhanceQuality: Enhance output quality (default: true)
-
-STRICTLY FORBIDDEN:
-- No single image processing
-- No non-consensual generation
-- No malicious use
-- No unhandled errors
-- No memory leaks
-- No missing UI context
-
-ETHICS CHECKLIST:
-- [ ] Consent mechanism implemented
-- [ ] Age verification for minors
-- [ ] Content moderation in place
-- [ ] Usage terms provided
-- [ ] Audit trail logging
-- [ ] Report/flag functionality
-```
-
-#### AI Implementation Checklist
-
-Use this checklist when generating code:
-
-- [ ] Feature imported from correct path
-- [ ] Dual image selection implemented
-- [ ] Person 1/Person 2 labels clear
-- [ ] Future scenario selector added
-- [ ] Both images validated before processing
-- [ ] Confirmation dialog added
-- [ ] Progress indicator during processing
-- [ ] Error display with user-friendly message
-- [ ] Result preview before saving
-- [ ] Consent mechanism in place
-- [ ] Cleanup on unmount
-- [ ] Content moderation configured
-
----
-
-## 🛠️ Configuration Strategy
-
-### Essential Configuration
-
-```typescript
-// Required fields
-{
-  userId: string
-  scenario: 'wedding' | 'old-age' | 'anniversary' | 'family'
-  onSelectPerson1: () => Promise<string | null>
-  onSelectPerson2: () => Promise<string | null>
-}
-
-// Optional callbacks
-{
-  onProcessingStart?: () => void
-  onProcessingComplete?: (result) => void
-  onError?: (error: string) => void
-}
-```
-
-### Recommended Settings
-
-1. **Future Scenarios**
-   - Wedding: Romantic wedding day imagery
-   - Old Age: Realistic aging progression
-   - Anniversary: Celebration scenes
-   - Family: Couple with children
-
-2. **Image Quality**
-   - Minimum: 512x512 resolution
-   - Recommended: 1024x1024 or higher
-   - Format: JPEG or PNG
-   - Max size: 10MB per image
-
-3. **Performance Settings**
-   - Compress images before upload
-   - Show progress for long operations
-   - Implement timeout (120s default)
-   - Enable result caching
-
----
-
-## 📊 State Management
-
-### Feature States
-
-**isReady**: boolean
-- Both images selected and validated
-- Check before enabling generate button
-
-**isProcessing**: boolean
-- Future generation in progress
-- Show loading/progress indicator
-- Disable generate button
-
-**progress**: number (0-100)
-- Generation progress percentage
-- Update progress bar
-
-**error**: string | null
-- Error message if generation failed
-- Common errors: "No person found in image", "Generation failed"
-
-**result**: {
-  imageUrl: string
-  scenario?: string
-  metadata?: any
-}
-
----
-
-## 🔐 Ethics & Privacy
-
-### Consent Requirements
-
-- **MUST** obtain explicit consent from all subjects
-- **MUST** provide clear explanation of how images will be used
-- **MUST** implement age verification
-- **MUST** allow subjects to opt-out
-
-### Content Moderation
-
-- **MUST** filter inappropriate content
-- **MUST** prevent malicious use cases
-- **MUST** implement reporting mechanism
-- **MUST** review flagged content
-
-### Usage Guidelines
-
-- **MUST** provide terms of service
-- **MUST** clearly label AI-generated content
-- **MUST** prevent deception/misrepresentation
-- **MUST** comply with deepfake regulations
-
----
-
-## 🎨 Best Practices
-
-### Photo Selection
-
-1. **Photo Quality**
-   - Good: High-quality, well-lit photos
-   - Bad: Blurry, dark, low-resolution images
-
-2. **Face Visibility**
-   - Good: Clear, frontal face shots
-   - Bad: Occluded or profile faces
-
-3. **Similar Angles**
-   - Similar head angles produce better results
-   - Forward-facing photos work best
-
-4. **Lighting**
-   - Similar lighting conditions work best
-   - Front-facing well-lit photos ideal
-
-### User Experience
-
-1. **Clear UI**
-   - Label person 1 vs person 2 clearly
-   - Show preview before processing
-   - Add confirmation dialog
-
-2. **Error Handling**
-   - Explain "no person found" errors
-   - Provide troubleshooting tips
-   - Offer retry option
-
-3. **Performance**
-   - Compress images before upload
-   - Show progress for long operations
-   - Cache results for re-download
-
----
-
-## 🐛 Common Pitfalls
-
-### Detection Issues
-
-❌ **Problem**: "No person found" error
-✅ **Solution**: Ensure people are clearly visible, well-lit, frontal
-
-### Quality Issues
-
-❌ **Problem**: Poor quality generation
-✅ **Solution**: Use higher resolution images, better lighting
-
-### UX Confusion
-
-❌ **Problem**: Users confused about which person is which
-✅ **Solution**: Clear labels, visual indicators, preview
-
-### Privacy Concerns
-
-❌ **Problem**: Non-consensual image generation
-✅ **Solution**: Implement consent mechanisms, age verification
-
----
-
-## 📦 Related Components
-
-Use these components from the library:
-
-- **DualImagePicker**: Select two images
-- **ScenarioSelector**: Choose future scenario
-- **ResultImageCard**: Display result with actions
-- **ConfirmationDialog**: Confirm before processing
-
-Located at: `src/presentation/components/`
-
----
-
-## 🔄 Migration Strategy
-
-If migrating from previous implementation:
-
-1. **Update imports** to new path
-2. **Add dual image selection** (person 1 + person 2)
-3. **Implement consent mechanism**
-4. **Add scenario selector**
-5. **Update state handling** for both images
-6. **Test all error cases**
-
----
-
-## ⚖️ Legal Considerations
-
-### Compliance
-
-- **Deepfake Regulations**: Comply with local laws
-- **Privacy Laws**: GDPR, CCPA compliance
-- **Consent Requirements**: Explicit permission needed
-- **Age Restrictions**: Verify adult subjects
-- **Content Labeling**: Mark as AI-generated
-
-### Best Practices
-
-- Provide attribution for source images
-- Allow content reporting/flagging
-- Implement audit trail logging
-- Cooperate with takedown requests
-
----
-
-## 📚 Additional Resources
-
-- Main documentation: `/docs/`
-- API reference: `/docs/api/`
-- Examples: `/docs/examples/basic/couple-future/`
-- Ethics guidelines: `/docs/ethics.md`
-
----
-
-**Last Updated**: 2025-01-08
-**Version**: 2.0.0 (Strategy-based Documentation)
-
----
-
-## 📝 Changelog
-
-### v2.0.0 - 2025-01-08
-- **BREAKING**: Documentation format changed to strategy-based
-- Removed extensive code examples
-- Added ethics and privacy guidelines
-- Added rules, prohibitions, and AI agent directions
-- Focus on responsible AI usage
-
-### v1.0.0 - Initial Release
-- Initial feature documentation

package/src/features/couple-future/domain/types.ts

@@ -1,63 +0,0 @@
-/**
- * Couple Future Types
- * Multi-reference image generation for couples using Nano Banana
- */
-
-export type NanoBananaAspectRatio =
-  | "auto"
-  | "21:9"
-  | "16:9"
-  | "3:2"
-  | "4:3"
-  | "5:4"
-  | "1:1"
-  | "4:5"
-  | "3:4"
-  | "2:3"
-  | "9:16";
-
-export type NanoBananaOutputFormat = "jpeg" | "png" | "webp";
-
-export interface CoupleFutureInput {
-  partnerABase64: string;
-  partnerBBase64: string;
-  prompt: string;
-}
-
-export interface CoupleFutureConfig {
-  /** REQUIRED: AI model ID from app config */
-  model: string;
-  timeoutMs?: number;
-  aspectRatio?: NanoBananaAspectRatio;
-  outputFormat?: NanoBananaOutputFormat;
-  onProgress?: (progress: number) => void;
-}
-
-export interface CoupleFutureResult {
-  success: boolean;
-  imageUrl?: string;
-  error?: string;
-}
-
-export const COUPLE_FUTURE_DEFAULTS = {
-  aspectRatio: "4:3" as NanoBananaAspectRatio,
-  outputFormat: "jpeg" as NanoBananaOutputFormat,
-  timeoutMs: 300000,
-};
-
-export type CoupleFeatureId =
-  | "romantic-mood"
-  | "art-style"
-  | "artist-style"
-  | "wardrobe";
-
-export interface CoupleFeatureSelection {
-  romanticMoods?: string[];
-  romanticIntensity?: number;
-  artStyle?: string | null;
-  artStyleIntensity?: number;
-  artist?: string | null;
-  artistIntensity?: number;
-  wardrobeStyle?: string | null;
-  wardrobeIntensity?: number;
-}

package/src/features/couple-future/domain/wizard-config.adapter.ts

@@ -1,76 +0,0 @@
-/**
- * Wizard Configuration Adapter
- * Adapts old wizard config to new dynamic step system
- */
-
-import { buildStepsFromScenario, buildStepsWithNavigation, SCENARIO_CONFIGS } from "../../../infrastructure/flow/step-builder";
-import type { DynamicStepDefinition } from "../../../domain/entities/step-config.types";
-import type { WizardScenarioData } from "../presentation/types";
-import { StepType } from "../../../domain/entities/flow-config.types";
-
-/**
- * Build steps for a scenario
- * Returns dynamically generated step definitions based on scenario type
- */
-export const buildStepsForScenario = (scenario: WizardScenarioData | undefined): DynamicStepDefinition[] => {
-  if (!scenario) {
-    // No scenario selected - only show scenario selection
-    return [
-      {
-        id: "SCENARIO_SELECTION",
-        type: StepType.SCENARIO_SELECTION,
-        required: true,
-      },
-    ];
-  }
-
-  const steps: DynamicStepDefinition[] = [];
-
-  // Always start with scenario preview if scenario is selected
-  steps.push({
-    id: "SCENARIO_PREVIEW",
-    type: StepType.SCENARIO_PREVIEW,
-    required: true,
-  });
-
-  // Get scenario-specific config
-  const scenarioConfig = SCENARIO_CONFIGS[scenario.category || ""] || SCENARIO_CONFIGS["romantic-kiss"];
-
-  // Build dynamic steps from config
-  const dynamicSteps = buildStepsFromScenario(scenario.id, scenarioConfig);
-  steps.push(...dynamicSteps);
-
-  // Add generating step
-  steps.push({
-    id: "GENERATING",
-    type: StepType.GENERATING,
-    required: true,
-  });
-
-  // Link steps together
-  return buildStepsWithNavigation(steps);
-};
-
-/**
- * Get photo upload count for a scenario
- * Used to determine how many partner images are needed
- */
-export const getPhotoUploadCount = (scenario: WizardScenarioData | undefined): number => {
-  if (!scenario) return 0;
-
-  const scenarioConfig = SCENARIO_CONFIGS[scenario.category || ""] || SCENARIO_CONFIGS["romantic-kiss"];
-  return scenarioConfig.photoUploads?.count ?? 0;
-};
-
-/**
- * Get photo upload label for a specific index
- */
-export const getPhotoUploadLabel = (
-  scenario: WizardScenarioData | undefined,
-  index: number,
-): string => {
-  if (!scenario) return `Photo ${index + 1}`;
-
-  const scenarioConfig = SCENARIO_CONFIGS[scenario.category || ""] || SCENARIO_CONFIGS["romantic-kiss"];
-  return scenarioConfig.photoUploads?.labels?.[index] || `Photo ${index + 1}`;
-};