ocr-provenance-mcp 1.0.0

package/dist/utils/backoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backoff.js","sourceRoot":"","sources":["../../src/utils/backoff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAaH,MAAM,eAAe,GAAkB;IACrC,WAAW,EAAE,IAAI;IACjB,UAAU,EAAE,KAAK;IACjB,WAAW,EAAE,CAAC;IACd,cAAc,EAAE,IAAI;CACrB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe,EAAE,MAA+B;IACpF,MAAM,GAAG,GAAG,EAAE,GAAG,eAAe,EAAE,GAAG,MAAM,EAAE,CAAC;IAC9C,MAAM,gBAAgB,GAAG,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAChE,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IAE/D,gCAAgC;IAChC,MAAM,WAAW,GAAG,WAAW,GAAG,GAAG,CAAC,cAAc,CAAC;IACrD,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,WAAW,CAAC;IAErD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,MAA+B;IAC3E,MAAM,KAAK,GAAG,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACrD,OAAO,CAAC,KAAK,CAAC,qBAAqB,OAAO,GAAG,CAAC,aAAa,KAAK,IAAI,CAAC,CAAC;IACtE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,EAAoB,EACpB,WAAwC,EACxC,MAA+B;IAE/B,MAAM,GAAG,GAAG,EAAE,GAAG,eAAe,EAAE,GAAG,MAAM,EAAE,CAAC;IAC9C,IAAI,SAAkB,CAAC;IAEvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QAC3D,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAC;YAClB,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;gBAAE,MAAM,KAAK,CAAC;YACrC,IAAI,OAAO,GAAG,GAAG,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;gBAClC,MAAM,YAAY,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,SAAS,CAAC;AAClB,CAAC"}

package/dist/utils/config-persistence.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Configuration Persistence Utilities
+ *
+ * Handles reading/writing config to the database_metadata table's config_json column.
+ * Separated from tools/config.ts and server/state.ts to avoid circular dependencies.
+ *
+ * CRITICAL: NEVER use console.log() - stdout is JSON-RPC protocol.
+ *
+ * @module utils/config-persistence
+ */
+import type Database from 'better-sqlite3';
+/**
+ * Persist a config value to the database_metadata table's config_json column.
+ *
+ * Idempotently adds the config_json column if it doesn't exist.
+ * Reads existing persisted config, merges the new value, and writes back.
+ *
+ * @param conn - better-sqlite3 Database connection
+ * @param key - Config key name
+ * @param value - Config value to persist
+ */
+export declare function persistConfigValue(conn: Database.Database, key: string, value: string | number | boolean): void;
+/**
+ * Load persisted config from the database_metadata table.
+ *
+ * Called when a database is selected to restore config changes
+ * that were persisted from a previous session.
+ *
+ * @param conn - better-sqlite3 Database connection
+ * @returns Record of persisted config key-value pairs, or empty object
+ */
+export declare function loadPersistedConfig(conn: Database.Database): Record<string, unknown>;
+//# sourceMappingURL=config-persistence.d.ts.map

package/dist/utils/config-persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-persistence.d.ts","sourceRoot":"","sources":["../../src/utils/config-persistence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,QAAQ,CAAC,QAAQ,EACvB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAC/B,IAAI,CAkBN;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,CAAC,QAAQ,GACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBzB"}

package/dist/utils/config-persistence.js

@@ -0,0 +1,61 @@
+/**
+ * Configuration Persistence Utilities
+ *
+ * Handles reading/writing config to the database_metadata table's config_json column.
+ * Separated from tools/config.ts and server/state.ts to avoid circular dependencies.
+ *
+ * CRITICAL: NEVER use console.log() - stdout is JSON-RPC protocol.
+ *
+ * @module utils/config-persistence
+ */
+/**
+ * Persist a config value to the database_metadata table's config_json column.
+ *
+ * Idempotently adds the config_json column if it doesn't exist.
+ * Reads existing persisted config, merges the new value, and writes back.
+ *
+ * @param conn - better-sqlite3 Database connection
+ * @param key - Config key name
+ * @param value - Config value to persist
+ */
+export function persistConfigValue(conn, key, value) {
+    // Ensure config_json column exists (idempotent)
+    const cols = conn.prepare('PRAGMA table_info(database_metadata)').all();
+    if (!cols.some((c) => c.name === 'config_json')) {
+        conn.exec("ALTER TABLE database_metadata ADD COLUMN config_json TEXT DEFAULT '{}'");
+    }
+    // Read existing config, merge, write back
+    const row = conn.prepare('SELECT config_json FROM database_metadata WHERE id = 1').get();
+    const existing = row?.config_json
+        ? JSON.parse(row.config_json)
+        : {};
+    existing[key] = value;
+    conn.prepare('UPDATE database_metadata SET config_json = ? WHERE id = 1').run(JSON.stringify(existing));
+}
+/**
+ * Load persisted config from the database_metadata table.
+ *
+ * Called when a database is selected to restore config changes
+ * that were persisted from a previous session.
+ *
+ * @param conn - better-sqlite3 Database connection
+ * @returns Record of persisted config key-value pairs, or empty object
+ */
+export function loadPersistedConfig(conn) {
+    try {
+        // Check if config_json column exists
+        const cols = conn.prepare('PRAGMA table_info(database_metadata)').all();
+        if (!cols.some((c) => c.name === 'config_json')) {
+            return {};
+        }
+        const row = conn.prepare('SELECT config_json FROM database_metadata WHERE id = 1').get();
+        if (!row?.config_json)
+            return {};
+        return JSON.parse(row.config_json);
+    }
+    catch (error) {
+        console.error(`[config-persistence] Failed to load persisted config: ${error instanceof Error ? error.message : String(error)}`);
+        return {};
+    }
+}
+//# sourceMappingURL=config-persistence.js.map

package/dist/utils/config-persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-persistence.js","sourceRoot":"","sources":["../../src/utils/config-persistence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAuB,EACvB,GAAW,EACX,KAAgC;IAEhC,gDAAgD;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC,GAAG,EAA6B,CAAC;IACnG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAC;IACtF,CAAC;IAED,0CAA0C;IAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,wDAAwD,CAAC,CAAC,GAAG,EAEzE,CAAC;IACd,MAAM,QAAQ,GAA4B,GAAG,EAAE,WAAW;QACxD,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAA6B;QAC1D,CAAC,CAAC,EAAE,CAAC;IACP,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACtB,IAAI,CAAC,OAAO,CAAC,2DAA2D,CAAC,CAAC,GAAG,CAC3E,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CACzB,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAuB;IAEvB,IAAI,CAAC;QACH,qCAAqC;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC,GAAG,EAA6B,CAAC;QACnG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,EAAE,CAAC;YAChD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,wDAAwD,CAAC,CAAC,GAAG,EAEzE,CAAC;QAEd,IAAI,CAAC,GAAG,EAAE,WAAW;YAAE,OAAO,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAA4B,CAAC;IAChE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CACX,yDAAyD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAClH,CAAC;QACF,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/utils/hash.d.ts

@@ -0,0 +1,65 @@
+/**
+ * SHA-256 Hash Utilities for Provenance Integrity Verification
+ *
+ * This module provides cryptographic hashing functions for the OCR Provenance MCP System.
+ * All hashes use the format: 'sha256:' + 64-character lowercase hex string.
+ *
+ * @module utils/hash
+ * @see CS-PROV-002 Hash Computation standard in constitution.md
+ */
+/**
+ * Compute SHA-256 hash of content
+ *
+ * @param content - String or Buffer to hash
+ * @returns Hash in format 'sha256:' + 64-char lowercase hex string
+ * @example
+ * computeHash('hello')
+ * // Returns: 'sha256:2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824'
+ *
+ * @example
+ * computeHash(Buffer.from([0x01, 0x02, 0x03]))
+ * // Returns: 'sha256:039058c6f2c0cb492c533b0a4d14ef77cc0f78abccced5287d84a1a2011cfb81'
+ */
+export declare function computeHash(content: string | Buffer): string;
+/**
+ * Compute SHA-256 hash of a file using streaming (memory efficient)
+ *
+ * This function reads the file in chunks using a stream, making it suitable
+ * for hashing large files without loading them entirely into memory.
+ *
+ * @param filePath - Absolute path to file
+ * @returns Promise resolving to hash in format 'sha256:' + 64-char hex string
+ * @throws Error if file doesn't exist, path is not absolute, or can't be read
+ *
+ * @example
+ * const hash = await hashFile('/path/to/document.pdf');
+ * // Returns: 'sha256:...'
+ */
+export declare function hashFile(filePath: string): Promise<string>;
+/**
+ * Compute SHA-256 hash of a file synchronously using chunked reads.
+ *
+ * Reads the file in 64KB chunks to avoid loading the entire file into memory.
+ * Suitable for hashing large image files during batch processing.
+ *
+ * @param filePath - Path to the file to hash
+ * @returns Hash in format 'sha256:' + 64-char lowercase hex string
+ * @throws Error if file cannot be read
+ */
+export declare function computeFileHashSync(filePath: string): string;
+/**
+ * Validate hash format is correct
+ *
+ * @param hash - Hash string to validate
+ * @returns true if format is 'sha256:' + 64 lowercase hex chars, false otherwise
+ *
+ * @example
+ * isValidHashFormat('sha256:2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824')
+ * // Returns: true
+ *
+ * @example
+ * isValidHashFormat('sha256:ABC123') // Wrong length, uppercase
+ * // Returns: false
+ */
+export declare function isValidHashFormat(hash: string): boolean;
+//# sourceMappingURL=hash.d.ts.map

package/dist/utils/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiBH;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAI5D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiDhE;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAc5D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKvD"}

package/dist/utils/hash.js

@@ -0,0 +1,146 @@
+/**
+ * SHA-256 Hash Utilities for Provenance Integrity Verification
+ *
+ * This module provides cryptographic hashing functions for the OCR Provenance MCP System.
+ * All hashes use the format: 'sha256:' + 64-character lowercase hex string.
+ *
+ * @module utils/hash
+ * @see CS-PROV-002 Hash Computation standard in constitution.md
+ */
+import crypto from 'crypto';
+import fs from 'fs';
+import path from 'path';
+/**
+ * Hash prefix used for all SHA-256 hashes in this system
+ */
+const HASH_PREFIX = 'sha256:';
+/**
+ * Regular expression for validating hash format
+ * Matches: 'sha256:' followed by exactly 64 lowercase hex characters
+ */
+const HASH_PATTERN = /^sha256:[a-f0-9]{64}$/;
+/**
+ * Compute SHA-256 hash of content
+ *
+ * @param content - String or Buffer to hash
+ * @returns Hash in format 'sha256:' + 64-char lowercase hex string
+ * @example
+ * computeHash('hello')
+ * // Returns: 'sha256:2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824'
+ *
+ * @example
+ * computeHash(Buffer.from([0x01, 0x02, 0x03]))
+ * // Returns: 'sha256:039058c6f2c0cb492c533b0a4d14ef77cc0f78abccced5287d84a1a2011cfb81'
+ */
+export function computeHash(content) {
+    const hash = crypto.createHash('sha256').update(content).digest('hex');
+    return HASH_PREFIX + hash;
+}
+/**
+ * Compute SHA-256 hash of a file using streaming (memory efficient)
+ *
+ * This function reads the file in chunks using a stream, making it suitable
+ * for hashing large files without loading them entirely into memory.
+ *
+ * @param filePath - Absolute path to file
+ * @returns Promise resolving to hash in format 'sha256:' + 64-char hex string
+ * @throws Error if file doesn't exist, path is not absolute, or can't be read
+ *
+ * @example
+ * const hash = await hashFile('/path/to/document.pdf');
+ * // Returns: 'sha256:...'
+ */
+export async function hashFile(filePath) {
+    // Validate path is absolute
+    if (!path.isAbsolute(filePath)) {
+        throw new Error(`Path must be absolute: ${filePath}`);
+    }
+    // Check file exists and is accessible
+    try {
+        await fs.promises.access(filePath, fs.constants.R_OK);
+    }
+    catch (error) {
+        const fsError = error;
+        if (fsError.code === 'ENOENT') {
+            throw new Error(`File not found: ${filePath}`);
+        }
+        if (fsError.code === 'EACCES') {
+            throw new Error(`Permission denied: ${filePath}`);
+        }
+        throw new Error(`Cannot access file: ${filePath} - ${fsError.message}`);
+    }
+    // Verify it's a file, not a directory
+    const stats = await fs.promises.stat(filePath);
+    if (!stats.isFile()) {
+        throw new Error(`Path is not a file: ${filePath}`);
+    }
+    return new Promise((resolve, reject) => {
+        const hash = crypto.createHash('sha256');
+        const stream = fs.createReadStream(filePath);
+        stream.on('data', (chunk) => {
+            hash.update(chunk);
+        });
+        stream.on('end', () => {
+            resolve(HASH_PREFIX + hash.digest('hex'));
+        });
+        stream.on('error', (error) => {
+            stream.destroy();
+            if (error.code === 'ENOENT') {
+                reject(new Error(`File not found: ${filePath}`));
+            }
+            else if (error.code === 'EACCES') {
+                reject(new Error(`Permission denied: ${filePath}`));
+            }
+            else {
+                reject(new Error(`Error reading file: ${filePath} - ${error.message}`));
+            }
+        });
+    });
+}
+/**
+ * Compute SHA-256 hash of a file synchronously using chunked reads.
+ *
+ * Reads the file in 64KB chunks to avoid loading the entire file into memory.
+ * Suitable for hashing large image files during batch processing.
+ *
+ * @param filePath - Path to the file to hash
+ * @returns Hash in format 'sha256:' + 64-char lowercase hex string
+ * @throws Error if file cannot be read
+ */
+export function computeFileHashSync(filePath) {
+    const CHUNK_SIZE = 65536; // 64KB chunks
+    const hash = crypto.createHash('sha256');
+    const fd = fs.openSync(filePath, 'r');
+    try {
+        const buffer = Buffer.allocUnsafe(CHUNK_SIZE);
+        let bytesRead;
+        while ((bytesRead = fs.readSync(fd, buffer, 0, CHUNK_SIZE, null)) > 0) {
+            hash.update(bytesRead === CHUNK_SIZE ? buffer : buffer.subarray(0, bytesRead));
+        }
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+    return HASH_PREFIX + hash.digest('hex');
+}
+/**
+ * Validate hash format is correct
+ *
+ * @param hash - Hash string to validate
+ * @returns true if format is 'sha256:' + 64 lowercase hex chars, false otherwise
+ *
+ * @example
+ * isValidHashFormat('sha256:2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824')
+ * // Returns: true
+ *
+ * @example
+ * isValidHashFormat('sha256:ABC123') // Wrong length, uppercase
+ * // Returns: false
+ */
+export function isValidHashFormat(hash) {
+    if (typeof hash !== 'string') {
+        return false;
+    }
+    return HASH_PATTERN.test(hash);
+}
+//# sourceMappingURL=hash.js.map

package/dist/utils/hash.js.map

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

package/dist/utils/math.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Safe math utilities that avoid V8 stack overflow on large arrays.
+ *
+ * Math.min(...arr) / Math.max(...arr) spread every element as a function
+ * argument. V8 has a hard limit of ~65 536 arguments; exceeding it throws
+ * "RangeError: Maximum call stack size exceeded". These iterative helpers
+ * work on arrays of any length.
+ */
+/**
+ * Return the minimum value in a numeric array (iterative, no spread).
+ * Returns `undefined` when the array is empty so callers can provide
+ * their own fallback via `?? defaultValue`.
+ */
+export declare function safeMin(arr: number[]): number | undefined;
+/**
+ * Return the maximum value in a numeric array (iterative, no spread).
+ * Returns `undefined` when the array is empty so callers can provide
+ * their own fallback via `?? defaultValue`.
+ */
+export declare function safeMax(arr: number[]): number | undefined;
+//# sourceMappingURL=math.d.ts.map

package/dist/utils/math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../src/utils/math.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAOzD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAOzD"}

package/dist/utils/math.js

@@ -0,0 +1,39 @@
+/**
+ * Safe math utilities that avoid V8 stack overflow on large arrays.
+ *
+ * Math.min(...arr) / Math.max(...arr) spread every element as a function
+ * argument. V8 has a hard limit of ~65 536 arguments; exceeding it throws
+ * "RangeError: Maximum call stack size exceeded". These iterative helpers
+ * work on arrays of any length.
+ */
+/**
+ * Return the minimum value in a numeric array (iterative, no spread).
+ * Returns `undefined` when the array is empty so callers can provide
+ * their own fallback via `?? defaultValue`.
+ */
+export function safeMin(arr) {
+    if (arr.length === 0)
+        return undefined;
+    let min = arr[0];
+    for (let i = 1; i < arr.length; i++) {
+        if (arr[i] < min)
+            min = arr[i];
+    }
+    return min;
+}
+/**
+ * Return the maximum value in a numeric array (iterative, no spread).
+ * Returns `undefined` when the array is empty so callers can provide
+ * their own fallback via `?? defaultValue`.
+ */
+export function safeMax(arr) {
+    if (arr.length === 0)
+        return undefined;
+    let max = arr[0];
+    for (let i = 1; i < arr.length; i++) {
+        if (arr[i] > max)
+            max = arr[i];
+    }
+    return max;
+}
+//# sourceMappingURL=math.js.map

package/dist/utils/math.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.js","sourceRoot":"","sources":["../../src/utils/math.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,GAAa;IACnC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACvC,IAAI,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG;YAAE,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,GAAa;IACnC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACvC,IAAI,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG;YAAE,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}