@monoes/monobrowse 1.0.2 → 1.0.3

package/dist/src/__tests__/output.test.d.ts

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

package/dist/src/__tests__/output.test.d.ts.map

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

package/dist/src/__tests__/output.test.js

@@ -0,0 +1,54 @@
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+// The module exports a singleton `output` which reads process.stdout.isTTY at
+// construction time. We need to control that, so we reset modules per test.
+async function importOutput(isTTY) {
+    vi.resetModules();
+    // Stub isTTY before the module loads
+    Object.defineProperty(process.stdout, 'isTTY', { value: isTTY, configurable: true });
+    return import('../cli/output.js');
+}
+describe('OutputFormatter', () => {
+    beforeEach(() => {
+        vi.spyOn(console, 'log').mockImplementation(() => { });
+        vi.spyOn(console, 'error').mockImplementation(() => { });
+        vi.spyOn(console, 'warn').mockImplementation(() => { });
+    });
+    it('printSuccess calls console.log with the message', async () => {
+        const { output } = await importOutput(false);
+        output.printSuccess('done');
+        expect(console.log).toHaveBeenCalledOnce();
+        expect(console.log.mock.calls[0][0]).toContain('done');
+    });
+    it('printError calls console.error with the message and optional details', async () => {
+        const { output } = await importOutput(false);
+        output.printError('fail', 'reason');
+        expect(console.error).toHaveBeenCalledTimes(2);
+        expect(console.error.mock.calls[0][0]).toContain('fail');
+        expect(console.error.mock.calls[1][0]).toContain('reason');
+    });
+    it('printWarning calls console.warn', async () => {
+        const { output } = await importOutput(false);
+        output.printWarning('careful');
+        expect(console.warn).toHaveBeenCalledOnce();
+        expect(console.warn.mock.calls[0][0]).toContain('careful');
+    });
+    it('printInfo calls console.log with info prefix', async () => {
+        const { output } = await importOutput(false);
+        output.printInfo('note');
+        expect(console.log).toHaveBeenCalledOnce();
+        expect(console.log.mock.calls[0][0]).toContain('note');
+    });
+    it('with color disabled (non-TTY), output contains no ANSI escape codes', async () => {
+        const { output } = await importOutput(false);
+        output.printSuccess('plain');
+        const logged = console.log.mock.calls[0][0];
+        expect(logged).not.toContain('\x1b[');
+    });
+    it('with color enabled (TTY), output contains ANSI escape codes', async () => {
+        const { output } = await importOutput(true);
+        output.printSuccess('colored');
+        const logged = console.log.mock.calls[0][0];
+        expect(logged).toContain('\x1b[');
+    });
+});
+//# sourceMappingURL=output.test.js.map

package/dist/src/__tests__/output.test.js.map

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

package/dist/src/__tests__/ref-cache.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ref-cache.test.d.ts.map

package/dist/src/__tests__/ref-cache.test.d.ts.map

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

package/dist/src/__tests__/ref-cache.test.js

@@ -0,0 +1,109 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { mkdtemp, readFile, rm, stat } from 'fs/promises';
+import { join } from 'path';
+import { tmpdir } from 'os';
+// We need to mock process.cwd() before importing ref-cache so CACHE_DIR
+// resolves to our temp directory.
+let tempDir;
+beforeEach(async () => {
+    tempDir = await mkdtemp(join(tmpdir(), 'monobrowse-test-'));
+    vi.spyOn(process, 'cwd').mockReturnValue(tempDir);
+});
+afterEach(async () => {
+    vi.restoreAllMocks();
+    await rm(tempDir, { recursive: true, force: true });
+});
+// Dynamic import so each test picks up the mocked cwd.
+// We must bust the module cache between tests.
+async function importRefCache() {
+    // Vitest module cache means re-import returns the same module.
+    // Since CACHE_DIR is set at module-load time, we need resetModules.
+    vi.resetModules();
+    return import('../browser/ref-cache.js');
+}
+function makeRefs(count = 2) {
+    const map = new Map();
+    for (let i = 1; i <= count; i++) {
+        map.set(`ref${i}`, { ref: `ref${i}`, role: 'button', name: `Button ${i}`, nodeId: i });
+    }
+    return map;
+}
+describe('ref-cache', () => {
+    it('round-trip: save then load returns equivalent data', async () => {
+        const mod = await importRefCache();
+        const refs = makeRefs(2);
+        await mod.saveRefCache('target-1', 'https://example.com', refs);
+        const loaded = await mod.loadRefCache('target-1');
+        expect(loaded).not.toBeNull();
+        expect(loaded.url).toBe('https://example.com');
+        expect(loaded.refs.size).toBe(2);
+        expect(loaded.refs.get('ref1').role).toBe('button');
+        expect(loaded.refs.get('ref2').name).toBe('Button 2');
+        expect(typeof loaded.savedAt).toBe('number');
+        expect(typeof loaded.ageMs).toBe('number');
+    });
+    it('targetId mismatch returns null', async () => {
+        const mod = await importRefCache();
+        const refs = makeRefs(1);
+        await mod.saveRefCache('target-A', 'https://a.com', refs);
+        const loaded = await mod.loadRefCache('target-B');
+        expect(loaded).toBeNull();
+    });
+    it('corrupt JSON file returns null', async () => {
+        const mod = await importRefCache();
+        // First save a valid cache to create the directory structure
+        await mod.saveRefCache('t', 'https://x.com', makeRefs(1));
+        // Now overwrite the file with invalid JSON
+        const cacheFile = join(tempDir, '.monomind', 'monobrowse', 'ax-snapshot.json');
+        const { writeFile: wf } = await import('fs/promises');
+        await wf(cacheFile, '{{{not valid json!!!');
+        const loaded = await mod.loadRefCache('t');
+        expect(loaded).toBeNull();
+    });
+    it('clearRefCache removes the cache file', async () => {
+        const mod = await importRefCache();
+        await mod.saveRefCache('t1', 'https://x.com', makeRefs(1));
+        const cacheFile = join(tempDir, '.monomind', 'monobrowse', 'ax-snapshot.json');
+        // Verify file exists
+        const before = await stat(cacheFile).catch(() => null);
+        expect(before).not.toBeNull();
+        await mod.clearRefCache();
+        const after = await stat(cacheFile).catch(() => null);
+        expect(after).toBeNull();
+    });
+    it('load after clear returns null', async () => {
+        const mod = await importRefCache();
+        await mod.saveRefCache('t1', 'https://x.com', makeRefs(1));
+        await mod.clearRefCache();
+        const loaded = await mod.loadRefCache('t1');
+        expect(loaded).toBeNull();
+    });
+    it('freshly saved cache is not stale', async () => {
+        const mod = await importRefCache();
+        await mod.saveRefCache('t1', 'https://x.com', makeRefs(1));
+        const loaded = await mod.loadRefCache('t1');
+        expect(loaded).not.toBeNull();
+        expect(loaded.stale).toBe(false);
+        expect(loaded.ageMs).toBeLessThan(mod.REF_CACHE_STALE_MS);
+    });
+    it('cache older than REF_CACHE_STALE_MS is flagged stale', async () => {
+        const mod = await importRefCache();
+        await mod.saveRefCache('t1', 'https://x.com', makeRefs(1));
+        // Manually backdate the savedAt timestamp
+        const cacheFile = join(tempDir, '.monomind', 'monobrowse', 'ax-snapshot.json');
+        const raw = JSON.parse(await readFile(cacheFile, 'utf8'));
+        raw.savedAt = Date.now() - mod.REF_CACHE_STALE_MS - 5000;
+        const { writeFile: wf } = await import('fs/promises');
+        await wf(cacheFile, JSON.stringify(raw));
+        const loaded = await mod.loadRefCache('t1');
+        expect(loaded).not.toBeNull();
+        expect(loaded.stale).toBe(true);
+        expect(loaded.ageMs).toBeGreaterThan(mod.REF_CACHE_STALE_MS);
+    });
+    it('loading with no cache file returns null (no crash)', async () => {
+        const mod = await importRefCache();
+        const loaded = await mod.loadRefCache('nonexistent');
+        expect(loaded).toBeNull();
+    });
+});
+//# sourceMappingURL=ref-cache.test.js.map

package/dist/src/__tests__/ref-cache.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-cache.test.js","sourceRoot":"","sources":["../../../src/__tests__/ref-cache.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAE5B,wEAAwE;AACxE,kCAAkC;AAClC,IAAI,OAAe,CAAC;AAEpB,UAAU,CAAC,KAAK,IAAI,EAAE;IACpB,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAC5D,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;AACpD,CAAC,CAAC,CAAC;AAEH,SAAS,CAAC,KAAK,IAAI,EAAE;IACnB,EAAE,CAAC,eAAe,EAAE,CAAC;IACrB,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACtD,CAAC,CAAC,CAAC;AAEH,uDAAuD;AACvD,+CAA+C;AAC/C,KAAK,UAAU,cAAc;IAC3B,+DAA+D;IAC/D,oEAAoE;IACpE,EAAE,CAAC,YAAY,EAAE,CAAC;IAClB,OAAO,MAAM,CAAC,yBAAyB,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,QAAQ,CAAC,KAAK,GAAG,CAAC;IACzB,MAAM,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,GAAG,GAAG,MAAM,cAAc,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAEzB,MAAM,GAAG,CAAC,YAAY,CAAC,UAAU,EAAE,qBAAqB,EAAE,IAAW,CAAC,CAAC;QACvE,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QAElD,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,MAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAChD,MAAM,CAAC,MAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,MAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtD,MAAM,CAAC,MAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACxD,MAAM,CAAC,OAAO,MAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,CAAC,OAAO,MAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;QAC9C,MAAM,GAAG,GAAG,MAAM,cAAc,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAEzB,MAAM,GAAG,CAAC,YAAY,CAAC,UAAU,EAAE,eAAe,EAAE,IAAW,CAAC,CAAC;QACjE,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QAElD,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;QAC9C,MAAM,GAAG,GAAG,MAAM,cAAc,EAAE,CAAC;QACnC,6DAA6D;QAC7D,MAAM,GAAG,CAAC,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAQ,CAAC,CAAC;QAEjE,2CAA2C;QAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,kBAAkB,CAAC,CAAC;QAC/E,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QACtD,MAAM,EAAE,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAAC;QAE5C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;QACpD,MAAM,GAAG,GAAG,MAAM,cAAc,EAAE,CAAC;QACnC,MAAM,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAQ,CAAC,CAAC;QAElE,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,kBAAkB,CAAC,CAAC;QAC/E,qBAAqB;QACrB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACvD,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAE9B,MAAM,GAAG,CAAC,aAAa,EAAE,CAAC;QAE1B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;QAC7C,MAAM,GAAG,GAAG,MAAM,cAAc,EAAE,CAAC;QACnC,MAAM,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAQ,CAAC,CAAC;QAClE,MAAM,GAAG,CAAC,aAAa,EAAE,CAAC;QAE1B,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;QAChD,MAAM,GAAG,GAAG,MAAM,cAAc,EAAE,CAAC;QACnC,MAAM,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAQ,CAAC,CAAC;QAElE,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,MAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,CAAC,MAAO,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,GAAG,GAAG,MAAM,cAAc,EAAE,CAAC;QACnC,MAAM,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAQ,CAAC,CAAC;QAElE,0CAA0C;QAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,kBAAkB,CAAC,CAAC;QAC/E,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;QAC1D,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,kBAAkB,GAAG,IAAI,CAAC;QACzD,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QACtD,MAAM,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QAEzC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,MAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,CAAC,MAAO,CAAC,KAAK,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,GAAG,GAAG,MAAM,cAAc,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/browser/index.d.ts

@@ -20,4 +20,5 @@ export * from './trace.js';
 export * from './profiler.js';
 export * from './vitals.js';
 export * from './har.js';
+export * from './ref-cache.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/browser/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/browser/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/browser/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC"}

package/dist/src/browser/index.js

@@ -20,4 +20,5 @@ export * from './trace.js';
 export * from './profiler.js';
 export * from './vitals.js';
 export * from './har.js';
+export * from './ref-cache.js';
 //# sourceMappingURL=index.js.map

package/dist/src/browser/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/browser/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/browser/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC"}

package/dist/src/browser/ref-cache.d.ts

@@ -0,0 +1,21 @@
+import type { ElementRef } from './types.js';
+/** Snapshot older than this is flagged as possibly stale (page may have changed). */
+export declare const REF_CACHE_STALE_MS = 30000;
+export interface RefCacheEntry {
+    refs: Map<string, ElementRef>;
+    url: string;
+    savedAt: number;
+    ageMs: number;
+    stale: boolean;
+}
+/** Persist the current ref index for a target so a later CLI process can read it back. */
+export declare function saveRefCache(targetId: string, url: string, refs: Map<string, ElementRef>): Promise<void>;
+/**
+ * Load the persisted ref index, scoped to the given targetId (a cache from a
+ * different tab/target is ignored). Returns null if no usable cache exists —
+ * callers fall back to an empty in-memory Map, matching prior behavior.
+ */
+export declare function loadRefCache(targetId: string): Promise<RefCacheEntry | null>;
+/** Drop the persisted ref index — call whenever refs are invalidated (navigation, tab switch, close). */
+export declare function clearRefCache(): Promise<void>;
+//# sourceMappingURL=ref-cache.d.ts.map

package/dist/src/browser/ref-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-cache.d.ts","sourceRoot":"","sources":["../../../src/browser/ref-cache.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAK7C,qFAAqF;AACrF,eAAO,MAAM,kBAAkB,QAAS,CAAC;AASzC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,0FAA0F;AAC1F,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC,CAcf;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAiBlF;AAED,yGAAyG;AACzG,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAMnD"}

package/dist/src/browser/ref-cache.js

@@ -0,0 +1,70 @@
+/**
+ * AX-tree ref cache persistence.
+ *
+ * `snapshot` and `find` are separate CLI invocations — each starts a fresh
+ * node process, so the in-memory ElementRef Map built by captureSnapshot()
+ * does not survive between them. This module persists a lightweight lookup
+ * index (ref -> role/name/nodeId/backendDOMNodeId, i.e. everything CDP needs
+ * to re-target an element) to disk so a later process can rehydrate it.
+ *
+ * The full AX-tree text/dump is intentionally NOT persisted — only the
+ * per-ref index, to keep the file small.
+ */
+import { readFile, writeFile, mkdir, rm } from 'fs/promises';
+import { join } from 'path';
+const CACHE_DIR = join(process.cwd(), '.monomind', 'monobrowse');
+const CACHE_FILE = join(CACHE_DIR, 'ax-snapshot.json');
+/** Snapshot older than this is flagged as possibly stale (page may have changed). */
+export const REF_CACHE_STALE_MS = 30_000;
+/** Persist the current ref index for a target so a later CLI process can read it back. */
+export async function saveRefCache(targetId, url, refs) {
+    try {
+        await mkdir(CACHE_DIR, { recursive: true });
+        const data = {
+            targetId,
+            url,
+            savedAt: Date.now(),
+            refs: [...refs.values()],
+        };
+        await writeFile(CACHE_FILE, JSON.stringify(data));
+    }
+    catch {
+        // Best-effort — persistence failure just means cross-process rehydration
+        // won't work; in-process (same run) behavior is unaffected.
+    }
+}
+/**
+ * Load the persisted ref index, scoped to the given targetId (a cache from a
+ * different tab/target is ignored). Returns null if no usable cache exists —
+ * callers fall back to an empty in-memory Map, matching prior behavior.
+ */
+export async function loadRefCache(targetId) {
+    try {
+        const raw = await readFile(CACHE_FILE, 'utf8');
+        const data = JSON.parse(raw);
+        if (!data || !Array.isArray(data.refs) || data.targetId !== targetId)
+            return null;
+        const refs = new Map();
+        for (const ref of data.refs) {
+            if (ref && typeof ref.ref === 'string')
+                refs.set(ref.ref, ref);
+        }
+        if (refs.size === 0)
+            return null;
+        const ageMs = Date.now() - data.savedAt;
+        return { refs, url: data.url, savedAt: data.savedAt, ageMs, stale: ageMs > REF_CACHE_STALE_MS };
+    }
+    catch {
+        return null;
+    }
+}
+/** Drop the persisted ref index — call whenever refs are invalidated (navigation, tab switch, close). */
+export async function clearRefCache() {
+    try {
+        await rm(CACHE_FILE, { force: true });
+    }
+    catch {
+        // Nothing to clear, or not writable — non-fatal.
+    }
+}
+//# sourceMappingURL=ref-cache.js.map

package/dist/src/browser/ref-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-cache.js","sourceRoot":"","sources":["../../../src/browser/ref-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;AACjE,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;AAEvD,qFAAqF;AACrF,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAiBzC,0FAA0F;AAC1F,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAgB,EAChB,GAAW,EACX,IAA6B;IAE7B,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAiB;YACzB,QAAQ;YACR,GAAG;YACH,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE;YACnB,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;SACzB,CAAC;QACF,MAAM,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,yEAAyE;QACzE,4DAA4D;IAC9D,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAiB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAElF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAsB,CAAC;QAC3C,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,GAAG,KAAK,QAAQ;gBAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEjC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QACxC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,kBAAkB,EAAE,CAAC;IAClG,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,yGAAyG;AACzG,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,iDAAiD;IACnD,CAAC;AACH,CAAC"}