quikchat 1.1.14 → 1.1.15

package/README.md

@@ -1,6 +1,4 @@
-[![License](https://img.shields.io/badge/License-BSD%202--Clause-blue.svg)](https://opensource.org/licenses/BSD-2-Clause)
-[![NPM version](https://img.shields.io/npm/v/quikchat.svg?style=flat-square)](https://www.npmjs.com/package/quikchat)
-![CI](https://github.com/deftio/quikchat/actions/workflows/ci.yml/badge.svg)
+[![License](https://img.shields.io/badge/License-BSD%202--Clause-blue.svg)](https://opensource.org/licenses/BSD-2-Clause) [![NPM version](https://img.shields.io/npm/v/quikchat.svg?style=flat-square)](https://www.npmjs.com/package/quikchat) ![CI](https://github.com/deftio/quikchat/actions/workflows/ci.yml/badge.svg)
 
 # QuikChat
 
@@ -8,7 +6,7 @@
 
 QuikChat is a lightweight, highly customizable chat interface that integrates seamlessly with any web project. Built with vanilla JavaScript, it provides powerful features for LLM applications, real-time chat, and interactive messaging experiences.
 
-**🚀 [Live Demo](https://deftio.github.io/quikchat/examples/example_umd.html) | 📚 [API Reference](API-REFERENCE.md) | 🛠 [Developer Guide](DEVELOPER-GUIDE.md)**
+**🚀 [Live Demo](https://deftio.github.io/quikchat/examples/example_umd.html) | 📚 [API Reference](docs/API-REFERENCE.md) | 🛠 [Developer Guide](docs/DEVELOPER-GUIDE.md)**
 
 
 
@@ -97,7 +95,65 @@ Download the latest release from [GitHub Releases](https://github.com/deftio/qui
 
 
 
-## 🆕 What's New in v1.1.14
+## 🆕 What's New in v1.1.15 (In Development)
+
+### 🎯 Smart Scroll Behavior
+Improved user experience when reading chat history:
+
+```javascript
+// Never auto-scroll (user has full control)
+chat.messageAddNew('New message', 'Bot', 'left', 'assistant', false);
+
+// Smart scroll - only scrolls if user is near bottom
+chat.messageAddNew('New message', 'Bot', 'left', 'assistant', 'smart');
+
+// Always scroll to new messages (default)
+chat.messageAddNew('New message', 'Bot', 'left', 'assistant', true);
+```
+
+### 🔔 Enhanced Message Callbacks
+Track message modifications for streaming and real-time updates:
+
+```javascript
+// Track streaming content as it arrives
+chat.setCallbackonMessageAppend((instance, msgId, content) => {
+  console.log(`Streaming: ${content} added to message ${msgId}`);
+});
+
+// Monitor message edits
+chat.setCallbackonMessageReplace((instance, msgId, newContent) => {
+  console.log(`Message ${msgId} updated`);
+});
+
+// Track deletions
+chat.setCallbackonMessageDelete((instance, msgId) => {
+  console.log(`Message ${msgId} deleted`);
+});
+```
+
+### 📚 Powerful History Management
+Efficiently handle large chat histories with pagination and search:
+
+```javascript
+// Paginated history retrieval
+const page = chat.historyGetPage(1, 20, 'desc'); // Get newest 20 messages
+console.log(page.messages);
+console.log(page.pagination.hasNext); // Check if more pages exist
+
+// Search through history
+const results = chat.historySearch({ 
+  text: 'error',
+  userString: 'Support',
+  limit: 50 
+});
+
+// Get history metadata
+const info = chat.historyGetInfo();
+console.log(`Total messages: ${info.totalMessages}`);
+console.log(`Memory used: ${info.memoryUsage.estimatedSize} bytes`);
+```
+
+## 📦 Previous Release: v1.1.14
 
 ### 🏷 Tagged Message System
 Group and control message visibility with powerful tagging:
@@ -179,7 +235,7 @@ const chat = new quikchat('#chat', handler, {
 });
 ```
 
-**📖 [Complete Theming Guide](DEVELOPER-GUIDE.md#theming-guide)**
+**📖 [Complete Theming Guide](docs/DEVELOPER-GUIDE.md#theming-guide)**
 
 
 
@@ -218,7 +274,7 @@ streamingAPI.onChunk(chunk => {
 });
 ```
 
-**🛠 [Complete LLM Integration Guide](DEVELOPER-GUIDE.md#llm-integration-best-practices)**
+**🛠 [Complete LLM Integration Guide](docs/DEVELOPER-GUIDE.md#llm-integration-best-practices)**
 
 
 
@@ -255,7 +311,7 @@ export default {
 </script>
 ```
 
-**⚛️ [Framework Integration Examples](DEVELOPER-GUIDE.md#frontend-framework-integration)**
+**⚛️ [Framework Integration Examples](docs/DEVELOPER-GUIDE.md#frontend-framework-integration)**
 
 
 
@@ -263,8 +319,8 @@ export default {
 
 | Document | Description |
 |-|-|
-| **[API Reference](API-REFERENCE.md)** | Complete technical reference for all methods and options |
-| **[Developer Guide](DEVELOPER-GUIDE.md)** | Practical recipes and advanced patterns |
+| **[API Reference](docs/API-REFERENCE.md)** | Complete technical reference for all methods and options |
+| **[Developer Guide](docs/DEVELOPER-GUIDE.md)** | Practical recipes and advanced patterns |
 | **[Examples](examples/)** | Working code examples and demos |
 | **[Live Demo](https://deftio.github.io/quikchat/examples/)** | Interactive examples and showcase |
 
@@ -293,7 +349,7 @@ QuikChat is built for production use with excellent performance characteristics:
 - **Scalable**: Handles thousands of messages efficiently
 - **Memory Efficient**: Automatic cleanup and optimization
 
-**📊 [Performance Optimization Guide](DEVELOPER-GUIDE.md#performance-optimization)**
+**📊 [Performance Optimization Guide](docs/DEVELOPER-GUIDE.md#performance-optimization)**