The library has been refactored to provide a more direct and modern API. The previous version exported modules as namespaces, whereas v2.0.0 exports functions and constants directly.

Before (v1):

import { rules, validation } from '@rviscomi/capo.js';

const weight = rules.getWeight(element);
const isValid = validation.isValidElement(element);

After (v2):

import { getWeight, isValidElement, BrowserAdapter } from '@rviscomi/capo.js';

const adapter = new BrowserAdapter();
const weight = getWeight(element, adapter);
const isValid = isValidElement(element, adapter);

Support for WebPageTest and BigQuery has been removed from the core library to reduce maintenance burden and focus on the core analysis engine. This includes the removal of the webpagetest/ and bigquery/ directories.

The standalone Capo.js snippet has been removed. Users are encouraged to use the Chrome extension or the programmatic API.

Capo.js now supports a flexible adapter system, allowing it to run on different DOM implementations.

• Built-in adapter: The BrowserAdapter is provided for standard browser DOM environments.
• Custom adapters: Consumers can implement their own adapters by extending the base AdapterInterface class. This enables Capo.js to work with different parsers (like JSDOM or ASTs), unlocking its use in static analysis tools.

import { BrowserAdapter, analyzeHead } from '@rviscomi/capo.js';

const adapter = new BrowserAdapter();
const results = analyzeHead(document.head, adapter);

• Font preload missing crossorigin: Capo.js now validates that font preloads include the crossorigin attribute.

The demo page now includes a virtual console, making it easier to see Capo output right in the docs, without needing to open the browser console.