@tryhamster/gerbil 1.0.0-rc.0 → 1.0.0-rc.10

package/dist/browser/index.d.mts

@@ -1,262 +0,0 @@
-import { _ as SystemInfo, a as GenerateOptions, c as GerbilModelSettings, d as LoadOptions, f as ModelConfig, g as SessionStats, h as ProgressInfo, i as FallbackConfig, l as GerbilProviderSettings, m as ModelStats, n as EmbedOptions, o as GenerateResult, p as ModelSource, r as EmbedResult, s as GerbilConfig, t as CacheConfig, u as JsonOptions } from "../types-BS1N92Jt.mjs";
-import { t as BUILTIN_MODELS } from "../models-De2-_GmQ.mjs";
-
-//#region src/browser/index.d.ts
-
-type WorkerProgress = {
-  status: "loading" | "downloading" | "ready" | "error";
-  message?: string;
-  file?: string;
-  progress?: number;
-  /** Number of files being downloaded (0 = loading from cache) */
-  downloadCount?: number;
-  /** Total files to process */
-  totalFiles?: number;
-  error?: string;
-};
-type WorkerToken = {
-  status: "token";
-  text: string;
-  state: "thinking" | "answering";
-  numTokens: number;
-  tps: number;
-};
-type WorkerComplete = {
-  status: "complete";
-  text: string;
-  numTokens: number;
-  totalTime: number;
-  tps: number;
-};
-type GerbilWorkerOptions = {
-  /** Model ID to load (default: "qwen3-0.6b") */
-  modelId?: string;
-  /** Called during model loading with progress updates */
-  onProgress?: (progress: WorkerProgress) => void;
-  /** Called for each token during streaming generation */
-  onToken?: (token: WorkerToken) => void;
-  /** Called when generation is complete */
-  onComplete?: (result: WorkerComplete) => void;
-  /** Called on errors */
-  onError?: (error: string) => void;
-  /** Worker script URL (auto-detected if not provided) */
-  workerUrl?: string;
-};
-type GenerateStreamOptions = {
-  /** Maximum tokens to generate */
-  maxTokens?: number;
-  /** Temperature for sampling (0 = deterministic) */
-  temperature?: number;
-  /** Top-p nucleus sampling */
-  topP?: number;
-  /** Top-k sampling */
-  topK?: number;
-  /** Enable thinking mode (Qwen3) */
-  thinking?: boolean;
-  /** System prompt */
-  system?: string;
-};
-type GerbilWorker = {
-  /** Generate text with streaming */
-  generate: (prompt: string, options?: GenerateStreamOptions) => Promise<string>;
-  /** Interrupt current generation */
-  interrupt: () => void;
-  /** Reset conversation cache */
-  reset: () => void;
-  /** Terminate the worker */
-  terminate: () => void;
-  /** Check if model is loaded */
-  isReady: () => boolean;
-};
-/**
- * Create a Gerbil worker for streaming WebGPU inference
- *
- * Uses a Web Worker to keep the UI responsive during model loading
- * and text generation, with real-time token streaming.
- */
-declare function createGerbilWorker(options?: GerbilWorkerOptions): Promise<GerbilWorker>;
-/** Message in a chat conversation */
-type Message = {
-  id: string;
-  role: "user" | "assistant";
-  content: string;
-  thinking?: string;
-};
-/** Loading progress state */
-type LoadingProgress = {
-  status: "loading" | "downloading" | "ready" | "error";
-  message?: string;
-  file?: string;
-  progress?: number;
-  /** Number of files being downloaded (0 = loading from cache) */
-  downloadCount?: number;
-  /** Total files to process */
-  totalFiles?: number;
-};
-/** Options for useChat hook */
-type UseChatOptions = {
-  /** Model ID (default: "qwen3-0.6b") */
-  model?: string;
-  /** System prompt */
-  system?: string;
-  /** Enable thinking mode (Qwen3) */
-  thinking?: boolean;
-  /** Max tokens per response */
-  maxTokens?: number;
-  /** Temperature (0-2) */
-  temperature?: number;
-  /** Initial messages */
-  initialMessages?: Message[];
-  /** Auto-load model on mount (default: false - loads on first generate or load()) */
-  autoLoad?: boolean;
-  /** Called when model is ready */
-  onReady?: () => void;
-  /** Called on error */
-  onError?: (error: string) => void;
-};
-/** Return type for useChat hook */
-type UseChatReturn = {
-  /** Chat messages */
-  messages: Message[];
-  /** Current input value */
-  input: string;
-  /** Set input value */
-  setInput: (value: string) => void;
-  /** Submit current input */
-  handleSubmit: (e?: {
-    preventDefault?: () => void;
-  }) => void;
-  /** Whether model is loading */
-  isLoading: boolean;
-  /** Loading progress */
-  loadingProgress: LoadingProgress | null;
-  /** Whether generating a response */
-  isGenerating: boolean;
-  /** Current thinking content (streaming) */
-  thinking: string;
-  /** Stop generation */
-  stop: () => void;
-  /** Clear all messages */
-  clear: () => void;
-  /** Current tokens per second */
-  tps: number;
-  /** Whether model is ready */
-  isReady: boolean;
-  /** Error message if any */
-  error: string | null;
-  /** Load the model (only needed if lazy: true) */
-  load: () => void;
-};
-/**
- * React hook for chat with local LLM
- *
- * @example
- * ```tsx
- * import { useChat } from "@tryhamster/gerbil/browser";
- *
- * function Chat() {
- *   const { messages, input, setInput, handleSubmit, isLoading, isGenerating } = useChat();
- *
- *   if (isLoading) return <div>Loading model...</div>;
- *
- *   return (
- *     <div>
- *       {messages.map(m => (
- *         <div key={m.id}>{m.role}: {m.content}</div>
- *       ))}
- *       <form onSubmit={handleSubmit}>
- *         <input value={input} onChange={e => setInput(e.target.value)} />
- *         <button disabled={isGenerating}>Send</button>
- *       </form>
- *     </div>
- *   );
- * }
- * ```
- */
-declare function useChat(options?: UseChatOptions): UseChatReturn;
-/** Options for useCompletion hook */
-type UseCompletionOptions = {
-  /** Model ID (default: "qwen3-0.6b") */
-  model?: string;
-  /** System prompt */
-  system?: string;
-  /** Enable thinking mode (Qwen3) */
-  thinking?: boolean;
-  /** Max tokens */
-  maxTokens?: number;
-  /** Temperature (0-2) */
-  temperature?: number;
-  /** Auto-load model on mount (default: false - loads on first complete() or load()) */
-  autoLoad?: boolean;
-  /** Called when model is ready */
-  onReady?: () => void;
-  /** Called on error */
-  onError?: (error: string) => void;
-};
-/** Return type for useCompletion hook */
-type UseCompletionReturn = {
-  /** Generated completion */
-  completion: string;
-  /** Thinking content (if enabled) */
-  thinking: string;
-  /** Generate completion */
-  complete: (prompt: string) => Promise<string>;
-  /** Whether model is loading */
-  isLoading: boolean;
-  /** Loading progress */
-  loadingProgress: LoadingProgress | null;
-  /** Whether generating */
-  isGenerating: boolean;
-  /** Stop generation */
-  stop: () => void;
-  /** Current tokens per second */
-  tps: number;
-  /** Whether model is ready */
-  isReady: boolean;
-  /** Error message if any */
-  error: string | null;
-  /** Load the model (only needed if lazy: true) */
-  load: () => void;
-};
-/**
- * React hook for text completion with local LLM
- *
- * @example
- * ```tsx
- * import { useCompletion } from "@tryhamster/gerbil/browser";
- *
- * function App() {
- *   const { complete, completion, isLoading, isGenerating } = useCompletion();
- *
- *   if (isLoading) return <div>Loading...</div>;
- *
- *   return (
- *     <div>
- *       <button onClick={() => complete("Write a haiku")}>Generate</button>
- *       <p>{completion}</p>
- *     </div>
- *   );
- * }
- * ```
- */
-declare function useCompletion(options?: UseCompletionOptions): UseCompletionReturn;
-/**
- * Check if WebGPU is supported
- */
-declare function isWebGPUSupported(): boolean;
-/**
- * Get WebGPU adapter info
- */
-declare function getWebGPUInfo(): Promise<{
-  supported: boolean;
-  adapter?: string;
-  device?: string;
-} | null>;
-declare const _default: {
-  isWebGPUSupported: typeof isWebGPUSupported;
-  getWebGPUInfo: typeof getWebGPUInfo;
-  createGerbilWorker: typeof createGerbilWorker;
-};
-//#endregion
-export { BUILTIN_MODELS, CacheConfig, EmbedOptions, EmbedResult, FallbackConfig, GenerateOptions, GenerateResult, GenerateStreamOptions, GerbilConfig, GerbilModelSettings, GerbilProviderSettings, GerbilWorker, GerbilWorkerOptions, JsonOptions, LoadOptions, LoadingProgress, Message, ModelConfig, ModelSource, ModelStats, ProgressInfo, SessionStats, SystemInfo, UseChatOptions, UseChatReturn, UseCompletionOptions, UseCompletionReturn, WorkerComplete, WorkerProgress, WorkerToken, createGerbilWorker, _default as default, getWebGPUInfo, isWebGPUSupported, useChat, useCompletion };
-//# sourceMappingURL=index.d.mts.map

package/dist/browser/index.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/browser/index.ts"],"sourcesContent":[],"mappings":";;;;;KA6DY,cAAA;;;;;;;;;;;KAYA,WAAA;;;;;;;KAQA,cAAA;;;;;;;KAQA,mBAAA;;;;0BAIc;;oBAEN;;wBAEI;;;;;;KAOZ,qBAAA;;;;;;;;;;;;;;KAeA,YAAA;;uCAE2B,0BAA0B;;;;;;;;;;;;;;;;iBAqB3C,kBAAA,WAA4B,sBAA2B,QAAQ;;KAwTzE,OAAA;;;;;;;KAQA,eAAA;;;;;;;;;;;KAYA,cAAA;;;;;;;;;;;;oBAYQ;;;;;;;;;KAUR,aAAA;;YAEA;;;;;;;;;;;;mBAUO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6CH,OAAA,WAAiB,iBAAsB;;KAmQ3C,oBAAA;;;;;;;;;;;;;;;;;;;KAoBA,mBAAA;;;;;;gCAMoB;;;;mBAIb;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoCH,aAAA,WAAuB,uBAA4B;;;;iBAqMnD,iBAAA,CAAA;;;;iBAUM,aAAA,CAAA,GAAiB;;;;;cAwBtC"}