pw-sanitizer 0.1.0

package/dist/remove/detector.js

@@ -0,0 +1,152 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findStepsToRemove = findStepsToRemove;
+const logger_js_1 = require("../logger.js");
+/**
+ * Tests whether an event field value satisfies a rule matcher.
+ *
+ * - `string` matcher → case-sensitive substring match (compatible with JSON-sourced rules).
+ * - `RegExp` matcher → tested against the value string.
+ * - Either argument being `undefined` → returns `false` immediately.
+ *
+ * @param value   - The event field value to test (may be `undefined` if the field is absent).
+ * @param matcher - The rule matcher from a {@link RemoveRule} field (may be `undefined` if not set).
+ * @returns `true` if the matcher is defined, the value is defined, and the value satisfies the matcher.
+ */
+function matchesField(value, matcher) {
+    if (matcher === undefined || value === undefined)
+        return false;
+    if (typeof matcher === 'string') {
+        // Substring match for compatibility with JSON rule files
+        return value.includes(matcher);
+    }
+    return matcher.test(value);
+}
+/**
+ * Tests whether a single {@link TraceEvent} satisfies a {@link RemoveRule}.
+ *
+ * Each matcher field on the rule (`stepName`, `selector`, `url`, `actionType`)
+ * is compared against the corresponding event field(s). Only matchers that are
+ * explicitly set on the rule are evaluated — unset matchers are ignored.
+ * **All active matchers must match** (AND logic); a rule with no matchers never matches.
+ *
+ * Field mapping:
+ * - `rule.stepName` → `event.title ?? event.action ?? event.method`
+ * - `rule.selector` → `event.selector`
+ * - `rule.url`      → `event.url`
+ * - `rule.actionType` → `event.actionType ?? event.type`
+ *
+ * @param event - The trace event to test.
+ * @param rule  - The removal rule to test against.
+ * @returns `true` if all active matchers on the rule match the event.
+ */
+function eventMatchesRule(event, rule) {
+    const matchers = [
+        { eventValue: event.title ?? event.action ?? event.method, ruleValue: rule.stepName },
+        { eventValue: event.selector, ruleValue: rule.selector },
+        { eventValue: event.url, ruleValue: rule.url },
+        { eventValue: event.actionType ?? event.type, ruleValue: rule.actionType },
+    ];
+    // Only consider matchers that are defined on the rule
+    const activeMatchers = matchers.filter((m) => m.ruleValue !== undefined);
+    if (activeMatchers.length === 0)
+        return false;
+    // ALL active matchers must match (AND logic)
+    return activeMatchers.every((m) => matchesField(m.eventValue, m.ruleValue));
+}
+/**
+ * Partitions the event list into contiguous runs where every event matches the rule.
+ *
+ * A "run" is a maximal sequence of consecutive indices where each event satisfies
+ * `eventMatchesRule`. Runs are separated by at least one non-matching event.
+ * Used to enforce {@link RemoveRule.minConsecutiveOccurrences}.
+ *
+ * @param events - The flat ordered list of trace events.
+ * @param rule   - The rule to match against each event.
+ * @returns An array of runs; each run is an array of matching event indices.
+ */
+function findConsecutiveRuns(events, rule) {
+    const runs = [];
+    let currentRun = [];
+    for (let i = 0; i < events.length; i++) {
+        const event = events[i];
+        if (eventMatchesRule(event, rule)) {
+            currentRun.push(i);
+        }
+        else {
+            if (currentRun.length > 0) {
+                runs.push(currentRun);
+                currentRun = [];
+            }
+        }
+    }
+    // Don't forget the last run
+    if (currentRun.length > 0) {
+        runs.push(currentRun);
+    }
+    return runs;
+}
+/**
+ * Identifies all trace events that should be removed based on user-declared rules.
+ *
+ * Matching semantics:
+ * - **Within a rule**: all provided matchers must match (AND logic).
+ * - **Across rules**: any matching rule makes an event a removal candidate (OR logic).
+ * - **No automatic detection**: zero built-in heuristics; only explicitly declared rules apply.
+ *
+ * `minConsecutiveOccurrences` safety guard:
+ * If a rule declares this threshold, each consecutive run of matching events is
+ * evaluated against it. Runs that are *shorter* than the threshold are **skipped**
+ * (not removed) and a warning is emitted. This prevents accidentally deleting
+ * one-off occurrences of a step that also appears in noisy repeating sequences.
+ *
+ * @param events - The flat ordered list of trace events to scan.
+ * @param rules  - The user-declared removal rules to apply.
+ * @returns A {@link RemovalSet} containing the indices and match details of every
+ *   event selected for removal.
+ */
+function findStepsToRemove(events, rules) {
+    const indices = new Set();
+    const matches = [];
+    for (const rule of rules) {
+        if (rule.minConsecutiveOccurrences !== undefined) {
+            // Use consecutive-run logic
+            const runs = findConsecutiveRuns(events, rule);
+            for (const run of runs) {
+                if (run.length >= rule.minConsecutiveOccurrences) {
+                    // Threshold met — remove all events in this run
+                    for (const idx of run) {
+                        indices.add(idx);
+                        matches.push({
+                            index: idx,
+                            ruleLabel: rule.label,
+                            event: events[idx],
+                        });
+                    }
+                }
+                else {
+                    // Threshold NOT met — warn and skip this entire run
+                    logger_js_1.logger.warn(`Rule "${rule.label}" matched ${run.length} consecutive occurrences ` +
+                        `but minConsecutiveOccurrences is ${rule.minConsecutiveOccurrences}. ` +
+                        `Skipping removal. Review your rule.`);
+                }
+            }
+        }
+        else {
+            // No consecutive guard — remove every single match
+            for (let i = 0; i < events.length; i++) {
+                const event = events[i];
+                if (eventMatchesRule(event, rule)) {
+                    indices.add(i);
+                    matches.push({
+                        index: i,
+                        ruleLabel: rule.label,
+                        event,
+                    });
+                }
+            }
+        }
+    }
+    return { indices, matches };
+}
+//# sourceMappingURL=detector.js.map

package/dist/remove/detector.js.map

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

package/dist/remove/remover.d.ts

@@ -0,0 +1,18 @@
+import type { TraceEvent, RemovalSet } from '../config/types.js';
+/**
+ * Removes the matched steps — and all their descendants — from the events array.
+ *
+ * Algorithm:
+ * 1. Expands the removal set to include all descendant events (via {@link collectChildIndices}).
+ * 2. Sorts the combined indices in **descending** order so earlier indices remain
+ *    stable as elements are spliced out.
+ * 3. Splices each index from a shallow copy of the events array.
+ *
+ * The input array is **never mutated** — a new array is returned.
+ *
+ * @param events     - The ordered list of trace events.
+ * @param removalSet - The set of matched step indices (from {@link findStepsToRemove}).
+ * @returns A new array with all matched steps (and their descendants) removed.
+ */
+export declare function removeSteps(events: TraceEvent[], removalSet: RemovalSet): TraceEvent[];
+//# sourceMappingURL=remover.d.ts.map

package/dist/remove/remover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remover.d.ts","sourceRoot":"","sources":["../../src/remove/remover.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAyCjE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,UAAU,EAAE,EACpB,UAAU,EAAE,UAAU,GACrB,UAAU,EAAE,CAwBd"}

package/dist/remove/remover.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeSteps = removeSteps;
+/**
+ * Recursively collects the indices of all descendant events for a given parent.
+ *
+ * Traverses the `callId` → `parentId` relationship: an event is considered a
+ * child of `parentIndex` if its `parentId` equals the parent's `callId`.
+ * Children of children are collected transitively.
+ *
+ * @param events      - The flat event array being searched (current working copy).
+ * @param parentIndex - Zero-based index of the parent event in `allEvents`.
+ * @param allEvents   - The original full event array used to look up the parent's `callId`.
+ * @returns A `Set` of all descendant indices (does **not** include `parentIndex` itself).
+ */
+function collectChildIndices(events, parentIndex, allEvents) {
+    const children = new Set();
+    const parentEvent = allEvents[parentIndex];
+    if (!parentEvent)
+        return children;
+    const parentCallId = parentEvent.callId;
+    if (!parentCallId)
+        return children;
+    for (let i = 0; i < events.length; i++) {
+        const event = events[i];
+        if (event && event.parentId === parentCallId && i !== parentIndex) {
+            children.add(i);
+            // Recursively collect children of children
+            const grandChildren = collectChildIndices(events, i, allEvents);
+            for (const gc of grandChildren) {
+                children.add(gc);
+            }
+        }
+    }
+    return children;
+}
+/**
+ * Removes the matched steps — and all their descendants — from the events array.
+ *
+ * Algorithm:
+ * 1. Expands the removal set to include all descendant events (via {@link collectChildIndices}).
+ * 2. Sorts the combined indices in **descending** order so earlier indices remain
+ *    stable as elements are spliced out.
+ * 3. Splices each index from a shallow copy of the events array.
+ *
+ * The input array is **never mutated** — a new array is returned.
+ *
+ * @param events     - The ordered list of trace events.
+ * @param removalSet - The set of matched step indices (from {@link findStepsToRemove}).
+ * @returns A new array with all matched steps (and their descendants) removed.
+ */
+function removeSteps(events, removalSet) {
+    // Expand removal set to include child indices
+    const expandedIndices = new Set(removalSet.indices);
+    for (const idx of removalSet.indices) {
+        const children = collectChildIndices(events, idx, events);
+        for (const childIdx of children) {
+            expandedIndices.add(childIdx);
+        }
+    }
+    // Sort indices in reverse order for safe removal
+    const sortedIndices = Array.from(expandedIndices).sort((a, b) => b - a);
+    // Create a new array (immutability)
+    const result = [...events];
+    for (const idx of sortedIndices) {
+        if (idx >= 0 && idx < result.length) {
+            result.splice(idx, 1);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=remover.js.map

package/dist/remove/remover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remover.js","sourceRoot":"","sources":["../../src/remove/remover.ts"],"names":[],"mappings":";;AAwDA,kCA2BC;AAjFD;;;;;;;;;;;GAWG;AACH,SAAS,mBAAmB,CAC1B,MAAoB,EACpB,WAAmB,EACnB,SAAuB;IAEvB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,MAAM,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;IAC3C,IAAI,CAAC,WAAW;QAAE,OAAO,QAAQ,CAAC;IAElC,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,CAAC;IACxC,IAAI,CAAC,YAAY;QAAE,OAAO,QAAQ,CAAC;IAEnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,KAAK,IAAI,KAAK,CAAC,QAAQ,KAAK,YAAY,IAAI,CAAC,KAAK,WAAW,EAAE,CAAC;YAClE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAChB,2CAA2C;YAC3C,MAAM,aAAa,GAAG,mBAAmB,CAAC,MAAM,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;YAChE,KAAK,MAAM,EAAE,IAAI,aAAa,EAAE,CAAC;gBAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAgB,WAAW,CACzB,MAAoB,EACpB,UAAsB;IAEtB,8CAA8C;IAC9C,MAAM,eAAe,GAAG,IAAI,GAAG,CAAS,UAAU,CAAC,OAAO,CAAC,CAAC;IAE5D,KAAK,MAAM,GAAG,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QAC1D,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAChC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,iDAAiD;IACjD,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAExE,oCAAoC;IACpC,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;IAE3B,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QAChC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;YACpC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/remove/rule-loader.d.ts

@@ -0,0 +1,25 @@
+import type { RemoveRule } from '../config/types.js';
+/**
+ * Thrown when a rule file path listed in `remove.ruleFiles` cannot be
+ * resolved or loaded.
+ */
+export declare class RuleFileNotFoundError extends Error {
+    constructor(filePath: string);
+}
+/**
+ * Loads an array of {@link RemoveRule}s from an external file.
+ *
+ * Supported formats:
+ * - **`.json`** — parsed with `JSON.parse`; RegExp values are not supported.
+ *   String matchers are evaluated as case-sensitive substring matches.
+ * - **`.ts` / `.js`** — loaded via dynamic `import()`; the file must export a
+ *   default array of {@link RemoveRule} objects (supports `RegExp` fields).
+ *   If a `.ts` file fails to import (e.g. no `tsx` / `ts-node` available),
+ *   a compiled `.js` sibling at the same path is tried automatically.
+ *
+ * @param filePath - Absolute or relative path to the rule file.
+ * @returns Array of {@link RemoveRule}s defined in the file.
+ * @throws {@link RuleFileNotFoundError} if the file does not exist or cannot be loaded.
+ */
+export declare function loadRuleFile(filePath: string): Promise<RemoveRule[]>;
+//# sourceMappingURL=rule-loader.d.ts.map

package/dist/remove/rule-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-loader.d.ts","sourceRoot":"","sources":["../../src/remove/rule-loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrD;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,QAAQ,EAAE,MAAM;CAI7B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAiD1E"}

package/dist/remove/rule-loader.js

@@ -0,0 +1,110 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RuleFileNotFoundError = void 0;
+exports.loadRuleFile = loadRuleFile;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const logger_js_1 = require("../logger.js");
+/**
+ * Thrown when a rule file path listed in `remove.ruleFiles` cannot be
+ * resolved or loaded.
+ */
+class RuleFileNotFoundError extends Error {
+    constructor(filePath) {
+        super(`remove.ruleFiles: file not found: ${filePath}`);
+        this.name = 'RuleFileNotFoundError';
+    }
+}
+exports.RuleFileNotFoundError = RuleFileNotFoundError;
+/**
+ * Loads an array of {@link RemoveRule}s from an external file.
+ *
+ * Supported formats:
+ * - **`.json`** — parsed with `JSON.parse`; RegExp values are not supported.
+ *   String matchers are evaluated as case-sensitive substring matches.
+ * - **`.ts` / `.js`** — loaded via dynamic `import()`; the file must export a
+ *   default array of {@link RemoveRule} objects (supports `RegExp` fields).
+ *   If a `.ts` file fails to import (e.g. no `tsx` / `ts-node` available),
+ *   a compiled `.js` sibling at the same path is tried automatically.
+ *
+ * @param filePath - Absolute or relative path to the rule file.
+ * @returns Array of {@link RemoveRule}s defined in the file.
+ * @throws {@link RuleFileNotFoundError} if the file does not exist or cannot be loaded.
+ */
+async function loadRuleFile(filePath) {
+    const absolutePath = path.resolve(filePath);
+    if (!fs.existsSync(absolutePath)) {
+        throw new RuleFileNotFoundError(filePath);
+    }
+    const ext = path.extname(absolutePath).toLowerCase();
+    if (ext === '.json') {
+        const content = fs.readFileSync(absolutePath, 'utf-8');
+        const parsed = JSON.parse(content);
+        if (!Array.isArray(parsed)) {
+            logger_js_1.logger.fatal(`Rule file ${filePath} must export an array of RemoveRule objects.`);
+        }
+        return parsed;
+    }
+    // .ts or .js — dynamic import
+    try {
+        const module = await import(absolutePath);
+        const rules = module.default ?? module;
+        if (!Array.isArray(rules)) {
+            logger_js_1.logger.fatal(`Rule file ${filePath} must export a default array of RemoveRule objects.`);
+        }
+        return rules;
+    }
+    catch (err) {
+        if (ext === '.ts') {
+            const jsSibling = absolutePath.replace(/\.ts$/, '.js');
+            if (fs.existsSync(jsSibling)) {
+                try {
+                    const module = await import(jsSibling);
+                    const rules = module.default ?? module;
+                    if (!Array.isArray(rules)) {
+                        logger_js_1.logger.fatal(`Rule file ${jsSibling} must export a default array of RemoveRule objects.`);
+                    }
+                    return rules;
+                }
+                catch {
+                    throw new RuleFileNotFoundError(`Failed to load rule file from both ${filePath} and ${jsSibling}`);
+                }
+            }
+        }
+        throw new RuleFileNotFoundError(`Failed to load rule file ${filePath}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+//# sourceMappingURL=rule-loader.js.map

package/dist/remove/rule-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-loader.js","sourceRoot":"","sources":["../../src/remove/rule-loader.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,oCAiDC;AAhFD,4CAA8B;AAC9B,gDAAkC;AAElC,4CAAsC;AAEtC;;;GAGG;AACH,MAAa,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,QAAgB;QAC1B,KAAK,CAAC,qCAAqC,QAAQ,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AALD,sDAKC;AAED;;;;;;;;;;;;;;GAcG;AACI,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE5C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;IAErD,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAiB,CAAC;QACnD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,kBAAM,CAAC,KAAK,CAAC,aAAa,QAAQ,8CAA8C,CAAC,CAAC;QACpF,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,8BAA8B;IAC9B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC;QACvC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,kBAAM,CAAC,KAAK,CAAC,aAAa,QAAQ,qDAAqD,CAAC,CAAC;QAC3F,CAAC;QACD,OAAO,KAAqB,CAAC;IAC/B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;YAClB,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YACvD,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC7B,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;oBACvC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC;oBACvC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;wBAC1B,kBAAM,CAAC,KAAK,CAAC,aAAa,SAAS,qDAAqD,CAAC,CAAC;oBAC5F,CAAC;oBACD,OAAO,KAAqB,CAAC;gBAC/B,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,IAAI,qBAAqB,CAC7B,sCAAsC,QAAQ,QAAQ,SAAS,EAAE,CAClE,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,IAAI,qBAAqB,CAC7B,4BAA4B,QAAQ,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC5F,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/remove/rule-registry.d.ts

@@ -0,0 +1,17 @@
+import type { RemoveConfig, RemoveRule } from '../config/types.js';
+/**
+ * Builds the complete, deduplicated list of {@link RemoveRule}s for a run.
+ *
+ * Merge order:
+ * 1. All rules loaded from `config.ruleFiles` (in declaration order)
+ * 2. Inline rules from `config.rules`
+ *
+ * No built-in rules are ever injected — only what the user explicitly declared.
+ * If the same `label` appears more than once, a warning is emitted and the **last**
+ * definition wins (last-write-wins semantics).
+ *
+ * @param config - The `remove` section of the sanitizer config.
+ * @returns Deduplicated array of validated {@link RemoveRule}s, ready for use.
+ */
+export declare function buildRuleRegistry(config: RemoveConfig): Promise<RemoveRule[]>;
+//# sourceMappingURL=rule-registry.d.ts.map

package/dist/remove/rule-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-registry.d.ts","sourceRoot":"","sources":["../../src/remove/rule-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAKnE;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,UAAU,EAAE,CAAC,CA6CvB"}

package/dist/remove/rule-registry.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildRuleRegistry = buildRuleRegistry;
+const rule_loader_js_1 = require("./rule-loader.js");
+const validator_js_1 = require("../config/validator.js");
+const logger_js_1 = require("../logger.js");
+/**
+ * Builds the complete, deduplicated list of {@link RemoveRule}s for a run.
+ *
+ * Merge order:
+ * 1. All rules loaded from `config.ruleFiles` (in declaration order)
+ * 2. Inline rules from `config.rules`
+ *
+ * No built-in rules are ever injected — only what the user explicitly declared.
+ * If the same `label` appears more than once, a warning is emitted and the **last**
+ * definition wins (last-write-wins semantics).
+ *
+ * @param config - The `remove` section of the sanitizer config.
+ * @returns Deduplicated array of validated {@link RemoveRule}s, ready for use.
+ */
+async function buildRuleRegistry(config) {
+    const allRules = [];
+    // Load from rule files first
+    if (config.ruleFiles) {
+        const files = Array.isArray(config.ruleFiles)
+            ? config.ruleFiles
+            : [config.ruleFiles];
+        for (const filePath of files) {
+            const rules = await (0, rule_loader_js_1.loadRuleFile)(filePath);
+            allRules.push(...rules);
+        }
+    }
+    // Then inline rules
+    if (config.rules) {
+        allRules.push(...config.rules);
+    }
+    // Validate each rule
+    for (const rule of allRules) {
+        (0, validator_js_1.validateRule)(rule);
+    }
+    // Check for duplicate labels and warn
+    const seenLabels = new Map();
+    for (let i = 0; i < allRules.length; i++) {
+        const rule = allRules[i];
+        const previousIndex = seenLabels.get(rule.label);
+        if (previousIndex !== undefined) {
+            logger_js_1.logger.warn(`Duplicate rule label "${rule.label}" — last definition wins (index ${i} replaces ${previousIndex}).`);
+        }
+        seenLabels.set(rule.label, i);
+    }
+    // Deduplicate: last-write-wins
+    const deduped = new Map();
+    for (const rule of allRules) {
+        deduped.set(rule.label, rule);
+    }
+    return Array.from(deduped.values());
+}
+//# sourceMappingURL=rule-registry.js.map

package/dist/remove/rule-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-registry.js","sourceRoot":"","sources":["../../src/remove/rule-registry.ts"],"names":[],"mappings":";;AAmBA,8CA+CC;AAjED,qDAAgD;AAChD,yDAAsD;AACtD,4CAAsC;AAEtC;;;;;;;;;;;;;GAaG;AACI,KAAK,UAAU,iBAAiB,CACrC,MAAoB;IAEpB,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAElC,6BAA6B;IAC7B,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC;YAC3C,CAAC,CAAC,MAAM,CAAC,SAAS;YAClB,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAEvB,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,MAAM,IAAA,6BAAY,EAAC,QAAQ,CAAC,CAAC;YAC3C,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,oBAAoB;IACpB,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,qBAAqB;IACrB,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAA,2BAAY,EAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IAED,sCAAsC;IACtC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;QAC1B,MAAM,aAAa,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjD,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAChC,kBAAM,CAAC,IAAI,CACT,yBAAyB,IAAI,CAAC,KAAK,mCAAmC,CAAC,aAAa,aAAa,IAAI,CACtG,CAAC;QACJ,CAAC;QACD,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAChC,CAAC;IAED,+BAA+B;IAC/B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC9C,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AACtC,CAAC"}

package/dist/remove/timestamp-repair.d.ts

@@ -0,0 +1,28 @@
+import type { TraceEvent, TimestampStrategy } from '../config/types.js';
+/**
+ * Repairs the event timeline after steps have been removed, so that the total
+ * duration reported in the Playwright UI remains coherent.
+ *
+ * For each removed event, the duration (`endTime - startTime`) that it occupied
+ * is redistributed to an adjacent event according to the chosen strategy:
+ *
+ * - **`'absorb-into-prev'`** *(default)*: the preceding event's `endTime` is
+ *   extended by the removed duration. Falls back to shifting the following
+ *   event's `startTime` if no preceding event exists.
+ * - **`'absorb-into-next'`**: the following event's `startTime` is shifted
+ *   back by the removed duration. Falls back to extending the preceding
+ *   event if no following event exists.
+ * - **`'gap'`**: no adjustment — a visible gap will appear in the timeline.
+ *
+ * After redistribution, events where `startTime > endTime` are detected and
+ * corrected (a warning is emitted for each such case).
+ *
+ * The input arrays are **never mutated** — a new events array is returned.
+ *
+ * @param events        - The events array **after** step removal (output of {@link removeSteps}).
+ * @param removedEvents - The events that were removed (needed to determine their durations).
+ * @param strategy      - The {@link TimestampStrategy} to apply.
+ * @returns A new array of events with adjusted timestamps.
+ */
+export declare function repairTimestamps(events: TraceEvent[], removedEvents: TraceEvent[], strategy: TimestampStrategy): TraceEvent[];
+//# sourceMappingURL=timestamp-repair.d.ts.map

package/dist/remove/timestamp-repair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestamp-repair.d.ts","sourceRoot":"","sources":["../../src/remove/timestamp-repair.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGxE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,UAAU,EAAE,EACpB,aAAa,EAAE,UAAU,EAAE,EAC3B,QAAQ,EAAE,iBAAiB,GAC1B,UAAU,EAAE,CA+Bd"}