@tashiscool/vue 0.1.0

package/README.md

@@ -0,0 +1,170 @@
+# @llm-utils/vue
+
+Vue 3 composables for LLM streaming. Reactive state management for chat interfaces.
+
+## Installation
+
+```bash
+pnpm add @llm-utils/vue
+# or
+npm install @llm-utils/vue
+```
+
+## Features
+
+- **useStreaming** - Full streaming state management
+- **useChunkBuffer** - Aggregate streaming chunks
+- **useTypingIndicator** - Typing indicator state
+- **useMessageHistory** - Persistent message history
+- **SSE Support** - Parse Server-Sent Events
+- **TypeScript** - Full type safety
+
+## Usage
+
+### Basic Streaming
+
+```vue
+<script setup lang="ts">
+import { useStreaming } from '@llm-utils/vue';
+
+const { messages, status, send, isStreaming, abort } = useStreaming({
+  endpoint: '/api/chat',
+  onChunk: (chunk) => console.log('Received:', chunk),
+});
+
+async function handleSend(input: string) {
+  await send(input);
+}
+</script>
+
+<template>
+  <div>
+    <div v-for="msg in messages" :key="msg.id">
+      <strong>{{ msg.role }}:</strong>
+      <span>{{ msg.content }}</span>
+      <span v-if="msg.isStreaming">▌</span>
+    </div>
+
+    <div v-if="status === 'connecting'">Connecting...</div>
+
+    <button @click="abort" v-if="isStreaming">Stop</button>
+  </div>
+</template>
+```
+
+### Stream from URL
+
+```typescript
+const { streamFrom, messages } = useStreaming();
+
+// Stream from any URL
+await streamFrom('/api/stream', {
+  method: 'POST',
+  body: JSON.stringify({ prompt: 'Hello' }),
+});
+```
+
+### Chunk Buffer
+
+```typescript
+import { useChunkBuffer } from '@llm-utils/vue';
+
+const { content, append, flush } = useChunkBuffer();
+
+// Append chunks
+append('Hello ');
+append('World');
+
+console.log(content.value); // 'Hello World'
+console.log(flush()); // 'Hello World' (also clears)
+```
+
+### Typing Indicator
+
+```typescript
+import { useTypingIndicator } from '@llm-utils/vue';
+
+const { isTyping, start, stop, startWithTimeout } = useTypingIndicator();
+
+// Manual control
+start();
+// ... do work
+stop();
+
+// Auto-stop after 3 seconds
+startWithTimeout(3000);
+```
+
+### Message History with Persistence
+
+```typescript
+import { useMessageHistory } from '@llm-utils/vue';
+
+const { messages, add, remove, clear } = useMessageHistory({
+  storageKey: 'my-chat-history',
+  maxMessages: 50,
+});
+
+// Add message
+add({
+  role: 'user',
+  content: 'Hello!',
+  isStreaming: false,
+});
+
+// Messages persist across page reloads
+```
+
+## API Reference
+
+### useStreaming
+
+```typescript
+interface UseStreamingReturn {
+  // State
+  status: Ref<StreamingStatus>;
+  messages: Ref<StreamingMessage[]>;
+  currentMessage: ComputedRef<StreamingMessage | null>;
+  isStreaming: ComputedRef<boolean>;
+  error: Ref<Error | null>;
+
+  // Actions
+  send: (content: string, options?) => Promise<void>;
+  streamFrom: (url: string, options?) => Promise<void>;
+  abort: () => void;
+  clear: () => void;
+  addMessage: (message) => void;
+}
+```
+
+### StreamingMessage
+
+```typescript
+interface StreamingMessage {
+  id: string;
+  role: 'user' | 'assistant' | 'system';
+  content: string;
+  isStreaming: boolean;
+  error?: string;
+  startedAt: Date;
+  completedAt?: Date;
+}
+```
+
+### StreamingOptions
+
+```typescript
+interface StreamingOptions {
+  endpoint?: string;
+  headers?: Record<string, string>;
+  transformChunk?: (chunk: string) => string;
+  onStart?: (message: StreamingMessage) => void;
+  onChunk?: (chunk: string, message: StreamingMessage) => void;
+  onComplete?: (message: StreamingMessage) => void;
+  onError?: (error: Error) => void;
+}
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @llm-utils/vue
+ * Vue 3 composables for LLM streaming
+ */
+export { useStreaming, useChunkBuffer, useTypingIndicator, useMessageHistory, } from './useStreaming.js';
+export type { StreamingStatus, StreamingMessage, StreamingOptions, StreamingState, StreamingActions, UseStreamingReturn, UseChunkBufferReturn, UseTypingIndicatorReturn, UseMessageHistoryOptions, UseMessageHistoryReturn, } from './useStreaming.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+/**
+ * @llm-utils/vue
+ * Vue 3 composables for LLM streaming
+ */
+export { useStreaming, useChunkBuffer, useTypingIndicator, useMessageHistory, } from './useStreaming.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC"}

package/dist/useStreaming.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Vue Streaming Composables
+ * Reactive state management for LLM streaming
+ */
+import { type Ref, type ComputedRef } from 'vue';
+/**
+ * Streaming status
+ */
+export type StreamingStatus = 'idle' | 'connecting' | 'streaming' | 'complete' | 'error';
+/**
+ * Streaming message
+ */
+export interface StreamingMessage {
+    /** Unique message ID */
+    id: string;
+    /** Message role */
+    role: 'user' | 'assistant' | 'system';
+    /** Current content (incrementally updated) */
+    content: string;
+    /** Is message still streaming */
+    isStreaming: boolean;
+    /** Error if any */
+    error?: string;
+    /** Timestamp when started */
+    startedAt: Date;
+    /** Timestamp when completed */
+    completedAt?: Date;
+}
+/**
+ * Streaming options
+ */
+export interface StreamingOptions {
+    /** API endpoint */
+    endpoint?: string;
+    /** Request headers */
+    headers?: Record<string, string>;
+    /** Transform response chunks */
+    transformChunk?: (chunk: string) => string;
+    /** On message start */
+    onStart?: (message: StreamingMessage) => void;
+    /** On chunk received */
+    onChunk?: (chunk: string, message: StreamingMessage) => void;
+    /** On message complete */
+    onComplete?: (message: StreamingMessage) => void;
+    /** On error */
+    onError?: (error: Error) => void;
+}
+/**
+ * Streaming state
+ */
+export interface StreamingState {
+    /** Current status */
+    status: Ref<StreamingStatus>;
+    /** All messages */
+    messages: Ref<StreamingMessage[]>;
+    /** Current streaming message */
+    currentMessage: ComputedRef<StreamingMessage | null>;
+    /** Is currently streaming */
+    isStreaming: ComputedRef<boolean>;
+    /** Latest error */
+    error: Ref<Error | null>;
+}
+/**
+ * Streaming actions
+ */
+export interface StreamingActions {
+    /** Send a message and stream response */
+    send: (content: string, options?: Partial<StreamingOptions>) => Promise<void>;
+    /** Stream from a URL */
+    streamFrom: (url: string, options?: RequestInit) => Promise<void>;
+    /** Abort current stream */
+    abort: () => void;
+    /** Clear all messages */
+    clear: () => void;
+    /** Add a message manually */
+    addMessage: (message: Omit<StreamingMessage, 'id' | 'startedAt'>) => void;
+}
+/**
+ * Use streaming composable return type
+ */
+export interface UseStreamingReturn extends StreamingState, StreamingActions {
+}
+/**
+ * Vue composable for LLM streaming
+ */
+export declare function useStreaming(defaultOptions?: StreamingOptions): UseStreamingReturn;
+/**
+ * Chunk buffer composable for aggregating streaming chunks
+ */
+export interface UseChunkBufferReturn {
+    /** Current buffered content */
+    content: Ref<string>;
+    /** Append a chunk */
+    append: (chunk: string) => void;
+    /** Clear buffer */
+    clear: () => void;
+    /** Get content and clear */
+    flush: () => string;
+}
+export declare function useChunkBuffer(): UseChunkBufferReturn;
+/**
+ * Typing indicator composable
+ */
+export interface UseTypingIndicatorReturn {
+    /** Is typing */
+    isTyping: Ref<boolean>;
+    /** Start typing */
+    start: () => void;
+    /** Stop typing */
+    stop: () => void;
+    /** Auto-stop after delay */
+    startWithTimeout: (ms: number) => void;
+}
+export declare function useTypingIndicator(): UseTypingIndicatorReturn;
+/**
+ * Message history composable with persistence
+ */
+export interface UseMessageHistoryOptions {
+    /** Storage key */
+    storageKey?: string;
+    /** Max messages to keep */
+    maxMessages?: number;
+    /** Use session storage instead of local */
+    sessionStorage?: boolean;
+}
+export interface UseMessageHistoryReturn {
+    /** Messages */
+    messages: Ref<StreamingMessage[]>;
+    /** Add message */
+    add: (message: Omit<StreamingMessage, 'id' | 'startedAt'>) => void;
+    /** Remove message */
+    remove: (id: string) => void;
+    /** Clear all */
+    clear: () => void;
+    /** Load from storage */
+    load: () => void;
+    /** Save to storage */
+    save: () => void;
+}
+export declare function useMessageHistory(options?: UseMessageHistoryOptions): UseMessageHistoryReturn;
+//# sourceMappingURL=useStreaming.d.ts.map

package/dist/useStreaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStreaming.d.ts","sourceRoot":"","sources":["../src/useStreaming.ts"],"names":[],"mappings":"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"}

package/dist/useStreaming.js

@@ -0,0 +1,306 @@
+/**
+ * Vue Streaming Composables
+ * Reactive state management for LLM streaming
+ */
+import { ref, computed } from 'vue';
+/**
+ * Generate message ID
+ */
+function generateId() {
+    return `msg_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;
+}
+/**
+ * Vue composable for LLM streaming
+ */
+export function useStreaming(defaultOptions = {}) {
+    // State
+    const status = ref('idle');
+    const messages = ref([]);
+    const error = ref(null);
+    let abortController = null;
+    // Computed
+    const currentMessage = computed(() => {
+        const streaming = messages.value.filter((m) => m.isStreaming);
+        return streaming.length > 0 ? streaming[streaming.length - 1] ?? null : null;
+    });
+    const isStreaming = computed(() => status.value === 'streaming');
+    /**
+     * Parse SSE data
+     */
+    function parseSSE(line) {
+        if (line.startsWith('data: ')) {
+            const data = line.slice(6);
+            if (data === '[DONE]')
+                return null;
+            try {
+                const parsed = JSON.parse(data);
+                // Handle various response formats
+                return (parsed.content ||
+                    parsed.delta?.content ||
+                    parsed.choices?.[0]?.delta?.content ||
+                    parsed.text ||
+                    '');
+            }
+            catch {
+                return data;
+            }
+        }
+        return null;
+    }
+    /**
+     * Stream from a URL
+     */
+    async function streamFrom(url, options = {}) {
+        abortController = new AbortController();
+        status.value = 'connecting';
+        error.value = null;
+        const message = {
+            id: generateId(),
+            role: 'assistant',
+            content: '',
+            isStreaming: true,
+            startedAt: new Date(),
+        };
+        messages.value.push(message);
+        defaultOptions.onStart?.(message);
+        try {
+            const response = await fetch(url, {
+                ...options,
+                signal: abortController.signal,
+                headers: {
+                    ...defaultOptions.headers,
+                    ...options.headers,
+                },
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            if (!response.body) {
+                throw new Error('Response body is null');
+            }
+            status.value = 'streaming';
+            const reader = response.body.getReader();
+            const decoder = new TextDecoder();
+            let buffer = '';
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split('\n');
+                buffer = lines.pop() || '';
+                for (const line of lines) {
+                    const trimmed = line.trim();
+                    if (!trimmed)
+                        continue;
+                    let chunk = parseSSE(trimmed);
+                    if (chunk === null)
+                        continue;
+                    if (defaultOptions.transformChunk) {
+                        chunk = defaultOptions.transformChunk(chunk);
+                    }
+                    // Update message content
+                    const msgIndex = messages.value.findIndex((m) => m.id === message.id);
+                    if (msgIndex !== -1 && messages.value[msgIndex]) {
+                        messages.value[msgIndex].content += chunk;
+                        defaultOptions.onChunk?.(chunk, messages.value[msgIndex]);
+                    }
+                }
+            }
+            // Complete message
+            const msgIndex = messages.value.findIndex((m) => m.id === message.id);
+            if (msgIndex !== -1 && messages.value[msgIndex]) {
+                messages.value[msgIndex].isStreaming = false;
+                messages.value[msgIndex].completedAt = new Date();
+                defaultOptions.onComplete?.(messages.value[msgIndex]);
+            }
+            status.value = 'complete';
+        }
+        catch (err) {
+            if (err.name === 'AbortError') {
+                status.value = 'idle';
+                return;
+            }
+            const errorObj = err instanceof Error ? err : new Error(String(err));
+            error.value = errorObj;
+            status.value = 'error';
+            // Mark message as error
+            const msgIndex = messages.value.findIndex((m) => m.id === message.id);
+            if (msgIndex !== -1 && messages.value[msgIndex]) {
+                messages.value[msgIndex].isStreaming = false;
+                messages.value[msgIndex].error = errorObj.message;
+            }
+            defaultOptions.onError?.(errorObj);
+        }
+        finally {
+            abortController = null;
+        }
+    }
+    /**
+     * Send a message and stream response
+     */
+    async function send(content, options = {}) {
+        const endpoint = options.endpoint || defaultOptions.endpoint;
+        if (!endpoint) {
+            throw new Error('No endpoint configured');
+        }
+        // Add user message
+        messages.value.push({
+            id: generateId(),
+            role: 'user',
+            content,
+            isStreaming: false,
+            startedAt: new Date(),
+            completedAt: new Date(),
+        });
+        // Stream response
+        await streamFrom(endpoint, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...defaultOptions.headers,
+                ...options.headers,
+            },
+            body: JSON.stringify({
+                messages: messages.value.map((m) => ({
+                    role: m.role,
+                    content: m.content,
+                })),
+            }),
+        });
+    }
+    /**
+     * Abort current stream
+     */
+    function abort() {
+        abortController?.abort();
+        status.value = 'idle';
+    }
+    /**
+     * Clear all messages
+     */
+    function clear() {
+        messages.value = [];
+        status.value = 'idle';
+        error.value = null;
+    }
+    /**
+     * Add message manually
+     */
+    function addMessage(msg) {
+        messages.value.push({
+            ...msg,
+            id: generateId(),
+            startedAt: new Date(),
+        });
+    }
+    return {
+        // State
+        status,
+        messages,
+        currentMessage,
+        isStreaming,
+        error,
+        // Actions
+        send,
+        streamFrom,
+        abort,
+        clear,
+        addMessage,
+    };
+}
+export function useChunkBuffer() {
+    const content = ref('');
+    function append(chunk) {
+        content.value += chunk;
+    }
+    function clear() {
+        content.value = '';
+    }
+    function flush() {
+        const result = content.value;
+        content.value = '';
+        return result;
+    }
+    return { content, append, clear, flush };
+}
+export function useTypingIndicator() {
+    const isTyping = ref(false);
+    let timeoutId = null;
+    function start() {
+        isTyping.value = true;
+    }
+    function stop() {
+        isTyping.value = false;
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+            timeoutId = null;
+        }
+    }
+    function startWithTimeout(ms) {
+        start();
+        timeoutId = setTimeout(stop, ms);
+    }
+    return { isTyping, start, stop, startWithTimeout };
+}
+export function useMessageHistory(options = {}) {
+    const { storageKey = 'llm-utils-messages', maxMessages = 100, sessionStorage: useSession = false, } = options;
+    const messages = ref([]);
+    const storage = typeof window !== 'undefined'
+        ? useSession
+            ? window.sessionStorage
+            : window.localStorage
+        : null;
+    function add(msg) {
+        messages.value.push({
+            ...msg,
+            id: generateId(),
+            startedAt: new Date(),
+        });
+        // Trim if needed
+        if (messages.value.length > maxMessages) {
+            messages.value = messages.value.slice(-maxMessages);
+        }
+        save();
+    }
+    function remove(id) {
+        messages.value = messages.value.filter((m) => m.id !== id);
+        save();
+    }
+    function clear() {
+        messages.value = [];
+        save();
+    }
+    function load() {
+        if (!storage)
+            return;
+        try {
+            const stored = storage.getItem(storageKey);
+            if (stored) {
+                const parsed = JSON.parse(stored);
+                messages.value = parsed.map((m) => ({
+                    ...m,
+                    startedAt: new Date(m.startedAt),
+                    completedAt: m.completedAt ? new Date(m.completedAt) : undefined,
+                }));
+            }
+        }
+        catch {
+            // Ignore parse errors
+        }
+    }
+    function save() {
+        if (!storage)
+            return;
+        try {
+            storage.setItem(storageKey, JSON.stringify(messages.value));
+        }
+        catch {
+            // Ignore storage errors
+        }
+    }
+    // Auto-load on init
+    load();
+    return { messages, add, remove, clear, load, save };
+}
+//# sourceMappingURL=useStreaming.js.map

package/dist/useStreaming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStreaming.js","sourceRoot":"","sources":["../src/useStreaming.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAA0C,MAAM,KAAK,CAAC;AAoF5E;;GAEG;AACH,SAAS,UAAU;IACjB,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACvE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,iBAAmC,EAAE;IAErC,QAAQ;IACR,MAAM,MAAM,GAAG,GAAG,CAAkB,MAAM,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,GAAG,CAAqB,EAAE,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,GAAG,CAAe,IAAI,CAAC,CAAC;IACtC,IAAI,eAAe,GAA2B,IAAI,CAAC;IAEnD,WAAW;IACX,MAAM,cAAc,GAAG,QAAQ,CAAC,GAA4B,EAAE;QAC5D,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QAC9D,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,WAAW,CAAC,CAAC;IAEjE;;OAEG;IACH,SAAS,QAAQ,CAAC,IAAY;QAC5B,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,IAAI,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC;YACnC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAChC,kCAAkC;gBAClC,OAAO,CACL,MAAM,CAAC,OAAO;oBACd,MAAM,CAAC,KAAK,EAAE,OAAO;oBACrB,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO;oBACnC,MAAM,CAAC,IAAI;oBACX,EAAE,CACH,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK,UAAU,UAAU,CACvB,GAAW,EACX,UAAuB,EAAE;QAEzB,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;QACxC,MAAM,CAAC,KAAK,GAAG,YAAY,CAAC;QAC5B,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC;QAEnB,MAAM,OAAO,GAAqB;YAChC,EAAE,EAAE,UAAU,EAAE;YAChB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,IAAI;YACjB,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC;QACF,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7B,cAAc,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC;QAElC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,GAAG,OAAO;gBACV,MAAM,EAAE,eAAe,CAAC,MAAM;gBAC9B,OAAO,EAAE;oBACP,GAAG,cAAc,CAAC,OAAO;oBACzB,GAAG,OAAO,CAAC,OAAO;iBACnB;aACF,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YACrE,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnB,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;YAC3C,CAAC;YAED,MAAM,CAAC,KAAK,GAAG,WAAW,CAAC;YAC3B,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACzC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;YAClC,IAAI,MAAM,GAAG,EAAE,CAAC;YAEhB,OAAO,IAAI,EAAE,CAAC;gBACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBAE5C,IAAI,IAAI;oBAAE,MAAM;gBAEhB,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBAClD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACjC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;gBAE3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;oBAC5B,IAAI,CAAC,OAAO;wBAAE,SAAS;oBAEvB,IAAI,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;oBAC9B,IAAI,KAAK,KAAK,IAAI;wBAAE,SAAS;oBAE7B,IAAI,cAAc,CAAC,cAAc,EAAE,CAAC;wBAClC,KAAK,GAAG,cAAc,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;oBAC/C,CAAC;oBAED,yBAAyB;oBACzB,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,EAAE,CAAC,CAAC;oBACtE,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;wBAChD,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAE,CAAC,OAAO,IAAI,KAAK,CAAC;wBAC3C,cAAc,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAE,CAAC,CAAC;oBAC7D,CAAC;gBACH,CAAC;YACH,CAAC;YAED,mBAAmB;YACnB,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,EAAE,CAAC,CAAC;YACtE,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAChD,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAE,CAAC,WAAW,GAAG,KAAK,CAAC;gBAC9C,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAE,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC;gBACnD,cAAc,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAE,CAAC,CAAC;YACzD,CAAC;YAED,MAAM,CAAC,KAAK,GAAG,UAAU,CAAC;QAC5B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAAa,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBACzC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC;gBACtB,OAAO;YACT,CAAC;YAED,MAAM,QAAQ,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YACrE,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAC;YACvB,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC;YAEvB,wBAAwB;YACxB,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,EAAE,CAAC,CAAC;YACtE,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAChD,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAE,CAAC,WAAW,GAAG,KAAK,CAAC;gBAC9C,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAE,CAAC,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC;YACrD,CAAC;YAED,cAAc,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC;QACrC,CAAC;gBAAS,CAAC;YACT,eAAe,GAAG,IAAI,CAAC;QACzB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,UAAU,IAAI,CACjB,OAAe,EACf,UAAqC,EAAE;QAEvC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,cAAc,CAAC,QAAQ,CAAC;QAC7D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC5C,CAAC;QAED,mBAAmB;QACnB,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;YAClB,EAAE,EAAE,UAAU,EAAE;YAChB,IAAI,EAAE,MAAM;YACZ,OAAO;YACP,WAAW,EAAE,KAAK;YAClB,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,WAAW,EAAE,IAAI,IAAI,EAAE;SACxB,CAAC,CAAC;QAEH,kBAAkB;QAClB,MAAM,UAAU,CAAC,QAAQ,EAAE;YACzB,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,GAAG,cAAc,CAAC,OAAO;gBACzB,GAAG,OAAO,CAAC,OAAO;aACnB;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACnC,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,OAAO,EAAE,CAAC,CAAC,OAAO;iBACnB,CAAC,CAAC;aACJ,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,SAAS,KAAK;QACZ,eAAe,EAAE,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,SAAS,KAAK;QACZ,QAAQ,CAAC,KAAK,GAAG,EAAE,CAAC;QACpB,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC;QACtB,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,SAAS,UAAU,CACjB,GAA+C;QAE/C,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;YAClB,GAAG,GAAG;YACN,EAAE,EAAE,UAAU,EAAE;YAChB,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,QAAQ;QACR,MAAM;QACN,QAAQ;QACR,cAAc;QACd,WAAW;QACX,KAAK;QACL,UAAU;QACV,IAAI;QACJ,UAAU;QACV,KAAK;QACL,KAAK;QACL,UAAU;KACX,CAAC;AACJ,CAAC;AAgBD,MAAM,UAAU,cAAc;IAC5B,MAAM,OAAO,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC;IAExB,SAAS,MAAM,CAAC,KAAa;QAC3B,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;IACzB,CAAC;IAED,SAAS,KAAK;QACZ,OAAO,CAAC,KAAK,GAAG,EAAE,CAAC;IACrB,CAAC;IAED,SAAS,KAAK;QACZ,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAC7B,OAAO,CAAC,KAAK,GAAG,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC3C,CAAC;AAgBD,MAAM,UAAU,kBAAkB;IAChC,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,SAAS,GAAyC,IAAI,CAAC;IAE3D,SAAS,KAAK;QACZ,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC;IACxB,CAAC;IAED,SAAS,IAAI;QACX,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;QACvB,IAAI,SAAS,EAAE,CAAC;YACd,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC;IACH,CAAC;IAED,SAAS,gBAAgB,CAAC,EAAU;QAClC,KAAK,EAAE,CAAC;QACR,SAAS,GAAG,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;AACrD,CAAC;AA6BD,MAAM,UAAU,iBAAiB,CAC/B,UAAoC,EAAE;IAEtC,MAAM,EACJ,UAAU,GAAG,oBAAoB,EACjC,WAAW,GAAG,GAAG,EACjB,cAAc,EAAE,UAAU,GAAG,KAAK,GACnC,GAAG,OAAO,CAAC;IAEZ,MAAM,QAAQ,GAAG,GAAG,CAAqB,EAAE,CAAC,CAAC;IAE7C,MAAM,OAAO,GACX,OAAO,MAAM,KAAK,WAAW;QAC3B,CAAC,CAAC,UAAU;YACV,CAAC,CAAC,MAAM,CAAC,cAAc;YACvB,CAAC,CAAC,MAAM,CAAC,YAAY;QACvB,CAAC,CAAC,IAAI,CAAC;IAEX,SAAS,GAAG,CAAC,GAA+C;QAC1D,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;YAClB,GAAG,GAAG;YACN,EAAE,EAAE,UAAU,EAAE;YAChB,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC,CAAC;QAEH,iBAAiB;QACjB,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;YACxC,QAAQ,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,CAAC;QACtD,CAAC;QAED,IAAI,EAAE,CAAC;IACT,CAAC;IAED,SAAS,MAAM,CAAC,EAAU;QACxB,QAAQ,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3D,IAAI,EAAE,CAAC;IACT,CAAC;IAED,SAAS,KAAK;QACZ,QAAQ,CAAC,KAAK,GAAG,EAAE,CAAC;QACpB,IAAI,EAAE,CAAC;IACT,CAAC;IAED,SAAS,IAAI;QACX,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAC3C,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBAClC,QAAQ,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAmB,EAAE,EAAE,CAAC,CAAC;oBACpD,GAAG,CAAC;oBACJ,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;oBAChC,WAAW,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS;iBACjE,CAAC,CAAC,CAAC;YACN,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,sBAAsB;QACxB,CAAC;IACH,CAAC;IAED,SAAS,IAAI;QACX,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,IAAI,CAAC;YACH,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9D,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC;IAED,oBAAoB;IACpB,IAAI,EAAE,CAAC;IAEP,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACtD,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@tashiscool/vue",
+  "version": "0.1.0",
+  "description": "Vue 3 composables for LLM streaming",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "llm",
+    "ai",
+    "vue",
+    "vue3",
+    "composables",
+    "streaming",
+    "reactive"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "vue": "^3.3.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0",
+    "vue": "^3.4.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tashiscool/llm-utils.git",
+    "directory": "packages/vue"
+  }
+}