@fairfox/polly 0.38.2 → 0.47.0

package/dist/tools/quality/src/plugins/core-checks.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Additional checks bundled into `pollyCorePlugin`.
+ *
+ * Each check here is a port of an existing `scripts/check-*.ts` script
+ * from polly's repo into the plugin contract. The original scripts
+ * remain on disk for back-compat with the existing pre-commit
+ * orchestrator (`scripts/check.ts`); the plugin path is the new way
+ * for downstream consumers (lingua, fairfox, warehouse-experiments)
+ * who do not want to copy the script verbatim.
+ *
+ * Out of scope for this release:
+ *   - `polly:boundaries` issue text describes a workspace-dependency
+ *     model (each package may only import from packages it lists in
+ *     its `dependencies`). Polly itself is a single-package repo and
+ *     uses directional zone bans (`src/` cannot import `tools/`,
+ *     etc.); that model is what ships here. The workspace-dep model
+ *     can be layered on as an additional configuration mode later.
+ */
+import type { Check } from "../types";
+export declare const additionalCoreChecks: Check<unknown>[];

package/dist/tools/quality/src/plugins/core.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `pollyCorePlugin` — the polly-provided core plugin.
+ *
+ * Wraps the four checks polly already ships in `@fairfox/polly/quality`
+ * into the new `Check` contract. The wrapping is purely adaptive: each
+ * underlying function (`checkNoAsCasting`, `checkNoRequire`,
+ * `checkSecrets`, `checkGitignoreCoversAllowlist`) keeps its existing
+ * exports unchanged, so consumers wiring those up by hand continue to
+ * work. The plugin path is the new way; the function path stays the
+ * same.
+ *
+ * The CSS family and shared-components live in a separate `polly-ui`
+ * plugin (#92–#94) because they belong to the styled-component
+ * contract polly-ui owns. Issue #98's scope is the four core checks.
+ */
+import type { QualityPlugin } from "../types";
+export declare const POLLY_CORE_VERSION = "0.45.0";
+export declare const pollyCorePlugin: QualityPlugin;

package/dist/tools/quality/src/plugins/extra-checks.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Three more checks bundled into `pollyCorePlugin`:
+ *
+ *   - polly:forbidden-deps     — import-graph ban list (#87)
+ *   - polly:no-state-hooks     — ban useState/useReducer/useSignal (#99)
+ *   - polly:typographic-quotes — opt-in straight-vs-curly enforcement (#88)
+ *
+ * Each check is parameterised: defaults match polly's own pre-commit
+ * surface; consumers override via `polly.config.ts`. Test files are
+ * excluded by default for the import-walking checks since mocks and
+ * fixtures legitimately reference banned packages.
+ */
+import type { Check } from "../types";
+export declare const extraCoreChecks: Check<unknown>[];

package/dist/tools/quality/src/plugins/import-checks.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Import-graph checks for `pollyCorePlugin`:
+ *
+ *   - polly:relative-imports — ban `../` imports beyond a depth threshold (#84)
+ *   - polly:tsconfig-paths   — ban `compilerOptions.paths` aliases (#84)
+ *   - polly:no-raw-http      — force HTTP through a canonical client (#86)
+ *   - polly:types            — multi-package tsc --noEmit orchestrator (#85)
+ *
+ * All four are parameterised. Defaults are silent or zero-impact unless a
+ * consumer opts in via `polly.config.ts`. Polly's own pre-commit pipeline
+ * does not currently run these — they exist primarily for downstream
+ * consumers (lingua, fairfox, warehouse-experiments) and ship under the
+ * core plugin namespace so adoption is one config-block change away.
+ */
+import type { Check } from "../types";
+export declare const importCoreChecks: Check<unknown>[];

package/dist/tools/quality/src/plugins/polly-ui.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `pollyUiPlugin` — the polly-ui-provided plugin (#89, #90, #91–#94).
+ *
+ * Re-homes the CSS conformance family and shared-components ban under a
+ * dedicated `polly-ui` namespace, and adds a new `no-inline-handlers`
+ * check for JSX event handlers. Every wrap reuses the underlying
+ * function from `tools/quality/src/css/*` and
+ * `tools/quality/src/check-shared-components.ts` so behaviour is
+ * identical to the pre-host invocation; only the integration surface
+ * changes.
+ *
+ * Out of scope for this release:
+ *   - The data-action dispatcher *runtime* described in #90. The check
+ *     ships here so a project can ban inline handlers today; the
+ *     dispatcher needs a real Preact implementation that mounts near
+ *     <OverlayRoot> and registers a delegated event listener, and that
+ *     work belongs in `src/polly-ui/actions.tsx` rather than under the
+ *     quality plugin host. The check on its own is useful — it forces
+ *     the consumer to pick an alternative — and the runtime can land
+ *     in a follow-up release without changing the check's id.
+ *   - Registry-driven CSS validation. The four CSS checks currently
+ *     parse polly-ui's CSS at scan time. The new
+ *     `@fairfox/polly/ui/registry` (introduced alongside this plugin)
+ *     exposes the canonical token + component lists as data, and a
+ *     follow-up can swap the parse-time discovery for a registry
+ *     lookup. The shape of the wraps does not change when that
+ *     happens; only the inner implementation does.
+ */
+import type { QualityPlugin } from "../types";
+export declare const POLLY_UI_PLUGIN_VERSION = "0.46.0";
+export declare const pollyUiPlugin: QualityPlugin;

package/dist/tools/quality/src/types.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Plugin-host contract for `@fairfox/polly/quality`.
+ *
+ * A `QualityPlugin` bundles a set of `Check`s under a namespace. The host
+ * loads one or more plugins from `polly.config.ts`, validates that each
+ * check's id is unique, and runs the requested set in parallel. A check
+ * declares the inputs it reads so the cache layer (see `cache.ts`) can
+ * compute a content-hash and skip re-execution when nothing has changed.
+ *
+ * Plugin and check ids are namespaced as `<plugin>:<name>`. Polly's own
+ * plugin uses the `polly` prefix; polly-ui will use `polly-ui`; consumer
+ * plugins use whatever prefix matches their package name.
+ */
+/**
+ * Outcome of running a single check. The host aggregates these into a
+ * `RunReport` for the CLI. `cached` is true when the result came back from
+ * the on-disk cache without re-running the check body.
+ */
+export type CheckRunResult = {
+    id: string;
+    ok: boolean;
+    durationMs: number;
+    cached: boolean;
+    /** Human-readable summary line (one violation per element, or status). */
+    messages: string[];
+    /** Raw error if the check threw; surfaces in CLI output. */
+    error?: string;
+};
+/**
+ * Context passed to a check at run time. The host fills in `rootDir`
+ * and `signal` (for cancellation) before invoking `run`.
+ */
+export type CheckContext<TConfig = unknown> = {
+    /** Repository root the consumer is checking. */
+    rootDir: string;
+    /** Resolved configuration for this check (already validated). */
+    config: TConfig;
+    /** Aborted when the run is cancelled (CLI Ctrl-C, watch reload, etc.). */
+    signal?: AbortSignal;
+};
+/**
+ * A single check. The host calls `validate(config)` once at load time
+ * and `run(ctx)` once per execution. `filesRead(config)` is consulted by
+ * the cache before `run` — return the absolute paths whose content must
+ * invalidate a cached result.
+ */
+export type Check<TConfig = unknown> = {
+    /** Namespaced id, e.g. `polly:no-as-casting`. */
+    id: string;
+    /** One-line description for `polly quality list`. */
+    description: string;
+    /**
+     * Validate user-supplied config. Return `null` for valid input or a
+     * non-empty array of error messages for invalid input. Errors are
+     * surfaced at load time, not at run time.
+     */
+    validate?: (config: unknown) => string[] | null;
+    /**
+     * Files whose content affects the result of this check. Returned as
+     * absolute paths (or paths relative to `rootDir`; the cache normalises).
+     * The host hashes these and skips `run` on cache hit.
+     */
+    filesRead?: (config: TConfig, rootDir: string) => Promise<string[]> | string[];
+    /**
+     * Environment variables and tool versions that contribute to the
+     * cache key alongside file content. Use this when the check's behaviour
+     * depends on something not captured by `filesRead` (e.g. a binary's
+     * version, an env var that flips a code path).
+     */
+    cacheKeyExtras?: (config: TConfig) => Record<string, string>;
+    /** Run the check. Throws are caught by the host and reported as failures. */
+    run: (ctx: CheckContext<TConfig>) => Promise<CheckOutcome>;
+};
+/**
+ * The body of a check returns either pass or fail with messages. The host
+ * adds id, duration, and cache status to produce a `CheckRunResult`.
+ */
+export type CheckOutcome = {
+    ok: boolean;
+    messages: string[];
+};
+/**
+ * A plugin contributes a namespaced bundle of checks.
+ */
+export type QualityPlugin = {
+    /** Namespace used as the prefix on every check id. */
+    name: string;
+    version: string;
+    checks: Check<unknown>[];
+};
+/**
+ * Per-check configuration map keyed by check id. The host pulls the
+ * matching entry out of `qualityConfig` and passes it as `ctx.config`.
+ */
+export type QualityRunConfig = {
+    plugins: QualityPlugin[];
+    /** Per-check config keyed by check id (e.g. `"polly:no-as-casting"`). */
+    checks?: Record<string, unknown>;
+};
+export type RunReport = {
+    ok: boolean;
+    results: CheckRunResult[];
+    totalDurationMs: number;
+};

package/dist/tools/test/src/adapters/index.js.map

@@ -7,7 +7,7 @@
     "// Mock logger adapter for testing\nimport type { LoggerAdapter } from \"@/shared/adapters/logger.adapter\";\nimport type { LogLevel } from \"@/shared/types/messages\";\n\nexport interface LogCall {\n  level: LogLevel;\n  message: string;\n  context?: Record<string, unknown>;\n  error?: Error;\n  timestamp: number;\n}\n\nexport interface MockLogger extends LoggerAdapter {\n  _calls: LogCall[];\n  _clear(): void;\n}\n\nexport function createMockLogger(options?: { silent?: boolean }): MockLogger {\n  const calls: LogCall[] = [];\n  const silent = options?.silent ?? true;\n\n  const logToConsole = (level: LogLevel, message: string, context?: Record<string, unknown>) => {\n    if (!silent) {\n      // biome-ignore lint/suspicious/noConsole: Mock logger intentionally uses console for testing\n      const consoleMethod = level === \"debug\" ? console.log : console[level];\n      consoleMethod(message, context);\n    }\n  };\n\n  return {\n    debug(message: string, context?: Record<string, unknown>): void {\n      calls.push({\n        level: \"debug\",\n        message,\n        ...(context && { context }),\n        timestamp: Date.now(),\n      });\n      logToConsole(\"debug\", message, context);\n    },\n\n    info(message: string, context?: Record<string, unknown>): void {\n      calls.push({\n        level: \"info\",\n        message,\n        ...(context && { context }),\n        timestamp: Date.now(),\n      });\n      logToConsole(\"info\", message, context);\n    },\n\n    warn(message: string, context?: Record<string, unknown>): void {\n      calls.push({\n        level: \"warn\",\n        message,\n        ...(context && { context }),\n        timestamp: Date.now(),\n      });\n      logToConsole(\"warn\", message, context);\n    },\n\n    error(message: string, error?: Error, context?: Record<string, unknown>): void {\n      calls.push({\n        level: \"error\",\n        message,\n        ...(error && { error }),\n        ...(context && { context }),\n        timestamp: Date.now(),\n      });\n      logToConsole(\"error\", message, { ...context, error });\n    },\n\n    log(level: LogLevel, message: string, context?: Record<string, unknown>): void {\n      calls.push({\n        level,\n        message,\n        ...(context && { context }),\n        timestamp: Date.now(),\n      });\n      logToConsole(level, message, context);\n    },\n\n    // Test-only internals\n    _calls: calls,\n    _clear() {\n      calls.length = 0;\n    },\n  };\n}\n",
     "import type {\n  CreateOffscreenDocumentParameters,\n  OffscreenAdapter,\n} from \"@/shared/adapters/offscreen.adapter\";\n\nexport interface MockOffscreen extends OffscreenAdapter {\n  _hasDocument: boolean;\n}\n\nexport function createMockOffscreen(): MockOffscreen {\n  let hasDocument = false;\n\n  return {\n    createDocument: async (_parameters: CreateOffscreenDocumentParameters): Promise<void> => {\n      hasDocument = true;\n    },\n    closeDocument: async (): Promise<void> => {\n      hasDocument = false;\n    },\n    hasDocument: async (): Promise<boolean> => {\n      return hasDocument;\n    },\n    _hasDocument: hasDocument,\n  };\n}\n",
     "import type { MessageSender, PortAdapter, RuntimeAdapter } from \"@/shared/adapters/runtime.adapter\";\n\nexport interface MockPort extends PortAdapter {\n  _listeners: Set<(message: unknown) => void>;\n  _disconnectListeners: Set<() => void>;\n}\n\nexport function createMockPort(name: string): MockPort {\n  const listeners = new Set<(message: unknown) => void>();\n  const disconnectListeners = new Set<() => void>();\n\n  return {\n    name,\n    onMessage: (callback) => listeners.add(callback),\n    onDisconnect: (callback) => disconnectListeners.add(callback),\n    postMessage: (message) => {\n      for (const listener of listeners) {\n        listener(message);\n      }\n    },\n    disconnect: () => {\n      for (const listener of disconnectListeners) {\n        listener();\n      }\n    },\n    _listeners: listeners,\n    _disconnectListeners: disconnectListeners,\n  };\n}\n\nexport interface MockRuntime extends RuntimeAdapter {\n  id: string;\n  _messageListeners: Set<\n    (message: unknown, sender: MessageSender, sendResponse: (response: unknown) => void) => void\n  >;\n  _connectListeners: Set<(port: PortAdapter) => void>;\n}\n\nexport function createMockRuntime(id = \"test-extension-id\"): MockRuntime {\n  const messageListeners = new Set<\n    (message: unknown, sender: MessageSender, sendResponse: (response: unknown) => void) => void\n  >();\n  const connectListeners = new Set<(port: PortAdapter) => void>();\n\n  return {\n    id,\n    sendMessage: async <T>(message: T): Promise<unknown> => {\n      // Check if this is a response message\n      if (typeof message === \"object\" && message !== null && \"success\" in message) {\n        // This is a response, route it back to all listeners\n        for (const listener of messageListeners) {\n          listener(message, { url: \"\" }, () => {\n            // Empty response handler for mock\n          });\n        }\n        return undefined;\n      }\n\n      // This is a request, call ALL listeners (Chrome calls all, but only first response is used)\n      if (messageListeners.size === 0) {\n        return undefined;\n      }\n\n      return new Promise((resolve) => {\n        let resolved = false;\n        const sharedSendResponse = (res: unknown) => {\n          if (!resolved) {\n            resolved = true;\n            resolve(res);\n          }\n        };\n\n        // Call all listeners (Chrome behavior)\n        for (const listener of messageListeners) {\n          const result = listener(message, { url: \"\" }, sharedSendResponse);\n          // If listener returns true, it will send response asynchronously\n          // If it returns false/undefined/void and we haven't resolved yet, continue to next listener\n          if (typeof result === \"boolean\" && result === true) {\n            // Listener will send response asynchronously, wait for it\n          }\n        }\n\n        // If no listener handled it, resolve with undefined\n        if (!resolved) {\n          resolve(undefined);\n        }\n      });\n    },\n    onMessage: (\n      callback: (\n        message: unknown,\n        sender: MessageSender,\n        sendResponse: (response: unknown) => void\n      ) => undefined | boolean\n    ) => {\n      messageListeners.add(callback);\n    },\n    removeMessageListener: (\n      callback: (\n        message: unknown,\n        sender: MessageSender,\n        sendResponse: (response: unknown) => void\n      ) => undefined | boolean\n    ) => {\n      messageListeners.delete(callback);\n    },\n    connect: (name: string): PortAdapter => {\n      const port = createMockPort(name);\n      for (const listener of connectListeners) {\n        listener(port);\n      }\n      return port;\n    },\n    onConnect: (callback: (port: PortAdapter) => void) => {\n      connectListeners.add(callback);\n    },\n    getURL: (path: string): string => {\n      return `chrome-extension://${id}/${path}`;\n    },\n    getId: (): string => {\n      return id;\n    },\n    openOptionsPage: (): void => {\n      // Mock implementation - no-op for tests\n    },\n    _messageListeners: messageListeners,\n    _connectListeners: connectListeners,\n  };\n}\n",
-    "import type { StorageAdapter, StorageChanges } from \"@/shared/adapters/storage.adapter\";\n\nexport interface MockStorageArea extends StorageAdapter {\n  _data: Map<string, unknown>;\n}\n\nexport function createMockStorageArea(): MockStorageArea {\n  const data = new Map<string, unknown>();\n\n  return {\n    get: async <T = Record<string, unknown>>(\n      keys?: string | string[] | Record<string, unknown> | null\n      // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: Mock storage needs to handle multiple key types\n    ): Promise<T> => {\n      if (!keys) {\n        return Object.fromEntries(data) as T;\n      }\n      if (typeof keys === \"string\") {\n        return (data.has(keys) ? { [keys]: data.get(keys) } : {}) as T;\n      }\n      if (Array.isArray(keys)) {\n        const result: Record<string, unknown> = {};\n        for (const key of keys) {\n          if (data.has(key)) {\n            result[key] = data.get(key);\n          }\n        }\n        return result as unknown as T;\n      }\n      // Object with defaults\n      const result: Record<string, unknown> = {};\n      for (const [key, defaultValue] of Object.entries(keys)) {\n        result[key] = data.has(key) ? data.get(key) : defaultValue;\n      }\n      return result as unknown as T;\n    },\n    set: async (items) => {\n      for (const [key, value] of Object.entries(items)) {\n        data.set(key, value);\n      }\n    },\n    remove: async (keys) => {\n      const keyArray = Array.isArray(keys) ? keys : [keys];\n      for (const key of keyArray) {\n        data.delete(key);\n      }\n    },\n    clear: async () => {\n      data.clear();\n    },\n    onChanged: (_callback: (changes: StorageChanges, areaName: string) => void) => {\n      // Mock implementation - not needed for current tests\n    },\n    _data: data,\n  };\n}\n",
+    "import type { StorageAdapter, StorageChanges } from \"@/shared/adapters/storage.adapter\";\n\nexport interface MockStorageArea extends StorageAdapter {\n  _data: Map<string, unknown>;\n}\n\nexport function createMockStorageArea(): MockStorageArea {\n  const data = new Map<string, unknown>();\n\n  return {\n    get: async <T = Record<string, unknown>>(\n      keys?: string | string[] | Record<string, unknown> | null\n      // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: Mock storage needs to handle multiple key types\n    ): Promise<T> => {\n      if (!keys) {\n        return Object.fromEntries(data) as unknown as T;\n      }\n      if (typeof keys === \"string\") {\n        return (data.has(keys) ? { [keys]: data.get(keys) } : {}) as unknown as T;\n      }\n      if (Array.isArray(keys)) {\n        const result: Record<string, unknown> = {};\n        for (const key of keys) {\n          if (data.has(key)) {\n            result[key] = data.get(key);\n          }\n        }\n        return result as unknown as T;\n      }\n      // Object with defaults\n      const result: Record<string, unknown> = {};\n      for (const [key, defaultValue] of Object.entries(keys)) {\n        result[key] = data.has(key) ? data.get(key) : defaultValue;\n      }\n      return result as unknown as T;\n    },\n    set: async (items) => {\n      for (const [key, value] of Object.entries(items)) {\n        data.set(key, value);\n      }\n    },\n    remove: async (keys) => {\n      const keyArray = Array.isArray(keys) ? keys : [keys];\n      for (const key of keyArray) {\n        data.delete(key);\n      }\n    },\n    clear: async () => {\n      data.clear();\n    },\n    onChanged: (_callback: (changes: StorageChanges, areaName: string) => void) => {\n      // Mock implementation - not needed for current tests\n    },\n    _data: data,\n  };\n}\n",
     "import type { TabsAdapter } from \"@/shared/adapters/tabs.adapter\";\n\nexport interface MockTabs extends TabsAdapter {\n  _tabs: Map<number, chrome.tabs.Tab>;\n}\n\nexport function createMockTabs(): MockTabs {\n  const tabs = new Map<number, chrome.tabs.Tab>();\n\n  return {\n    query: async (queryInfo: chrome.tabs.QueryInfo): Promise<chrome.tabs.Tab[]> => {\n      const results: chrome.tabs.Tab[] = [];\n      for (const tab of tabs.values()) {\n        let matches = true;\n        if (queryInfo.active !== undefined && tab.active !== queryInfo.active) {\n          matches = false;\n        }\n        if (queryInfo.currentWindow !== undefined) {\n          matches = false;\n        }\n        if (matches) {\n          results.push(tab);\n        }\n      }\n      return results;\n    },\n    get: async (tabId: number): Promise<chrome.tabs.Tab> => {\n      const tab = tabs.get(tabId);\n      if (!tab) {\n        throw new Error(`Tab ${tabId} not found`);\n      }\n      return tab;\n    },\n    sendMessage: async (_tabId: number, _message: unknown): Promise<unknown> => {\n      return Promise.resolve({ success: true });\n    },\n    reload: async (\n      _tabId: number,\n      _reloadProperties?: { bypassCache?: boolean }\n    ): Promise<void> => {\n      // Mock implementation\n    },\n    onRemoved: (\n      _callback: (tabId: number, removeInfo: chrome.tabs.OnRemovedInfo) => void\n    ): void => {\n      // Mock implementation - register listener\n    },\n    onUpdated: (\n      _callback: (\n        tabId: number,\n        changeInfo: chrome.tabs.OnUpdatedInfo,\n        tab: chrome.tabs.Tab\n      ) => void\n    ): void => {\n      // Mock implementation - register listener\n    },\n    onActivated: (_callback: (activeInfo: { tabId: number; windowId: number }) => void): void => {\n      // Mock implementation - register listener\n    },\n    create: async (createProperties: chrome.tabs.CreateProperties): Promise<chrome.tabs.Tab> => {\n      const newTab: chrome.tabs.Tab = {\n        id: Math.floor(Math.random() * 10000),\n        index: tabs.size,\n        pinned: false,\n        highlighted: false,\n        windowId: 1,\n        active: true,\n        incognito: false,\n        selected: true,\n        discarded: false,\n        autoDiscardable: true,\n        groupId: -1,\n        url: createProperties.url || \"about:blank\",\n        title: createProperties.url || \"New Tab\",\n        frozen: false,\n      };\n      if (newTab.id !== undefined) {\n        tabs.set(newTab.id, newTab);\n      }\n      return newTab;\n    },\n    _tabs: tabs,\n  };\n}\n",
     "import type { WindowAdapter } from \"@/shared/adapters/window.adapter\";\n\nexport interface MockWindow extends WindowAdapter {\n  _messageListeners: Set<(event: MessageEvent) => void>;\n}\n\nexport function createMockWindow(): MockWindow {\n  const messageListeners = new Set<(event: MessageEvent) => void>();\n\n  return {\n    postMessage: (message: unknown, targetOrigin: string) => {\n      const event = new MessageEvent(\"message\", {\n        data: message,\n        origin: targetOrigin,\n        source: null,\n      });\n      for (const listener of messageListeners) {\n        listener(event);\n      }\n    },\n    addEventListener: (type: string, listener: (event: MessageEvent) => void) => {\n      if (type === \"message\") {\n        messageListeners.add(listener);\n      }\n    },\n    removeEventListener: (type: string, listener: (event: MessageEvent) => void) => {\n      if (type === \"message\") {\n        messageListeners.delete(listener);\n      }\n    },\n    _messageListeners: messageListeners,\n  };\n}\n",
     "import { createMockContextMenus, type MockContextMenus } from \"./context-menus.mock\";\nimport { createMockFetch, type MockFetch } from \"./fetch.mock\";\nimport { createMockLogger, type MockLogger } from \"./logger.mock\";\nimport { createMockOffscreen, type MockOffscreen } from \"./offscreen.mock\";\nimport { createMockPort, createMockRuntime, type MockPort, type MockRuntime } from \"./runtime.mock\";\nimport { createMockStorageArea, type MockStorageArea } from \"./storage.mock\";\nimport { createMockTabs, type MockTabs } from \"./tabs.mock\";\nimport { createMockWindow, type MockWindow } from \"./window.mock\";\n\n/**\n * Mock adapters with full type information including mock-specific properties\n */\nexport interface MockExtensionAdapters {\n  runtime: MockRuntime;\n  storage: MockStorageArea;\n  tabs: MockTabs;\n  window: MockWindow;\n  offscreen: MockOffscreen;\n  contextMenus: MockContextMenus;\n  fetch: MockFetch;\n  logger: MockLogger;\n}\n\n/**\n * Convenience interface grouping Chrome-like mock APIs\n * Useful when tests need direct access to internal mock state\n */\nexport interface MockChrome {\n  runtime: MockRuntime;\n  storage: {\n    local: MockStorageArea;\n  };\n  tabs: MockTabs;\n}\n\n/**\n * Create a mock Chrome object with grouped APIs\n * Use this when you need access to internal mock state (e.g., mockChrome.tabs._tabs)\n */\nexport function createMockChrome(): MockChrome {\n  return {\n    runtime: createMockRuntime(),\n    storage: {\n      local: createMockStorageArea(),\n    },\n    tabs: createMockTabs(),\n  };\n}\n\n/**\n * Create a complete set of mock adapters for testing\n * Returns mock adapters with full type information\n */\nexport function createMockAdapters(): MockExtensionAdapters {\n  return {\n    runtime: createMockRuntime(),\n    storage: createMockStorageArea(),\n    tabs: createMockTabs(),\n    window: createMockWindow(),\n    offscreen: createMockOffscreen(),\n    contextMenus: createMockContextMenus(),\n    fetch: createMockFetch(),\n    logger: createMockLogger({ silent: true }),\n  };\n}\n\nexport type {\n  MockContextMenus,\n  MockFetch,\n  MockLogger,\n  MockOffscreen,\n  MockPort,\n  MockRuntime,\n  MockStorageArea,\n  MockTabs,\n  MockWindow,\n};\n// Re-export individual mock factories and types for convenience\nexport {\n  createMockContextMenus,\n  createMockFetch,\n  createMockLogger,\n  createMockOffscreen,\n  createMockPort,\n  createMockRuntime,\n  createMockStorageArea,\n  createMockTabs,\n  createMockWindow,\n};\n"

package/dist/tools/test/src/index.js.map

@@ -7,7 +7,7 @@
     "// Mock logger adapter for testing\nimport type { LoggerAdapter } from \"@/shared/adapters/logger.adapter\";\nimport type { LogLevel } from \"@/shared/types/messages\";\n\nexport interface LogCall {\n  level: LogLevel;\n  message: string;\n  context?: Record<string, unknown>;\n  error?: Error;\n  timestamp: number;\n}\n\nexport interface MockLogger extends LoggerAdapter {\n  _calls: LogCall[];\n  _clear(): void;\n}\n\nexport function createMockLogger(options?: { silent?: boolean }): MockLogger {\n  const calls: LogCall[] = [];\n  const silent = options?.silent ?? true;\n\n  const logToConsole = (level: LogLevel, message: string, context?: Record<string, unknown>) => {\n    if (!silent) {\n      // biome-ignore lint/suspicious/noConsole: Mock logger intentionally uses console for testing\n      const consoleMethod = level === \"debug\" ? console.log : console[level];\n      consoleMethod(message, context);\n    }\n  };\n\n  return {\n    debug(message: string, context?: Record<string, unknown>): void {\n      calls.push({\n        level: \"debug\",\n        message,\n        ...(context && { context }),\n        timestamp: Date.now(),\n      });\n      logToConsole(\"debug\", message, context);\n    },\n\n    info(message: string, context?: Record<string, unknown>): void {\n      calls.push({\n        level: \"info\",\n        message,\n        ...(context && { context }),\n        timestamp: Date.now(),\n      });\n      logToConsole(\"info\", message, context);\n    },\n\n    warn(message: string, context?: Record<string, unknown>): void {\n      calls.push({\n        level: \"warn\",\n        message,\n        ...(context && { context }),\n        timestamp: Date.now(),\n      });\n      logToConsole(\"warn\", message, context);\n    },\n\n    error(message: string, error?: Error, context?: Record<string, unknown>): void {\n      calls.push({\n        level: \"error\",\n        message,\n        ...(error && { error }),\n        ...(context && { context }),\n        timestamp: Date.now(),\n      });\n      logToConsole(\"error\", message, { ...context, error });\n    },\n\n    log(level: LogLevel, message: string, context?: Record<string, unknown>): void {\n      calls.push({\n        level,\n        message,\n        ...(context && { context }),\n        timestamp: Date.now(),\n      });\n      logToConsole(level, message, context);\n    },\n\n    // Test-only internals\n    _calls: calls,\n    _clear() {\n      calls.length = 0;\n    },\n  };\n}\n",
     "import type {\n  CreateOffscreenDocumentParameters,\n  OffscreenAdapter,\n} from \"@/shared/adapters/offscreen.adapter\";\n\nexport interface MockOffscreen extends OffscreenAdapter {\n  _hasDocument: boolean;\n}\n\nexport function createMockOffscreen(): MockOffscreen {\n  let hasDocument = false;\n\n  return {\n    createDocument: async (_parameters: CreateOffscreenDocumentParameters): Promise<void> => {\n      hasDocument = true;\n    },\n    closeDocument: async (): Promise<void> => {\n      hasDocument = false;\n    },\n    hasDocument: async (): Promise<boolean> => {\n      return hasDocument;\n    },\n    _hasDocument: hasDocument,\n  };\n}\n",
     "import type { MessageSender, PortAdapter, RuntimeAdapter } from \"@/shared/adapters/runtime.adapter\";\n\nexport interface MockPort extends PortAdapter {\n  _listeners: Set<(message: unknown) => void>;\n  _disconnectListeners: Set<() => void>;\n}\n\nexport function createMockPort(name: string): MockPort {\n  const listeners = new Set<(message: unknown) => void>();\n  const disconnectListeners = new Set<() => void>();\n\n  return {\n    name,\n    onMessage: (callback) => listeners.add(callback),\n    onDisconnect: (callback) => disconnectListeners.add(callback),\n    postMessage: (message) => {\n      for (const listener of listeners) {\n        listener(message);\n      }\n    },\n    disconnect: () => {\n      for (const listener of disconnectListeners) {\n        listener();\n      }\n    },\n    _listeners: listeners,\n    _disconnectListeners: disconnectListeners,\n  };\n}\n\nexport interface MockRuntime extends RuntimeAdapter {\n  id: string;\n  _messageListeners: Set<\n    (message: unknown, sender: MessageSender, sendResponse: (response: unknown) => void) => void\n  >;\n  _connectListeners: Set<(port: PortAdapter) => void>;\n}\n\nexport function createMockRuntime(id = \"test-extension-id\"): MockRuntime {\n  const messageListeners = new Set<\n    (message: unknown, sender: MessageSender, sendResponse: (response: unknown) => void) => void\n  >();\n  const connectListeners = new Set<(port: PortAdapter) => void>();\n\n  return {\n    id,\n    sendMessage: async <T>(message: T): Promise<unknown> => {\n      // Check if this is a response message\n      if (typeof message === \"object\" && message !== null && \"success\" in message) {\n        // This is a response, route it back to all listeners\n        for (const listener of messageListeners) {\n          listener(message, { url: \"\" }, () => {\n            // Empty response handler for mock\n          });\n        }\n        return undefined;\n      }\n\n      // This is a request, call ALL listeners (Chrome calls all, but only first response is used)\n      if (messageListeners.size === 0) {\n        return undefined;\n      }\n\n      return new Promise((resolve) => {\n        let resolved = false;\n        const sharedSendResponse = (res: unknown) => {\n          if (!resolved) {\n            resolved = true;\n            resolve(res);\n          }\n        };\n\n        // Call all listeners (Chrome behavior)\n        for (const listener of messageListeners) {\n          const result = listener(message, { url: \"\" }, sharedSendResponse);\n          // If listener returns true, it will send response asynchronously\n          // If it returns false/undefined/void and we haven't resolved yet, continue to next listener\n          if (typeof result === \"boolean\" && result === true) {\n            // Listener will send response asynchronously, wait for it\n          }\n        }\n\n        // If no listener handled it, resolve with undefined\n        if (!resolved) {\n          resolve(undefined);\n        }\n      });\n    },\n    onMessage: (\n      callback: (\n        message: unknown,\n        sender: MessageSender,\n        sendResponse: (response: unknown) => void\n      ) => undefined | boolean\n    ) => {\n      messageListeners.add(callback);\n    },\n    removeMessageListener: (\n      callback: (\n        message: unknown,\n        sender: MessageSender,\n        sendResponse: (response: unknown) => void\n      ) => undefined | boolean\n    ) => {\n      messageListeners.delete(callback);\n    },\n    connect: (name: string): PortAdapter => {\n      const port = createMockPort(name);\n      for (const listener of connectListeners) {\n        listener(port);\n      }\n      return port;\n    },\n    onConnect: (callback: (port: PortAdapter) => void) => {\n      connectListeners.add(callback);\n    },\n    getURL: (path: string): string => {\n      return `chrome-extension://${id}/${path}`;\n    },\n    getId: (): string => {\n      return id;\n    },\n    openOptionsPage: (): void => {\n      // Mock implementation - no-op for tests\n    },\n    _messageListeners: messageListeners,\n    _connectListeners: connectListeners,\n  };\n}\n",
-    "import type { StorageAdapter, StorageChanges } from \"@/shared/adapters/storage.adapter\";\n\nexport interface MockStorageArea extends StorageAdapter {\n  _data: Map<string, unknown>;\n}\n\nexport function createMockStorageArea(): MockStorageArea {\n  const data = new Map<string, unknown>();\n\n  return {\n    get: async <T = Record<string, unknown>>(\n      keys?: string | string[] | Record<string, unknown> | null\n      // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: Mock storage needs to handle multiple key types\n    ): Promise<T> => {\n      if (!keys) {\n        return Object.fromEntries(data) as T;\n      }\n      if (typeof keys === \"string\") {\n        return (data.has(keys) ? { [keys]: data.get(keys) } : {}) as T;\n      }\n      if (Array.isArray(keys)) {\n        const result: Record<string, unknown> = {};\n        for (const key of keys) {\n          if (data.has(key)) {\n            result[key] = data.get(key);\n          }\n        }\n        return result as unknown as T;\n      }\n      // Object with defaults\n      const result: Record<string, unknown> = {};\n      for (const [key, defaultValue] of Object.entries(keys)) {\n        result[key] = data.has(key) ? data.get(key) : defaultValue;\n      }\n      return result as unknown as T;\n    },\n    set: async (items) => {\n      for (const [key, value] of Object.entries(items)) {\n        data.set(key, value);\n      }\n    },\n    remove: async (keys) => {\n      const keyArray = Array.isArray(keys) ? keys : [keys];\n      for (const key of keyArray) {\n        data.delete(key);\n      }\n    },\n    clear: async () => {\n      data.clear();\n    },\n    onChanged: (_callback: (changes: StorageChanges, areaName: string) => void) => {\n      // Mock implementation - not needed for current tests\n    },\n    _data: data,\n  };\n}\n",
+    "import type { StorageAdapter, StorageChanges } from \"@/shared/adapters/storage.adapter\";\n\nexport interface MockStorageArea extends StorageAdapter {\n  _data: Map<string, unknown>;\n}\n\nexport function createMockStorageArea(): MockStorageArea {\n  const data = new Map<string, unknown>();\n\n  return {\n    get: async <T = Record<string, unknown>>(\n      keys?: string | string[] | Record<string, unknown> | null\n      // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: Mock storage needs to handle multiple key types\n    ): Promise<T> => {\n      if (!keys) {\n        return Object.fromEntries(data) as unknown as T;\n      }\n      if (typeof keys === \"string\") {\n        return (data.has(keys) ? { [keys]: data.get(keys) } : {}) as unknown as T;\n      }\n      if (Array.isArray(keys)) {\n        const result: Record<string, unknown> = {};\n        for (const key of keys) {\n          if (data.has(key)) {\n            result[key] = data.get(key);\n          }\n        }\n        return result as unknown as T;\n      }\n      // Object with defaults\n      const result: Record<string, unknown> = {};\n      for (const [key, defaultValue] of Object.entries(keys)) {\n        result[key] = data.has(key) ? data.get(key) : defaultValue;\n      }\n      return result as unknown as T;\n    },\n    set: async (items) => {\n      for (const [key, value] of Object.entries(items)) {\n        data.set(key, value);\n      }\n    },\n    remove: async (keys) => {\n      const keyArray = Array.isArray(keys) ? keys : [keys];\n      for (const key of keyArray) {\n        data.delete(key);\n      }\n    },\n    clear: async () => {\n      data.clear();\n    },\n    onChanged: (_callback: (changes: StorageChanges, areaName: string) => void) => {\n      // Mock implementation - not needed for current tests\n    },\n    _data: data,\n  };\n}\n",
     "import type { TabsAdapter } from \"@/shared/adapters/tabs.adapter\";\n\nexport interface MockTabs extends TabsAdapter {\n  _tabs: Map<number, chrome.tabs.Tab>;\n}\n\nexport function createMockTabs(): MockTabs {\n  const tabs = new Map<number, chrome.tabs.Tab>();\n\n  return {\n    query: async (queryInfo: chrome.tabs.QueryInfo): Promise<chrome.tabs.Tab[]> => {\n      const results: chrome.tabs.Tab[] = [];\n      for (const tab of tabs.values()) {\n        let matches = true;\n        if (queryInfo.active !== undefined && tab.active !== queryInfo.active) {\n          matches = false;\n        }\n        if (queryInfo.currentWindow !== undefined) {\n          matches = false;\n        }\n        if (matches) {\n          results.push(tab);\n        }\n      }\n      return results;\n    },\n    get: async (tabId: number): Promise<chrome.tabs.Tab> => {\n      const tab = tabs.get(tabId);\n      if (!tab) {\n        throw new Error(`Tab ${tabId} not found`);\n      }\n      return tab;\n    },\n    sendMessage: async (_tabId: number, _message: unknown): Promise<unknown> => {\n      return Promise.resolve({ success: true });\n    },\n    reload: async (\n      _tabId: number,\n      _reloadProperties?: { bypassCache?: boolean }\n    ): Promise<void> => {\n      // Mock implementation\n    },\n    onRemoved: (\n      _callback: (tabId: number, removeInfo: chrome.tabs.OnRemovedInfo) => void\n    ): void => {\n      // Mock implementation - register listener\n    },\n    onUpdated: (\n      _callback: (\n        tabId: number,\n        changeInfo: chrome.tabs.OnUpdatedInfo,\n        tab: chrome.tabs.Tab\n      ) => void\n    ): void => {\n      // Mock implementation - register listener\n    },\n    onActivated: (_callback: (activeInfo: { tabId: number; windowId: number }) => void): void => {\n      // Mock implementation - register listener\n    },\n    create: async (createProperties: chrome.tabs.CreateProperties): Promise<chrome.tabs.Tab> => {\n      const newTab: chrome.tabs.Tab = {\n        id: Math.floor(Math.random() * 10000),\n        index: tabs.size,\n        pinned: false,\n        highlighted: false,\n        windowId: 1,\n        active: true,\n        incognito: false,\n        selected: true,\n        discarded: false,\n        autoDiscardable: true,\n        groupId: -1,\n        url: createProperties.url || \"about:blank\",\n        title: createProperties.url || \"New Tab\",\n        frozen: false,\n      };\n      if (newTab.id !== undefined) {\n        tabs.set(newTab.id, newTab);\n      }\n      return newTab;\n    },\n    _tabs: tabs,\n  };\n}\n",
     "import type { WindowAdapter } from \"@/shared/adapters/window.adapter\";\n\nexport interface MockWindow extends WindowAdapter {\n  _messageListeners: Set<(event: MessageEvent) => void>;\n}\n\nexport function createMockWindow(): MockWindow {\n  const messageListeners = new Set<(event: MessageEvent) => void>();\n\n  return {\n    postMessage: (message: unknown, targetOrigin: string) => {\n      const event = new MessageEvent(\"message\", {\n        data: message,\n        origin: targetOrigin,\n        source: null,\n      });\n      for (const listener of messageListeners) {\n        listener(event);\n      }\n    },\n    addEventListener: (type: string, listener: (event: MessageEvent) => void) => {\n      if (type === \"message\") {\n        messageListeners.add(listener);\n      }\n    },\n    removeEventListener: (type: string, listener: (event: MessageEvent) => void) => {\n      if (type === \"message\") {\n        messageListeners.delete(listener);\n      }\n    },\n    _messageListeners: messageListeners,\n  };\n}\n",
     "import { createMockContextMenus, type MockContextMenus } from \"./context-menus.mock\";\nimport { createMockFetch, type MockFetch } from \"./fetch.mock\";\nimport { createMockLogger, type MockLogger } from \"./logger.mock\";\nimport { createMockOffscreen, type MockOffscreen } from \"./offscreen.mock\";\nimport { createMockPort, createMockRuntime, type MockPort, type MockRuntime } from \"./runtime.mock\";\nimport { createMockStorageArea, type MockStorageArea } from \"./storage.mock\";\nimport { createMockTabs, type MockTabs } from \"./tabs.mock\";\nimport { createMockWindow, type MockWindow } from \"./window.mock\";\n\n/**\n * Mock adapters with full type information including mock-specific properties\n */\nexport interface MockExtensionAdapters {\n  runtime: MockRuntime;\n  storage: MockStorageArea;\n  tabs: MockTabs;\n  window: MockWindow;\n  offscreen: MockOffscreen;\n  contextMenus: MockContextMenus;\n  fetch: MockFetch;\n  logger: MockLogger;\n}\n\n/**\n * Convenience interface grouping Chrome-like mock APIs\n * Useful when tests need direct access to internal mock state\n */\nexport interface MockChrome {\n  runtime: MockRuntime;\n  storage: {\n    local: MockStorageArea;\n  };\n  tabs: MockTabs;\n}\n\n/**\n * Create a mock Chrome object with grouped APIs\n * Use this when you need access to internal mock state (e.g., mockChrome.tabs._tabs)\n */\nexport function createMockChrome(): MockChrome {\n  return {\n    runtime: createMockRuntime(),\n    storage: {\n      local: createMockStorageArea(),\n    },\n    tabs: createMockTabs(),\n  };\n}\n\n/**\n * Create a complete set of mock adapters for testing\n * Returns mock adapters with full type information\n */\nexport function createMockAdapters(): MockExtensionAdapters {\n  return {\n    runtime: createMockRuntime(),\n    storage: createMockStorageArea(),\n    tabs: createMockTabs(),\n    window: createMockWindow(),\n    offscreen: createMockOffscreen(),\n    contextMenus: createMockContextMenus(),\n    fetch: createMockFetch(),\n    logger: createMockLogger({ silent: true }),\n  };\n}\n\nexport type {\n  MockContextMenus,\n  MockFetch,\n  MockLogger,\n  MockOffscreen,\n  MockPort,\n  MockRuntime,\n  MockStorageArea,\n  MockTabs,\n  MockWindow,\n};\n// Re-export individual mock factories and types for convenience\nexport {\n  createMockContextMenus,\n  createMockFetch,\n  createMockLogger,\n  createMockOffscreen,\n  createMockPort,\n  createMockRuntime,\n  createMockStorageArea,\n  createMockTabs,\n  createMockWindow,\n};\n",

package/dist/tools/test/src/visual/index.js

@@ -13351,13 +13351,14 @@ var require_png = __commonJS((exports) => {
 // tools/test/src/visual/compare.ts
 var {readFileSync, writeFileSync} = (() => ({}));
 
-// node_modules/.bun/pixelmatch@7.1.0/node_modules/pixelmatch/index.js
+// node_modules/.bun/pixelmatch@7.2.0/node_modules/pixelmatch/index.js
 function pixelmatch(img1, img2, output, width, height, options = {}) {
   const {
     threshold = 0.1,
     alpha = 0.1,
     aaColor = [255, 255, 0],
     diffColor = [255, 0, 0],
+    checkerboard = true,
     includeAA,
     diffColorAlt,
     diffMask
@@ -13365,9 +13366,9 @@ function pixelmatch(img1, img2, output, width, height, options = {}) {
   if (!isPixelData(img1) || !isPixelData(img2) || output && !isPixelData(output))
     throw new Error("Image data: Uint8Array, Uint8ClampedArray or Buffer expected.");
   if (img1.length !== img2.length || output && output.length !== img1.length)
-    throw new Error("Image sizes do not match.");
+    throw new Error(`Image sizes do not match. Image 1 size: ${img1.length}, image 2 size: ${img2.length}`);
   if (img1.length !== width * height * 4)
-    throw new Error("Image data size does not match width/height.");
+    throw new Error(`Image data size does not match width/height. Expecting ${width * height * 4}. Got ${img1.length}`);
   const len = width * height;
   const a32 = new Uint32Array(img1.buffer, img1.byteOffset, len);
   const b32 = new Uint32Array(img2.buffer, img2.byteOffset, len);
@@ -13380,8 +13381,8 @@ function pixelmatch(img1, img2, output, width, height, options = {}) {
   }
   if (identical) {
     if (output && !diffMask) {
-      for (let i = 0;i < len; i++)
-        drawGrayPixel(img1, 4 * i, alpha, output);
+      for (let i = 0, pos = 0;i < len; i++, pos += 4)
+        drawGrayPixel(img1, pos, alpha, output);
     }
     return 0;
   }
@@ -13390,29 +13391,27 @@ function pixelmatch(img1, img2, output, width, height, options = {}) {
   const [diffR, diffG, diffB] = diffColor;
   const [altR, altG, altB] = diffColorAlt || diffColor;
   let diff = 0;
-  for (let y = 0;y < height; y++) {
-    for (let x = 0;x < width; x++) {
-      const i = y * width + x;
-      const pos = i * 4;
-      const delta = a32[i] === b32[i] ? 0 : colorDelta(img1, img2, pos, pos, false);
-      if (Math.abs(delta) > maxDelta) {
-        const isAA = antialiased(img1, x, y, width, height, a32, b32) || antialiased(img2, x, y, width, height, b32, a32);
-        if (!includeAA && isAA) {
-          if (output && !diffMask)
-            drawPixel(output, pos, aaR, aaG, aaB);
-        } else {
-          if (output) {
-            if (delta < 0) {
-              drawPixel(output, pos, altR, altG, altB);
-            } else {
-              drawPixel(output, pos, diffR, diffG, diffB);
-            }
+  for (let i = 0, pos = 0;i < len; i++, pos += 4) {
+    const delta = a32[i] === b32[i] ? 0 : colorDelta(img1, img2, pos, pos, checkerboard);
+    if (Math.abs(delta) > maxDelta) {
+      const x = i % width;
+      const y = i / width | 0;
+      const isExcludedAA = !includeAA && (antialiased(img1, x, y, width, height, a32, b32, checkerboard) || antialiased(img2, x, y, width, height, b32, a32, checkerboard));
+      if (isExcludedAA) {
+        if (output && !diffMask)
+          drawPixel(output, pos, aaR, aaG, aaB);
+      } else {
+        if (output) {
+          if (delta < 0) {
+            drawPixel(output, pos, altR, altG, altB);
+          } else {
+            drawPixel(output, pos, diffR, diffG, diffB);
           }
-          diff++;
         }
-      } else if (output && !diffMask) {
-        drawGrayPixel(img1, pos, alpha, output);
+        diff++;
       }
+    } else if (output && !diffMask) {
+      drawGrayPixel(img1, pos, alpha, output);
     }
   }
   return diff;
@@ -13420,12 +13419,16 @@ function pixelmatch(img1, img2, output, width, height, options = {}) {
 function isPixelData(arr) {
   return ArrayBuffer.isView(arr) && arr.BYTES_PER_ELEMENT === 1;
 }
-function antialiased(img, x1, y1, width, height, a32, b32) {
+function antialiased(img, x1, y1, width, height, a32, b32, checkerboard) {
   const x0 = Math.max(x1 - 1, 0);
   const y0 = Math.max(y1 - 1, 0);
   const x2 = Math.min(x1 + 1, width - 1);
   const y2 = Math.min(y1 + 1, height - 1);
-  const pos = y1 * width + x1;
+  const pos4 = (y1 * width + x1) * 4;
+  const cr = img[pos4];
+  const cg = img[pos4 + 1];
+  const cb = img[pos4 + 2];
+  const ca = img[pos4 + 3];
   let zeroes = x1 === x0 || x1 === x2 || y1 === y0 || y1 === y2 ? 1 : 0;
   let min = 0;
   let max = 0;
@@ -13437,7 +13440,7 @@ function antialiased(img, x1, y1, width, height, a32, b32) {
     for (let y = y0;y <= y2; y++) {
       if (x === x1 && y === y1)
         continue;
-      const delta = colorDelta(img, img, pos * 4, (y * width + x) * 4, true);
+      const delta = brightnessDelta(img, pos4, (y * width + x) * 4, cr, cg, cb, ca, checkerboard);
       if (delta === 0) {
         zeroes++;
         if (zeroes > 2)
@@ -13475,7 +13478,7 @@ function hasManySiblings(img, x1, y1, width, height) {
   }
   return false;
 }
-function colorDelta(img1, img2, k, m, yOnly) {
+function colorDelta(img1, img2, k, m, checkerboard) {
   const r1 = img1[k];
   const g1 = img1[k + 1];
   const b1 = img1[k + 2];
@@ -13488,26 +13491,49 @@ function colorDelta(img1, img2, k, m, yOnly) {
   let dg = g1 - g2;
   let db = b1 - b2;
   const da = a1 - a2;
-  if (!dr && !dg && !db && !da)
-    return 0;
   if (a1 < 255 || a2 < 255) {
-    const rb = 48 + 159 * (k % 2);
-    const gb = 48 + 159 * ((k / 1.618033988749895 | 0) % 2);
-    const bb = 48 + 159 * ((k / 2.618033988749895 | 0) % 2);
+    let rb = 255, gb = 255, bb = 255;
+    if (checkerboard) {
+      rb = 48 + 159 * (k % 2);
+      gb = 48 + 159 * ((k / 1.618033988749895 | 0) % 2);
+      bb = 48 + 159 * ((k / 2.618033988749895 | 0) % 2);
+    }
     dr = (r1 * a1 - r2 * a2 - rb * da) / 255;
     dg = (g1 * a1 - g2 * a2 - gb * da) / 255;
     db = (b1 * a1 - b2 * a2 - bb * da) / 255;
   }
   const y = dr * 0.29889531 + dg * 0.58662247 + db * 0.11448223;
-  if (yOnly)
-    return y;
   const i = dr * 0.59597799 - dg * 0.2741761 - db * 0.32180189;
   const q = dr * 0.21147017 - dg * 0.52261711 + db * 0.31114694;
   const delta = 0.5053 * y * y + 0.299 * i * i + 0.1957 * q * q;
   return y > 0 ? -delta : delta;
 }
+function brightnessDelta(img, k, m, r1, g1, b1, a1, checkerboard) {
+  const r2 = img[m];
+  const g2 = img[m + 1];
+  const b2 = img[m + 2];
+  const a2 = img[m + 3];
+  let dr = r1 - r2;
+  let dg = g1 - g2;
+  let db = b1 - b2;
+  const da = a1 - a2;
+  if (!dr && !dg && !db && !da)
+    return 0;
+  if (a1 < 255 || a2 < 255) {
+    let rb = 255, gb = 255, bb = 255;
+    if (checkerboard) {
+      rb = 48 + 159 * (k % 2);
+      gb = 48 + 159 * ((k / 1.618033988749895 | 0) % 2);
+      bb = 48 + 159 * ((k / 2.618033988749895 | 0) % 2);
+    }
+    dr = (r1 * a1 - r2 * a2 - rb * da) / 255;
+    dg = (g1 * a1 - g2 * a2 - gb * da) / 255;
+    db = (b1 * a1 - b2 * a2 - bb * da) / 255;
+  }
+  return dr * 0.29889531 + dg * 0.58662247 + db * 0.11448223;
+}
 function drawPixel(output, pos, r, g, b) {
-  output[pos + 0] = r;
+  output[pos] = r;
   output[pos + 1] = g;
   output[pos + 2] = b;
   output[pos + 3] = 255;
@@ -13965,4 +13991,4 @@ export {
   assertSafeUpdateMode
 };
 
-//# debugId=5C6BB1754AE9201464756E2164756E21
+//# debugId=A8F0CA1BEDC12C8F64756E2164756E21