@tangle-network/browser-agent-driver 0.33.2 → 0.34.0

package/dist/design/audit/reference/dna/descriptor.js.map

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

package/dist/design/audit/reference/dna/page-adapter.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Page→DNA extraction adapter — the thin IO boundary over the pure `toDesignDNA`
+ * core. Implements the `DesignDnaExtractor` contract.
+ *
+ * Reuse, not reimplementation: the raw DOM walk (`extractTokensFromDOM`), the
+ * multi-viewport merge, colour clustering and grid detection all already live in
+ * `extractDesignTokens` (`design/audit/tokens/extract.ts`, a leaf). This adapter
+ * calls that one exported function and hands its `DesignTokens` to `toDesignDNA`
+ * — it owns zero extraction logic of its own.
+ *
+ * The reach into the tokens leaf is a LAZY `await import` (mirroring `compare.ts`)
+ * so the engine takes no static dependency on the browser-heavy extractor; the
+ * pure cores never touch it.
+ */
+import type { DesignDnaExtractor } from '../contracts.js';
+export declare function createPageDnaExtractor(): DesignDnaExtractor;
+//# sourceMappingURL=page-adapter.d.ts.map

package/dist/design/audit/reference/dna/page-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-adapter.d.ts","sourceRoot":"","sources":["../../../../../src/design/audit/reference/dna/page-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAqC,MAAM,iBAAiB,CAAA;AAG5F,wBAAgB,sBAAsB,IAAI,kBAAkB,CAkB3D"}

package/dist/design/audit/reference/dna/page-adapter.js

@@ -0,0 +1,35 @@
+/**
+ * Page→DNA extraction adapter — the thin IO boundary over the pure `toDesignDNA`
+ * core. Implements the `DesignDnaExtractor` contract.
+ *
+ * Reuse, not reimplementation: the raw DOM walk (`extractTokensFromDOM`), the
+ * multi-viewport merge, colour clustering and grid detection all already live in
+ * `extractDesignTokens` (`design/audit/tokens/extract.ts`, a leaf). This adapter
+ * calls that one exported function and hands its `DesignTokens` to `toDesignDNA`
+ * — it owns zero extraction logic of its own.
+ *
+ * The reach into the tokens leaf is a LAZY `await import` (mirroring `compare.ts`)
+ * so the engine takes no static dependency on the browser-heavy extractor; the
+ * pure cores never touch it.
+ */
+import { toDesignDNA } from './derive.js';
+export function createPageDnaExtractor() {
+    return {
+        async extract(opts) {
+            const { extractDesignTokens } = await import('../../tokens/extract.js');
+            const { tokens, outputDir, screenshotPaths, scrollMotion } = await extractDesignTokens({
+                url: opts.url,
+                headless: opts.headless,
+                outputDir: opts.outputDir,
+                captureScrollMotion: opts.captureScrollMotion,
+            });
+            return {
+                dna: toDesignDNA(tokens, opts.measurements, scrollMotion),
+                tokens,
+                screenshotPaths,
+                outputDir,
+            };
+        },
+    };
+}
+//# sourceMappingURL=page-adapter.js.map

package/dist/design/audit/reference/dna/page-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-adapter.js","sourceRoot":"","sources":["../../../../../src/design/audit/reference/dna/page-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,IAA2B;YACvC,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAA;YACvE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,GAAG,MAAM,mBAAmB,CAAC;gBACrF,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;aAC9C,CAAC,CAAA;YACF,OAAO;gBACL,GAAG,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC;gBACzD,MAAM;gBACN,eAAe;gBACf,SAAS;aACV,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/design/audit/reference/dna/scroll-capture.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Scroll-driven motion capture — the opt-in `captureScrollMotion` pass.
+ *
+ * Three concerns, deliberately split so the JUDGEMENT is pure and unit-testable
+ * while only the raw DOM read touches a browser:
+ *
+ *  1. `scrollSampleCollector` — the HERMETIC in-page function. It scrolls the
+ *     live page top→bottom in N stops and, at each stop, reads a bounded set of
+ *     elements' `getBoundingClientRect` + `getComputedStyle(opacity/transform/
+ *     position)`. It emits raw `ScrollStepSample[]` and makes NO judgement. It
+ *     references only browser globals + its own args (no module scope) so
+ *     Playwright can serialise it into the page.
+ *  2. `detectRawScrollCapture` — the PURE detector. It folds the sampled steps
+ *     into a `RawScrollCapture` (reveal count/kinds, sticky count, parallax
+ *     score, heights) with NO browser, NO IO, deterministic — so it unit-tests
+ *     on `ScrollStepSample` fixtures alone.
+ *  3. `foldScrollMotion` — the PURE rollup. It normalises a `RawScrollCapture`
+ *     into the DNA-altitude `ScrollMotionDNA`, computing the derived
+ *     `pageHeightRatio` and the `scrollDriven` verdict (the two fields the raw
+ *     capture deliberately leaves to the fold). Unit-tests on `RawScrollCapture`
+ *     fixtures.
+ *
+ * `createScrollCapturer` wires (1)+(2) behind the narrow `ScrollCapturePage`
+ * seam — it depends only on `evaluate`, never on Playwright, so it is browser-
+ * free and fakeable. The live token extractor (`design/audit/tokens/extract.ts`)
+ * hands it a real `Page`; tests hand it a fake whose `evaluate` returns canned
+ * samples.
+ *
+ * Honest signals: every quantity is measured. The capturer returns `undefined`
+ * for a page that cannot scroll (nothing to observe); a page that scrolls but
+ * shows little motion returns a real record that the fold marks
+ * `scrollDriven: false` — distinct from absence.
+ */
+import type { RawScrollCapture, ScrollMotionDNA, ScrollCapturer } from '../contracts.js';
+/**
+ * One element's measurement at a single scroll stop. `i` is the element's
+ * stable index in the captured element list, identical across every stop, so the
+ * detector can reconstruct each element's series.
+ */
+export interface ElementSample {
+    /** Stable element index across all stops. */
+    i: number;
+    /** `getBoundingClientRect().top` in viewport CSS px. */
+    top: number;
+    /** `getBoundingClientRect().bottom` in viewport CSS px. */
+    bottom: number;
+    /** Computed `opacity`, 0–1. */
+    opacity: number;
+    /** Parsed `translateY` from the computed transform, CSS px. */
+    ty: number;
+    /** Parsed vertical scale from the computed transform (1 = none). */
+    scale: number;
+    /** Computed `position` (`static` / `sticky` / `fixed` / …). */
+    position: string;
+}
+/** One top→bottom scroll stop: the scroll geometry plus every tracked element. */
+export interface ScrollStepSample {
+    /** `window.scrollY` at this stop. */
+    scrollY: number;
+    /** `window.innerHeight` at capture time. */
+    viewportHeight: number;
+    /** `document.scrollingElement.scrollHeight` at capture time. */
+    scrollHeight: number;
+    /** Per-element measurements at this stop. */
+    elements: ElementSample[];
+}
+/**
+ * Scroll the live page top→bottom in `steps` stops, sampling up to
+ * `maxElements` elements at each. Pure DOM read — emits raw samples, makes NO
+ * judgement. HERMETIC: references only its args + browser globals (no module
+ * scope) so it survives `Function.prototype.toString` serialisation into the
+ * page. Restores the original scroll position before returning.
+ */
+export declare function scrollSampleCollector(steps: number, settleMs: number, maxElements: number): Promise<ScrollStepSample[]>;
+/**
+ * Fold sampled scroll steps into a `RawScrollCapture`, or `undefined` when the
+ * page could not scroll (nothing to observe). Pure + deterministic.
+ */
+export declare function detectRawScrollCapture(samples: ScrollStepSample[]): RawScrollCapture | undefined;
+/**
+ * Normalise a raw scroll capture into the DNA-altitude `ScrollMotionDNA`,
+ * computing the derived `pageHeightRatio` and the `scrollDriven` verdict the raw
+ * capture leaves to the fold. Pure + deterministic.
+ */
+export declare function foldScrollMotion(raw: RawScrollCapture): ScrollMotionDNA;
+/**
+ * The shipped `ScrollCapturer`: drive a stepped top→bottom scroll on an already
+ * open, settled page and fold it to a `RawScrollCapture`. Browser-free — depends
+ * only on the `ScrollCapturePage.evaluate` seam — so a fake page drives it in
+ * unit tests. Returns `undefined` when the page cannot scroll or evaluation fails.
+ */
+export declare function createScrollCapturer(): ScrollCapturer;
+//# sourceMappingURL=scroll-capture.d.ts.map

package/dist/design/audit/reference/dna/scroll-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-capture.d.ts","sourceRoot":"","sources":["../../../../../src/design/audit/reference/dna/scroll-capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EAEf,cAAc,EAGf,MAAM,iBAAiB,CAAA;AAkDxB;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,CAAC,EAAE,MAAM,CAAA;IACT,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAA;IACX,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAA;IACd,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,+DAA+D;IAC/D,EAAE,EAAE,MAAM,CAAA;IACV,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAA;IACb,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,kFAAkF;AAClF,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,4CAA4C;IAC5C,cAAc,EAAE,MAAM,CAAA;IACtB,gEAAgE;IAChE,YAAY,EAAE,MAAM,CAAA;IACpB,6CAA6C;IAC7C,QAAQ,EAAE,aAAa,EAAE,CAAA;CAC1B;AAID;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CA4E7B;AAoHD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,GAAG,SAAS,CA2ChG;AAID;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,GAAG,eAAe,CAavE;AA0BD;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAerD"}

package/dist/design/audit/reference/dna/scroll-capture.js

@@ -0,0 +1,374 @@
+/**
+ * Scroll-driven motion capture — the opt-in `captureScrollMotion` pass.
+ *
+ * Three concerns, deliberately split so the JUDGEMENT is pure and unit-testable
+ * while only the raw DOM read touches a browser:
+ *
+ *  1. `scrollSampleCollector` — the HERMETIC in-page function. It scrolls the
+ *     live page top→bottom in N stops and, at each stop, reads a bounded set of
+ *     elements' `getBoundingClientRect` + `getComputedStyle(opacity/transform/
+ *     position)`. It emits raw `ScrollStepSample[]` and makes NO judgement. It
+ *     references only browser globals + its own args (no module scope) so
+ *     Playwright can serialise it into the page.
+ *  2. `detectRawScrollCapture` — the PURE detector. It folds the sampled steps
+ *     into a `RawScrollCapture` (reveal count/kinds, sticky count, parallax
+ *     score, heights) with NO browser, NO IO, deterministic — so it unit-tests
+ *     on `ScrollStepSample` fixtures alone.
+ *  3. `foldScrollMotion` — the PURE rollup. It normalises a `RawScrollCapture`
+ *     into the DNA-altitude `ScrollMotionDNA`, computing the derived
+ *     `pageHeightRatio` and the `scrollDriven` verdict (the two fields the raw
+ *     capture deliberately leaves to the fold). Unit-tests on `RawScrollCapture`
+ *     fixtures.
+ *
+ * `createScrollCapturer` wires (1)+(2) behind the narrow `ScrollCapturePage`
+ * seam — it depends only on `evaluate`, never on Playwright, so it is browser-
+ * free and fakeable. The live token extractor (`design/audit/tokens/extract.ts`)
+ * hands it a real `Page`; tests hand it a fake whose `evaluate` returns canned
+ * samples.
+ *
+ * Honest signals: every quantity is measured. The capturer returns `undefined`
+ * for a page that cannot scroll (nothing to observe); a page that scrolls but
+ * shows little motion returns a real record that the fold marks
+ * `scrollDriven: false` — distinct from absence.
+ */
+// ── tuning (pure, documented) ────────────────────────────────────────────────
+// A page whose scrollable range is below this (CSS px) is treated as
+// non-scrolling: there is nothing to observe, so the capturer returns undefined.
+const MIN_SCROLL_RANGE_PX = 48;
+// Opacity at/below this reads as "hidden" (reveal start); at/above HI reads as
+// "shown" (reveal end).
+const OPACITY_HIDDEN = 0.1;
+const OPACITY_SHOWN = 0.9;
+// A transform translateY of at least this (px) before settling to ~0 reads as a
+// slide reveal; SETTLED is the post-settle tolerance.
+const SLIDE_START_PX = 12;
+const SLIDE_SETTLED_PX = 4;
+// A scale this far from 1 before settling to ~1 reads as a scale-in reveal.
+const SCALE_START = 0.08;
+const SCALE_SETTLED = 0.03;
+// An element is "below / entering" (reveal candidate start) when its viewport
+// top sits at/under this fraction of the viewport, and "in view" (reveal end)
+// when its top sits at/above the IN fraction.
+const ENTER_FRACTION = 0.75;
+const INVIEW_FRACTION = 0.85;
+// A pinned element's viewport top must vary less than this (px) across the stops
+// where it is pinned, while scroll advances at least PIN_MIN_SCROLL_PX.
+const STICKY_TOP_VARIANCE_PX = 8;
+const PIN_MIN_SCROLL_PX = 100;
+// Parallax: a layer's translate rate (viewport movement ÷ scroll movement).
+// 1 = rigid with content, 0 = fixed/pinned. A genuine parallax layer sits in
+// the slow band (LO,HI) or moves faster than content (>FAST). The score is the
+// clamped distance of that rate from rigid (1).
+const PARALLAX_SLOW_LO = 0.15;
+const PARALLAX_SLOW_HI = 0.85;
+const PARALLAX_FAST = 1.15;
+// A transform reveal (slide / scale) only counts for a layer that, once shown,
+// moves RIGIDLY with the content (translate rate within ±this of 1). This is the
+// exact complement of the parallax bands above, so a parallax layer can never be
+// double-read as a slide. Disjoint by construction: rigid = [0.85, 1.15].
+const RIGID_RATE_TOLERANCE = 0.15;
+// scrollDriven rollup thresholds.
+const SCROLL_DRIVEN_MIN_REVEALS = 2;
+const SCROLL_DRIVEN_MIN_PARALLAX = 0.25;
+const round2 = (n) => Math.round(n * 100) / 100;
+const clamp01 = (n) => (n < 0 ? 0 : n > 1 ? 1 : n);
+const clampInt = (n, lo, hi) => Math.max(lo, Math.min(hi, Math.round(n)));
+// ── (1) in-page collector — HERMETIC, runs in the browser ────────────────────
+/**
+ * Scroll the live page top→bottom in `steps` stops, sampling up to
+ * `maxElements` elements at each. Pure DOM read — emits raw samples, makes NO
+ * judgement. HERMETIC: references only its args + browser globals (no module
+ * scope) so it survives `Function.prototype.toString` serialisation into the
+ * page. Restores the original scroll position before returning.
+ */
+export async function scrollSampleCollector(steps, settleMs, maxElements) {
+    const doc = document.scrollingElement || document.documentElement;
+    const viewportHeight = window.innerHeight;
+    const scrollHeight = doc ? doc.scrollHeight : document.body.scrollHeight;
+    const originalY = window.scrollY;
+    // Parse translateY + vertical scale out of a computed transform matrix.
+    const parseTransform = (t) => {
+        if (!t || t === 'none')
+            return { ty: 0, scale: 1 };
+        const open = t.indexOf('(');
+        const close = t.lastIndexOf(')');
+        if (open < 0 || close <= open)
+            return { ty: 0, scale: 1 };
+        const nums = t
+            .slice(open + 1, close)
+            .split(',')
+            .map((s) => parseFloat(s.trim()));
+        if (nums.length === 6)
+            return { ty: nums[5] || 0, scale: nums[3] || 1 };
+        if (nums.length === 16)
+            return { ty: nums[13] || 0, scale: nums[5] || 1 };
+        return { ty: 0, scale: 1 };
+    };
+    // Capture the tracked element list ONCE so identity (index) is stable across
+    // stops. Track a set SPREAD across the full document height — not the first N
+    // nodes in DOM order, which cluster in the header/hero and miss everything that
+    // reveals lower down the page (the original bug: reveal-heavy pages scored 0).
+    // Skip tiny nodes, then evenly subsample by document position up to maxElements.
+    const all = Array.from(document.body ? document.body.querySelectorAll('*') : []);
+    const candidates = [];
+    for (const el of all) {
+        const r = el.getBoundingClientRect();
+        if (r.width < 24 || r.height < 12)
+            continue;
+        candidates.push({ el, docTop: r.top + window.scrollY });
+    }
+    candidates.sort((a, b) => a.docTop - b.docTop);
+    let tracked;
+    if (candidates.length > maxElements) {
+        const stride = candidates.length / maxElements;
+        tracked = [];
+        for (let k = 0; k < maxElements; k++)
+            tracked.push(candidates[Math.floor(k * stride)].el);
+    }
+    else {
+        tracked = candidates.map((c) => c.el);
+    }
+    const range = Math.max(0, scrollHeight - viewportHeight);
+    const stops = Math.max(2, steps);
+    const samples = [];
+    for (let s = 0; s < stops; s++) {
+        const targetY = range * (s / (stops - 1));
+        window.scrollTo(0, targetY);
+        // Let rAF + CSS transitions / scroll handlers settle before reading.
+        await new Promise((resolve) => requestAnimationFrame(() => setTimeout(resolve, settleMs)));
+        const elements = [];
+        for (let i = 0; i < tracked.length; i++) {
+            const el = tracked[i];
+            const r = el.getBoundingClientRect();
+            const cs = getComputedStyle(el);
+            const { ty, scale } = parseTransform(cs.transform);
+            const opacity = parseFloat(cs.opacity);
+            elements.push({
+                i,
+                top: r.top,
+                bottom: r.bottom,
+                opacity: Number.isFinite(opacity) ? opacity : 1,
+                ty,
+                scale,
+                position: cs.position,
+            });
+        }
+        samples.push({ scrollY: window.scrollY, viewportHeight, scrollHeight, elements });
+    }
+    window.scrollTo(0, originalY);
+    return samples;
+}
+function seriesByElement(samples) {
+    const byEl = new Map();
+    for (const step of samples) {
+        for (const e of step.elements) {
+            const obs = {
+                scrollY: step.scrollY,
+                viewportHeight: step.viewportHeight,
+                top: e.top,
+                bottom: e.bottom,
+                opacity: e.opacity,
+                ty: e.ty,
+                scale: e.scale,
+                position: e.position,
+            };
+            const arr = byEl.get(e.i);
+            if (arr)
+                arr.push(obs);
+            else
+                byEl.set(e.i, [obs]);
+        }
+    }
+    for (const arr of byEl.values())
+        arr.sort((a, b) => a.scrollY - b.scrollY);
+    return byEl;
+}
+/**
+ * Classify one element's series as a reveal, returning its kind or null.
+ *
+ * Compares the element's HIDDEN state (strongest hidden reading while it sits
+ * below / entering the viewport) against its SHOWN state (most-settled reading
+ * once it has scrolled into view), aggregating EXTREMES across every sampled stop
+ * rather than trusting a single frame. A stop can easily land mid-transition (the
+ * per-stop settle window is shorter than a typical 300–600ms reveal), so a
+ * first-match "after" frame routinely catches an in-flight opacity/transform and
+ * misses a real reveal; the extreme over all shown frames does not.
+ */
+function classifyReveal(series) {
+    if (series.length < 2)
+        return null;
+    const vh = series[0].viewportHeight;
+    // "entering": frames where the element sits below / at the bottom edge of the
+    // viewport — its hidden start zone. "later": frames at a DEEPER scroll where it
+    // has risen above the in-view line. A reveal completes and then STAYS settled
+    // (the element does not re-hide as it scrolls off the top), so the shown
+    // reading is NOT gated on the element still being on-screen — gating it on
+    // `bottom >= 0` would miss reveals whose final settled frame is the one where
+    // the element has just scrolled past the viewport top.
+    const entering = series.filter((o) => o.top >= vh * ENTER_FRACTION);
+    if (entering.length === 0)
+        return null;
+    const firstEnterY = Math.min(...entering.map((o) => o.scrollY));
+    const later = series.filter((o) => o.scrollY > firstEnterY && o.top < vh * INVIEW_FRACTION);
+    if (later.length === 0)
+        return null;
+    const hiddenOpacity = Math.min(...entering.map((o) => o.opacity));
+    const shownOpacity = Math.max(...later.map((o) => o.opacity));
+    if (hiddenOpacity <= OPACITY_HIDDEN && shownOpacity >= OPACITY_SHOWN)
+        return 'fade';
+    // Slide / scale only count for a layer that, once shown, moves rigidly with the
+    // content; a parallax layer keeps translating at a non-rigid rate and must not
+    // be mis-read as a slide.
+    const laterRate = translateRate(later);
+    const rigidWhenShown = laterRate !== null && Math.abs(laterRate - 1) <= RIGID_RATE_TOLERANCE;
+    if (rigidWhenShown) {
+        const enterTy = entering.reduce((m, o) => (Math.abs(o.ty) > Math.abs(m) ? o.ty : m), 0);
+        const shownTy = Math.min(...later.map((o) => Math.abs(o.ty)));
+        if (Math.abs(enterTy) >= SLIDE_START_PX && shownTy <= SLIDE_SETTLED_PX) {
+            return enterTy > 0 ? 'slide-up' : 'slide-down';
+        }
+        const enterScale = entering.reduce((m, o) => (Math.abs(o.scale - 1) > Math.abs(m - 1) ? o.scale : m), 1);
+        const shownScale = Math.min(...later.map((o) => Math.abs(o.scale - 1)));
+        if (Math.abs(enterScale - 1) >= SCALE_START && shownScale <= SCALE_SETTLED)
+            return 'scale-in';
+    }
+    return null;
+}
+/** True when an element stayed pinned (sticky/fixed, ~constant top) while scrolled. */
+function isPinned(series) {
+    const pinned = series.filter((o) => o.position === 'sticky' || o.position === 'fixed');
+    if (pinned.length < 2)
+        return false;
+    const tops = pinned.map((o) => o.top);
+    const topRange = Math.max(...tops) - Math.min(...tops);
+    const scrollSpan = pinned[pinned.length - 1].scrollY - pinned[0].scrollY;
+    // Pinned only counts while the element is actually within the viewport band.
+    const inView = pinned.some((o) => o.top >= -STICKY_TOP_VARIANCE_PX && o.top <= o.viewportHeight);
+    return inView && topRange <= STICKY_TOP_VARIANCE_PX && scrollSpan >= PIN_MIN_SCROLL_PX;
+}
+/** Median translate rate of an element vs scroll, or null when it never moved with scroll. */
+function translateRate(series) {
+    const rates = [];
+    for (let k = 1; k < series.length; k++) {
+        const prev = series[k - 1];
+        const cur = series[k];
+        const dScroll = cur.scrollY - prev.scrollY;
+        if (dScroll <= 0)
+            continue;
+        // Rigid content moves up by dScroll in viewport coords (top decreases by dScroll).
+        rates.push((prev.top - cur.top) / dScroll);
+    }
+    if (rates.length === 0)
+        return null;
+    rates.sort((a, b) => a - b);
+    const mid = Math.floor(rates.length / 2);
+    return rates.length % 2 ? rates[mid] : (rates[mid - 1] + rates[mid]) / 2;
+}
+/**
+ * Fold sampled scroll steps into a `RawScrollCapture`, or `undefined` when the
+ * page could not scroll (nothing to observe). Pure + deterministic.
+ */
+export function detectRawScrollCapture(samples) {
+    if (samples.length < 2)
+        return undefined;
+    const viewportHeightPx = samples[0].viewportHeight;
+    const scrollHeightPx = Math.max(...samples.map((s) => s.scrollHeight));
+    if (viewportHeightPx <= 0)
+        return undefined;
+    if (scrollHeightPx - viewportHeightPx < MIN_SCROLL_RANGE_PX)
+        return undefined;
+    const byEl = seriesByElement(samples);
+    let revealCount = 0;
+    const kinds = new Set();
+    let stickyCount = 0;
+    let parallax = 0;
+    for (const series of byEl.values()) {
+        const pinned = isPinned(series);
+        if (pinned)
+            stickyCount++;
+        const kind = classifyReveal(series);
+        if (kind) {
+            revealCount++;
+            kinds.add(kind);
+        }
+        if (!pinned) {
+            const rate = translateRate(series);
+            if (rate !== null) {
+                const isSlow = rate > PARALLAX_SLOW_LO && rate < PARALLAX_SLOW_HI;
+                const isFast = rate > PARALLAX_FAST;
+                if (isSlow || isFast)
+                    parallax = Math.max(parallax, clamp01(Math.abs(rate - 1)));
+            }
+        }
+    }
+    const reveals = { count: revealCount, kinds: [...kinds].sort() };
+    return {
+        scrollHeightPx,
+        viewportHeightPx,
+        steps: samples.length,
+        reveals,
+        stickyCount,
+        parallax: round2(parallax),
+    };
+}
+// ── (3) pure rollup — RawScrollCapture → ScrollMotionDNA ──────────────────────
+/**
+ * Normalise a raw scroll capture into the DNA-altitude `ScrollMotionDNA`,
+ * computing the derived `pageHeightRatio` and the `scrollDriven` verdict the raw
+ * capture leaves to the fold. Pure + deterministic.
+ */
+export function foldScrollMotion(raw) {
+    const pageHeightRatio = raw.viewportHeightPx > 0 ? round2(raw.scrollHeightPx / raw.viewportHeightPx) : 0;
+    const scrollDriven = raw.reveals.count >= SCROLL_DRIVEN_MIN_REVEALS ||
+        raw.stickyCount >= 1 ||
+        raw.parallax >= SCROLL_DRIVEN_MIN_PARALLAX;
+    return {
+        pageHeightRatio,
+        reveals: { count: raw.reveals.count, kinds: [...raw.reveals.kinds] },
+        stickyCount: raw.stickyCount,
+        parallax: raw.parallax,
+        scrollDriven,
+    };
+}
+// ── live harness behind the narrow seam ──────────────────────────────────────
+const DEFAULT_STEPS = 12;
+const DEFAULT_SETTLE_MS = 160;
+const MAX_TRACKED_ELEMENTS = 900;
+/**
+ * Build a no-arg page function that runs `scrollSampleCollector` with the
+ * resolved tunables baked in as literals. The locked `ScrollCapturePage.evaluate`
+ * seam is no-arg, and a serialised closure cannot carry config, so the values are
+ * inlined into the function source. `Function` runs only in Node to mint the
+ * wrapper; Playwright serialises and runs it in the page (CDP eval — not subject
+ * to page CSP).
+ */
+function buildPageCollector(steps, settleMs, maxElements) {
+    const src = scrollSampleCollector.toString();
+    // eslint-disable-next-line @typescript-eslint/no-implied-eval
+    return new Function(`return (${src})(${steps}, ${settleMs}, ${maxElements})`);
+}
+/**
+ * The shipped `ScrollCapturer`: drive a stepped top→bottom scroll on an already
+ * open, settled page and fold it to a `RawScrollCapture`. Browser-free — depends
+ * only on the `ScrollCapturePage.evaluate` seam — so a fake page drives it in
+ * unit tests. Returns `undefined` when the page cannot scroll or evaluation fails.
+ */
+export function createScrollCapturer() {
+    return {
+        async capture(page, opts = {}) {
+            const steps = clampInt(opts.steps ?? DEFAULT_STEPS, 3, 24);
+            const settleMs = clampInt(opts.settleMs ?? DEFAULT_SETTLE_MS, 0, 1000);
+            let samples;
+            try {
+                samples = await page.evaluate(buildPageCollector(steps, settleMs, MAX_TRACKED_ELEMENTS));
+            }
+            catch {
+                return undefined;
+            }
+            if (!Array.isArray(samples) || samples.length === 0)
+                return undefined;
+            return detectRawScrollCapture(samples);
+        },
+    };
+}
+//# sourceMappingURL=scroll-capture.js.map

package/dist/design/audit/reference/dna/scroll-capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-capture.js","sourceRoot":"","sources":["../../../../../src/design/audit/reference/dna/scroll-capture.ts"],"names":[],"mappings":"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"}

package/dist/design/audit/reference/engine/budget.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Engine budget accounting — the PURE home for all concurrency + judge-cost math.
+ *
+ * `planJudgeBudget` decides how many pairwise comparisons each leg can afford
+ * under an `EngineBudget`, and `mapWithConcurrency` runs independent async work
+ * with a bounded in-flight pool. Both are deterministic and IO/LLM-free so the
+ * orchestrator and the adapters stay thin — no module re-derives "how many calls
+ * can we afford" or hand-rolls a worker pool.
+ *
+ * Cost model (the single invariant every consumer relies on): one pairwise
+ * comparison is judged in BOTH slot orders (A/B then B/A) to debias position, so
+ * each comparison costs `2` judge calls per repetition. The total judge calls a
+ * plan implies is therefore:
+ *
+ *     (directionPairs + qualityPairs) × 2 × reps   ≤   budget.maxJudgeCalls
+ *
+ * `qualityPairs` folds in the per-`Dimension` expansion of the absolute quality
+ * leg: judging each of the `k` exemplars across `qualityDimensions` dimensions is
+ * `k × qualityDimensions` comparisons (or `k` overall-only comparisons when no
+ * dimension budget is affordable). When the full dimension set doesn't fit, the
+ * plan drops `qualityDimensions` to 0 — an honest overall-only leg — rather than
+ * fabricating per-dimension win-rates the budget never paid for.
+ */
+import type { EngineBudget } from '../contracts.js';
+/**
+ * A resolved judging plan. Every count is what the engine will actually issue,
+ * already bounded by `budget.maxJudgeCalls`.
+ */
+export interface JudgeBudgetPlan {
+    /** Distinct direction-vs-direction pairs to judge (relative ranking leg). */
+    directionPairs: number;
+    /** Page-vs-exemplar comparisons to judge (absolute quality leg). */
+    qualityPairs: number;
+    /** Repetitions per comparison (each rep = both slot orders). */
+    reps: number;
+    /**
+     * Number of product dimensions the quality leg can afford to judge per-dim.
+     * 0 ⇒ overall-only (no per-`Dimension` win-rates are produced).
+     */
+    qualityDimensions: number;
+}
+/**
+ * Plan the judge budget for one engine run.
+ *
+ * Preference order (richest → leanest), stopping at the first plan that fits
+ * `budget.maxJudgeCalls`:
+ *   1. full per-`Dimension` quality leg at the configured `judgeReps`,
+ *   2. overall-only quality leg at `judgeReps`, then walking reps down to 1.
+ * Dimensions are dropped before reps because a dimension-scoped leg is opt-in,
+ * whereas repetitions buy debiasing on every comparison. If even the leanest
+ * plan overflows (a pathologically small `maxJudgeCalls`), the pairs themselves
+ * are capped — direction pairs first (winner selection is the core artifact),
+ * then the overall quality pairs — so the returned plan never exceeds budget.
+ */
+export declare function planJudgeBudget(directionCount: number, k: number, budget: EngineBudget, dimensions?: number): JudgeBudgetPlan;
+/**
+ * Map `fn` over `items` with at most `n` calls in flight at once, preserving
+ * input order in the output. The first rejection propagates (in-flight siblings
+ * are not cancelled, mirroring `Promise.all`). A non-positive / non-finite `n`
+ * is treated as 1; concurrency never exceeds `items.length`.
+ */
+export declare function mapWithConcurrency<T, R>(items: T[], n: number, fn: (item: T, index: number) => Promise<R>): Promise<R[]>;
+//# sourceMappingURL=budget.d.ts.map

package/dist/design/audit/reference/engine/budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../../../../src/design/audit/reference/engine/budget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAKnD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,cAAc,EAAE,MAAM,CAAA;IACtB,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAA;IACpB,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,iBAAiB,EAAE,MAAM,CAAA;CAC1B;AAcD;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC7B,cAAc,EAAE,MAAM,EACtB,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,YAAY,EACpB,UAAU,CAAC,EAAE,MAAM,GAClB,eAAe,CAsCjB;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAC3C,KAAK,EAAE,CAAC,EAAE,EACV,CAAC,EAAE,MAAM,EACT,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GACzC,OAAO,CAAC,CAAC,EAAE,CAAC,CAcd"}