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

package/src/features/ai-hug/domain/types/ai-hug.types.ts

@@ -1,25 +0,0 @@
-/**
- * AI Hug Feature Types
- * Extends dual-image-video types for AI hug video generation
- */
-
-import type {
-  DualImageVideoFeatureConfig,
-  DualImageVideoFeatureState,
-  DualImageVideoTranslations,
-} from "../../../shared/dual-image-video";
-
-export interface AIHugResult {
-  success: boolean;
-  videoUrl?: string;
-  error?: string;
-  requestId?: string;
-}
-
-export type AIHugFeatureState = DualImageVideoFeatureState;
-
-export type AIHugTranslations = DualImageVideoTranslations;
-
-export type AIHugResultExtractor = (result: unknown) => string | undefined;
-
-export type AIHugFeatureConfig = DualImageVideoFeatureConfig;

package/src/features/ai-hug/domain/types/index.ts

@@ -1,7 +0,0 @@
-export type {
-  AIHugResult,
-  AIHugFeatureState,
-  AIHugTranslations,
-  AIHugResultExtractor,
-  AIHugFeatureConfig,
-} from "./ai-hug.types";

package/src/features/ai-hug/index.ts

@@ -1,19 +0,0 @@
-/**
- * AI Hug Feature
- * Provider-agnostic AI hug video generation feature
- */
-
-// Domain Types
-export type {
-  AIHugResult,
-  AIHugFeatureState,
-  AIHugTranslations,
-  AIHugFeatureConfig,
-  AIHugResultExtractor,
-} from "./domain";
-
-// Presentation Hooks
-export { useAIHugFeature, type UseAIHugFeatureProps } from "./presentation";
-
-// Presentation Components
-export { AIHugFeature, type AIHugFeatureProps } from "./presentation";

package/src/features/ai-hug/presentation/components/AIHugFeature.tsx

@@ -1,77 +0,0 @@
-import React, { useMemo } from "react";
-import { View, StyleSheet } from "react-native";
-import { DualImagePicker } from "../../../../presentation/components/image-picker/DualImagePicker";
-import { DualImageVideoFeatureLayout } from "../../../../presentation/layouts";
-import type { DualImageInputRenderProps } from "../../../../presentation/layouts";
-import { useAIHugFeature } from "../hooks";
-import type { AIHugTranslations, AIHugFeatureConfig } from "../../domain/types";
-
-export interface AIHugFeatureProps {
-  config: AIHugFeatureConfig;
-  translations: AIHugTranslations & {
-    modalTitle?: string;
-    modalMessage?: string;
-    modalHint?: string;
-    modalBackgroundHint?: string;
-  };
-  onSelectSourceImage: () => Promise<string | null>;
-  onSelectTargetImage: () => Promise<string | null>;
-  onSaveVideo: (videoUrl: string) => Promise<void>;
-  onBeforeProcess?: () => Promise<boolean>;
-}
-
-export const AIHugFeature: React.FC<AIHugFeatureProps> = ({
-  config,
-  translations,
-  onSelectSourceImage,
-  onSelectTargetImage,
-  onSaveVideo,
-  onBeforeProcess,
-}) => {
-  const feature = useAIHugFeature({
-    config,
-    onSelectSourceImage,
-    onSelectTargetImage,
-    onSaveVideo,
-    onBeforeProcess,
-  });
-
-  const modalTranslations = useMemo(
-    () => ({
-      title: translations.modalTitle || "Creating your video",
-      message: translations.modalMessage || "AI is working its magic...",
-      hint: translations.modalHint || "This may take a moment",
-      backgroundHint: translations.modalBackgroundHint || "Continue in background",
-    }),
-    [translations],
-  );
-
-  return (
-    <DualImageVideoFeatureLayout
-      feature={feature}
-      translations={translations}
-      modalTranslations={modalTranslations}
-      renderInput={({ sourceImageUri, targetImageUri, onSelectSource, onSelectTarget, isDisabled }: DualImageInputRenderProps) => (
-        <View style={styles.pickerContainer}>
-          <DualImagePicker
-            sourceImageUri={sourceImageUri}
-            targetImageUri={targetImageUri}
-            isDisabled={isDisabled}
-            onSelectSource={onSelectSource}
-            onSelectTarget={onSelectTarget}
-            sourcePlaceholder={translations.sourceUploadTitle}
-            targetPlaceholder={translations.targetUploadTitle}
-            layout="horizontal"
-          />
-        </View>
-      )}
-    />
-  );
-};
-
-const styles = StyleSheet.create({
-  pickerContainer: {
-    marginHorizontal: 16,
-    marginBottom: 16,
-  },
-});

package/src/features/ai-hug/presentation/components/index.ts

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

package/src/features/ai-hug/presentation/hooks/index.ts

@@ -1,9 +0,0 @@
-/**
- * AI Hug Presentation Hooks Index
- */
-
-export { useAIHugFeature } from "./useAIHugFeature";
-export type {
-  UseAIHugFeatureProps,
-  UseAIHugFeatureReturn,
-} from "./useAIHugFeature";

package/src/features/ai-hug/presentation/hooks/useAIHugFeature.ts

@@ -1,34 +0,0 @@
-/**
- * useAIHugFeature Hook
- * Thin wrapper around useDualImageVideoFeature for ai-hug feature
- * DRY: Uses shared base hook for common logic
- */
-
-import { useDualImageVideoFeature } from "../../../shared/dual-image-video";
-import type {
-  AIHugFeatureConfig,
-  AIHugFeatureState,
-} from "../../domain/types";
-
-export interface UseAIHugFeatureProps {
-  config: AIHugFeatureConfig;
-  onSelectSourceImage: () => Promise<string | null>;
-  onSelectTargetImage: () => Promise<string | null>;
-  onSaveVideo: (videoUrl: string) => Promise<void>;
-  onBeforeProcess?: () => Promise<boolean>;
-}
-
-export interface UseAIHugFeatureReturn extends AIHugFeatureState {
-  selectSourceImage: () => Promise<void>;
-  selectTargetImage: () => Promise<void>;
-  process: () => Promise<void>;
-  save: () => Promise<void>;
-  reset: () => void;
-}
-
-export function useAIHugFeature(props: UseAIHugFeatureProps): UseAIHugFeatureReturn {
-  return useDualImageVideoFeature({
-    featureType: "ai-hug",
-    ...props,
-  });
-}

package/src/features/ai-hug/presentation/index.ts

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

package/src/features/ai-kiss/README.md

@@ -1,445 +0,0 @@
-# AI Kiss Feature
-
-Generate AI-powered kiss images between two people.
-
-## 📍 Import Path
-
-```typescript
-import { useAIKissFeature } from '@umituz/react-native-ai-generation-content';
-```
-
-**Location**: `src/features/ai-kiss/`
-
-## 🎯 Feature Purpose
-
-Create realistic kiss images by combining two photos using AI. Automatically detects poses, positions faces naturally, and generates high-quality facial matching for various kiss types including romantic, gentle, passionate, and cute styles.
-
----
-
-## 📋 Usage Strategy
-
-### When to Use This Feature
-
-✅ **Use Cases:**
-- Creating couple photos
-- Generating romantic moments
-- Fun friendship images
-- Social media content
-- Creative personal projects
-
-❌ **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 kiss type** (romantic, gentle, passionate, cute)
-3. **Validate both photos** before generation
-4. **Generate AI kiss** with progress tracking
-5. **Preview result** and offer regeneration
-6. **Save or share** the 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 `kissType` (romantic, gentle, passionate, cute)
-- **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 kisses 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 kisses 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 an AI kiss generation feature using @umituz/react-native-ai-generation-content.
-
-REQUIREMENTS:
-1. Import from: @umituz/react-native-ai-generation-content
-2. Use the useAIKissFeature hook
-3. Require TWO images (person 1 + person 2)
-4. Implement dual image selection UI
-5. Select kiss type (romantic, gentle, passionate, cute)
-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 kissType: 'romantic' | 'gentle' | 'passionate' | 'cute'
-- 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
-
-KISS TYPES:
-- romantic: Intimate, romantic kiss
-- gentle: Soft, gentle kiss
-- passionate: Passionate kiss
-- cute: Adorable, cute kiss
-
-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
-- [ ] Kiss type 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
-  kissType: 'romantic' | 'gentle' | 'passionate' | 'cute'
-  onSelectPerson1: () => Promise<string | null>
-  onSelectPerson2: () => Promise<string | null>
-}
-
-// Optional callbacks
-{
-  onProcessingStart?: () => void
-  onProcessingComplete?: (result) => void
-  onError?: (error: string) => void
-}
-```
-
-### Recommended Settings
-
-1. **Kiss Types**
-   - Romantic: Intimate couple kisses
-   - Gentle: Soft, tender kisses
-   - Passionate: Strong, passionate kisses
-   - Cute: Adorable, playful kisses
-
-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
-- AI kiss 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
-  kissType?: 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
-- **KissTypeSelector**: Choose kiss style
-- **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 kiss type 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/ai-kiss/`
-- 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/ai-kiss/domain/index.ts

@@ -1,5 +0,0 @@
-/**
- * AI Kiss Domain Index
- */
-
-export * from "./types";

package/src/features/ai-kiss/domain/types/ai-kiss.types.ts

@@ -1,25 +0,0 @@
-/**
- * AI Kiss Feature Types
- * Extends dual-image-video types for AI kiss video generation
- */
-
-import type {
-  DualImageVideoFeatureConfig,
-  DualImageVideoFeatureState,
-  DualImageVideoTranslations,
-} from "../../../shared/dual-image-video";
-
-export interface AIKissResult {
-  success: boolean;
-  videoUrl?: string;
-  error?: string;
-  requestId?: string;
-}
-
-export type AIKissFeatureState = DualImageVideoFeatureState;
-
-export type AIKissTranslations = DualImageVideoTranslations;
-
-export type AIKissResultExtractor = (result: unknown) => string | undefined;
-
-export type AIKissFeatureConfig = DualImageVideoFeatureConfig;

package/src/features/ai-kiss/domain/types/index.ts

@@ -1,7 +0,0 @@
-export type {
-  AIKissResult,
-  AIKissFeatureState,
-  AIKissTranslations,
-  AIKissResultExtractor,
-  AIKissFeatureConfig,
-} from "./ai-kiss.types";

package/src/features/ai-kiss/index.ts

@@ -1,19 +0,0 @@
-/**
- * AI Kiss Feature
- * Provider-agnostic AI kiss video generation feature
- */
-
-// Domain Types
-export type {
-  AIKissResult,
-  AIKissFeatureState,
-  AIKissTranslations,
-  AIKissFeatureConfig,
-  AIKissResultExtractor,
-} from "./domain";
-
-// Presentation Hooks
-export { useAIKissFeature, type UseAIKissFeatureProps } from "./presentation";
-
-// Presentation Components
-export { AIKissFeature, type AIKissFeatureProps } from "./presentation";