@cliquify.me/ai-effects 0.0.0-stage → 1.0.0

package/dist/knowledge.d.ts

@@ -0,0 +1,25 @@
+export interface ExistingAnimationDetail {
+    property: string;
+    delayInFrames: number;
+    durationInFrames: number;
+    name?: string;
+}
+export interface SelectedItemSummary {
+    id: string;
+    name?: string;
+    type: string;
+    startFrame: number;
+    endFrame: number;
+    durationInFrames: number;
+    startTimeMs: number;
+    endTimeMs: number;
+    durationMs: number;
+    width?: number;
+    height?: number;
+    text?: string;
+    currentEffects?: string[];
+    currentAnimations?: string[];
+    existingAnimationDetails?: ExistingAnimationDetail[];
+}
+export declare const ANIMATION_CONTEXT_KNOWLEDGE = "\n### EDITOR ANIMATIONS & EFFECTS CATALOG (ELEMENT-TYPE SPECIFIC):\n\n1. **TEXT & CAPTIONS ELEMENT PRESETS (isTextItem = true)**:\n   - **Basic**: \"disappearIn\" (character typing / typewriter reveal), \"fadeIn\".\n   - **Slide**: \"slideInLeft\", \"slideInRight\", \"slideInTop\", \"slideInBottom\".\n   - **Scale**: \"growIn\", \"shrinkIn\", \"scaleIn\", \"zoomIn\".\n   - **Rotate**: \"spinIn\", \"rotateIn\", \"flipInX\", \"flipInY\".\n   - **Bounce**: \"bounceIn\", \"elasticIn\".\n   - **Filters**: \"blurIn\", \"brightnessIn\".\n   - **Mask (Text Specific)**: \"maskUpIn\", \"maskDownIn\", \"maskRevealIn\", \"maskRevealSlideIn\", \"maskRevealCenterIn\", \"maskRevealCornerIn\".\n   - **Blur**: \"blurV2In\", \"blurSlide\".\n   - **Custom Keyframe Properties**: \"scale\", \"rotate\", \"opacity\", \"move\" ({ fromX, toX, fromY, toY }), \"blur\", \"brightness\".\n\n2. **IMAGE, VIDEO & MEDIA ELEMENT PRESETS (isMediaItem = true)**:\n   - **Fade**: \"fadeIn\", \"slideInRight\".\n   - **Scale**: \"scaleIn\", \"shrinkIn\", \"spinIn\", \"twistIn\", \"moveScaleIn\".\n   - **Mask**: \"maskRevealIn\", \"maskRevealSlideIn\", \"maskRevealCenterIn\", \"maskRevealCornerIn\", \"maskRevealShrinkScaleIn\", \"maskRevealCenterScaleIn\".\n   - **Blur**: \"blurIn\", \"blurSlideV2In\".\n   - **Basic Visual Effects**:\n     - \"blur\" (Gaussian blur 0 to 40px)\n     - \"vignette\" (Cinematic edge darkening)\n     - \"chromaticAberration\" (RGB chromatic glitch split)\n     - \"noise\" (Granular static texture)\n     - \"pixelate\" (8-bit mosaic blocks 1 to 40px)\n     - \"grayscale\" (B&W monochrome)\n     - \"contrast\" (Punches contrast 0 to 3)\n     - \"brightness\" (Modulates luminance 0 to 2)\n     - \"hue\" (Color spectrum rotation 0 to 360)\n     - \"saturation\" (Color vibrancy 0 to 3)\n\n3. **SHAPE ELEMENT PRESETS**:\n   - **Fade**: \"fadeIn\", \"slideInRight\".\n   - **Scale**: \"scaleIn\", \"shrinkIn\", \"spinIn\", \"twistIn\", \"moveScaleIn\".\n   - **Blur**: \"blurIn\", \"blurSlideV2In\".\n   - **Keyframe Properties**: \"scale\", \"rotate\", \"opacity\", \"move\", \"borderRadius\", \"stroke\".\n\n4. **EXIT ANIMATIONS**:\n   - \"fadeOut\", \"slideOutLeft\", \"slideOutRight\", \"slideOutTop\", \"slideOutBottom\", \"scaleOut\", \"zoomOut\", \"spinOut\", \"rotateOut\", \"bounceOut\", \"blurOut\", \"maskRevealSlideOut\".\n";
+export declare const TOOLS_CAPABILITIES_KNOWLEDGE = "\n### AVAILABLE TOOLS AND CREATION CAPABILITIES:\nYou have access to 2 dynamic creation tools:\n\n1. **add_text**: Adds a new text element to the editor canvas and timeline.\n   - Parameters:\n     - \"text\": The textual content requested by user (string, e.g. \"Summer Sale 50% Off\", \"Subscribe\", headline, or paragraph).\n     - \"fontSize\": Font size in pixels (number, default: 64, typical range 32 to 120).\n     - \"color\": Text hex color (string, default: \"#ffffff\", e.g. \"#f43f5e\", \"#3b82f6\").\n     - \"textAlign\": \"left\" | \"center\" | \"right\".\n     - \"fontFamily\": Optional font family (e.g. \"Roboto\", \"Inter\", \"Montserrat\").\n\n2. **add_shape**: Adds a geometric or AI-generated vector shape element to canvas and timeline.\n   - Parameters:\n     - \"shapeType\": Standard (\"rectangle\" | \"circle\" | \"triangle\" | \"star\") OR \"custom\".\n     - \"color\": Fill color hex (string, e.g. \"#3b82f6\", \"#ef4444\", \"#10b981\", \"#eab308\", \"#8b5cf6\").\n     - \"width\": Width in pixels (number, default: 300).\n     - \"height\": Height in pixels (number, default: 300).\n     - \"borderRadius\": Corner radius for rectangles (number, e.g. 0 to 50).\n     - \"svgContent\": OPTIONAL dynamic SVG markup generated by AI when user asks for custom shapes (e.g. hearts, arrows, shields, badges, icons, speech bubbles, polygons). Format: valid self-contained <svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 100 100\">...</svg>.\n\n### CRITICAL SCOPE & RESTRICTION RULES:\n- ONLY **text** and **shapes** are currently supported for creation/generation.\n- If the user asks to add or generate **images**, **photos**, **videos**, **audio**, **music**, **voiceovers**, or **3D models**, return an \"unsupported\" response explaining that currently only text and shapes are supported.\n- When generating motion effects for selected elements, strictly respect the element type:\n  - Text animations (typewriter/disappearIn, maskUpIn, text zoom/slide) for TEXT layers.\n  - Image/Video visual filters (vignette, chromatic, pixelate, mask reveal, blur) for IMAGE and VIDEO layers.\n  - Shape animations (borderRadius, stroke, scale, rotate) for SHAPE layers.\n";

package/dist/provider.d.ts

@@ -0,0 +1,14 @@
+export type LLMProvider = "openai" | "google" | "anthropic";
+export interface ModelOption {
+    id: string;
+    name: string;
+    description: string;
+}
+export declare const PROVIDER_MODELS: Record<LLMProvider, ModelOption[]>;
+export interface LLMConfig {
+    provider: LLMProvider;
+    model: string;
+    apiKey?: string;
+    baseUrl?: string;
+}
+export declare const getAIModel: (config?: LLMConfig) => import('ai').LanguageModelV1;

package/dist/types.d.ts

@@ -0,0 +1,63 @@
+export type SupportedEffectProperty = "scale" | "rotate" | "move" | "translateX" | "translateY" | "opacity" | "blur" | "backgroundBlur" | "glass" | "shadow" | "hide-show" | "borderRadius" | "stroke" | "pixelate" | "brightness";
+export interface GeneratedEffectStep {
+    property: SupportedEffectProperty;
+    from: number;
+    to: number;
+    durationInFrames: number;
+    delayInFrames?: number;
+    easing?: "linear" | "easeIn" | "easeOut" | "easeInOut";
+    details?: {
+        fromX?: number;
+        toX?: number;
+        fromY?: number;
+        toY?: number;
+        scale?: number;
+    };
+}
+export interface AIEffectResponse {
+    title: string;
+    description: string;
+    steps: GeneratedEffectStep[];
+}
+export type StandardShapeType = "rectangle" | "circle" | "triangle" | "star";
+export type ShapeType = StandardShapeType | "custom";
+export interface AddTextAction {
+    type: "add_text";
+    text: string;
+    fontSize?: number;
+    color?: string;
+    textAlign?: "left" | "center" | "right";
+    fontFamily?: string;
+}
+export interface AddShapeAction {
+    type: "add_shape";
+    shapeType: ShapeType;
+    color?: string;
+    width?: number;
+    height?: number;
+    borderRadius?: number;
+    svgContent?: string;
+}
+export interface UnsupportedAction {
+    type: "unsupported";
+    feature: string;
+    message: string;
+}
+export type AIAction = AddTextAction | AddShapeAction | UnsupportedAction;
+export interface AIGenerationResult {
+    action?: AIAction;
+    effect?: AIEffectResponse;
+    message: string;
+}
+export interface ChatMessage {
+    id: string;
+    sender: "bot" | "user";
+    text: string;
+    effect?: AIEffectResponse;
+    action?: AIAction;
+    targetElement?: {
+        id: string;
+        name: string;
+        type: string;
+    };
+}

package/dist/utils.d.ts

@@ -0,0 +1,19 @@
+export declare const calculateFrames: (display: {
+    from: number;
+    to: number;
+}, fps: number) => {
+    from: number;
+    durationInFrames: number;
+};
+export declare const cancelPreviewAnimation: () => void;
+export declare const previewAnimation: (durationInFrames: number, playerRef: {
+    current: {
+        seekTo: (frame: number) => void;
+        getCurrentFrame: () => number;
+        play: () => void;
+        pause: () => void;
+        isPlaying: () => boolean;
+    } | null;
+}, previewTimeoutRef?: {
+    current: number | null;
+}, startFrameOffset?: number) => void;

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "@cliquify.me/ai-effects",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.0",
+  "type": "module",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "dist/index.es.js",
+  "module": "dist/index.es.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.es.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.24",
+    "@types/react": "^19.1.8",
+    "@types/react-dom": "^19.1.6",
+    "rollup-plugin-peer-deps-external": "^2.2.4",
+    "typescript": "^5.8.3",
+    "vite": "^5.2.0",
+    "vite-plugin-dts": "^3.9.1",
+    "@cliquify.me/typescript-config": "1.0.4"
+  },
+  "dependencies": {
+    "@ai-sdk/anthropic": "^1.1.9",
+    "@ai-sdk/google": "^1.1.16",
+    "@ai-sdk/openai": "^1.1.13",
+    "ai": "^4.1.41",
+    "nanoid": "^5.0.7",
+    "lucide-react": "^0.469.0",
+    "sonner": "^1.7.1"
+  },
+  "peerDependencies": {
+    "@designcombo/events": "1.0.2",
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0",
+    "remotion": ">=4.0.0",
+    "@cliquify.me/state": "9.0.8",
+    "@cliquify.me/types": "9.0.9"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build",
+    "format": "prettier --write ."
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.