barebrowse 0.2.0 → 0.2.2

package/test/unit/cdp.test.js

@@ -1,110 +0,0 @@
-/**
- * Unit tests for the CDP client + chromium launcher.
- * Requires Chromium installed.
- *
- * Run: node --test test/unit/cdp.test.js
- */
-
-import { describe, it } from 'node:test';
-import assert from 'node:assert/strict';
-import { findBrowser, launch } from '../../src/chromium.js';
-import { createCDP } from '../../src/cdp.js';
-
-describe('findBrowser()', () => {
-  it('finds a Chromium-based browser', () => {
-    const binary = findBrowser();
-    assert.ok(binary.length > 0, 'should return a path');
-    assert.ok(binary.includes('chrom') || binary.includes('brave') || binary.includes('edge'),
-      `${binary} should be a Chromium browser`);
-  });
-});
-
-describe('launch()', () => {
-  it('launches headless Chromium and returns WebSocket URL', async () => {
-    const browser = await launch();
-    try {
-      assert.ok(browser.wsUrl.startsWith('ws://'), 'should return a ws:// URL');
-      assert.ok(browser.port > 0, 'should have a port');
-      assert.ok(browser.process.pid > 0, 'should have a process');
-    } finally {
-      browser.process.kill();
-    }
-  });
-});
-
-describe('createCDP()', () => {
-  it('connects to browser and sends commands', async () => {
-    const browser = await launch();
-    try {
-      const cdp = await createCDP(browser.wsUrl);
-      try {
-        // Get browser version — should work on browser-level connection
-        const version = await cdp.send('Browser.getVersion');
-        assert.ok(version.product.includes('Chrome') || version.product.includes('Headless'),
-          `product should be Chrome, got: ${version.product}`);
-      } finally {
-        cdp.close();
-      }
-    } finally {
-      browser.process.kill();
-    }
-  });
-
-  it('creates session-scoped handles', async () => {
-    const browser = await launch();
-    try {
-      const cdp = await createCDP(browser.wsUrl);
-      try {
-        const { targetId } = await cdp.send('Target.createTarget', { url: 'about:blank' });
-        const { sessionId } = await cdp.send('Target.attachToTarget', { targetId, flatten: true });
-
-        const session = cdp.session(sessionId);
-        // Enable Page domain on the session
-        await session.send('Page.enable');
-
-        // Navigate — should work on session scope
-        await session.send('Page.navigate', { url: 'data:text/html,<h1>hello</h1>' });
-
-        // Clean up
-        await cdp.send('Target.closeTarget', { targetId });
-      } finally {
-        cdp.close();
-      }
-    } finally {
-      browser.process.kill();
-    }
-  });
-});
-
-describe('ARIA tree via CDP', () => {
-  it('gets accessibility tree from a page', async () => {
-    const browser = await launch();
-    try {
-      const cdp = await createCDP(browser.wsUrl);
-      try {
-        const { targetId } = await cdp.send('Target.createTarget', { url: 'about:blank' });
-        const { sessionId } = await cdp.send('Target.attachToTarget', { targetId, flatten: true });
-        const session = cdp.session(sessionId);
-
-        await session.send('Page.enable');
-        const loadPromise = session.once('Page.loadEventFired', 10000);
-        await session.send('Page.navigate', { url: 'data:text/html,<h1>Test</h1><button>Click</button>' });
-        await loadPromise;
-
-        await session.send('Accessibility.enable');
-        const { nodes } = await session.send('Accessibility.getFullAXTree');
-
-        assert.ok(nodes.length > 0, 'should return ARIA nodes');
-        const roles = nodes.map((n) => n.role?.value).filter(Boolean);
-        assert.ok(roles.includes('heading'), 'should have heading');
-        assert.ok(roles.includes('button'), 'should have button');
-
-        await cdp.send('Target.closeTarget', { targetId });
-      } finally {
-        cdp.close();
-      }
-    } finally {
-      browser.process.kill();
-    }
-  });
-});

package/test/unit/prune.test.js

@@ -1,292 +0,0 @@
-/**
- * Unit tests for ARIA tree pruning.
- * No browser needed — pure function tests on tree objects.
- *
- * Run: node --test test/unit/prune.test.js
- */
-
-import { describe, it } from 'node:test';
-import assert from 'node:assert/strict';
-import { prune } from '../../src/prune.js';
-
-// Helper: create a minimal ARIA node
-function node(role, name = '', children = [], props = {}) {
-  return { nodeId: String(Math.random()).slice(2, 8), role, name, properties: props, ignored: false, children };
-}
-
-describe('prune()', () => {
-  it('returns null for empty tree', () => {
-    assert.equal(prune(null), null);
-  });
-
-  it('unwraps RootWebArea', () => {
-    const tree = node('RootWebArea', 'Test Page', [
-      node('main', '', [
-        node('heading', 'Hello', [], { level: 1 }),
-      ]),
-    ]);
-    const result = prune(tree);
-    // Should not have RootWebArea in output
-    assert.notEqual(result.role, 'RootWebArea');
-  });
-
-  it('keeps interactive elements in act mode', () => {
-    const tree = node('RootWebArea', '', [
-      node('main', '', [
-        node('button', 'Click me'),
-        node('link', 'Go somewhere'),
-        node('textbox', 'Search'),
-      ]),
-    ]);
-    const result = prune(tree, { mode: 'act' });
-    const flat = flattenTree(result);
-    const roles = flat.map((n) => n.role);
-    assert.ok(roles.includes('button'), 'should keep button');
-    assert.ok(roles.includes('link'), 'should keep link');
-    assert.ok(roles.includes('textbox'), 'should keep textbox');
-  });
-
-  it('drops paragraphs in act mode', () => {
-    const tree = node('RootWebArea', '', [
-      node('main', '', [
-        node('paragraph', '', [
-          node('StaticText', 'Some article content'),
-        ]),
-        node('button', 'Submit'),
-      ]),
-    ]);
-    const result = prune(tree, { mode: 'act' });
-    const flat = flattenTree(result);
-    const hasP = flat.some((n) => n.role === 'paragraph');
-    assert.equal(hasP, false, 'should drop paragraphs in act mode');
-    assert.ok(flat.some((n) => n.role === 'button'), 'should keep button');
-  });
-
-  it('keeps paragraphs in browse mode', () => {
-    const tree = node('RootWebArea', '', [
-      node('main', '', [
-        node('paragraph', '', [
-          node('StaticText', 'Some article content'),
-        ]),
-        node('button', 'Submit'),
-      ]),
-    ]);
-    const result = prune(tree, { mode: 'browse' });
-    const flat = flattenTree(result);
-    assert.ok(flat.some((n) => n.role === 'paragraph'), 'should keep paragraphs in browse mode');
-  });
-
-  it('drops InlineTextBox noise', () => {
-    const tree = node('RootWebArea', '', [
-      node('main', '', [
-        node('heading', 'Title', [
-          node('StaticText', 'Title', [
-            node('InlineTextBox', 'Title'),
-          ]),
-        ], { level: 1 }),
-      ]),
-    ]);
-    const result = prune(tree, { mode: 'browse' });
-    const flat = flattenTree(result);
-    assert.equal(flat.some((n) => n.role === 'InlineTextBox'), false, 'should drop InlineTextBox');
-  });
-
-  it('keeps headings', () => {
-    const tree = node('RootWebArea', '', [
-      node('main', '', [
-        node('heading', 'Page Title', [], { level: 1 }),
-        node('heading', 'Section', [], { level: 2 }),
-      ]),
-    ]);
-    const result = prune(tree, { mode: 'browse' });
-    const flat = flattenTree(result);
-    const headings = flat.filter((n) => n.role === 'heading');
-    assert.equal(headings.length, 2, 'should keep both headings in browse mode');
-  });
-
-  it('drops description headings in act mode', () => {
-    const tree = node('RootWebArea', '', [
-      node('main', '', [
-        node('heading', 'Page Title', [], { level: 1 }),
-        node('heading', 'About this product', [], { level: 2 }),
-        node('heading', 'Product details', [], { level: 2 }),
-        node('button', 'Buy'),
-      ]),
-    ]);
-    const result = prune(tree, { mode: 'act' });
-    const flat = flattenTree(result);
-    const headings = flat.filter((n) => n.role === 'heading');
-    // h1 kept, "About this product" and "Product details" dropped
-    assert.equal(headings.length, 1, 'should only keep h1 in act mode');
-    assert.equal(headings[0].name, 'Page Title');
-  });
-
-  it('collapses unnamed structural wrappers', () => {
-    const tree = node('RootWebArea', '', [
-      node('main', '', [
-        node('generic', '', [
-          node('generic', '', [
-            node('button', 'Deep button'),
-          ]),
-        ]),
-      ]),
-    ]);
-    const result = prune(tree);
-    const flat = flattenTree(result);
-    // The nested generics should be collapsed — button should still be there
-    assert.ok(flat.some((n) => n.role === 'button' && n.name === 'Deep button'));
-    // Generics should be collapsed to _promote or removed
-    const generics = flat.filter((n) => n.role === 'generic');
-    assert.equal(generics.length, 0, 'generics should be collapsed');
-  });
-
-  it('keeps named groups', () => {
-    const tree = node('RootWebArea', '', [
-      node('main', '', [
-        node('radiogroup', 'Color', [
-          node('radio', 'Red'),
-          node('radio', 'Blue'),
-        ]),
-      ]),
-    ]);
-    const result = prune(tree);
-    const flat = flattenTree(result);
-    assert.ok(flat.some((n) => n.role === 'radiogroup' && n.name === 'Color'));
-    assert.ok(flat.some((n) => n.role === 'radio' && n.name === 'Red'));
-  });
-
-  it('drops separators', () => {
-    const tree = node('RootWebArea', '', [
-      node('main', '', [
-        node('button', 'A'),
-        node('separator', ''),
-        node('button', 'B'),
-      ]),
-    ]);
-    const result = prune(tree);
-    const flat = flattenTree(result);
-    assert.equal(flat.some((n) => n.role === 'separator'), false);
-  });
-
-  it('drops images in act mode, keeps named images in browse', () => {
-    const tree = node('RootWebArea', '', [
-      node('main', '', [
-        node('img', 'Product photo'),
-        node('img', ''),
-        node('button', 'Buy'),
-      ]),
-    ]);
-
-    const act = prune(tree, { mode: 'act' });
-    const actFlat = flattenTree(act);
-    assert.equal(actFlat.some((n) => n.role === 'img'), false, 'act: drop all images');
-
-    const browse = prune(tree, { mode: 'browse' });
-    const browseFlat = flattenTree(browse);
-    assert.ok(browseFlat.some((n) => n.role === 'img' && n.name === 'Product photo'), 'browse: keep named img');
-    // Unnamed image should still be dropped
-    const imgs = browseFlat.filter((n) => n.role === 'img');
-    assert.equal(imgs.length, 1, 'browse: drop unnamed img');
-  });
-
-  it('trims combobox to just name + selected value', () => {
-    const tree = node('RootWebArea', '', [
-      node('main', '', [
-        node('combobox', 'Size', [
-          node('option', 'Small'),
-          node('option', 'Medium', [], { selected: true }),
-          node('option', 'Large'),
-        ]),
-      ]),
-    ]);
-    const result = prune(tree);
-    const flat = flattenTree(result);
-    const combo = flat.find((n) => n.role === 'combobox');
-    assert.ok(combo, 'should keep combobox');
-    assert.equal(combo.name, 'Medium', 'should have selected value as name');
-    assert.equal(combo.children.length, 0, 'should strip option children');
-  });
-
-  it('uses context keywords to condense non-matching product cards', () => {
-    const tree = node('RootWebArea', '', [
-      node('listitem', '', [
-        node('link', 'iPhone 15 Pro'),
-        node('StaticText', '$999'),
-        node('button', 'Add to cart'),
-      ]),
-      node('listitem', '', [
-        node('link', 'Galaxy S24'),
-        node('StaticText', '$799'),
-        node('button', 'Add to cart'),
-      ]),
-    ]);
-    const result = prune(tree, { mode: 'act', context: 'iPhone' });
-    const flat = flattenTree(result);
-    // iPhone card should be full
-    assert.ok(flat.some((n) => n.name === 'iPhone 15 Pro'));
-    assert.ok(flat.some((n) => n.name === '$999'));
-    // Galaxy card should be condensed (just link, no button/price)
-    assert.ok(flat.some((n) => n.name === 'Galaxy S24'), 'condensed card keeps title link');
-    // Galaxy's "Add to cart" should be gone
-    const galaxyIdx = flat.findIndex((n) => n.name === 'Galaxy S24');
-    // After Galaxy, there shouldn't be a button before the next major element
-    const afterGalaxy = flat.slice(galaxyIdx + 1);
-    const hasGalaxyButton = afterGalaxy.some((n) => n.role === 'button' && n.name === 'Add to cart');
-    // This may or may not work depending on exact tree structure — just check Galaxy link exists
-    assert.ok(flat.some((n) => n.name === 'Galaxy S24'));
-  });
-});
-
-describe('prune() landmark extraction', () => {
-  it('extracts main landmark when present', () => {
-    const tree = node('RootWebArea', '', [
-      node('banner', '', [
-        node('link', 'Logo'),
-        node('navigation', '', [node('link', 'Home')]),
-      ]),
-      node('main', '', [
-        node('heading', 'Content', [], { level: 1 }),
-        node('button', 'Action'),
-      ]),
-      node('contentinfo', '', [
-        node('link', 'Privacy'),
-      ]),
-    ]);
-
-    // Act mode: only main
-    const act = prune(tree, { mode: 'act' });
-    const actFlat = flattenTree(act);
-    assert.ok(actFlat.some((n) => n.name === 'Action'), 'should have main content');
-    assert.equal(actFlat.some((n) => n.name === 'Logo'), false, 'should drop banner');
-    assert.equal(actFlat.some((n) => n.name === 'Privacy'), false, 'should drop footer');
-
-    // Navigate mode: main + banner + navigation
-    const nav = prune(tree, { mode: 'navigate' });
-    const navFlat = flattenTree(nav);
-    assert.ok(navFlat.some((n) => n.name === 'Action'), 'nav: should have main');
-    assert.ok(navFlat.some((n) => n.name === 'Home'), 'nav: should have navigation links');
-  });
-
-  it('handles pages without landmarks (HN-style)', () => {
-    const tree = node('RootWebArea', 'Hacker News', [
-      node('link', 'Hacker News'),
-      node('link', 'Article 1'),
-      node('link', 'Article 2'),
-    ]);
-    const result = prune(tree, { mode: 'act' });
-    const flat = flattenTree(result);
-    // All links should survive — no landmarks to filter by
-    assert.ok(flat.some((n) => n.name === 'Article 1'));
-    assert.ok(flat.some((n) => n.name === 'Article 2'));
-  });
-});
-
-// Helper: flatten tree to array for easy assertions
-function flattenTree(node) {
-  if (!node) return [];
-  const result = [node];
-  for (const child of (node.children || [])) {
-    result.push(...flattenTree(child));
-  }
-  return result;
-}