@juxtapose/core 0.2.0 → 0.5.0

package/dist/diff/structural.js

@@ -0,0 +1,219 @@
+// Structural diff → tier-0 verdict. Pure, no browser, no I/O.
+//
+// Composition: match → facts → shifts → unique labels → coverage → classify → summary, then a
+// signature over the abstracted facts. Every list is sorted by a documented
+// key and the result is built as one literal, so the same inputs always
+// serialize to the same bytes (the CLI promises that in its JSON contract).
+import { createHash } from 'node:crypto';
+import { classify, computeFlags } from './structural/classify.js';
+import { computeCoverage } from './structural/coverage.js';
+import { disambiguate } from './structural/disambiguate.js';
+import { compareCodeUnits, computeFacts } from './structural/deltas.js';
+import { matchElements } from './structural/match.js';
+import { synthesizeShifts } from './structural/shift.js';
+import { buildChange, buildSummary } from './structural/summary.js';
+export const MAX_DELTAS = 20;
+/** JSON.stringify(verdict).length never exceeds this. */
+export const MAX_VERDICT = 1500;
+/** `cause.files` is capped here as well as in the index: the budget is a
+ *  guarantee for any input. */
+export const MAX_CAUSE_FILES = 5;
+/** Longest `cause.files[].path`. The tail is kept: the file name is what a
+ *  reader greps for; a 10-deep monorepo prefix is not. */
+export const MAX_CAUSE_PATH = 80;
+/** The verdict plus every unexplained region: the verdict's own list is the
+ *  prefix that fits the budget, and crops must order and label from the whole. */
+export function structuralDiffWithCoverage(input) {
+    const { baseline, current, pixels, imagesIdentical } = input;
+    const comparable = baseline !== undefined &&
+        current !== undefined &&
+        !pixels.dimensionMismatch &&
+        baseline.viewport.width === current.viewport.width &&
+        baseline.viewport.height === current.viewport.height;
+    // With a truncated side, the elements past the cap exist but were not
+    // recorded; reporting them as removed would be a lie the summary already
+    // tells more honestly as a count.
+    // Labels are made unique last, so only elements still named after the
+    // shift collapse — the ones a reader will see — are renamed.
+    const facts = comparable
+        ? disambiguate(synthesizeShifts(computeFacts(baseline, current, matchElements(baseline, current)).filter((f) => !(f.delta.kind === 'removed' && current.truncated) &&
+            !(f.delta.kind === 'added' && baseline.truncated))), baseline, current)
+        : [];
+    const cov = computeCoverage(pixels.changedRegions, facts);
+    const ctx = {
+        baseline,
+        current,
+        facts,
+        explained: cov.explained,
+        unexplainedRegions: cov.unexplainedRegions,
+        pixels: {
+            imagesIdentical,
+            dimensionMismatch: pixels.dimensionMismatch,
+            hasRegions: cov.regionCount > 0,
+            subThreshold: !imagesIdentical && !pixels.dimensionMismatch && cov.regionCount === 0,
+        },
+    };
+    const { classification, styleTags } = classify(ctx);
+    const flags = computeFlags(ctx);
+    const deltas = facts.slice(0, MAX_DELTAS).map((f) => f.delta);
+    const summary = buildSummary({
+        classification,
+        styleTags,
+        deltas,
+        deltaCount: facts.length,
+        regionCount: cov.regionCount,
+        unexplainedRegions: cov.unexplainedRegions,
+        flags,
+        imagesIdentical,
+        baseline,
+        current,
+    });
+    // The same clauses with `el` swapped for role|tag, so it reads the same on
+    // every page that made the change. Absent when there is nothing to state.
+    const change = facts.length > 0
+        ? buildChange({
+            classification,
+            styleTags,
+            deltas: facts
+                .slice(0, MAX_DELTAS)
+                .map((f) => f.delta.kind === 'shift'
+                ? { ...f.delta, after: f.abstract }
+                : { ...f.delta, el: f.abstract }),
+            deltaCount: facts.length,
+            regionCount: 0,
+            unexplainedRegions: [],
+            flags,
+            imagesIdentical,
+        })
+        : undefined;
+    const sig = signature(classification, facts);
+    // Fitted here, not trusted from the caller: the budget is a guarantee for
+    // any input, and the index's cap is a courtesy.
+    const cause = input.cause && fitCause(input.cause);
+    // One literal, one key order: the CLI's byte-stability rests on it.
+    const build = (ds, regions) => ({
+        schema: 'juxtapose.verdict/v1',
+        classification,
+        styleTags,
+        summary,
+        ...(change ? { change } : {}),
+        deltas: ds,
+        deltaCount: facts.length,
+        coverage: cov.coverage,
+        explained: cov.explained,
+        unexplainedRegions: regions,
+        flags,
+        ...(cause ? { cause } : {}),
+        signature: sig,
+        escalate: { command: input.escalate.command },
+    });
+    // The tier-0 budget is a guarantee, not a corpus statistic. Labels (60)
+    // and values (200) are capped, but one delta is still 70–400 chars, so 20
+    // of them (or a diff with hundreds of regions) would pass 1,500: one button
+    // with 10 realistic style changes measured 1,701. Each list keeps the
+    // prefix that fits — deltas first, they are the "what" — while deltaCount,
+    // coverage and explained still describe the whole. Holds for any input
+    // except an escalate command that alone exceeds the budget.
+    let room = MAX_VERDICT - JSON.stringify(build([], [])).length;
+    const fit = (items) => {
+        const out = [];
+        for (const x of items) {
+            const n = JSON.stringify(x).length + (out.length > 0 ? 1 : 0);
+            if (n > room)
+                break;
+            room -= n;
+            out.push(x);
+        }
+        return out;
+    };
+    const kept = fit(deltas);
+    return {
+        verdict: build(kept, fit(cov.unexplainedRegions)),
+        unexplainedRegions: cov.unexplainedRegions,
+        elementRegions: elementRegions(facts),
+    };
+}
+/** Facts are grouped by element identity (`source`), not label: two
+ *  `div.card`s are two boxes. A shift carries its anchor's source but its
+ *  run's rects, so it is a box of its own rather than swelling the anchor's.
+ *  Zero-area unions carry no pixels and are dropped. */
+function elementRegions(facts) {
+    const boxes = new Map();
+    for (const f of facts) {
+        const key = `${f.delta.kind === 'shift' ? 'shift:' : ''}${f.source.side}:${f.source.index}`;
+        for (const r of f.rects) {
+            const b = boxes.get(key);
+            const x0 = Math.floor(r.x);
+            const y0 = Math.floor(r.y);
+            const x1 = Math.ceil(r.x + r.w);
+            const y1 = Math.ceil(r.y + r.h);
+            boxes.set(key, b
+                ? {
+                    x0: Math.min(b.x0, x0),
+                    y0: Math.min(b.y0, y0),
+                    x1: Math.max(b.x1, x1),
+                    y1: Math.max(b.y1, y1),
+                }
+                : { x0, y0, x1, y1 });
+        }
+    }
+    return [...boxes.values()]
+        .map((b) => ({ x: b.x0, y: b.y0, width: b.x1 - b.x0, height: b.y1 - b.y0 }))
+        .filter((r) => r.width > 0 && r.height > 0);
+}
+/** The verdict alone; what every caller but `--crops` wants. */
+export function structuralDiff(input) {
+    return structuralDiffWithCoverage(input).verdict;
+}
+/** sha256 of the classification, then the facts with each element reduced
+ *  to role|tag and the values kept: "every button background
+ *  #2563eb→#1d4ed8" hashes the same on any page that made that change. The
+ *  classification leads so that verdicts with no facts — identical, a
+ *  canvas redraw, a size change — do not all share one signature. Facts are
+ *  sorted (by code unit) so order of discovery cannot leak in. */
+function signature(classification, facts) {
+    const items = facts
+        .map((f) => {
+        const d = f.delta;
+        const rest = d.kind === 'text' || d.kind === 'style' || d.kind === 'attr'
+            ? [
+                d.kind === 'style' ? d.prop : d.kind === 'attr' ? d.attr : 'text',
+                d.from,
+                d.to,
+            ]
+            : d.kind === 'moved'
+                ? ['moved', d.dx, d.dy]
+                : d.kind === 'resized'
+                    ? ['resized', d.dw, d.dh]
+                    : d.kind === 'shift'
+                        ? ['shift', d.dx, d.dy, d.count]
+                        : [d.kind];
+        return JSON.stringify([f.abstract, ...rest]);
+    })
+        .sort(compareCodeUnits);
+    return createHash('sha256')
+        .update([classification, ...items].join('\n'))
+        .digest('hex');
+}
+function fitCause(c) {
+    return {
+        kind: c.kind,
+        files: c.files.slice(0, MAX_CAUSE_FILES).map((f) => ({
+            path: clipHead(f.path, MAX_CAUSE_PATH),
+            distance: f.distance,
+        })),
+        ...(c.partial ? { partial: true } : {}),
+    };
+}
+/** `…` plus at most the last `max - 1` code units, never starting on the
+ *  low half of a surrogate pair: a lone surrogate is not valid UTF-8. */
+function clipHead(s, max) {
+    if (s.length <= max)
+        return s;
+    let from = s.length - (max - 1);
+    const c = s.charCodeAt(from);
+    if (c >= 0xdc00 && c <= 0xdfff)
+        from++;
+    return '…' + s.slice(from);
+}
+//# sourceMappingURL=structural.js.map

package/dist/diff/structural.js.map

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

package/dist/index.d.ts

@@ -1,17 +1,39 @@
-export type { StoryParams, Viewport, StoryManifest, Snapshot, ChangedRegion, DiffStatus, DiffResult, RunReport, ApprovalMeta, BaselineEntry, BaselineManifest, ProjectConfig, StorageConfig, BaselineStore, } from './types.js';
+export type { StoryParams, Viewport, StoryManifest, Snapshot, StructureSnapshot, StructureElement, StructureRect, CaptureEnv, ChangedRegion, Delta, Classification, StyleTag, Flag, StructuralVerdict, Cause, CauseKind, DiffStatus, DiffResult, RunReport, RunGroup, ApprovalMeta, BaselineEntry, BaselineManifest, ProjectConfig, UrlEntry, StorageConfig, BaselineStore, } from './types.js';
 export type { Platform, EnumerateTarget, SettleContext } from './platform.js';
 export { navigateToStory } from './url-platform.js';
-export { hashImage, resolveStatus, toDiffStatus, type BaselineStatus, type AncestryCheck, } from './baseline/status.js';
+export { createUrlPlatform } from './platforms/urls.js';
+export { waitForSelector } from './capture/settle.js';
 export { GitBaselineStore, encodeStoryId } from './baseline/git-store.js';
+export { hashImage } from './baseline/status.js';
+export type { BaselineStatus, AncestryCheck } from './baseline/status.js';
 export { createAncestryCheck, alwaysAncestor } from './git/ancestry.js';
-export { armSettle, drain, waitForSelector, waitForPaint, FREEZE_ANIMATIONS_CSS, DOM_IDLE_MS, DOM_IDLE_TIMEOUT_MS, } from './capture/settle.js';
-export { captureStory, type CaptureDeps } from './capture/capture.js';
-export { deterministicLaunchOptions, DETERMINISTIC_CHROMIUM_ARGS, type LaunchOptions, } from './capture/launch.js';
-export { capturePool, DEFAULT_CONCURRENCY, type PoolOptions, type CaptureOutcome, } from './capture/pool.js';
-export { diffImages, resolveThreshold, resolveMinDiffPercent, type DiffOutput, } from './diff/diff.js';
-export { computeChangedRegions } from './diff/regions.js';
-export { resolveAffected, type AffectedOptions, type AffectedResult, } from './analysis/affected.js';
+export { encodeStructure, decodeStructure } from './capture/structure.js';
+export { approveCapture, readRunStructure, type RunStructure, } from './baseline/approve.js';
+export { structuralDiff, structuralDiffWithCoverage, type StructuralDiffInput, } from './diff/structural.js';
+export { compareSnaps, type SnapSide, type SnapComparison } from './diff/compare.js';
+export { renderCrops, MAX_CROPS, MAX_CROP_SIDE, type Crop } from './diff/crops.js';
+export { describeDelta, describeDeltas } from './diff/structural/summary.js';
+export { compareCodeUnits } from './diff/structural/deltas.js';
+export { shellQuote } from './shell-quote.js';
 export { runCapture, DEFAULT_VIEWPORT, type RunOptions, type RunArtifact, } from './run/run.js';
-export { buildHandoffPrompt, describeRegion, type HandoffPayload, } from './agent/handoff.js';
-export { buildComment, COMMENT_MARKER, type CommentOptions } from './report/comment.js';
-export { resolveGitHubContext, postComment, type GitHubContext, } from './report/github.js';
+export { computeGroups } from './run/groups.js';
+export { phases, formatPhases, type Phases } from './run/phases.js';
+export { snapPage, snapPages, type SnapOptions, type SnapResult, type SnapPagesOptions, type SnapPageResult, } from './capture/snap.js';
+export { deterministicLaunchOptions, type LaunchOptions } from './capture/launch.js';
+export { chromeArgs, PARITY_CHROMIUM_ARGS } from './capture/launch.js';
+export type { Browser, BrowserContext } from './browser/browser.js';
+export { BrowserDiedError } from './browser/browser.js';
+export { TargetClosedError } from './browser/cdp.js';
+export { PageCrashedError, TimeoutError, type Page } from './browser/page.js';
+export { acquireBrowser, type AcquireOptions } from './browser/acquire.js';
+export { resolveChrome, juxCacheDir, noBrowserMessage, NO_BROWSER_MESSAGE, type ChromeSource, type ResolvedChrome, } from './browser/resolve.js';
+export { installChrome, proxyReexecArgs, stderrProgress, type InstallOptions, type InstallResult, } from './browser/install.js';
+export { CHROME_VERSION, CHROME_PINS, chromePlatform } from './browser/pins.js';
+export { assertCssSelector } from './browser/selectors.js';
+export { resolveAffected, resolveAffectedFromPaths, gitIsCommit, type AffectedOptions, type AffectedResult, } from './analysis/affected.js';
+export { buildCauseIndex, prepareCause, type CauseIndex, type CauseSources, type ChangedFile, } from './analysis/cause.js';
+export { buildHandoffPrompt, describeCause, type HandoffPayload, } from './agent/handoff.js';
+export { buildComment, type CommentOptions } from './report/comment.js';
+export { buildHtmlReport, type HtmlReportOptions } from './report/html.js';
+export { formatPercent } from './report/format.js';
+export { resolveArtifactUrl, resolveGitHubContext, postComment, type GitHubContext, } from './report/github.js';

package/dist/index.js

@@ -1,16 +1,60 @@
+// The public surface of @juxtapose/core.
+//
+// Everything here is a semver commitment once this publishes, so it is chosen
+// rather than accumulated. The settle pipeline, the diff internals and the
+// worker pool are deliberately NOT exported: CLAUDE.md describes them as
+// load-bearing and easy to break, and exporting them invites downstream code
+// to pin exactly the parts that most need freedom to change.
+//
+// If you are writing a third-party adapter or baseline store, the types and
+// helpers below are what you need. If something is missing for that, the seam
+// needs widening — say so rather than reaching into the package.
 export { navigateToStory } from './url-platform.js';
-export { hashImage, resolveStatus, toDiffStatus, } from './baseline/status.js';
+export { createUrlPlatform } from './platforms/urls.js';
+export { waitForSelector } from './capture/settle.js';
+// Implementing a baseline store. `encodeStoryId` matters for anyone building
+// keys from a story id — they are platform-supplied and not path-safe.
 export { GitBaselineStore, encodeStoryId } from './baseline/git-store.js';
+// hashImage is exported because anything comparing against a manifest entry
+// must use the same function the manifest was written with, not its own copy.
+export { hashImage } from './baseline/status.js';
 export { createAncestryCheck, alwaysAncestor } from './git/ancestry.js';
-export { armSettle, drain, waitForSelector, waitForPaint, FREEZE_ANIMATIONS_CSS, DOM_IDLE_MS, DOM_IDLE_TIMEOUT_MS, } from './capture/settle.js';
-export { captureStory } from './capture/capture.js';
-export { deterministicLaunchOptions, DETERMINISTIC_CHROMIUM_ARGS, } from './capture/launch.js';
-export { capturePool, DEFAULT_CONCURRENCY, } from './capture/pool.js';
-export { diffImages, resolveThreshold, resolveMinDiffPercent, } from './diff/diff.js';
-export { computeChangedRegions } from './diff/regions.js';
-export { resolveAffected, } from './analysis/affected.js';
+// Structure sidecars: read and write the gzipped snapshot beside an image.
+export { encodeStructure, decodeStructure } from './capture/structure.js';
+// Approving a run capture with its sidecar: every approval path (CLI approve,
+// init, the review server) goes through this so they cannot disagree.
+export { approveCapture, readRunStructure, } from './baseline/approve.js';
+// Structural diff: two sidecars + a pixel diff → the tier-0 verdict.
+export { structuralDiff, structuralDiffWithCoverage, } from './diff/structural.js';
+export { compareSnaps } from './diff/compare.js';
+// Tier-3 crops: two images + regions → side-by-side PNG strips, no browser.
+export { renderCrops, MAX_CROPS, MAX_CROP_SIDE } from './diff/crops.js';
+export { describeDelta, describeDeltas } from './diff/structural/summary.js';
+export { compareCodeUnits } from './diff/structural/deltas.js';
+export { shellQuote } from './shell-quote.js';
+// Driving a run.
 export { runCapture, DEFAULT_VIEWPORT, } from './run/run.js';
-export { buildHandoffPrompt, describeRegion, } from './agent/handoff.js';
-export { buildComment, COMMENT_MARKER } from './report/comment.js';
-export { resolveGitHubContext, postComment, } from './report/github.js';
+export { computeGroups } from './run/groups.js';
+// Per-phase timings, so a slow run can say which phase was slow.
+export { phases, formatPhases } from './run/phases.js';
+export { snapPage, snapPages, } from './capture/snap.js';
+export { deterministicLaunchOptions } from './capture/launch.js';
+export { chromeArgs, PARITY_CHROMIUM_ARGS } from './capture/launch.js';
+export { BrowserDiedError } from './browser/browser.js';
+export { TargetClosedError } from './browser/cdp.js';
+export { PageCrashedError, TimeoutError } from './browser/page.js';
+export { acquireBrowser } from './browser/acquire.js';
+export { resolveChrome, juxCacheDir, noBrowserMessage, NO_BROWSER_MESSAGE, } from './browser/resolve.js';
+export { installChrome, proxyReexecArgs, stderrProgress, } from './browser/install.js';
+export { CHROME_VERSION, CHROME_PINS, chromePlatform } from './browser/pins.js';
+export { assertCssSelector } from './browser/selectors.js';
+export { resolveAffected, resolveAffectedFromPaths, gitIsCommit, } from './analysis/affected.js';
+// Cause: the story's import closure intersected with the changed files.
+export { buildCauseIndex, prepareCause, } from './analysis/cause.js';
+// Reporting on one.
+export { buildHandoffPrompt, describeCause, } from './agent/handoff.js';
+export { buildComment } from './report/comment.js';
+export { buildHtmlReport } from './report/html.js';
+export { formatPercent } from './report/format.js';
+export { resolveArtifactUrl, resolveGitHubContext, postComment, } from './report/github.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EACL,SAAS,EACT,aAAa,EACb,YAAY,GAGb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE1E,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExE,OAAO,EACL,SAAS,EACT,KAAK,EACL,eAAe,EACf,YAAY,EACZ,qBAAqB,EACrB,WAAW,EACX,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAoB,MAAM,sBAAsB,CAAC;AACtE,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,GAE5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,WAAW,EACX,mBAAmB,GAGpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,qBAAqB,GAEtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,EACL,eAAe,GAGhB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,UAAU,EACV,gBAAgB,GAGjB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,kBAAkB,EAClB,cAAc,GAEf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,YAAY,EAAE,cAAc,EAAuB,MAAM,qBAAqB,CAAC;AACxF,OAAO,EACL,oBAAoB,EACpB,WAAW,GAEZ,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/platform.d.ts

@@ -1,4 +1,4 @@
-import type { Page } from 'playwright';
+import type { Page } from './browser/page.js';
 import type { StoryManifest, StoryParams } from './types.js';
 export interface EnumerateTarget {
     /** Built workbench directory, when capturing a static build. */

package/dist/platforms/urls.d.ts

@@ -0,0 +1,3 @@
+import type { Platform } from '../platform.js';
+import type { UrlEntry } from '../types.js';
+export declare function createUrlPlatform(urls: UrlEntry[]): Platform;

package/dist/platforms/urls.js

@@ -0,0 +1,89 @@
+// The null platform: an explicit list of URLs, no workbench (issue #11).
+//
+// Everything a workbench adapter contributes — enumeration, a render signal,
+// componentPath — is absent here, which is exactly what the Platform seam was
+// designed to allow: settling falls entirely to core's generic pipeline (DOM
+// quiescence, fonts, images, animation freeze, paint barrier), and affected
+// analysis sees an empty componentPath and falls back to capturing everything.
+//
+// Lives in core rather than its own adapter package because it has no
+// knowledge of any workbench and `jux snap` must always have it.
+export function createUrlPlatform(urls) {
+    const notHttp = (u) => new Error(`jux: url '${u.url}' for id '${u.id}' must be http(s)`);
+    const isHttp = (url) => url.protocol === 'http:' || url.protocol === 'https:';
+    // Ids are baseline keys. A Map would silently keep the last duplicate and
+    // two pages would share one baseline, so reject them up front.
+    const byId = new Map();
+    for (const u of urls) {
+        if (!u.id)
+            throw new Error('jux: url entry has an empty id');
+        // Validate with the same parser navigation uses. A regex disagrees with it:
+        // WHATWG strips leading/trailing C0 controls and spaces and removes tabs and
+        // newlines, so ' file:///x' or 'fi\tle:///x' looks relative to a regex but
+        // navigates to file:. A file:/javascript:/data: url would let whoever
+        // controls the config (a fork PR in CI) publish local file contents in the
+        // image and structure sidecar. 'localhost:3000/x' (scheme "localhost:")
+        // also becomes a clear error instead of a confusing navigation failure.
+        let abs = null;
+        try {
+            abs = new URL(u.url);
+        }
+        catch {
+            // relative; checked again against the origin in resolve()
+        }
+        if (abs && !isHttp(abs))
+            throw notHttp(u);
+        if (byId.has(u.id))
+            throw new Error(`jux: duplicate url id '${u.id}'`);
+        byId.set(u.id, u);
+    }
+    const resolve = (id, baseUrl) => {
+        const entry = byId.get(id);
+        if (!entry)
+            throw new Error(`jux: no url with id '${id}'`);
+        let final;
+        try {
+            final = new URL(entry.url);
+        }
+        catch {
+            if (!/^https?:/i.test(baseUrl)) {
+                throw new Error(`jux: relative url '${entry.url}' needs --origin`);
+            }
+            final = new URL(entry.url, baseUrl);
+        }
+        // Navigate to exactly what was validated.
+        if (!isHttp(final))
+            throw notHttp(entry);
+        return final.href;
+    };
+    return {
+        name: 'urls',
+        async detect() {
+            return false;
+        },
+        async enumerate() {
+            return urls.map((u) => ({
+                storyId: u.id,
+                title: u.id,
+                name: u.id,
+                componentPath: '',
+                params: u.params ?? {},
+            }));
+        },
+        async showStory(page, storyId, baseUrl) {
+            await page.goto(resolve(storyId, baseUrl));
+        },
+        previewUrl() {
+            return 'about:blank';
+        },
+        storyUrl(baseUrl, storyId) {
+            return resolve(storyId, baseUrl);
+        },
+        async settle() {
+            // No platform render signal. Core's generic settle runs after this.
+        },
+        configDirs: [],
+        storyFileGlobs: [],
+    };
+}
+//# sourceMappingURL=urls.js.map

package/dist/platforms/urls.js.map

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

package/dist/report/comment.d.ts

@@ -10,7 +10,8 @@ export declare const COMMENT_MARKER = "<!-- juxtapose-bot -->";
 export interface CommentOptions {
     report: RunReport;
     /** Where to point someone who wants the images. Omitted when there is no
-     *  artifact to link to. */
+     *  artifact to link to — a link to an empty artifacts list is worse than no
+     *  link, so callers pass this only when they actually wrote a report. */
     artifactUrl?: string;
 }
 export declare function buildComment({ report, artifactUrl }: CommentOptions): string;