@domandigital/craft 0.12.0 → 0.14.0

package/dist/audit.d.cts

@@ -93,6 +93,57 @@ interface SnapshotSection {
     role?: SectionRole;
     /** Version 2. */
     geometry?: SectionGeometry;
+    /** Version 2: short pill or label texts in the section ("Most popular", "New"), at most 5. */
+    badges?: string[];
+    /** Version 2: small round portraits (at most 96px, roughly square, radius 40% or more). */
+    avatars?: number;
+    /** Version 2: a horizontal scroller, snap track or prev/next control holds the content. */
+    carousel?: boolean;
+    /** Version 2: large standalone figures ("500+", "98%", "4.9/5") at 24px or more. */
+    figures?: number;
+    /**
+     * Version 2, craft 0.13 and later: the section's visible text, one block per
+     * heading, paragraph, list item or quote, each at most 300 characters, at
+     * most 40. Navigation, buttons and footers are left out. What the
+     * specificity and proof tells read.
+     */
+    text?: string[];
+}
+type ImageRole = "photo" | "illustration" | "icon" | "avatar" | "logo";
+/**
+ * What the image's own bytes say about where it came from. Only a positive
+ * is evidence: most images carry no metadata at all, and a re-encode strips
+ * it, so no marker proves nothing.
+ */
+interface ImageProvenance {
+    /** The IPTC digital source type found, if any: "trainedAlgorithmicMedia" or "compositeWithTrainedAlgorithmicMedia". */
+    digitalSourceType: string | null;
+    /** Where the marker sat: an XMP packet, a C2PA manifest, or somewhere else in the file. */
+    source: "xmp" | "c2pa" | "other" | null;
+    /** The file carries a C2PA manifest (Content Credentials), whatever it says. */
+    c2pa: boolean;
+    /** Bytes read, from the start of the file. */
+    bytes: number;
+}
+/** One image as the visitor sees it: an `img`, or a CSS background large enough to be a picture. */
+interface SnapshotImage {
+    /** The URL the browser loaded, unwrapped from an image optimiser (`/_next/image?url=`), or a `data:` URI cut to 64 characters. */
+    src: string;
+    /** Host of `src`, or null for a `data:` URI. */
+    host: string | null;
+    width: number;
+    height: number;
+    top: number;
+    role: ImageRole;
+    alt: string | null;
+    /** Empty alt, `aria-hidden` or `role="presentation"`. */
+    decorative: boolean;
+    /** Index into `sections`, or null when the image sits outside them. */
+    section: number | null;
+    /** A CSS `background-image`, not an `img`. */
+    background: boolean;
+    /** Present when the bytes were read. */
+    provenance?: ImageProvenance;
 }
 /**
  * Measures of the rendered pixels, from a full-page screenshot (capped at
@@ -167,6 +218,18 @@ interface Snapshot {
     rhythmVariance?: number | null;
     /** Version 2: absent when the page could not be screenshotted. */
     visual?: SnapshotVisual;
+    /**
+     * Version 2, craft 0.13 and later: every image on the page, largest first, at
+     * most 60. Absent in older snapshots, which the imagery tells never judge.
+     */
+    images?: SnapshotImage[];
+    /**
+     * Version 2, craft 0.13 and later: the text a visitor reads before
+     * scrolling, at most 12 blocks. Navigation, a header without the headline,
+     * and the words on buttons and links are left out: this is the page's
+     * claim, not its menu or its calls to action.
+     */
+    firstScreenText?: string[];
     /** Set when a version 1 snapshot was read and upgraded in memory. */
     migratedFrom?: 1;
     /** The design-system measures trawl has collected since v7, kept so it can switch to this. */
@@ -326,6 +389,21 @@ interface FingerprintSection {
     centred: number;
     /** Content width over viewport width, 0 to 1. */
     width: number;
+    /** Left-right balance of the content, 0 to 1. Component comparison only. */
+    symmetry?: number;
+    /** Buttons in the section. */
+    controls?: number;
+    /** Cards side by side. */
+    cards?: number;
+    /** The section's own background, or null when it is the page ground. */
+    background?: Oklch | null;
+    /** Badge texts ("Most popular"), lower-cased. */
+    badges?: string[];
+    /** Small round portraits. */
+    avatars?: number;
+    carousel?: boolean;
+    /** Large standalone figures. */
+    figures?: number;
 }
 interface Fingerprint {
     version: 1 | 2;
@@ -393,6 +471,8 @@ interface SnapshotOptions {
     timeoutMs?: number;
     /** Take a screenshot and measure its pixels (`visual`). Default true. */
     visual?: boolean;
+    /** Read the first bytes of the page's larger images for AI provenance markers. Default true. */
+    provenance?: boolean;
 }
 interface MinimalPage {
     close?(): Promise<void>;
@@ -413,7 +493,21 @@ interface MinimalPage {
             height: number;
         };
     }): Promise<Uint8Array>;
+    /** Optional: Playwright's request context, which fetches outside the page's CORS rules. Without it, no image gets `provenance`. */
+    request?: {
+        get(url: string, options?: {
+            headers?: Record<string, string>;
+            timeout?: number;
+        }): Promise<{
+            ok(): boolean;
+            body(): Promise<Uint8Array>;
+        }>;
+    };
 }
+/** At most this many images are read for provenance, largest first. */
+declare const PROVENANCE_MAX_IMAGES = 24;
+/** The most time the reads may take for one page, in ms, so a machine offline waits seconds, not minutes. */
+declare const PROVENANCE_BUDGET_MS = 20000;
 /** The most of a page the screenshot measures read, in CSS px. A long page is judged on its opening. */
 declare const VISUAL_MAX_HEIGHT = 6000;
 interface MinimalBrowser {
@@ -465,4 +559,4 @@ interface AuditResult {
 /** Snapshot a URL, judge it against the rendered tells, and fingerprint it. */
 declare function audit(url: string, options?: SnapshotOptions & CheckOptions): Promise<AuditResult>;
 
-export { type AuditResult, type SnapshotOptions, type SnapshotResult, VISUAL_MAX_HEIGHT, audit, collectInPage, loadPlaywright, overlayInPage, snapshotPage, snapshotUrl, snapshotUrls };
+export { type AuditResult, PROVENANCE_BUDGET_MS, PROVENANCE_MAX_IMAGES, type SnapshotOptions, type SnapshotResult, VISUAL_MAX_HEIGHT, audit, collectInPage, loadPlaywright, overlayInPage, snapshotPage, snapshotUrl, snapshotUrls };

package/dist/audit.d.ts

@@ -93,6 +93,57 @@ interface SnapshotSection {
     role?: SectionRole;
     /** Version 2. */
     geometry?: SectionGeometry;
+    /** Version 2: short pill or label texts in the section ("Most popular", "New"), at most 5. */
+    badges?: string[];
+    /** Version 2: small round portraits (at most 96px, roughly square, radius 40% or more). */
+    avatars?: number;
+    /** Version 2: a horizontal scroller, snap track or prev/next control holds the content. */
+    carousel?: boolean;
+    /** Version 2: large standalone figures ("500+", "98%", "4.9/5") at 24px or more. */
+    figures?: number;
+    /**
+     * Version 2, craft 0.13 and later: the section's visible text, one block per
+     * heading, paragraph, list item or quote, each at most 300 characters, at
+     * most 40. Navigation, buttons and footers are left out. What the
+     * specificity and proof tells read.
+     */
+    text?: string[];
+}
+type ImageRole = "photo" | "illustration" | "icon" | "avatar" | "logo";
+/**
+ * What the image's own bytes say about where it came from. Only a positive
+ * is evidence: most images carry no metadata at all, and a re-encode strips
+ * it, so no marker proves nothing.
+ */
+interface ImageProvenance {
+    /** The IPTC digital source type found, if any: "trainedAlgorithmicMedia" or "compositeWithTrainedAlgorithmicMedia". */
+    digitalSourceType: string | null;
+    /** Where the marker sat: an XMP packet, a C2PA manifest, or somewhere else in the file. */
+    source: "xmp" | "c2pa" | "other" | null;
+    /** The file carries a C2PA manifest (Content Credentials), whatever it says. */
+    c2pa: boolean;
+    /** Bytes read, from the start of the file. */
+    bytes: number;
+}
+/** One image as the visitor sees it: an `img`, or a CSS background large enough to be a picture. */
+interface SnapshotImage {
+    /** The URL the browser loaded, unwrapped from an image optimiser (`/_next/image?url=`), or a `data:` URI cut to 64 characters. */
+    src: string;
+    /** Host of `src`, or null for a `data:` URI. */
+    host: string | null;
+    width: number;
+    height: number;
+    top: number;
+    role: ImageRole;
+    alt: string | null;
+    /** Empty alt, `aria-hidden` or `role="presentation"`. */
+    decorative: boolean;
+    /** Index into `sections`, or null when the image sits outside them. */
+    section: number | null;
+    /** A CSS `background-image`, not an `img`. */
+    background: boolean;
+    /** Present when the bytes were read. */
+    provenance?: ImageProvenance;
 }
 /**
  * Measures of the rendered pixels, from a full-page screenshot (capped at
@@ -167,6 +218,18 @@ interface Snapshot {
     rhythmVariance?: number | null;
     /** Version 2: absent when the page could not be screenshotted. */
     visual?: SnapshotVisual;
+    /**
+     * Version 2, craft 0.13 and later: every image on the page, largest first, at
+     * most 60. Absent in older snapshots, which the imagery tells never judge.
+     */
+    images?: SnapshotImage[];
+    /**
+     * Version 2, craft 0.13 and later: the text a visitor reads before
+     * scrolling, at most 12 blocks. Navigation, a header without the headline,
+     * and the words on buttons and links are left out: this is the page's
+     * claim, not its menu or its calls to action.
+     */
+    firstScreenText?: string[];
     /** Set when a version 1 snapshot was read and upgraded in memory. */
     migratedFrom?: 1;
     /** The design-system measures trawl has collected since v7, kept so it can switch to this. */
@@ -326,6 +389,21 @@ interface FingerprintSection {
     centred: number;
     /** Content width over viewport width, 0 to 1. */
     width: number;
+    /** Left-right balance of the content, 0 to 1. Component comparison only. */
+    symmetry?: number;
+    /** Buttons in the section. */
+    controls?: number;
+    /** Cards side by side. */
+    cards?: number;
+    /** The section's own background, or null when it is the page ground. */
+    background?: Oklch | null;
+    /** Badge texts ("Most popular"), lower-cased. */
+    badges?: string[];
+    /** Small round portraits. */
+    avatars?: number;
+    carousel?: boolean;
+    /** Large standalone figures. */
+    figures?: number;
 }
 interface Fingerprint {
     version: 1 | 2;
@@ -393,6 +471,8 @@ interface SnapshotOptions {
     timeoutMs?: number;
     /** Take a screenshot and measure its pixels (`visual`). Default true. */
     visual?: boolean;
+    /** Read the first bytes of the page's larger images for AI provenance markers. Default true. */
+    provenance?: boolean;
 }
 interface MinimalPage {
     close?(): Promise<void>;
@@ -413,7 +493,21 @@ interface MinimalPage {
             height: number;
         };
     }): Promise<Uint8Array>;
+    /** Optional: Playwright's request context, which fetches outside the page's CORS rules. Without it, no image gets `provenance`. */
+    request?: {
+        get(url: string, options?: {
+            headers?: Record<string, string>;
+            timeout?: number;
+        }): Promise<{
+            ok(): boolean;
+            body(): Promise<Uint8Array>;
+        }>;
+    };
 }
+/** At most this many images are read for provenance, largest first. */
+declare const PROVENANCE_MAX_IMAGES = 24;
+/** The most time the reads may take for one page, in ms, so a machine offline waits seconds, not minutes. */
+declare const PROVENANCE_BUDGET_MS = 20000;
 /** The most of a page the screenshot measures read, in CSS px. A long page is judged on its opening. */
 declare const VISUAL_MAX_HEIGHT = 6000;
 interface MinimalBrowser {
@@ -465,4 +559,4 @@ interface AuditResult {
 /** Snapshot a URL, judge it against the rendered tells, and fingerprint it. */
 declare function audit(url: string, options?: SnapshotOptions & CheckOptions): Promise<AuditResult>;
 
-export { type AuditResult, type SnapshotOptions, type SnapshotResult, VISUAL_MAX_HEIGHT, audit, collectInPage, loadPlaywright, overlayInPage, snapshotPage, snapshotUrl, snapshotUrls };
+export { type AuditResult, PROVENANCE_BUDGET_MS, PROVENANCE_MAX_IMAGES, type SnapshotOptions, type SnapshotResult, VISUAL_MAX_HEIGHT, audit, collectInPage, loadPlaywright, overlayInPage, snapshotPage, snapshotUrl, snapshotUrls };