prompts.chat 0.0.1 → 0.0.3

package/README.md

@@ -0,0 +1,856 @@
+# prompts.chat
+
+The **D3.js of prompt engineering** — a comprehensive developer toolkit for building, validating, and parsing AI prompts. Create structured prompts for chat models, image generators, video AI, and music generation with fluent, type-safe APIs.
+
+## Installation
+
+```bash
+npm install prompts.chat
+```
+
+## Quick Start
+
+```typescript
+import { builder, chat, image, audio, variables, quality } from 'prompts.chat';
+
+// Build structured text prompts
+const prompt = builder()
+  .role("Senior TypeScript Developer")
+  .task("Review the following code for bugs and improvements")
+  .constraints(["Be concise", "Focus on critical issues"])
+  .variable("code", { required: true })
+  .build();
+
+// Build chat prompts with full control
+const chatPrompt = chat()
+  .role("expert code reviewer")
+  .tone("professional")
+  .expertise("TypeScript", "React", "Node.js")
+  .task("Review code and provide actionable feedback")
+  .stepByStep()
+  .json()
+  .build();
+
+// Build image generation prompts
+const imagePrompt = image()
+  .subject("a cyberpunk samurai")
+  .environment("neon-lit Tokyo streets")
+  .shot("medium")
+  .lens("35mm")
+  .lightingType("neon")
+  .medium("cinematic")
+  .build();
+
+// Build music generation prompts  
+const musicPrompt = audio()
+  .genre("electronic")
+  .mood("energetic")
+  .bpm(128)
+  .instruments(["synthesizer", "drums", "bass"])
+  .build();
+
+// Normalize variable formats
+const normalized = variables.normalize("Hello {{name}}, you are [ROLE]");
+// → "Hello ${name}, you are ${role}"
+
+// Check quality locally (no API needed)
+const result = quality.check("Act as a developer...");
+console.log(result.score); // 0.85
+```
+
+---
+
+## Modules
+
+- [Variables](#-variables) — Variable detection and normalization
+- [Similarity](#-similarity) — Content deduplication
+- [Builder](#️-builder) — Structured text prompts
+- [Chat Builder](#-chat-builder) — Chat/conversational prompts
+- [Image Builder](#-image-builder) — Image generation prompts
+- [Video Builder](#-video-builder) — Video generation prompts
+- [Audio Builder](#-audio-builder) — Music/audio generation prompts
+- [Quality](#-quality) — Prompt validation
+- [Parser](#-parser) — Multi-format parsing
+
+---
+
+## 🔧 Variables
+
+Universal variable detection and normalization across different formats.
+
+```typescript
+import { variables } from 'prompts.chat';
+
+// Detect variables in any format
+const detected = variables.detect("Hello {{name}}, welcome to [COMPANY]");
+// → [{ name: "name", pattern: "double_curly" }, { name: "COMPANY", pattern: "single_bracket" }]
+
+// Normalize all formats to ${var}
+const normalized = variables.normalize("Hello {{name}}, you are [ROLE]");
+// → "Hello ${name}, you are ${role}"
+
+// Extract variables from ${var} format
+const vars = variables.extractVariables("Hello ${name:World}");
+// → [{ name: "name", defaultValue: "World" }]
+
+// Compile template with values
+const result = variables.compile("Hello ${name:World}", { name: "Developer" });
+// → "Hello Developer"
+
+// Get pattern descriptions
+variables.getPatternDescription("double_bracket"); // → "[[...]]"
+```
+
+### Supported Formats
+
+| Format | Example | Pattern Name |
+|--------|---------|--------------|
+| `${var}` | `${name}` | `dollar_curly` |
+| `${var:default}` | `${name:World}` | `dollar_curly` |
+| `{{var}}` | `{{name}}` | `double_curly` |
+| `[[var]]` | `[[name]]` | `double_bracket` |
+| `[VAR]` | `[NAME]` | `single_bracket` |
+| `{VAR}` | `{NAME}` | `single_curly` |
+| `<VAR>` | `<NAME>` | `angle_bracket` |
+| `%VAR%` | `%NAME%` | `percent` |
+
+### API Reference
+
+| Function | Description |
+|----------|-------------|
+| `detect(text)` | Detect variables in any format |
+| `normalize(text)` | Convert all formats to `${var}` |
+| `extractVariables(text)` | Extract from `${var}` format |
+| `compile(text, values, options?)` | Replace variables with values |
+| `convertToSupportedFormat(variable)` | Convert a single variable |
+| `getPatternDescription(pattern)` | Get human-readable pattern |
+
+---
+
+## 📊 Similarity
+
+Content similarity detection for deduplication using Jaccard and n-gram algorithms.
+
+```typescript
+import { similarity } from 'prompts.chat';
+
+// Calculate similarity score (0-1)
+const score = similarity.calculate(prompt1, prompt2);
+// → 0.87
+
+// Check if prompts are duplicates (default threshold: 0.85)
+const isDupe = similarity.isDuplicate(prompt1, prompt2, 0.85);
+// → true
+
+// Find groups of duplicate prompts
+const groups = similarity.findDuplicates(prompts, 0.85);
+// → [[prompt1, prompt3], [prompt2, prompt5]]
+
+// Deduplicate an array (keeps first occurrence)
+const unique = similarity.deduplicate(prompts, 0.85);
+
+// Get content fingerprint for indexing
+const fingerprint = similarity.getContentFingerprint(prompt);
+
+// Normalize content for comparison
+const normalized = similarity.normalizeContent(text);
+```
+
+### API Reference
+
+| Function | Description |
+|----------|-------------|
+| `calculate(content1, content2)` | Calculate similarity score (0-1) |
+| `isDuplicate(content1, content2, threshold?)` | Check if similar (default 0.85) |
+| `findDuplicates(prompts, threshold?)` | Find groups of duplicates |
+| `deduplicate(prompts, threshold?)` | Remove duplicates |
+| `normalizeContent(content)` | Normalize for comparison |
+| `getContentFingerprint(content)` | Get fingerprint for indexing |
+
+---
+
+## 🏗️ Builder
+
+Fluent DSL for creating structured text prompts.
+
+```typescript
+import { builder, fromPrompt, templates } from 'prompts.chat';
+
+// Build a custom prompt
+const prompt = builder()
+  .role("Senior Developer")
+  .context("You are helping review a React application")
+  .task("Analyze the code for performance issues")
+  .constraints([
+    "Be concise",
+    "Focus on critical issues",
+    "Suggest fixes with code examples"
+  ])
+  .output("JSON with { issues: [], suggestions: [] }")
+  .variable("code", { required: true, description: "Code to review" })
+  .example("const x = 1;", '{ "issues": [], "suggestions": [] }')
+  .section("Additional Notes", "Consider React 18 best practices")
+  .build();
+
+console.log(prompt.content);
+console.log(prompt.variables);
+console.log(prompt.metadata);
+
+// Create from existing prompt
+const existing = fromPrompt("You are a helpful assistant...").build();
+```
+
+### Builder Methods
+
+| Method | Description |
+|--------|-------------|
+| `.role(role)` | Set AI persona (alias: `.persona()`) |
+| `.context(context)` | Set background info (alias: `.background()`) |
+| `.task(task)` | Set main instruction (alias: `.instruction()`) |
+| `.constraints(list)` | Add multiple constraints (alias: `.rules()`) |
+| `.constraint(text)` | Add single constraint |
+| `.output(format)` | Set output format (alias: `.format()`) |
+| `.example(input, output)` | Add input/output example |
+| `.examples(list)` | Add multiple examples |
+| `.variable(name, options?)` | Define a variable |
+| `.section(title, content)` | Add custom section |
+| `.raw(content)` | Set raw content |
+| `.build()` | Build the prompt |
+| `.toString()` | Get content string |
+
+### Pre-built Templates
+
+```typescript
+import { templates } from 'prompts.chat';
+
+// Code review template
+const review = templates.codeReview({ 
+  language: "TypeScript",
+  focus: ["performance", "security"]
+});
+
+// Translation template
+const translate = templates.translation("English", "Spanish");
+
+// Summarization template
+const summary = templates.summarize({ 
+  maxLength: 100, 
+  style: "bullet" 
+});
+
+// Q&A template
+const qa = templates.qa("You are answering questions about React.");
+```
+
+---
+
+## 💬 Chat Builder
+
+Model-agnostic builder for conversational AI prompts. Works with GPT-4, Claude, Gemini, and any chat model.
+
+```typescript
+import { chat, chatPresets } from 'prompts.chat';
+
+const prompt = chat()
+  // Persona
+  .role("senior software architect")
+  .tone("professional", "analytical")
+  .expertise("system design", "microservices", "cloud architecture")
+  
+  // Context
+  .context("Designing a scalable e-commerce platform")
+  .domain("software engineering")
+  
+  // Task
+  .task("Review the architecture proposal and provide feedback")
+  .objectives(["Identify bottlenecks", "Suggest improvements"])
+  
+  // Constraints
+  .constraints(["Focus on scalability", "Consider cost"])
+  .avoid(["Over-engineering", "Vendor lock-in"])
+  
+  // Reasoning
+  .stepByStep()
+  .showReasoning()
+  
+  // Output
+  .json({ schema: { type: "object", properties: { feedback: { type: "array" } } } })
+  .detailed()
+  
+  // Examples
+  .example("Simple API design", "Consider using API Gateway for rate limiting...")
+  
+  // Messages
+  .user("Here's my architecture proposal...")
+  .build();
+
+// Access outputs
+console.log(prompt.systemPrompt);  // Full system prompt
+console.log(prompt.messages);      // Message array
+console.log(prompt.userPrompt);    // Latest user message
+
+// Output formats
+const yaml = prompt.toYAML();
+const md = prompt.toMarkdown();
+const json = prompt.toJSON();
+```
+
+### Chat Builder Methods
+
+#### Persona
+| Method | Description |
+|--------|-------------|
+| `.role(role)` | Set the AI's role |
+| `.tone(tones...)` | Set communication tone(s) |
+| `.expertise(areas...)` | Define expertise areas |
+| `.personality(traits...)` | Set personality traits |
+
+#### Context
+| Method | Description |
+|--------|-------------|
+| `.context(text)` | Set situation context |
+| `.domain(domain)` | Set knowledge domain |
+| `.audience(audience)` | Define target audience |
+| `.background(text)` | Add background info |
+
+#### Task
+| Method | Description |
+|--------|-------------|
+| `.task(description)` | Main task description |
+| `.objectives(list)` | Add objectives |
+| `.scope(scope)` | Define scope |
+| `.priority(priority)` | Set priority |
+
+#### Constraints
+| Method | Description |
+|--------|-------------|
+| `.constraints(list)` | Must-follow rules |
+| `.avoid(list)` | Things to avoid |
+| `.requirements(list)` | Requirements |
+
+#### Reasoning
+| Method | Description |
+|--------|-------------|
+| `.stepByStep()` | Enable step-by-step reasoning |
+| `.showReasoning()` | Show reasoning process |
+| `.thinkFirst()` | Think before answering |
+| `.socratic()` | Use Socratic method |
+
+#### Output
+| Method | Description |
+|--------|-------------|
+| `.json(schema?)` | Output as JSON |
+| `.markdown()` | Output as Markdown |
+| `.yaml()` | Output as YAML |
+| `.xml()` | Output as XML |
+| `.code(language?)` | Output as code |
+| `.concise()` | Brief output |
+| `.detailed()` | Detailed output |
+| `.comprehensive()` | Comprehensive output |
+
+#### Messages
+| Method | Description |
+|--------|-------------|
+| `.system(content)` | Add system message |
+| `.user(content)` | Add user message |
+| `.assistant(content)` | Add assistant message |
+| `.example(input, output)` | Add few-shot example |
+| `.memory(key, value, priority?)` | Store memory |
+
+### Chat Presets
+
+```typescript
+import { chatPresets } from 'prompts.chat';
+
+// Expert coder
+const coder = chatPresets.coder("TypeScript");
+
+// Creative writer
+const writer = chatPresets.writer("technical");
+
+// Patient tutor
+const tutor = chatPresets.tutor("mathematics");
+
+// Data analyst
+const analyst = chatPresets.analyst();
+
+// Socratic teacher
+const socratic = chatPresets.socratic();
+
+// JSON responder
+const jsonBot = chatPresets.jsonResponder({
+  type: "object",
+  properties: { answer: { type: "string" } }
+});
+
+// Summarizer
+const summarizer = chatPresets.summarizer(100);
+
+// Translator
+const translator = chatPresets.translator("English", "Japanese");
+```
+
+---
+
+## 🎨 Image Builder
+
+Comprehensive builder for image generation prompts (Midjourney, DALL-E, Stable Diffusion, etc.).
+
+```typescript
+import { image } from 'prompts.chat';
+
+const prompt = image()
+  // Subject
+  .subject("a cyberpunk samurai warrior")
+  .subjectDetails({
+    pose: "dynamic battle stance",
+    expression: "determined",
+    clothing: "neon-lit armor with glowing circuits",
+    accessories: ["katana", "holographic visor"]
+  })
+  
+  // Environment
+  .environment("rain-soaked Tokyo alley")
+  .setting("urban", "futuristic")
+  .atmosphere("electric", "mysterious")
+  .weather("rain")
+  .timeOfDay("night")
+  
+  // Camera
+  .shot("medium")
+  .angle("low-angle")
+  .lens("35mm")
+  .aperture("f/1.8")
+  .focus("sharp")
+  .cameraBrand("Sony")
+  .cameraModel("A7R V")
+  .bokeh("smooth")
+  
+  // Lighting
+  .lightingType("neon")
+  .lightingDirection("rim")
+  .lightingIntensity("dramatic")
+  
+  // Style
+  .medium("cinematic")
+  .artStyle("cyberpunk")
+  .artist("Syd Mead")
+  .era("futuristic")
+  .filmStock("Kodak Vision3 500T")
+  
+  // Color
+  .colorPalette("cyberpunk")
+  .colorGrade("teal and orange")
+  .saturation("vibrant")
+  
+  // Technical
+  .resolution("8K")
+  .quality("ultra-detailed")
+  .aspectRatio("16:9")
+  .build();
+
+console.log(prompt.prompt);        // Text prompt
+console.log(prompt.negativePrompt); // Negative prompt
+
+// Output formats
+const json = prompt.toJSON();
+const yaml = prompt.toYAML();
+const md = prompt.toMarkdown();
+```
+
+### Camera Options
+
+| Category | Examples |
+|----------|----------|
+| **Brands** | Canon, Nikon, Sony, ARRI, RED, Hasselblad, Leica, Fujifilm |
+| **Shot Types** | extreme-close-up, close-up, medium, full, wide, aerial |
+| **Angles** | eye-level, low-angle, high-angle, dutch, bird's-eye, worm's-eye |
+| **Lens Types** | wide, standard, telephoto, macro, fisheye, anamorphic |
+| **Film Stocks** | Kodak Portra, Fuji Velvia, Kodak Vision3, Ilford HP5 |
+
+### Lighting Options
+
+| Type | Examples |
+|------|----------|
+| **Lighting Types** | natural, studio, rim, butterfly, rembrandt, neon, volumetric |
+| **Time of Day** | golden-hour, blue-hour, midday, sunset, night, dawn |
+| **Weather** | clear, cloudy, rain, snow, fog, storm |
+
+### Style Options
+
+| Category | Examples |
+|----------|----------|
+| **Art Styles** | photorealistic, anime, oil-painting, watercolor, cyberpunk, art-deco |
+| **Mediums** | photography, cinematic, illustration, 3d-render, concept-art |
+| **Color Palettes** | warm, cool, pastel, neon, monochrome, vintage |
+
+---
+
+## � Video Builder
+
+Builder for video generation prompts (Sora, Runway, Pika, etc.).
+
+```typescript
+import { video } from 'prompts.chat';
+
+const prompt = video()
+  // Scene
+  .scene("A lone astronaut walks across the Martian surface")
+  .location("Mars", "Olympus Mons base camp")
+  .environment("dusty red landscape", "thin atmosphere")
+  .time("dusk")
+  .weather("dust storm approaching")
+  
+  // Subject
+  .character("astronaut", {
+    appearance: "NASA spacesuit, reflective visor",
+    action: "walking purposefully",
+    emotion: "determined"
+  })
+  
+  // Camera
+  .movement("tracking")
+  .shot("wide")
+  .angle("low-angle")
+  .speed("slow")
+  .lens("anamorphic")
+  .cameraBrand("ARRI")
+  .cameraModel("ALEXA 65")
+  .stabilization("gimbal")
+  
+  // Motion
+  .pacing("slow")
+  .transitions("fade")
+  .motionBlur(true)
+  
+  // Lighting
+  .lightingType("golden hour")
+  .lightingMood("epic")
+  
+  // Style
+  .style("cinematic")
+  .colorGrade("orange and teal")
+  .filmGrain("subtle")
+  .styleFilmStock("Kodak Vision3 500T")
+  
+  // Audio
+  .audioMood("epic orchestral")
+  .soundDesign("wind, footsteps, breathing")
+  
+  // Technical
+  .duration(10)
+  .fps(24)
+  .resolution("4K")
+  .aspectRatio("2.39:1")
+  .build();
+
+console.log(prompt.prompt);
+console.log(prompt.structure);
+
+// Output formats
+const json = prompt.toJSON();
+const yaml = prompt.toYAML();
+```
+
+### Video-Specific Options
+
+| Category | Examples |
+|----------|----------|
+| **Camera Movement** | static, pan, tilt, dolly, tracking, crane, handheld, drone |
+| **Transitions** | cut, fade, dissolve, wipe, zoom |
+| **Pacing** | slow-motion, normal, fast-motion, timelapse |
+| **Frame Rates** | 24, 30, 60, 120 fps |
+
+---
+
+## 🎵 Audio Builder
+
+Builder for music and audio generation prompts (Suno, Udio, etc.).
+
+```typescript
+import { audio } from 'prompts.chat';
+
+const prompt = audio()
+  // Genre & Style
+  .genre("electronic")
+  .subgenre("synthwave")
+  .era("1980s")
+  .influences(["Kavinsky", "Carpenter Brut", "Perturbator"])
+  
+  // Mood & Energy
+  .mood("nostalgic")
+  .energy("high")
+  .emotion("triumphant")
+  
+  // Tempo & Rhythm
+  .bpm(120)
+  .feel("driving")
+  .groove("steady")
+  
+  // Vocals
+  .vocalStyle("ethereal")
+  .vocalRange("tenor")
+  .lyrics("retro-futuristic themes")
+  .harmony("layered")
+  
+  // Instrumentation
+  .instruments(["synthesizer", "drums", "bass", "electric guitar"])
+  .lead("analog synth lead")
+  .rhythm("drum machine")
+  .bass("deep sub bass")
+  .pads("lush synth pads")
+  
+  // Structure
+  .intro("atmospheric build")
+  .verse("rhythmic drive")
+  .chorus("anthemic climax")
+  .bridge("breakdown")
+  .outro("fade out")
+  .duration(210)  // 3:30
+  
+  // Production
+  .productionStyle("polished")
+  .mixing("wide stereo")
+  .effects(["reverb", "delay", "sidechain compression"])
+  
+  // Technical
+  .key("A minor")
+  .timeSignature("4/4")
+  .build();
+
+console.log(prompt.stylePrompt);
+console.log(prompt.lyricsPrompt);
+console.log(prompt.structure);
+
+// Output formats
+const json = prompt.toJSON();
+const yaml = prompt.toYAML();
+```
+
+### Audio Options
+
+| Category | Examples |
+|----------|----------|
+| **Genres** | pop, rock, jazz, classical, electronic, hip-hop, ambient, cinematic |
+| **Moods** | happy, sad, energetic, calm, dark, uplifting, melancholic |
+| **Instruments** | piano, guitar, drums, bass, synthesizer, violin, saxophone |
+| **Vocal Styles** | clean, breathy, raspy, falsetto, operatic, whispered |
+| **Keys** | C major, A minor, G major, E minor, etc. |
+| **Time Signatures** | 4/4, 3/4, 6/8, 5/4, 7/8 |
+
+---
+
+## ✅ Quality
+
+Local prompt quality validation (no API required).
+
+```typescript
+import { quality } from 'prompts.chat';
+
+// Check prompt quality
+const result = quality.check("Act as a senior developer...");
+
+console.log(result.valid);   // true
+console.log(result.score);   // 0.85 (0-1)
+console.log(result.issues);  // Array of issues
+console.log(result.stats);   // Detailed statistics
+
+// Statistics include:
+// - characterCount, wordCount, sentenceCount
+// - variableCount
+// - hasRole, hasTask, hasConstraints, hasExamples
+
+// Validate (throws if invalid)
+quality.validate(promptText);
+
+// Check validity
+const isValid = quality.isValid(promptText);
+
+// Get improvement suggestions
+const suggestions = quality.getSuggestions(promptText);
+// → ["Add a role definition", "Consider adding examples"]
+```
+
+### Quality Checks
+
+| Check | Type | Description |
+|-------|------|-------------|
+| `EMPTY` | error | Prompt is empty |
+| `TOO_SHORT` | error | Below minimum length |
+| `GIBBERISH` | error | Random/keyboard patterns |
+| `FEW_WORDS` | warning | Very few words |
+| `UNBALANCED_BRACKETS` | warning | Mismatched brackets |
+| `LONG_LINES` | suggestion | Lines over 500 chars |
+| `NO_CLEAR_INSTRUCTION` | suggestion | Missing role or task |
+
+---
+
+## 📄 Parser
+
+Parse prompt files in YAML, JSON, Markdown, and plain text formats.
+
+```typescript
+import { parser } from 'prompts.chat';
+
+// Auto-detect format
+const prompt = parser.parse(content);
+
+// Parse YAML
+const yamlPrompt = parser.parse(`
+name: Code Review
+model: gpt-4
+modelParameters:
+  temperature: 0.7
+messages:
+  - role: system
+    content: You are a code reviewer.
+`, 'yaml');
+
+// Parse JSON
+const jsonPrompt = parser.parse(`{
+  "name": "Assistant",
+  "messages": [{"role": "system", "content": "You are helpful."}]
+}`, 'json');
+
+// Parse Markdown with frontmatter
+const mdPrompt = parser.parse(`
+---
+name: Creative Writer
+model: gpt-4
+---
+You are a creative writing assistant.
+`, 'markdown');
+
+// Parse plain text (becomes system message)
+const textPrompt = parser.parse("You are a helpful assistant.", 'text');
+
+// Serialize
+const yaml = parser.toYaml(prompt);
+const json = parser.toJson(prompt, true);  // pretty print
+
+// Get system message
+const systemPrompt = parser.getSystemPrompt(prompt);
+
+// Interpolate variables
+const filled = parser.interpolate(prompt, { name: "John" });
+```
+
+### ParsedPrompt Structure
+
+```typescript
+interface ParsedPrompt {
+  name?: string;
+  description?: string;
+  model?: string;
+  modelParameters?: {
+    temperature?: number;
+    maxTokens?: number;
+    topP?: number;
+    frequencyPenalty?: number;
+    presencePenalty?: number;
+  };
+  messages: PromptMessage[];
+  variables?: Record<string, {
+    description?: string;
+    default?: string;
+    required?: boolean;
+  }>;
+  metadata?: Record<string, unknown>;
+}
+```
+
+---
+
+## Tree-Shakeable Imports
+
+Import only what you need for smaller bundles:
+
+```typescript
+// Full namespace imports
+import { variables, similarity, quality, parser } from 'prompts.chat';
+
+// Direct builder imports
+import { builder, chat, image, video, audio } from 'prompts.chat';
+import { templates, chatPresets } from 'prompts.chat';
+
+// Direct module imports (smallest bundle)
+import { detect, normalize, compile } from 'prompts.chat/variables';
+import { calculate, isDuplicate } from 'prompts.chat/similarity';
+import { check, validate, getSuggestions } from 'prompts.chat/quality';
+import { parse, toYaml, toJson } from 'prompts.chat/parser';
+import { builder, templates } from 'prompts.chat/builder';
+```
+
+---
+
+## TypeScript Support
+
+Full TypeScript support with comprehensive type exports:
+
+```typescript
+import type { 
+  // Variables
+  DetectedVariable,
+  VariablePattern,
+  
+  // Builder
+  BuiltPrompt,
+  PromptVariable,
+  
+  // Chat
+  BuiltChatPrompt,
+  ChatMessage,
+  ChatPersona,
+  PersonaTone,
+  ReasoningStyle,
+  
+  // Image
+  BuiltImagePrompt,
+  ImageSubject,
+  ImageCamera,
+  CameraAngle,
+  ShotType,
+  LensType,
+  
+  // Video
+  BuiltVideoPrompt,
+  VideoScene,
+  VideoCamera,
+  
+  // Audio
+  BuiltAudioPrompt,
+  MusicGenre,
+  Instrument,
+  
+  // Quality
+  QualityResult,
+  QualityIssue,
+  
+  // Parser
+  ParsedPrompt,
+  PromptMessage,
+} from 'prompts.chat';
+```
+
+---
+
+## Requirements
+
+- **Node.js** 18+
+- **TypeScript** 5+ (optional, for type checking)
+
+---
+
+## Testing
+
+```bash
+npm test              # Run all tests
+npm run test:watch    # Watch mode
+npm run test:coverage # With coverage
+```
+
+---
+
+## License
+
+MIT © [Fatih Kadir Akın](https://github.com/f)