browser-visual-search 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 export { embedImage, embedBatch } from './embedding/index.js';
 export { segmentImage } from './segmentation/index.js';
-export { buildIndex, loadIndex } from './search/index.js';
+export { buildFromDirectory } from './search-index/build-from-directory.js';
+export { indexExists, openIndex } from './search-index/index.js';
 export type { BBox, IndexedImage, IndexedImageSegment, SearchOptions, SearchResult, Segment, VisualSearchIndex } from './types.js';
-export type { BuildOptions, BuildProgress } from './search/build-index.js';
-export type { LoadIndexOptions } from './search/load-index.js';
+export type { BuildFromDirectoryOptions, BuildFromDirectoryProgress } from './search-index/build-from-directory.js';
+export type { BuildIndexOptions, LoadIndexOptions } from './search-index/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE1D,YAAY,EACV,IAAI,EACJ,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,OAAO,EACP,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,YAAY,EACZ,aAAa,EACd,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,gBAAgB,EACjB,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEjE,YAAY,EACV,IAAI,EACJ,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,OAAO,EACP,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,wCAAwC,CAAC;AAEhD,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export { embedImage, embedBatch } from './embedding/index.js';
 export { segmentImage } from './segmentation/index.js';
-export { buildIndex, loadIndex } from './search/index.js';
+export { buildFromDirectory } from './search-index/build-from-directory.js';
+export { indexExists, openIndex } from './search-index/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/search-index/build-from-directory.d.ts

@@ -0,0 +1,16 @@
+import { type BuildIndexOptions } from './index.js';
+import type { VisualSearchIndex } from '../types.js';
+export interface BuildFromDirectoryOptions extends BuildIndexOptions {
+    forceReindex?: boolean;
+    onProgress?: (progress: BuildFromDirectoryProgress) => void;
+}
+export type BuildFromDirectoryProgress = {
+    phase: 'loading' | 'scanning' | 'saving' | 'done';
+} | {
+    phase: 'indexing';
+    total: number;
+    completed: number;
+    currentFile?: string;
+};
+export declare const buildFromDirectory: (dirHandle: FileSystemDirectoryHandle, opts: BuildFromDirectoryOptions) => Promise<VisualSearchIndex>;
+//# sourceMappingURL=build-from-directory.d.ts.map

package/dist/search-index/build-from-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-from-directory.d.ts","sourceRoot":"","sources":["../../src/search-index/build-from-directory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAyC,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,KAAK,EAAqC,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAExF,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB;IAElE,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,0BAA0B,KAAK,IAAI,CAAC;CAE7D;AAED,MAAM,MAAM,0BAA0B,GAClC;IAAE,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAA;CAAE,GACrD;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AA8BlF,eAAO,MAAM,kBAAkB,GAC7B,WAAW,yBAAyB,EACpC,MAAM,yBAAyB,KAC9B,OAAO,CAAC,iBAAiB,CAgG3B,CAAA"}

package/dist/search-index/build-from-directory.js

@@ -0,0 +1,99 @@
+import { embedBatch } from '../embedding/embed.js';
+import { segmentImage } from '../segmentation/index.js';
+import { createIndex, openIndex, EMBEDDING_DIM } from './index.js';
+const collectImages = async (dirHandle, path = '') => {
+    const images = [];
+    const entries = dirHandle.entries();
+    for await (const [name, handle] of entries) {
+        const fullPath = path ? `${path}/${name}` : name;
+        if (handle.kind === 'file') {
+            const ext = name.toLowerCase().split('.').pop();
+            if (['jpg', 'jpeg', 'png', 'webp'].includes(ext ?? '')) {
+                const file = await handle.getFile();
+                images.push({ id: fullPath, file });
+            }
+        }
+        else if (handle.kind === 'directory') {
+            images.push(...await collectImages(handle, fullPath));
+        }
+    }
+    return images;
+};
+export const buildFromDirectory = async (dirHandle, opts) => {
+    const { onProgress, forceReindex } = opts;
+    // 1. Try to load existing index
+    onProgress?.({ phase: 'loading' });
+    let existingImages = [];
+    let existingEmbeddings = new Float32Array(0);
+    try {
+        const existing = await openIndex(dirHandle, opts);
+        existingImages = [...existing.images];
+        existingEmbeddings = existing.embeddings;
+        ;
+    }
+    catch {
+        // No index yet — start fresh
+    }
+    // 2. Scan directory
+    onProgress?.({ phase: 'scanning' });
+    const allImages = await collectImages(dirHandle);
+    const allImageIds = new Set(allImages.map(img => img.id));
+    // 3. Prune images no longer on disk
+    const keptImages = existingImages.filter(img => allImageIds.has(img.imageId));
+    // 4. Determine which images need indexing
+    const indexedIds = new Set(keptImages.map(img => img.imageId));
+    const toIndex = forceReindex
+        ? allImages
+        : allImages.filter(img => !indexedIds.has(img.id));
+    // 5. Index new images
+    const newImages = [];
+    const newEmbeddings = [];
+    let nextRow = 0;
+    for (let i = 0; i < toIndex.length; i++) {
+        const input = toIndex[i];
+        onProgress?.({ phase: 'indexing', total: toIndex.length, completed: i, currentFile: input.id });
+        const detections = await segmentImage(input.file, opts);
+        const bitmap = await createImageBitmap(input.file);
+        const embeddings = await embedBatch(bitmap, detections.map(d => d.bbox), opts);
+        bitmap.close();
+        const segments = detections.map((det, j) => ({
+            bbox: det.bbox,
+            area: det.area,
+            embeddingRow: nextRow++,
+        }));
+        newImages.push({ imageId: input.id, indexedAt: new Date().toISOString(), segments });
+        newEmbeddings.push(...embeddings);
+    }
+    // 6. Merge kept + new
+    // Re-map embeddingRows for kept images, then append new
+    const mergedImages = [];
+    const mergedEmbeddingVecs = [];
+    let row = 0;
+    const baseImages = forceReindex ? [] : keptImages;
+    for (const img of baseImages) {
+        const remappedSegments = img.segments.map(seg => {
+            const vec = existingEmbeddings.subarray(seg.embeddingRow * EMBEDDING_DIM, seg.embeddingRow * EMBEDDING_DIM + EMBEDDING_DIM);
+            mergedEmbeddingVecs.push(new Float32Array(vec));
+            return { ...seg, embeddingRow: row++ };
+        });
+        mergedImages.push({ ...img, segments: remappedSegments });
+    }
+    for (const img of newImages) {
+        const remappedSegments = img.segments.map(seg => ({
+            ...seg,
+            embeddingRow: row++,
+        }));
+        mergedImages.push({ ...img, segments: remappedSegments });
+    }
+    mergedEmbeddingVecs.push(...newEmbeddings);
+    // Flatten into a single Float32Array
+    const mergedEmbeddings = new Float32Array(mergedEmbeddingVecs.length * EMBEDDING_DIM);
+    mergedEmbeddingVecs.forEach((vec, i) => mergedEmbeddings.set(vec, i * EMBEDDING_DIM));
+    // 7. Serialize
+    onProgress?.({ phase: 'saving' });
+    const index = createIndex(mergedImages, mergedEmbeddings, dirHandle, opts);
+    await index.save();
+    onProgress?.({ phase: 'done' });
+    return index;
+};
+//# sourceMappingURL=build-from-directory.js.map

package/dist/search-index/build-from-directory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-from-directory.js","sourceRoot":"","sources":["../../src/search-index/build-from-directory.ts"],"names":[],"mappings":"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"}

package/dist/search-index/index.d.ts

@@ -0,0 +1,19 @@
+import type { IndexedImage, VisualSearchIndex } from '../types.js';
+export declare const EMBEDDING_DIM = 512;
+export interface LoadIndexOptions {
+    embedderUrl: string;
+    executionProviders?: string[];
+    create?: boolean;
+}
+export interface BuildIndexOptions extends LoadIndexOptions {
+    segmenterUrl: string;
+}
+export declare const indexExists: (dirHandle: FileSystemDirectoryHandle) => Promise<boolean>;
+export declare const createIndex: (images: IndexedImage[], embeddings: Float32Array, dirHandle: FileSystemDirectoryHandle, opts: LoadIndexOptions | BuildIndexOptions) => VisualSearchIndex;
+/**
+ * Load an existing visual search index from a directory handle.
+ * @param dirHandle The directory handle containing index.json and embeddings.bin
+ * @returns The loaded index
+ */
+export declare const openIndex: (dirHandle: FileSystemDirectoryHandle, opts: LoadIndexOptions | BuildIndexOptions) => Promise<VisualSearchIndex>;
+//# sourceMappingURL=index.d.ts.map

package/dist/search-index/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/search-index/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,YAAY,EAIZ,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAMrB,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC,MAAM,WAAW,gBAAgB;IAE/B,WAAW,EAAE,MAAM,CAAC;IAEpB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE9B,MAAM,CAAC,EAAE,OAAO,CAAC;CAElB;AAED,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IAEzD,YAAY,EAAE,MAAM,CAAC;CAEtB;AAsDD,eAAO,MAAM,WAAW,GACtB,WAAW,yBAAyB,KACnC,OAAO,CAAC,OAAO,CAYjB,CAAA;AAED,eAAO,MAAM,WAAW,GACtB,QAAQ,YAAY,EAAE,EACtB,YAAY,YAAY,EACxB,WAAW,yBAAyB,EACpC,MAAM,gBAAgB,GAAG,iBAAiB,KACzC,iBAgEF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,SAAS,GACpB,WAAW,yBAAyB,EACpC,MAAM,gBAAgB,GAAG,iBAAiB,KACzC,OAAO,CAAC,iBAAiB,CAwB3B,CAAA"}

package/dist/search-index/index.js

@@ -0,0 +1,123 @@
+import { embedBatch, embedImage } from '../embedding/embed.js';
+import { segmentImage } from '../segmentation/segment.js';
+const DIR_NAME = '.visual-search';
+const INDEX_FILE = 'index.json';
+const EMBED_FILE = 'embeddings.bin';
+export const EMBEDDING_DIM = 512;
+const nearestNeighbours = (query, embeddings, images, topK = 20) => {
+    const results = [];
+    for (const img of images) {
+        for (const seg of img.segments) {
+            const offset = seg.embeddingRow * EMBEDDING_DIM;
+            let score = 0;
+            for (let k = 0; k < EMBEDDING_DIM; k++)
+                score += query[k] * embeddings[offset + k];
+            results.push({ imageId: img.imageId, bbox: seg.bbox, area: seg.area, score });
+        }
+    }
+    return results
+        .sort((a, b) => b.score - a.score)
+        .slice(0, topK);
+};
+const appendEmbeddings = (current, toAdd) => {
+    const totalFloats = current.length + toAdd.reduce((n, c) => n + c.length, 0);
+    const next = new Float32Array(totalFloats);
+    next.set(current, 0);
+    let offset = current.length;
+    for (const chunk of toAdd) {
+        next.set(chunk, offset);
+        offset += chunk.length;
+    }
+    return next;
+};
+export const indexExists = async (dirHandle) => {
+    try {
+        const vsDir = await dirHandle.getDirectoryHandle(DIR_NAME);
+        await vsDir.getFileHandle(INDEX_FILE);
+        await vsDir.getFileHandle(EMBED_FILE);
+        return true;
+    }
+    catch (err) {
+        if (err instanceof DOMException && err.name === 'NotFoundError') {
+            return false;
+        }
+        throw err; // re-throw unexpected errors (e.g. SecurityError, TypeError)
+    }
+};
+export const createIndex = (images, embeddings, dirHandle, opts) => {
+    const imageMap = new Map(images.map(img => [img.imageId, img]));
+    let _embeddings = embeddings;
+    return {
+        dirHandle,
+        images,
+        get embeddings() { return _embeddings; },
+        async addToIndex(image, id) {
+            if (!('segmenterUrl' in opts))
+                throw new Error('addToIndex requires a segmenter model');
+            const detections = await segmentImage(image, opts);
+            const bitmap = await createImageBitmap(image);
+            const vecs = await embedBatch(bitmap, detections.map(d => d.bbox), opts);
+            bitmap.close();
+            const nextRow = _embeddings.length / EMBEDDING_DIM;
+            const segments = detections.map((det, j) => ({
+                bbox: det.bbox,
+                area: det.area,
+                embeddingRow: nextRow + j
+            }));
+            images.push({
+                imageId: id,
+                indexedAt: new Date().toISOString(),
+                segments
+            });
+            _embeddings = appendEmbeddings(_embeddings, vecs);
+        },
+        getImage(imageId) {
+            return imageMap.get(imageId);
+        },
+        async query(file, bbox, options) {
+            const queryEmbedding = await embedImage(file, bbox, {
+                embedderUrl: opts.embedderUrl,
+                executionProviders: opts.executionProviders,
+            });
+            return nearestNeighbours(queryEmbedding, _embeddings, images, options?.topK);
+        },
+        async save() {
+            const vsDir = await dirHandle.getDirectoryHandle(DIR_NAME, { create: true });
+            const jsonHandle = await vsDir.getFileHandle('index.json', { create: true });
+            const jsonWriter = await jsonHandle.createWritable();
+            await jsonWriter.write(JSON.stringify({ version: 1, updatedAt: new Date().toISOString(), images }, null, 2));
+            await jsonWriter.close();
+            const binHandle = await vsDir.getFileHandle('embeddings.bin', { create: true });
+            const binWriter = await binHandle.createWritable();
+            await binWriter.write(_embeddings.buffer);
+            await binWriter.close();
+        }
+    };
+};
+/**
+ * Load an existing visual search index from a directory handle.
+ * @param dirHandle The directory handle containing index.json and embeddings.bin
+ * @returns The loaded index
+ */
+export const openIndex = async (dirHandle, opts) => {
+    if (!await indexExists(dirHandle)) {
+        if (opts.create)
+            return createIndex([], new Float32Array(0), dirHandle, opts);
+        throw new Error(`No index found in directory`);
+    }
+    const vsDir = await dirHandle.getDirectoryHandle(DIR_NAME);
+    const jsonHandle = await vsDir.getFileHandle(INDEX_FILE);
+    const jsonFile = await jsonHandle.getFile();
+    const jsonText = await jsonFile.text();
+    const { images } = JSON.parse(jsonText);
+    const binHandle = await vsDir.getFileHandle(EMBED_FILE);
+    const binFile = await binHandle.getFile();
+    const binBuffer = await binFile.arrayBuffer();
+    const embeddings = new Float32Array(binBuffer);
+    // Validate length
+    const totalSegments = images.reduce((n, img) => n + img.segments.length, 0);
+    if (embeddings.length !== totalSegments * EMBEDDING_DIM)
+        throw new Error(`embeddings.bin length mismatch: expected ${totalSegments * EMBEDDING_DIM}, got ${embeddings.length}`);
+    return createIndex(images, embeddings, dirHandle, opts);
+};
+//# sourceMappingURL=index.js.map

package/dist/search-index/index.js.map

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

package/dist/types.d.ts

@@ -15,11 +15,13 @@ export interface IndexedImage {
     segments: IndexedImageSegment[];
 }
 export interface VisualSearchIndex {
+    readonly dirHandle: FileSystemDirectoryHandle;
     readonly images: ReadonlyArray<IndexedImage>;
     readonly embeddings: Float32Array;
-    readonly dirHandle: FileSystemDirectoryHandle;
-    query(file: File, bbox?: BBox, options?: SearchOptions): Promise<SearchResult[]>;
+    addToIndex(image: File, id: string): Promise<void>;
     getImage(imageId: string): IndexedImage | undefined;
+    query(file: File, bbox?: BBox, options?: SearchOptions): Promise<SearchResult[]>;
+    save(): Promise<void>;
 }
 export interface SearchOptions {
     topK?: number;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEpD,MAAM,WAAW,OAAO;IAEtB,IAAI,EAAE,IAAI,CAAC;IAEX,IAAI,EAAE,MAAM,CAAC;IAEb,SAAS,EAAE,YAAY,CAAC;CAEzB;AAED,MAAM,WAAW,mBAAmB;IAElC,IAAI,EAAE,IAAI,CAAC;IAEX,IAAI,EAAE,MAAM,CAAC;IAEb,YAAY,EAAE,MAAM,CAAC;CAEtB;AAED,MAAM,WAAW,YAAY;IAE3B,OAAO,EAAE,MAAM,CAAC;IAEhB,SAAS,EAAE,MAAM,CAAC;IAElB,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CAEjC;AAED,MAAM,WAAW,iBAAiB;IAEhC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IAE7C,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC;IAElC,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;IAE9C,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAEjF,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;CAErD;AAED,MAAM,WAAW,aAAa;IAE5B,IAAI,CAAC,EAAE,MAAM,CAAC;CAEf;AAED,MAAM,WAAW,YAAY;IAE3B,OAAO,EAAE,MAAM,CAAC;IAEhB,IAAI,EAAE,IAAI,CAAC;IAEX,IAAI,EAAE,MAAM,CAAC;IAEb,KAAK,EAAE,MAAM,CAAC;CAEf"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEpD,MAAM,WAAW,OAAO;IAEtB,IAAI,EAAE,IAAI,CAAC;IAEX,IAAI,EAAE,MAAM,CAAC;IAEb,SAAS,EAAE,YAAY,CAAC;CAEzB;AAED,MAAM,WAAW,mBAAmB;IAElC,IAAI,EAAE,IAAI,CAAC;IAEX,IAAI,EAAE,MAAM,CAAC;IAEb,YAAY,EAAE,MAAM,CAAC;CAEtB;AAED,MAAM,WAAW,YAAY;IAE3B,OAAO,EAAE,MAAM,CAAC;IAEhB,SAAS,EAAE,MAAM,CAAC;IAElB,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CAEjC;AAED,MAAM,WAAW,iBAAiB;IAEhC,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;IAE9C,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IAE7C,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC;IAElC,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IAEpD,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAEjF,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAEvB;AAED,MAAM,WAAW,aAAa;IAE5B,IAAI,CAAC,EAAE,MAAM,CAAC;CAEf;AAED,MAAM,WAAW,YAAY;IAE3B,OAAO,EAAE,MAAM,CAAC;IAEhB,IAAI,EAAE,IAAI,CAAC;IAEX,IAAI,EAAE,MAAM,CAAC;IAEb,KAAK,EAAE,MAAM,CAAC;CAEf"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browser-visual-search",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "In-browser visual search powered by FastSAM, CLIP and onnxruntime-web.",
   "type": "module",
   "sideEffects": false,