@umituz/react-native-ai-generation-content 1.80.3 → 1.81.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-ai-generation-content",
-  "version": "1.80.3",
+  "version": "1.81.0",
   "description": "Provider-agnostic AI generation orchestration for React Native with result preview components",
   "main": "src/index.ts",
   "types": "src/index.ts",

package/src/core/constants/animation.constants.ts

@@ -0,0 +1,17 @@
+/**
+ * Animation Constants
+ * Single Responsibility: Define animation style constants
+ */
+
+export const ANIMATION_STYLE = {
+  ZOOM: "zoom",
+  PAN: "pan",
+  KEN_BURNS: "ken_burns",
+  NONE: "none",
+} as const;
+
+export type AnimationStyle =
+  | typeof ANIMATION_STYLE.ZOOM
+  | typeof ANIMATION_STYLE.PAN
+  | typeof ANIMATION_STYLE.KEN_BURNS
+  | typeof ANIMATION_STYLE.NONE;

package/src/core/constants/aspect-ratio.constants.ts

@@ -0,0 +1,24 @@
+/**
+ * Aspect Ratio Constants
+ * Single Responsibility: Define aspect ratio constants for AI generation
+ */
+
+export const ASPECT_RATIO = {
+  LANDSCAPE: "16:9",
+  PORTRAIT: "9:16",
+  SQUARE: "1:1",
+} as const;
+
+export type AspectRatio =
+  | typeof ASPECT_RATIO.LANDSCAPE
+  | typeof ASPECT_RATIO.PORTRAIT
+  | typeof ASPECT_RATIO.SQUARE;
+
+/**
+ * Default image sizes based on aspect ratio
+ */
+export const DEFAULT_IMAGE_SIZES: Record<AspectRatio, string> = {
+  [ASPECT_RATIO.LANDSCAPE]: "1024x576",
+  [ASPECT_RATIO.PORTRAIT]: "576x1024",
+  [ASPECT_RATIO.SQUARE]: "1024x1024",
+} as const;

package/src/core/constants/duration-options.constants.ts

@@ -0,0 +1,12 @@
+/**
+ * Duration Options Constants
+ */
+
+export interface DurationOption {
+  seconds: number;
+  label: string;
+}
+
+export const DURATION_OPTIONS: DurationOption[] = [
+  { seconds: 4, label: "4s - Standard" },
+];

package/src/core/constants/image.constants.ts

@@ -0,0 +1,31 @@
+/**
+ * Image Generation Constants
+ * Single Responsibility: Define image generation constants
+ *
+ * NOTE: For AI model names, use DEFAULT_MODELS from model.constants.ts
+ */
+
+export const IMAGE_SIZE = {
+  SMALL: "512x512",
+  MEDIUM: "768x768",
+  LARGE: "1024x1024",
+  PORTRAIT_LARGE: "1024x1792",
+  LANDSCAPE_LARGE: "1792x1024",
+} as const;
+
+export type ImageSize =
+  | typeof IMAGE_SIZE.SMALL
+  | typeof IMAGE_SIZE.MEDIUM
+  | typeof IMAGE_SIZE.LARGE
+  | typeof IMAGE_SIZE.PORTRAIT_LARGE
+  | typeof IMAGE_SIZE.LANDSCAPE_LARGE;
+
+/**
+ * Default number of images to generate
+ */
+export const DEFAULT_NUM_IMAGES = 1;
+
+/**
+ * Default guidance scale for image generation
+ */
+export const DEFAULT_IMAGE_GUIDANCE_SCALE = 7.5;

package/src/core/constants/index.ts

@@ -0,0 +1,49 @@
+/**
+ * AI Generation Constants
+ * Generic constants reusable across any AI generation app
+ *
+ * Note: AspectRatio, StyleOption, DurationOption, AnimationStyle, VideoDuration
+ * already exist in the feature domains with their own names.
+ * Here we export the raw config constants (not UI-specific types).
+ */
+
+// Video resolution options
+export {
+  VIDEO_RESOLUTION,
+  VIDEO_RESOLUTION_OPTIONS,
+  DEFAULT_MOTION_STRENGTH,
+  DEFAULT_GUIDANCE_SCALE,
+} from "./video.constants";
+export type { VideoResolution } from "./video.constants";
+
+// Video duration options
+export {
+  VIDEO_DURATION,
+  VIDEO_DURATION_OPTIONS,
+  VIDEO_DURATION_OPTIONS_WITH_LABELS,
+  VIDEO_ASPECT_RATIO,
+  VIDEO_ASPECT_RATIO_OPTIONS,
+} from "./video.constants";
+export type { VideoAspectRatio } from "./video.constants";
+
+// Image constants
+export {
+  IMAGE_SIZE,
+  DEFAULT_NUM_IMAGES,
+  DEFAULT_IMAGE_GUIDANCE_SCALE,
+} from "./image.constants";
+
+// Aspect ratio config
+export { ASPECT_RATIO, DEFAULT_IMAGE_SIZES } from "./aspect-ratio.constants";
+
+// Status constants
+export { FAL_AI_STATUS, CREATION_STATUS, PROVIDER } from "./status.constants";
+
+// Validation limits
+export { VALIDATION_LIMITS } from "./validation.constants";
+
+// Polling config
+export { POLLING_CONFIG } from "./polling.constants";
+
+// Animation style options
+export { ANIMATION_STYLE } from "./animation.constants";

package/src/core/constants/model.constants.ts

@@ -0,0 +1,11 @@
+/**
+ * AI Model Constants
+ * Single Source of Truth for all AI model IDs
+ */
+
+export const DEFAULT_MODELS = {
+  TEXT_TO_IMAGE: "xai/grok-imagine-image",
+  TEXT_TO_VIDEO: "xai/grok-imagine-video/text-to-video",
+  IMAGE_TO_VIDEO: "xai/grok-imagine-video/image-to-video",
+  SCENARIO_VIDEO: "fal-ai/ltx-video",
+} as const;

package/src/core/constants/polling.constants.ts

@@ -0,0 +1,12 @@
+/**
+ * Job Polling Constants
+ * Single Responsibility: Define polling configuration constants
+ */
+
+export const POLLING_CONFIG = {
+  MAX_ATTEMPTS: 60,
+  INTERVAL_MS: 5000,
+  INITIAL_PROGRESS: 20,
+  FINAL_PROGRESS: 90,
+  COMPLETION_PROGRESS: 100,
+} as const;

package/src/core/constants/preset-styles.constants.ts

@@ -0,0 +1,76 @@
+/**
+ * Preset Styles Constants
+ */
+
+export interface PresetStyle {
+  id: string;
+  emoji: string;
+  name: string;
+  description: string;
+  prompt: string;
+  style: string;
+  duration: number;
+}
+
+export const PRESET_STYLES: PresetStyle[] = [
+  {
+    id: "birthday",
+    emoji: "🎉",
+    name: "Birthday",
+    description: "Celebration with balloons & confetti",
+    prompt:
+      "Create a joyful birthday celebration video with colorful balloons, confetti animations, happy birthday text effects, and party atmosphere",
+    style: "playful",
+    duration: 4,
+  },
+  {
+    id: "social",
+    emoji: "📱",
+    name: "Social Media",
+    description: "Modern intro with colors",
+    prompt:
+      "Create a modern social media intro with solid background, smooth transitions, trending aesthetics, and attention-grabbing text",
+    style: "vibrant",
+    duration: 4,
+  },
+  {
+    id: "business",
+    emoji: "💼",
+    name: "Business",
+    description: "Professional presentation",
+    prompt:
+      "Create a professional business presentation video with clean design, corporate colors, elegant transitions, and polished look",
+    style: "professional",
+    duration: 4,
+  },
+  {
+    id: "education",
+    emoji: "🎓",
+    name: "Education",
+    description: "Tutorial & learning content",
+    prompt:
+      "Create an educational tutorial video with clear step-by-step structure, informative text, learning-friendly design",
+    style: "minimal",
+    duration: 4,
+  },
+  {
+    id: "music",
+    emoji: "🎵",
+    name: "Music Video",
+    description: "Vibrant & energetic visuals",
+    prompt:
+      "Create a music video with vibrant colors, rhythm-synced animations, abstract shapes, and energetic motion",
+    style: "vibrant",
+    duration: 4,
+  },
+  {
+    id: "promo",
+    emoji: "🔥",
+    name: "Promotion",
+    description: "Product showcase & ads",
+    prompt:
+      "Create an engaging product promotion video with dynamic animations, call-to-action text, bold colors, and persuasive messaging",
+    style: "modern",
+    duration: 4,
+  },
+];

package/src/core/constants/script-durations.constants.ts

@@ -0,0 +1,3 @@
+export const SCRIPT_DURATIONS = [4] as const;
+
+export type ScriptDuration = (typeof SCRIPT_DURATIONS)[number];

package/src/core/constants/status.constants.ts

@@ -0,0 +1,24 @@
+/**
+ * AI Generation Status Constants
+ */
+
+export const FAL_AI_STATUS = {
+  IN_QUEUE: "IN_QUEUE",
+  QUEUED: "QUEUED",
+  IN_PROGRESS: "IN_PROGRESS",
+  PROCESSING: "PROCESSING",
+  COMPLETED: "COMPLETED",
+  FAILED: "FAILED",
+} as const;
+
+export const CREATION_STATUS = {
+  PENDING: "pending",
+  QUEUED: "queued",
+  PROCESSING: "processing",
+  COMPLETED: "completed",
+  FAILED: "failed",
+} as const;
+
+export const PROVIDER = {
+  FAL: "fal",
+} as const;

package/src/core/constants/style-options.constants.ts

@@ -0,0 +1,18 @@
+/**
+ * Style Options Constants
+ */
+
+export interface StyleOption {
+  id: string;
+  label: string;
+  icon: string;
+}
+
+export const STYLE_OPTIONS: StyleOption[] = [
+  { id: "modern", label: "Modern", icon: "Zap" },
+  { id: "minimal", label: "Minimal", icon: "Minus" },
+  { id: "vibrant", label: "Vibrant", icon: "sparkles" },
+  { id: "professional", label: "Professional", icon: "Briefcase" },
+  { id: "playful", label: "Playful", icon: "Smile" },
+  { id: "elegant", label: "Elegant", icon: "Award" },
+];

package/src/core/constants/text-to-image-models.constants.ts

@@ -0,0 +1,18 @@
+/**
+ * Text-to-Image Models Configuration
+ */
+
+import type { FalModelConfig } from "@umituz/react-native-ai-fal-provider";
+
+export const TEXT_TO_IMAGE_MODELS: FalModelConfig[] = [
+  {
+    id: "xai/grok-imagine-image",
+    name: "Grok Imagine",
+    type: "text-to-image",
+    isDefault: true,
+    isActive: true,
+    pricing: { freeUserCost: 0.5, premiumUserCost: 0.25 },
+    description: "X.AI's cost-effective text-to-image generation ($0.02/image)",
+    order: 1,
+  },
+];

package/src/core/constants/validation.constants.ts

@@ -0,0 +1,45 @@
+/**
+ * Validation Constants
+ * Single Responsibility: Define validation limits and rules
+ */
+
+export const VALIDATION_LIMITS = {
+  /**
+   * Prompt validation limits
+   */
+  PROMPT: {
+    MIN_LENGTH: 3,
+    MAX_LENGTH: 5000,
+  },
+
+  /**
+   * Text-to-voice validation limits
+   */
+  TEXT_TO_VOICE: {
+    MAX_LENGTH: 5000,
+  },
+
+  /**
+   * Number of images validation
+   */
+  NUM_IMAGES: {
+    MIN: 1,
+    MAX: 4,
+  },
+
+  /**
+   * Guidance scale validation
+   */
+  GUIDANCE_SCALE: {
+    MIN: 1,
+    MAX: 20,
+  },
+
+  /**
+   * Seed validation
+   */
+  SEED: {
+    MIN: 0,
+    MAX: 2147483647, // 32-bit integer max
+  },
+} as const;

package/src/core/constants/video.constants.ts

@@ -0,0 +1,79 @@
+/**
+ * Video Generation Constants
+ * Single Responsibility: Define video generation constants
+ *
+ * Grok Imagine Video supports:
+ * - Duration: 4, 5, 6 seconds
+ * - Resolution: 480p, 720p ($0.05/sec @ 480p, $0.07/sec @ 720p)
+ * - Aspect Ratio: 16:9, 9:16
+ */
+
+export const VIDEO_DURATION = {
+  SHORT: 4,
+  MEDIUM: 8,
+  LONG: 12,
+} as const;
+
+export type VideoDuration =
+  | typeof VIDEO_DURATION.SHORT
+  | typeof VIDEO_DURATION.MEDIUM
+  | typeof VIDEO_DURATION.LONG;
+
+/**
+ * Duration options for video generation (fixed to 4 seconds)
+ */
+export const VIDEO_DURATION_OPTIONS: VideoDuration[] = [4];
+
+/**
+ * Duration options with labels (for DurationSelector components)
+ */
+export const VIDEO_DURATION_OPTIONS_WITH_LABELS: Array<{
+  value: VideoDuration;
+  label: string;
+}> = [{ value: 4, label: "4s" }];
+
+/**
+ * Video Aspect Ratio options
+ */
+export const VIDEO_ASPECT_RATIO = {
+  LANDSCAPE: "16:9",
+  PORTRAIT: "9:16",
+} as const;
+
+export type VideoAspectRatio =
+  | typeof VIDEO_ASPECT_RATIO.LANDSCAPE
+  | typeof VIDEO_ASPECT_RATIO.PORTRAIT;
+
+export const VIDEO_ASPECT_RATIO_OPTIONS: VideoAspectRatio[] = ["16:9", "9:16"];
+
+/**
+ * Video Resolution options
+ */
+export const VIDEO_RESOLUTION = {
+  DEFAULT: "default",
+  SD_480P: "480p",
+  HD_720P: "720p",
+} as const;
+
+export type VideoResolution =
+  | typeof VIDEO_RESOLUTION.DEFAULT
+  | typeof VIDEO_RESOLUTION.SD_480P
+  | typeof VIDEO_RESOLUTION.HD_720P;
+
+export const VIDEO_RESOLUTION_OPTIONS: Array<{
+  value: VideoResolution;
+  label: string;
+}> = [
+  { value: "480p", label: "Standard (480p)" },
+  { value: "720p", label: "HD (720p)" },
+];
+
+/**
+ * Default motion strength for video generation
+ */
+export const DEFAULT_MOTION_STRENGTH = 0.7;
+
+/**
+ * Default guidance scale for text-to-video
+ */
+export const DEFAULT_GUIDANCE_SCALE = 12;

package/src/core/index.ts

@@ -54,6 +54,9 @@ export type {
   IAIProvider,
 } from "../domain/interfaces/ai-provider.interface";
 
+// Generation Constants
+export * from "./constants";
+
 // Segregated provider sub-interfaces
 export type { IAIProviderLifecycle } from "../domain/interfaces/provider-lifecycle.interface";
 export type { IAIProviderCapabilities } from "../domain/interfaces/provider-capabilities.interface";

package/src/domain/interfaces/video-model-config.types.ts

@@ -11,7 +11,7 @@ export interface ModelCapabilityOption {
 }
 
 export interface VideoModelConfig {
-  /** Fal.ai model endpoint (e.g., "fal-ai/ltx-video-13b-distilled/image-to-video") */
+  /** Provider model endpoint ID */
   readonly modelId: string;
 
   /** Human-readable display name */
@@ -29,10 +29,7 @@ export interface VideoModelConfig {
     };
   };
 
-  /**
-   * Maps generic WizardVideoInput to model-specific API parameters.
-   * This is the core adapter function - eliminates all model-specific if/else checks.
-   */
+  /** Maps generic wizard input to model-specific API parameters */
   readonly buildInput: (input: {
     readonly prompt: string;
     readonly sourceImageBase64?: string;
@@ -42,10 +39,7 @@ export interface VideoModelConfig {
     readonly resolution?: string;
   }) => Record<string, unknown>;
 
-  /**
-   * Pricing data for credit calculation.
-   * Keys are resolution IDs matching capabilities.resolutions[].id
-   */
+  /** Pricing data for credit calculation (keys = resolution IDs) */
   readonly pricing: {
     readonly costPerSecond: Record<string, number>;
   };

package/src/index.ts

@@ -46,3 +46,6 @@ export type { VideoModelConfig, ModelCapabilityOption } from "./domain/interface
 
 // Wizard Config Builder (generates wizard steps from VideoModelConfig)
 export { buildWizardConfigFromModelConfig } from "./domains/generation/wizard/utilities/build-wizard-config";
+
+// Generation Constants (VideoResolution, AspectRatio, StyleOptions, etc.)
+export * from "./core/constants";