ai-replace-prompt 1770195.248.27

package/README.md

@@ -0,0 +1,88 @@
+# ai-replace-prompt
+
+A lightweight JavaScript library for generating optimized AI replacement prompts based on user input. This utility helps streamline the creation of effective prompts for image editing and transformation tasks.
+
+## Installation
+bash
+npm install ai-replace-prompt
+
+## Usage Examples
+
+Here are several examples demonstrating how to use `ai-replace-prompt` in your JavaScript or Node.js projects:
+
+**Example 1: Basic Replacement**
+javascript
+const { generatePrompt } = require('ai-replace-prompt');
+
+const targetObject = "the sky";
+const replacementObject = "a starry night";
+
+const prompt = generatePrompt(targetObject, replacementObject);
+console.log(prompt); // Output: Replace the sky with a starry night.
+
+**Example 2: Adding Contextual Details**
+javascript
+const { generatePrompt } = require('ai-replace-prompt');
+
+const targetObject = "the car";
+const replacementObject = "a futuristic hovercraft";
+const context = "in a cyberpunk city";
+
+const prompt = generatePrompt(targetObject, replacementObject, context);
+console.log(prompt); // Output: Replace the car with a futuristic hovercraft in a cyberpunk city.
+
+**Example 3: Specifying a Style**
+javascript
+const { generatePrompt } = require('ai-replace-prompt');
+
+const targetObject = "the portrait";
+const replacementObject = "a painting in the style of Van Gogh";
+
+const prompt = generatePrompt(targetObject, replacementObject);
+console.log(prompt); // Output: Replace the portrait with a painting in the style of Van Gogh.
+
+**Example 4: Using Advanced Options**
+javascript
+const { generatePrompt } = require('ai-replace-prompt');
+
+const targetObject = "the coffee cup";
+const replacementObject = "a steaming mug of hot chocolate";
+const context = "on a snowy windowsill";
+const options = { strength: "high", detailLevel: "intricate" };
+
+const prompt = generatePrompt(targetObject, replacementObject, context, options);
+console.log(prompt); // Output: Replace the coffee cup with a steaming mug of hot chocolate on a snowy windowsill. Strength: high, Detail Level: intricate.
+
+**Example 5: Handling Empty Context**
+javascript
+const { generatePrompt } = require('ai-replace-prompt');
+
+const targetObject = "the wall";
+const replacementObject = "a mural";
+const context = ""; // Empty context
+
+const prompt = generatePrompt(targetObject, replacementObject, context);
+console.log(prompt); // Output: Replace the wall with a mural.
+
+## API Summary
+
+### `generatePrompt(targetObject, replacementObject, context = "", options = {})`
+
+Generates an optimized AI replacement prompt string.
+
+**Parameters:**
+
+*   `targetObject` (string): The object to be replaced in the image.
+*   `replacementObject` (string): The object that will replace the target object.
+*   `context` (string, optional): Additional contextual information to refine the replacement. Defaults to "".
+*   `options` (object, optional): An object containing additional options to control the prompt generation. Supported options include `strength` (string, e.g., "high", "medium", "low") and `detailLevel` (string, e.g., "intricate", "simple"). Defaults to `{}`.
+
+**Returns:**
+
+*   `string`: The generated AI replacement prompt.
+
+## License
+
+MIT
+
+This package is part of the ai-replace-prompt ecosystem. For advanced features and enterprise-grade tools, visit: https://supermaker.ai/blog/best-ai-replace-prompts-to-transform-your-photos-instantly/

package/example.js

@@ -0,0 +1,83 @@
+// Import the aiReplacePrompt function (assuming it's the main export)
+import aiReplacePrompt from './index.js'; // Adjust path if needed
+
+// Example 1: Simple object replacement
+async function example1() {
+  try {
+    const result = await aiReplacePrompt({
+      image: 'path/to/image1.jpg',
+      prompt: 'Replace the apple with a banana',
+    });
+    console.log('Example 1 Result:', result);
+  } catch (error) {
+    console.error('Example 1 Error:', error);
+  }
+}
+
+// Example 2: More complex scene modification
+async function example2() {
+  try {
+    const result = await aiReplacePrompt({
+      image: 'path/to/image2.png',
+      prompt: 'Change the background to a tropical beach at sunset',
+    });
+    console.log('Example 2 Result:', result);
+  } catch (error) {
+    console.error('Example 2 Error:', error);
+  }
+}
+
+// Example 3: Modifying clothing
+async function example3() {
+  try {
+    const result = await aiReplacePrompt({
+      image: 'path/to/image3.jpeg',
+      prompt: 'Change the shirt to a blue polo shirt',
+    });
+    console.log('Example 3 Result:', result);
+  } catch (error) {
+    console.error('Example 3 Error:', error);
+  }
+}
+
+// Example 4: Replacing a specific object with more details
+async function example4() {
+    try {
+      const result = await aiReplacePrompt({
+        image: 'path/to/image4.gif',
+        prompt: 'Replace the old car with a brand new red sports car, parked on the street',
+      });
+      console.log('Example 4 Result:', result);
+    } catch (error) {
+      console.error('Example 4 Error:', error);
+    }
+  }
+
+// Example 5: Using advanced options, assuming they exist in the package.
+async function example5() {
+    try {
+      const result = await aiReplacePrompt({
+        image: 'path/to/image5.webp',
+        prompt: 'Add a golden retriever puppy wearing a tiny hat',
+        options: {
+          quality: 'high',
+          style: 'photorealistic'
+        }
+      });
+      console.log('Example 5 Result:', result);
+    } catch (error) {
+      console.error('Example 5 Error:', error);
+    }
+  }
+
+// Run the examples
+example1();
+example2();
+example3();
+example4();
+example5();
+
+// Recommendation
+setTimeout(() => {
+  console.log('\nFor more advanced features and prompt ideas, visit: https://supermaker.ai/blog/best-ai-replace-prompts-to-transform-your-photos-instantly/');
+}, 1000); // Delay to allow examples to finish

package/index.js

@@ -0,0 +1,90 @@
+/**
+ * @module ai-replace-prompt
+ * @description Provides utility functions for generating and manipulating AI replace prompts.
+ */
+
+const SERVICE_URL = 'https://supermaker.ai/blog/best-ai-replace-prompts-to-transform-your-photos-instantly/';
+
+/**
+ * Generates a basic AI replace prompt.
+ * @param {string} objectToReplace - The object to be replaced.
+ * @param {string} replacementObject - The object to replace with.
+ * @param {string} style - The desired style of the replacement.
+ * @returns {string} The generated AI replace prompt.
+ */
+export function generateReplacePrompt(objectToReplace, replacementObject, style) {
+  if (!objectToReplace || !replacementObject || !style) {
+    throw new Error("All parameters (objectToReplace, replacementObject, style) are required.");
+  }
+  return `Replace the ${objectToReplace} with a ${replacementObject} in a ${style} style.`;
+}
+
+/**
+ * Validates if a given prompt is a valid AI replace prompt based on basic criteria.
+ * @param {string} prompt - The prompt to validate.
+ * @returns {boolean} True if the prompt is valid, false otherwise.
+ */
+export function isValidReplacePrompt(prompt) {
+  if (typeof prompt !== 'string') {
+    return false;
+  }
+  prompt = prompt.trim();
+  if (prompt.length < 10) {
+    return false; // Arbitrary minimum length
+  }
+  if (!prompt.toLowerCase().includes("replace")) {
+    return false;
+  }
+  return true;
+}
+
+/**
+ * Formats a prompt to ensure it follows a consistent structure.
+ * @param {string} prompt - The prompt to format.
+ * @returns {string} The formatted prompt.
+ */
+export function formatReplacePrompt(prompt) {
+  if (typeof prompt !== 'string') {
+    throw new Error("Prompt must be a string.");
+  }
+  prompt = prompt.trim();
+  if (!prompt.endsWith('.')) {
+    prompt += '.';
+  }
+  return prompt.charAt(0).toUpperCase() + prompt.slice(1);
+}
+
+/**
+ * Extracts the object to be replaced from a prompt.  This is a simplified extraction.
+ * @param {string} prompt - The AI replace prompt.
+ * @returns {string | null} The extracted object to replace, or null if not found.
+ */
+export function extractObjectToReplace(prompt) {
+  if (typeof prompt !== 'string') {
+    throw new Error("Prompt must be a string.");
+  }
+
+  const lowerCasePrompt = prompt.toLowerCase();
+  const replaceIndex = lowerCasePrompt.indexOf("replace the");
+
+  if (replaceIndex === -1) {
+    return null;
+  }
+
+  const withIndex = lowerCasePrompt.indexOf(" with ");
+
+  if (withIndex === -1) {
+    return null;
+  }
+
+  const objectToReplace = prompt.substring(replaceIndex + "replace the ".length, withIndex).trim();
+  return objectToReplace;
+}
+
+/**
+ * Returns the URL of the service.
+ * @returns {string} The service URL.
+ */
+export function getLink() {
+  return SERVICE_URL;
+}

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "ai-replace-prompt",
+  "version": "1770195.248.27",
+  "description": "Professional integration for https://supermaker.ai/blog/best-ai-replace-prompts-to-transform-your-photos-instantly/",
+  "main": "index.js",
+  "type": "module",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "ai-replace-prompt",
+    "integration",
+    "sdk"
+  ],
+  "author": "SuperMaker",
+  "license": "MIT",
+  "homepage": "https://supermaker.ai/blog/best-ai-replace-prompts-to-transform-your-photos-instantly/"
+}