repoimage 0.2.0

package/docs/features/session.md

@@ -0,0 +1,64 @@
+# Browser Session Persistence
+
+RepoImage remembers your session state between browser visits, so you can pick up where you left off.
+
+## What Gets Saved
+
+**Automatically saved in localStorage:**
+
+1. **Current working directory** — The folder path you're scanning
+2. **Exclude preference** — Whether "Exclude common folders" is enabled
+3. **Scan results cache** — The images from your last scan
+
+## What Happens When You Return
+
+When you reload the page or come back later:
+
+1. Your last folder path is restored in the input field
+2. The exclude preference is restored (checked or unchecked)
+3. If you had recent scan results, they appear in the table (no need to re-scan immediately)
+
+Example:
+
+```
+Session 1: Open RepoImage
+  → Enter /home/user/my-project
+  → Toggle "Exclude common folders" ON
+  → Scan, get 42 images
+  → Close browser
+
+Session 2: Open RepoImage again
+  → Folder input shows: /home/user/my-project
+  → "Exclude common folders" is ON
+  → Table shows: 42 cached images (from previous scan)
+  → Click "Browse" or press Enter to re-scan if needed
+```
+
+## Cache Invalidation
+
+The **scan results cache is optional and not guaranteed**:
+
+- If the folder has changed, results may be stale (re-scan to refresh)
+- If you switch projects, old cache is overwritten
+- If you clear browser data/storage, cache is lost
+
+The cache is a **convenience only** — always re-scan if you need current data.
+
+## Clearing All Data
+
+To clear all saved session state (folder, preferences, cache):
+
+1. Click the ⚙️ (gear) icon in the top-right
+2. Click "Clear all data"
+3. Confirm the alert
+
+All localStorage is wiped, and the UI resets to defaults.
+
+## Technical Details
+
+- **Storage:** Browser localStorage (persists across sessions)
+- **Scope:** Per origin (domain + protocol + port)
+- **Lifetime:** Persists until manually cleared or browser data is deleted
+- **Size:** Minimal (folder path ~200 bytes, preferences ~5 bytes, images vary)
+
+If you use private/incognito mode, localStorage is cleared when the window closes.

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "repoimage",
+  "version": "0.2.0",
+  "description": "Scan a repository for image files and estimate compression quality",
+  "workspaces": [
+    "shared",
+    "server",
+    "client"
+  ],
+  "bin": {
+    "repoimage": "./server/dist/cli.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yourappdotie/repoimage/"
+  },
+  "scripts": {
+    "build": "npm run build -w @repoimage/shared && npm run build -w @repoimage/server && npm run build -w @repoimage/client",
+    "dev": "concurrently -n server,client -c blue,green \"npm run dev -w @repoimage/server\" \"npm run dev -w @repoimage/client\"",
+    "gui": "npm run build && npm run start -w @repoimage/server",
+    "start": "node server/dist/cli.js",
+    "test": "npm run build -w @repoimage/shared && npm run build -w @repoimage/server && node --test test/*.test.js"
+  },
+  "devDependencies": {
+    "concurrently": "^9.1.2",
+    "typescript": "^5.7.2"
+  },
+  "keywords": [
+    "images",
+    "file-finder",
+    "directory-walker",
+    "compression",
+    "optimization"
+  ],
+  "author": "Ger O'Connell <info@levelhead.ie>",
+  "license": "MIT"
+}

package/server/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/server/dist/cli.d.ts.map

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

package/server/dist/cli.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const scan_1 = require("./scan");
+const args = process.argv.slice(2);
+const jsonMode = args.includes('--json');
+const sortByScore = args.includes('--sort-by-score');
+const folders = args.filter(arg => !arg.startsWith('--'));
+if (folders.length === 0) {
+    const usage = 'Usage: repoimage [--json] [--sort-by-score] <folder1> [folder2] ...\n' +
+        'Example: repoimage --json /path/to/repo\n' +
+        '         repoimage --sort-by-score /path/to/Pictures';
+    if (jsonMode) {
+        process.stderr.write(`${usage}\n`);
+    }
+    else {
+        console.log(usage);
+    }
+    process.exit(1);
+}
+let { images, issues } = (0, scan_1.findImagesInFolders)(folders, { verbose: !jsonMode });
+if (sortByScore) {
+    images = (0, scan_1.sortByCompressionScore)(images);
+}
+if (jsonMode) {
+    process.stdout.write(JSON.stringify({ images, issues }));
+    process.stdout.write('\n');
+    process.exit(0);
+}
+if (issues.length) {
+    for (const issue of issues) {
+        console.error(issue.message);
+    }
+    if (issues.some(i => i.code === 'MISSING_FOLDER')) {
+        console.error('');
+    }
+}
+function formatFileSize(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const k = 1024;
+    const sizes = ['B', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return `${parseFloat((bytes / k ** i).toFixed(2))} ${sizes[i]}`;
+}
+console.log(`\nFound ${images.length} images:`);
+images.forEach((image, index) => {
+    const dimensions = image.width && image.height ? `${image.width}x${image.height}` : 'unknown';
+    const compression = image.compressionRatio ? `${image.compressionRatio}/10` : 'N/A';
+    console.log(`${index + 1}. ${image.path} (${formatFileSize(image.size)}, ${dimensions}, compression: ${compression})`);
+});
+const totalSize = images.reduce((sum, image) => sum + image.size, 0);
+console.log(`\nTotal: ${images.length} images found (${formatFileSize(totalSize)})`);
+//# sourceMappingURL=cli.js.map

package/server/dist/cli.js.map

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

package/server/dist/fs-list.d.ts

@@ -0,0 +1,3 @@
+import type { FsListResult } from '@repoimage/shared';
+export declare function listDirectory(inputPath: string): FsListResult;
+//# sourceMappingURL=fs-list.d.ts.map

package/server/dist/fs-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-list.d.ts","sourceRoot":"","sources":["../src/fs-list.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,mBAAmB,CAAC;AASnE,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,CA0D7D"}

package/server/dist/fs-list.js

@@ -0,0 +1,73 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listDirectory = listDirectory;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+function typeFromDirent(d) {
+    if (d.isSymbolicLink())
+        return 'symlink';
+    if (d.isDirectory())
+        return 'directory';
+    if (d.isFile())
+        return 'file';
+    return 'other';
+}
+function listDirectory(inputPath) {
+    const resolved = path_1.default.resolve(inputPath);
+    if (!fs_1.default.existsSync(resolved)) {
+        return { error: 'ENOENT', message: `Path not found: ${resolved}` };
+    }
+    let st;
+    try {
+        st = fs_1.default.statSync(resolved);
+    }
+    catch (e) {
+        return {
+            error: 'ESTAT',
+            message: e instanceof Error ? e.message : String(e)
+        };
+    }
+    if (!st.isDirectory()) {
+        return { error: 'ENOTDIR', message: `Not a directory: ${resolved}` };
+    }
+    let dirents;
+    try {
+        dirents = fs_1.default.readdirSync(resolved, { withFileTypes: true });
+    }
+    catch (e) {
+        return {
+            error: 'EACCES',
+            message: e instanceof Error ? e.message : String(e)
+        };
+    }
+    const entries = dirents.map(d => {
+        const name = d.name;
+        const fullPath = path_1.default.join(resolved, name);
+        return {
+            name,
+            path: fullPath.split(path_1.default.sep).join('/'),
+            type: typeFromDirent(d)
+        };
+    });
+    entries.sort((a, b) => {
+        const order = {
+            directory: 0,
+            symlink: 1,
+            file: 2,
+            other: 3
+        };
+        const oa = order[a.type] ?? 3;
+        const ob = order[b.type] ?? 3;
+        if (oa !== ob)
+            return oa - ob;
+        return a.name.localeCompare(b.name, undefined, { sensitivity: 'base' });
+    });
+    return {
+        path: resolved.split(path_1.default.sep).join('/'),
+        entries
+    };
+}
+//# sourceMappingURL=fs-list.js.map

package/server/dist/fs-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-list.js","sourceRoot":"","sources":["../src/fs-list.ts"],"names":[],"mappings":";;;;;AAWA,sCA0DC;AArED,4CAAoB;AACpB,gDAAwB;AAGxB,SAAS,cAAc,CAAC,CAAY;IAClC,IAAI,CAAC,CAAC,cAAc,EAAE;QAAE,OAAO,SAAS,CAAC;IACzC,IAAI,CAAC,CAAC,WAAW,EAAE;QAAE,OAAO,WAAW,CAAC;IACxC,IAAI,CAAC,CAAC,MAAM,EAAE;QAAE,OAAO,MAAM,CAAC;IAC9B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAgB,aAAa,CAAC,SAAiB;IAC7C,MAAM,QAAQ,GAAG,cAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEzC,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,mBAAmB,QAAQ,EAAE,EAAE,CAAC;IACrE,CAAC;IAED,IAAI,EAAY,CAAC;IACjB,IAAI,CAAC;QACH,EAAE,GAAG,YAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO;YACL,KAAK,EAAE,OAAO;YACd,OAAO,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;SACpD,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;QACtB,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,oBAAoB,QAAQ,EAAE,EAAE,CAAC;IACvE,CAAC;IAED,IAAI,OAAoB,CAAC;IACzB,IAAI,CAAC;QACH,OAAO,GAAG,YAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO;YACL,KAAK,EAAE,QAAQ;YACf,OAAO,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;SACpD,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAkB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QAC7C,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;QACpB,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC3C,OAAO;YACL,IAAI;YACJ,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,cAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;YACxC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC;SACxB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACpB,MAAM,KAAK,GAAwC;YACjD,SAAS,EAAE,CAAC;YACZ,OAAO,EAAE,CAAC;YACV,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,CAAC;SACT,CAAC;QACF,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO,EAAE,GAAG,EAAE,CAAC;QAC9B,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,cAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QACxC,OAAO;KACR,CAAC;AACJ,CAAC"}

package/server/dist/paths.d.ts

@@ -0,0 +1,3 @@
+/** Default production client bundle: `client/dist` from repo root. */
+export declare function defaultClientRoot(): string;
+//# sourceMappingURL=paths.d.ts.map

package/server/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAEA,sEAAsE;AACtE,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}

package/server/dist/paths.js

@@ -0,0 +1,12 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultClientRoot = defaultClientRoot;
+const path_1 = __importDefault(require("path"));
+/** Default production client bundle: `client/dist` from repo root. */
+function defaultClientRoot() {
+    return path_1.default.resolve(__dirname, '../../client/dist');
+}
+//# sourceMappingURL=paths.js.map

package/server/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":";;;;;AAGA,8CAEC;AALD,gDAAwB;AAExB,sEAAsE;AACtE,SAAgB,iBAAiB;IAC/B,OAAO,cAAI,CAAC,OAAO,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;AACtD,CAAC"}

package/server/dist/scan.d.ts

@@ -0,0 +1,16 @@
+import { IMAGE_EXTENSIONS, type ImageRow, type RawImageEntry, type ScanIssue } from '@repoimage/shared';
+export { IMAGE_EXTENSIONS };
+export declare function computeCompressionFields(ext: string, fileSize: number, width: number | null | undefined, height: number | null | undefined): {
+    uncompressedSize: number | null;
+    compressionRatio: string | null;
+};
+export declare function enrichImageEntry(entry: RawImageEntry): ImageRow | null;
+export declare function findImagesInFolders(folders: string[], options?: {
+    verbose?: boolean;
+    excludeCommon?: boolean;
+}): {
+    images: ImageRow[];
+    issues: ScanIssue[];
+};
+export declare function sortByCompressionScore(images: ImageRow[]): ImageRow[];
+//# sourceMappingURL=scan.d.ts.map

package/server/dist/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../src/scan.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,gBAAgB,EAGhB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,SAAS,EACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAE5B,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAChC;IAAE,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAatE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,QAAQ,GAAG,IAAI,CA8CtE;AAyED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3D;IAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAAC,MAAM,EAAE,SAAS,EAAE,CAAA;CAAE,CAsC7C;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAMrE"}

package/server/dist/scan.js

@@ -0,0 +1,158 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IMAGE_EXTENSIONS = void 0;
+exports.computeCompressionFields = computeCompressionFields;
+exports.enrichImageEntry = enrichImageEntry;
+exports.findImagesInFolders = findImagesInFolders;
+exports.sortByCompressionScore = sortByCompressionScore;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const image_size_1 = __importDefault(require("image-size"));
+const shared_1 = require("@repoimage/shared");
+Object.defineProperty(exports, "IMAGE_EXTENSIONS", { enumerable: true, get: function () { return shared_1.IMAGE_EXTENSIONS; } });
+function computeCompressionFields(ext, fileSize, width, height) {
+    let uncompressedSize = null;
+    let compressionRatio = null;
+    if (width && height && !['.svg'].includes(ext)) {
+        const bytesPerPixel = ['.png', '.gif'].includes(ext) ? 4 : 3;
+        uncompressedSize = width * height * bytesPerPixel;
+        const linearRatio = fileSize / uncompressedSize;
+        const logScore = Math.max(0, Math.min(10, -Math.log2(linearRatio)));
+        compressionRatio = logScore.toFixed(1);
+    }
+    return { uncompressedSize, compressionRatio };
+}
+function enrichImageEntry(entry) {
+    const relativePath = String(entry.path || '').replace(/\\/g, '/').trim();
+    if (!relativePath || relativePath.split('/').includes('..')) {
+        return null;
+    }
+    const size = Number(entry.size);
+    if (!Number.isFinite(size) || size < 0) {
+        return null;
+    }
+    let width = entry.width != null ? Number(entry.width) : null;
+    let height = entry.height != null ? Number(entry.height) : null;
+    if (!Number.isFinite(width))
+        width = null;
+    if (!Number.isFinite(height))
+        height = null;
+    const ext = path_1.default.extname(relativePath).toLowerCase();
+    const { uncompressedSize, compressionRatio } = computeCompressionFields(ext, size, width, height);
+    const { roleGuess, roleGuessReason } = (0, shared_1.guessRole)({
+        path: relativePath,
+        size,
+        width,
+        height
+    });
+    const row = {
+        path: relativePath,
+        size: Math.round(size),
+        width,
+        height,
+        uncompressedSize,
+        compressionRatio,
+        role: null,
+        roleGuess
+    };
+    if (roleGuessReason) {
+        row.roleGuessReason = roleGuessReason;
+    }
+    return row;
+}
+function isImageFile(filename) {
+    const ext = path_1.default.extname(filename).toLowerCase();
+    return shared_1.IMAGE_EXTENSIONS.includes(ext);
+}
+function shouldExcludePath(dirName, excludeCommon) {
+    if (!excludeCommon) {
+        return false;
+    }
+    return shared_1.COMMON_EXCLUDE_PATHS.includes(dirName);
+}
+function walkDirectory(dirPath, imageFiles, ctx) {
+    try {
+        const items = fs_1.default.readdirSync(dirPath);
+        for (const item of items) {
+            const fullPath = path_1.default.join(dirPath, item);
+            const stat = fs_1.default.statSync(fullPath);
+            if (stat.isDirectory()) {
+                if (!shouldExcludePath(item, ctx.excludeCommon)) {
+                    walkDirectory(fullPath, imageFiles, ctx);
+                }
+            }
+            else if (stat.isFile() && isImageFile(item)) {
+                try {
+                    const dimensions = (0, image_size_1.default)(fullPath);
+                    imageFiles.push({
+                        path: fullPath,
+                        size: stat.size,
+                        width: dimensions.width ?? null,
+                        height: dimensions.height ?? null
+                    });
+                }
+                catch {
+                    imageFiles.push({
+                        path: fullPath,
+                        size: stat.size,
+                        width: null,
+                        height: null
+                    });
+                }
+            }
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        ctx.issues.push({ code: 'DIR_READ_ERROR', path: dirPath, message });
+        if (ctx.verbose) {
+            console.error(`Error reading directory ${dirPath}:`, message);
+        }
+    }
+    return imageFiles;
+}
+function findImagesInFolders(folders, options = {}) {
+    const verbose = Boolean(options.verbose);
+    const excludeCommon = Boolean(options.excludeCommon);
+    const issues = [];
+    const ctx = { issues, verbose, excludeCommon };
+    const allImages = [];
+    for (const folder of folders) {
+        if (!fs_1.default.existsSync(folder)) {
+            const message = `Folder does not exist: ${folder}`;
+            issues.push({ code: 'MISSING_FOLDER', path: folder, message });
+            if (verbose) {
+                console.error(message);
+            }
+            continue;
+        }
+        if (verbose) {
+            console.log(`Scanning folder: ${folder}`);
+        }
+        const images = walkDirectory(folder, [], ctx);
+        const relativeImages = images
+            .map(image => {
+            const relativePath = path_1.default.relative(folder, image.path).split(path_1.default.sep).join('/');
+            return enrichImageEntry({
+                path: relativePath,
+                size: image.size,
+                width: image.width,
+                height: image.height
+            });
+        })
+            .filter((row) => row != null);
+        allImages.push(...relativeImages);
+    }
+    return { images: allImages, issues };
+}
+function sortByCompressionScore(images) {
+    return [...images].sort((a, b) => {
+        const scoreA = parseFloat(a.compressionRatio ?? '') || 0;
+        const scoreB = parseFloat(b.compressionRatio ?? '') || 0;
+        return scoreB - scoreA;
+    });
+}
+//# sourceMappingURL=scan.js.map

package/server/dist/scan.js.map

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

package/server/dist/server.d.ts

@@ -0,0 +1,6 @@
+import http from 'http';
+export interface RepoimageServerOptions {
+    clientRoot?: string;
+}
+export declare function createRepoimageServer(options?: RepoimageServerOptions): http.Server;
+//# sourceMappingURL=server.d.ts.map

package/server/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAiHxB,MAAM,WAAW,sBAAsB;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,sBAA2B,GAAG,IAAI,CAAC,MAAM,CAiOvF"}