@danielzfliu/memory 1.0.1 → 2.0.0

package/README.md

@@ -1,196 +1,362 @@
-[![npm version](https://img.shields.io/npm/v/@danielzfliu/memory.svg)](https://www.npmjs.com/package/@danielzfliu/memory)
-
-# Memory
-A fully local Node.js library and REST API for storing, searching, and querying tagged text pieces using ChromaDB for vector storage and Ollama for embeddings + generation.
-
-## Prerequisites
-
-- **Node.js** ≥ 18
-- **Ollama** running locally ([install](https://ollama.com))
-- **ChromaDB** server running locally
-
-### Start Ollama & pull models
-To pull models, run:
-```bash
-ollama pull nomic-embed-text-v2-moe
-ollama pull llama3.2
-```
-
-If used as api:
-```bash
-npm run ollama # or
-npm run ollama:port 11435
-```
-
-If used as a npm package:
-```bash
-ollama serve
-```
-
-### Start ChromaDB
-If used as api:
-```bash
-npm run db # or
-npm run db:port 9000
-```
-
-If used as a npm package:
-```bash
-chroma run --port 8000
-```
-
-**Windows note:** If `chroma` is not recognized, the `Scripts` directory may not be on your PATH. Either add it (e.g. `%APPDATA%\Python\Python3xx\Scripts`) or run the executable directly:
-```powershell
-& "$env:APPDATA\Python\Python313\Scripts\chroma.exe" run --port 8000
-```
-
-## Usage
-
-### REST API Server
-```bash
-npm install
-npm run dev
-```
-
-Server starts on `http://localhost:3000` by default (set `PORT` env var to change).
-
-### API Endpoints
-
-#### Add a piece
-```bash
-curl -X POST http://localhost:3000/pieces \
-  -H "Content-Type: application/json" \
-  -d '{"content": "TypeScript is a typed superset of JavaScript.", "tags": ["typescript", "programming"]}'
-```
-
-#### Get a piece by ID
-```bash
-curl http://localhost:3000/pieces/<id>
-```
-
-#### Update a piece
-```bash
-curl -X PUT http://localhost:3000/pieces/<id> \
-  -H "Content-Type: application/json" \
-  -d '{"content": "Updated content.", "tags": ["new-tag"]}'
-```
-
-#### Delete a piece
-```bash
-curl -X DELETE http://localhost:3000/pieces/<id>
-```
-
-#### Semantic search
-```bash
-curl -X POST http://localhost:3000/query \
-  -H "Content-Type: application/json" \
-  -d '{"query": "What is TypeScript?", "topK": 5}'
-```
-
-With tag filtering:
-```bash
-curl -X POST http://localhost:3000/query \
-  -H "Content-Type: application/json" \
-  -d '{"query": "What is TypeScript?", "tags": ["programming"], "topK": 5}'
-```
-
-#### RAG query (retrieve + generate)
-```bash
-curl -X POST http://localhost:3000/rag \
-  -H "Content-Type: application/json" \
-  -d '{"query": "Explain TypeScript", "tags": ["programming"], "topK": 5}'
-```
-
-Returns:
-```json
-{
-  "answer": "Generated answer based on retrieved context...",
-  "sources": [
-    {
-      "piece": { "id": "...", "content": "...", "tags": ["..."] },
-      "score": 0.87
-    }
-  ]
-}
-```
-
-### Programmatic Usage (Library)
-
-```typescript
-import { PieceStore, RagPipeline, MemoryConfig } from "@danielzfliu/memory";
-
-async function main() {
-    const config: MemoryConfig = {
-        chromaUrl: "http://localhost:8000",
-        ollamaUrl: "http://localhost:11434",
-        embeddingModel: "nomic-embed-text-v2-moe",
-    };
-
-    const store = new PieceStore(config);
-    await store.init();
-
-    await store.addPiece("TypeScript is a typed superset of JavaScript.", [
-        "typescript",
-        "programming",
-    ]);
-    await store.addPiece("Python is great for data science.", [
-        "python",
-        "data-science",
-    ]);
-
-    const results = await store.queryPieces("typed languages", { topK: 5 });
-    console.log("results", results);
-
-    const filtered = await store.queryPieces("typed languages", {
-        tags: ["typescript"],
-        topK: 5,
-    });
-    console.log("filtered", filtered);
-
-    const rag = new RagPipeline(store, "http://localhost:11434", "llama3.2");
-    const answer = await rag.query("What is TypeScript?", {
-        tags: ["programming"],
-    });
-    console.log("answer", answer);
-}
-
-main().catch((err) => {
-    console.error(err);
-    process.exit(1);
-});
-```
-
-## Configuration (`MemoryConfig`)
-
-| Option | Default | Description |
-|--------|---------|-------------|
-| `chromaUrl` | `http://localhost:8000` | ChromaDB server URL |
-| `ollamaUrl` | `http://localhost:11434` | Ollama server URL |
-| `embeddingModel` | `nomic-embed-text-v2-moe` | Ollama model for embeddings |
-| `generationModel` | `llama3.2` | Ollama model for RAG generation |
-| `collectionName` | `pieces` | ChromaDB collection name |
-
-## Testing
-
-```bash
-npm test              # run all tests
-npm run test:watch    # watch mode
-npm run test:coverage # with coverage report
-```
-
-## Project Structure
-
-```
-src/
-├── types.ts        # Interfaces (MemoryConfig, Piece, QueryResult, etc.)
-├── embeddings.ts   # Ollama embedding client
-├── store.ts        # PieceStore — CRUD + semantic search + tag filtering
-├── rag.ts          # RAG pipeline — retrieve → prompt → generate
-├── server.ts       # Express REST API (app factory)
-├── main.ts         # Server entry point (starts listening)
-└── index.ts        # Library entry point (public exports)
-tests/
-├── helpers/        # Shared test fixtures (in-memory ChromaDB mock, etc.)
-├── unit/           # Unit tests (embeddings, store, rag)
-└── integration/    # API integration tests (supertest)
+[![npm version](https://img.shields.io/npm/v/@danielzfliu/memory.svg)](https://www.npmjs.com/package/@danielzfliu/memory)
+
+# Memory
+
+A fully local MCP server and Node.js library for storing, semantically searching, and querying tagged/titled text with ChromaDB (vector storage) and Ollama (embeddings and generation).
+
+Three ways to use Memory:
+
+- MCP Server — Run Memory as a Model Context Protocol server over stdio and expose memory tools to MCP-compatible clients.
+- npm Package — Install `@danielzfliu/memory` in your own project and use the classes directly (store, embeddings, RAG, and MCP server class).
+- REST API Server — Run the standalone HTTP server with CRUD, semantic search, and RAG endpoints.
+
+---
+
+## Prerequisites
+
+- **Node.js** ≥ 18
+- **Ollama** running locally
+- **ChromaDB** server running locally
+
+### Setting up Ollama
+
+Install Ollama ([install](https://ollama.com)) and pull the default models:
+
+```bash
+ollama pull nomic-embed-text-v2-moe:latest
+ollama pull gemma3:latest
+```
+
+Then run:
+```bash
+npm run ollama                     # start Ollama on default port 11434
+npm run ollama:port -- 11435       # start Ollama on a custom port
+```
+
+### Setting up ChromaDB
+
+**Option 1: Docker**
+
+The repo includes a Docker Compose file that runs ChromaDB and stores its data in `./chroma/`.
+
+```bash
+npm run docker:up       # start ChromaDB on port 8000
+npm run docker:logs     # view logs
+npm run docker:down     # stop ChromaDB
+```
+
+**Option 2: pip**
+
+```bash
+pip install chromadb
+chroma run --port 8000  # start ChromaDB on port 8000
+```
+
+Note: You may need to add Python's Scripts folder to your PATH after installing.
+
+---
+
+## Option A: MCP Server
+
+Use this option to run Memory as a standalone MCP server.
+
+### 1. Setup
+
+```bash
+git clone https://github.com/DanielZFLiu/memory.git
+cd memory
+npm install
+```
+
+### 2. Build and run the MCP server
+
+```bash
+npm run build
+node ./dist/main.js
+```
+
+Memory MCP communicates over stdio, so it does not bind an HTTP port.
+
+### MCP Client Configuration
+
+#### Claude Desktop (example)
+
+```json
+{
+  "mcpServers": {
+    "memory": {
+      "command": "npx",
+      "args": ["-y", "@danielzfliu/memory"]
+    }
+  }
+}
+```
+
+If you are running from a local clone instead of npm:
+
+```json
+{
+  "mcpServers": {
+    "memory": {
+      "command": "node",
+      "args": ["c:/path/to/memory/dist/main.js"]
+    }
+  }
+}
+```
+
+### MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `add_piece` | Add a new piece with optional title and tags |
+| `get_piece` | Retrieve a piece by id |
+| `update_piece` | Update piece content, title, and/or tags (`title: null` clears title) |
+| `delete_piece` | Delete a piece by id |
+| `query_pieces` | Semantic search over content, plus title when present. Supports hybrid search (vector + keyword via RRF). |
+| `rag_query` | Retrieve + generate answer with citations using content and title context. Supports hybrid search. |
+| `list_collections` | List all collection names in the memory store |
+| `delete_collection` | Delete an entire collection and all its pieces |
+
+All piece-level tools accept an optional `collection` parameter to target a specific collection instead of the default. This allows multiple agents to use isolated memory stores.
+
+---
+
+## Option B: npm Package
+
+Use this option to integrate Memory into your own Node.js/TypeScript project.
+
+### 1. Install
+
+```bash
+npm install @danielzfliu/memory
+```
+
+### 2. Programmatic usage
+
+#### Using PieceStore and RagPipeline directly
+
+```typescript
+import { PieceStore, RagPipeline, MemoryConfig } from "@danielzfliu/memory";
+
+async function main() {
+    const config: MemoryConfig = {
+        chromaUrl: "http://localhost:8000",
+        ollamaUrl: "http://localhost:11434",
+        embeddingModel: "nomic-embed-text-v2-moe:latest",
+    };
+
+    // Store: CRUD + semantic search
+    const store = new PieceStore(config);
+    await store.init();
+
+    await store.addPiece(
+        "TypeScript is a typed superset of JavaScript.",
+        ["typescript", "programming"],
+        "TypeScript overview",
+    );
+    await store.addPiece("Python is great for data science.", [
+        "python",
+        "data-science",
+    ]);
+
+    const results = await store.queryPieces("typed languages", { topK: 5 });
+    console.log("results", results);
+
+    const filtered = await store.queryPieces("typed languages", {
+        tags: ["typescript"],
+        topK: 5,
+    });
+    console.log("filtered", filtered);
+
+    // Hybrid search: combines vector similarity with keyword matching via RRF
+    const hybrid = await store.queryPieces("typed languages", {
+        topK: 5,
+        useHybridSearch: true,
+    });
+    console.log("hybrid", hybrid);
+
+    // RAG: retrieve relevant pieces → generate an answer via Ollama
+    const rag = new RagPipeline(store, config.ollamaUrl!, "gemma3:latest");
+    const answer = await rag.query("What is TypeScript?", {
+        tags: ["programming"],
+    });
+    console.log("answer", answer);
+}
+
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+```
+
+#### Embedding the REST API in your own Express app
+
+`createServer` returns a configured Express app you can mount or extend:
+
+```typescript
+import { createServer } from "@danielzfliu/memory";
+
+const app = createServer({
+    chromaUrl: "http://localhost:8000",
+    ollamaUrl: "http://localhost:11434",
+});
+
+app.listen(4000, () => console.log("Running on :4000"));
+```
+
+---
+
+## Option C: REST API Server
+
+Use this option to run Memory as a standalone HTTP service.
+
+### 1. Setup
+
+```bash
+git clone https://github.com/DanielZFLiu/memory.git
+cd memory
+npm install
+```
+
+### 2. Start the REST server
+
+```bash
+npm run dev:http
+```
+
+Server starts on `http://localhost:3000` by default (set `PORT` env var to change).
+
+### API Endpoints
+
+#### Add a piece
+```bash
+curl -X POST http://localhost:3000/pieces \
+  -H "Content-Type: application/json" \
+  -d '{"title": "TypeScript overview", "content": "TypeScript is a typed superset of JavaScript.", "tags": ["typescript", "programming"]}'
+```
+
+With a specific collection:
+```bash
+curl -X POST http://localhost:3000/pieces \
+  -H "Content-Type: application/json" \
+  -d '{"content": "Agent-specific memory.", "tags": ["agent"], "collection": "agent-alice"}'
+```
+
+#### Get a piece by ID
+```bash
+curl http://localhost:3000/pieces/<id>
+curl http://localhost:3000/pieces/<id>?collection=agent-alice
+```
+
+#### Update a piece
+```bash
+curl -X PUT http://localhost:3000/pieces/<id> \
+  -H "Content-Type: application/json" \
+  -d '{"title": "Updated title", "content": "Updated content.", "tags": ["new-tag"]}'
+```
+
+Set `title` to `null` to clear it.
+
+#### Delete a piece
+```bash
+curl -X DELETE http://localhost:3000/pieces/<id>
+curl -X DELETE http://localhost:3000/pieces/<id>?collection=agent-alice
+```
+
+#### Semantic search
+```bash
+curl -X POST http://localhost:3000/query \
+  -H "Content-Type: application/json" \
+  -d '{"query": "What is TypeScript?", "topK": 5}'
+```
+
+With tag filtering:
+```bash
+curl -X POST http://localhost:3000/query \
+  -H "Content-Type: application/json" \
+  -d '{"query": "What is TypeScript?", "tags": ["programming"], "topK": 5}'
+```
+
+With hybrid search (vector + keyword via Reciprocal Rank Fusion):
+```bash
+curl -X POST http://localhost:3000/query \
+  -H "Content-Type: application/json" \
+  -d '{"query": "What is TypeScript?", "topK": 5, "useHybridSearch": true}'
+```
+
+#### RAG query (retrieve + generate)
+```bash
+curl -X POST http://localhost:3000/rag \
+  -H "Content-Type: application/json" \
+  -d '{"query": "Explain TypeScript", "tags": ["programming"], "topK": 5}'
+```
+
+Returns:
+```json
+{
+  "answer": "Generated answer based on retrieved context...",
+  "sources": [
+    {
+      "piece": { "id": "...", "title": "...", "content": "...", "tags": ["..."] },
+      "score": 0.87
+    }
+  ]
+}
+```
+
+#### List collections
+```bash
+curl http://localhost:3000/collections
+```
+
+#### Delete a collection
+```bash
+curl -X DELETE http://localhost:3000/collections/agent-alice
+```
+
+> **Multi-collection:** All piece and query endpoints accept an optional `collection` parameter (in the request body for POST/PUT, as a query string for GET/DELETE) to target a specific collection. Omitting it uses the default collection.
+
+---
+
+## Exports
+
+| Export | Description |
+|--------|-------------|
+| `PieceStore` | CRUD + semantic search over tagged text pieces |
+| `RagPipeline` | Retrieve-then-generate pipeline using `PieceStore` + Ollama |
+| `EmbeddingClient` | Low-level Ollama embedding wrapper |
+| `MemoryMcpServer` | MCP server class (stdio transport) exposing memory tools |
+| `createServer` | Express app factory with all REST endpoints pre-configured |
+| `MemoryConfig` | Configuration interface (all fields optional with defaults) |
+| `DEFAULT_MEMORY_CONFIG` | The default values for `MemoryConfig` |
+| `Piece` | `{ id, content, title?, tags }` |
+| `QueryOptions` | `{ tags?, topK?, useHybridSearch? }` |
+| `QueryResult` | `{ piece, score }` |
+| `RagResult` | `{ answer, sources }` |
+
+---
+
+## Configuration (`MemoryConfig`)
+
+All fields are optional. Defaults are applied automatically.
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `chromaUrl` | `http://localhost:8000` | ChromaDB server URL |
+| `ollamaUrl` | `http://localhost:11434` | Ollama server URL |
+| `embeddingModel` | `nomic-embed-text-v2-moe:latest` | Ollama model for embeddings |
+| `generationModel` | `gemma3:latest` | Ollama model for RAG generation |
+| `collectionName` | `pieces` | ChromaDB collection name |
+
+> **Note:** `generationModel` is used by `createServer` and `MemoryMcpServer`. When constructing `RagPipeline` directly, you pass the model name to its constructor.
+
+Environment variables with the names above can override these defaults at runtime.
+
+## Testing
+
+```bash
+npm test              # run all tests
+npm run test:watch    # watch mode
+npm run test:coverage # with coverage report
 ```

package/dist/config.d.ts

@@ -0,0 +1,4 @@
+import { MemoryConfig } from "./types";
+export declare const DEFAULT_MEMORY_CONFIG: Required<MemoryConfig>;
+export declare function resolveConfig(config?: MemoryConfig): Required<MemoryConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,YAAY,CAMxD,CAAC;AAqBF,wBAAgB,aAAa,CAAC,MAAM,GAAE,YAAiB,GAAG,QAAQ,CAAC,YAAY,CAAC,CAuB/E"}

package/dist/config.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_MEMORY_CONFIG = void 0;
+exports.resolveConfig = resolveConfig;
+exports.DEFAULT_MEMORY_CONFIG = {
+    chromaUrl: "http://localhost:8000",
+    ollamaUrl: "http://localhost:11434",
+    embeddingModel: "nomic-embed-text-v2-moe:latest",
+    generationModel: "gemma3:latest",
+    collectionName: "pieces",
+};
+const ENV_CONFIG_KEYS = {
+    chromaUrl: ["MEMORY_CHROMA_URL", "CHROMA_URL"],
+    ollamaUrl: ["MEMORY_OLLAMA_URL", "OLLAMA_URL"],
+    embeddingModel: ["MEMORY_EMBEDDING_MODEL", "EMBEDDING_MODEL"],
+    generationModel: ["MEMORY_GENERATION_MODEL", "GENERATION_MODEL"],
+    collectionName: ["MEMORY_COLLECTION_NAME", "COLLECTION_NAME"],
+};
+function resolveEnvOverride(keys) {
+    for (const key of keys) {
+        const value = process.env[key]?.trim();
+        if (value) {
+            return value;
+        }
+    }
+    return undefined;
+}
+function resolveConfig(config = {}) {
+    return {
+        chromaUrl: config.chromaUrl ??
+            resolveEnvOverride(ENV_CONFIG_KEYS.chromaUrl) ??
+            exports.DEFAULT_MEMORY_CONFIG.chromaUrl,
+        ollamaUrl: config.ollamaUrl ??
+            resolveEnvOverride(ENV_CONFIG_KEYS.ollamaUrl) ??
+            exports.DEFAULT_MEMORY_CONFIG.ollamaUrl,
+        embeddingModel: config.embeddingModel ??
+            resolveEnvOverride(ENV_CONFIG_KEYS.embeddingModel) ??
+            exports.DEFAULT_MEMORY_CONFIG.embeddingModel,
+        generationModel: config.generationModel ??
+            resolveEnvOverride(ENV_CONFIG_KEYS.generationModel) ??
+            exports.DEFAULT_MEMORY_CONFIG.generationModel,
+        collectionName: config.collectionName ??
+            resolveEnvOverride(ENV_CONFIG_KEYS.collectionName) ??
+            exports.DEFAULT_MEMORY_CONFIG.collectionName,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;AA6BA,sCAuBC;AAlDY,QAAA,qBAAqB,GAA2B;IACzD,SAAS,EAAE,uBAAuB;IAClC,SAAS,EAAE,wBAAwB;IACnC,cAAc,EAAE,gCAAgC;IAChD,eAAe,EAAE,eAAe;IAChC,cAAc,EAAE,QAAQ;CAC3B,CAAC;AAEF,MAAM,eAAe,GAAmD;IACpE,SAAS,EAAE,CAAC,mBAAmB,EAAE,YAAY,CAAC;IAC9C,SAAS,EAAE,CAAC,mBAAmB,EAAE,YAAY,CAAC;IAC9C,cAAc,EAAE,CAAC,wBAAwB,EAAE,iBAAiB,CAAC;IAC7D,eAAe,EAAE,CAAC,yBAAyB,EAAE,kBAAkB,CAAC;IAChE,cAAc,EAAE,CAAC,wBAAwB,EAAE,iBAAiB,CAAC;CAChE,CAAC;AAEF,SAAS,kBAAkB,CAAC,IAAc;IACtC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC;QACvC,IAAI,KAAK,EAAE,CAAC;YACR,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,SAAgB,aAAa,CAAC,SAAuB,EAAE;IACnD,OAAO;QACH,SAAS,EACL,MAAM,CAAC,SAAS;YAChB,kBAAkB,CAAC,eAAe,CAAC,SAAS,CAAC;YAC7C,6BAAqB,CAAC,SAAS;QACnC,SAAS,EACL,MAAM,CAAC,SAAS;YAChB,kBAAkB,CAAC,eAAe,CAAC,SAAS,CAAC;YAC7C,6BAAqB,CAAC,SAAS;QACnC,cAAc,EACV,MAAM,CAAC,cAAc;YACrB,kBAAkB,CAAC,eAAe,CAAC,cAAc,CAAC;YAClD,6BAAqB,CAAC,cAAc;QACxC,eAAe,EACX,MAAM,CAAC,eAAe;YACtB,kBAAkB,CAAC,eAAe,CAAC,eAAe,CAAC;YACnD,6BAAqB,CAAC,eAAe;QACzC,cAAc,EACV,MAAM,CAAC,cAAc;YACrB,kBAAkB,CAAC,eAAe,CAAC,cAAc,CAAC;YAClD,6BAAqB,CAAC,cAAc;KAC3C,CAAC;AACN,CAAC"}

package/dist/http-main.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=http-main.d.ts.map

package/dist/http-main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-main.d.ts","sourceRoot":"","sources":["../src/http-main.ts"],"names":[],"mappings":""}

package/dist/http-main.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const server_1 = require("./server");
+const PORT = process.env.PORT ?? 3000;
+const app = (0, server_1.createServer)();
+app.listen(PORT, () => {
+    console.log(`Memory RAG server running on http://localhost:${PORT}`);
+});
+//# sourceMappingURL=http-main.js.map

package/dist/http-main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-main.js","sourceRoot":"","sources":["../src/http-main.ts"],"names":[],"mappings":";;AAAA,qCAAwC;AAExC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC;AACtC,MAAM,GAAG,GAAG,IAAA,qBAAY,GAAE,CAAC;AAC3B,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;IAClB,OAAO,CAAC,GAAG,CAAC,iDAAiD,IAAI,EAAE,CAAC,CAAC;AACzE,CAAC,CAAC,CAAC"}

package/dist/hybrid.d.ts

@@ -0,0 +1,8 @@
+export declare function tokenize(text: string): string[];
+export declare function keywordScore(queryTokens: string[], docText: string): number;
+export interface RankedItem<T> {
+    item: T;
+    score: number;
+}
+export declare function reciprocalRankFusion<T>(rankings: RankedItem<T>[][], idFn: (item: T) => string, k?: number): RankedItem<T>[];
+//# sourceMappingURL=hybrid.d.ts.map

package/dist/hybrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybrid.d.ts","sourceRoot":"","sources":["../src/hybrid.ts"],"names":[],"mappings":"AAUA,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAK/C;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAQ3E;AAED,MAAM,WAAW,UAAU,CAAC,CAAC;IACzB,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAClC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,EAC3B,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EACzB,CAAC,SAAK,GACP,UAAU,CAAC,CAAC,CAAC,EAAE,CAejB"}