@ztothez/design-engineering 2.0.0

package/dist/src/runtime/policy.js

@@ -0,0 +1,97 @@
+import { existsSync } from "node:fs";
+export const DEFAULT_RUNTIME_VIEWPORTS = [
+    { name: "mobile-375", width: 375, height: 812 },
+    { name: "tablet-768", width: 768, height: 1024 },
+    { name: "desktop-1024", width: 1024, height: 768 },
+    { name: "wide-1440", width: 1440, height: 900 },
+];
+export const DEFAULT_RUNTIME_COLOR_SCHEMES = ["light"];
+export const DEFAULT_NAVIGATION_TIMEOUT_MS = 30_000;
+export const DEFAULT_SETTLE_MS = 500;
+export const MAX_RUNTIME_VIEWPORTS = 8;
+export const MAX_RUNTIME_JOURNEYS = 10;
+export const MAX_JOURNEY_STEPS = 50;
+const chromiumCandidates = [
+    "/usr/bin/chromium",
+    "/usr/bin/chromium-browser",
+    "/usr/bin/google-chrome",
+    "/usr/bin/google-chrome-stable",
+];
+export function resolveChromiumPath(configuredPath) {
+    const explicitPath = configuredPath ?? process.env.ZTOTHEZ_DESIGN_CHROMIUM_PATH;
+    if (explicitPath) {
+        if (!existsSync(explicitPath)) {
+            throw new Error(`Configured Chromium executable does not exist: ${explicitPath}`);
+        }
+        return explicitPath;
+    }
+    return chromiumCandidates.find((candidate) => existsSync(candidate));
+}
+export function resolveChromiumCdpUrl(configuredUrl) {
+    const explicitUrl = configuredUrl ?? process.env.ZTOTHEZ_DESIGN_CHROMIUM_CDP_URL;
+    if (!explicitUrl)
+        return undefined;
+    let url;
+    try {
+        url = new URL(explicitUrl);
+    }
+    catch {
+        throw new Error("Configured Chromium CDP URL must be a valid absolute URL");
+    }
+    if (url.protocol !== "http:" && url.protocol !== "https:") {
+        throw new Error("Configured Chromium CDP URL must use http or https");
+    }
+    if (!["127.0.0.1", "localhost", "::1"].includes(url.hostname)) {
+        throw new Error("Configured Chromium CDP URL must use a loopback host");
+    }
+    if (url.username || url.password || url.pathname !== "/" || url.search || url.hash) {
+        throw new Error("Configured Chromium CDP URL must contain only a loopback origin");
+    }
+    return url.toString();
+}
+export function validateRuntimeUrl(value) {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw new Error("Runtime target must be a valid absolute URL");
+    }
+    if (url.protocol !== "http:" && url.protocol !== "https:") {
+        throw new Error("Runtime target must use http or https");
+    }
+    if (url.username || url.password) {
+        throw new Error("Runtime target URL must not contain credentials");
+    }
+    return url;
+}
+export function validateViewports(viewports) {
+    if (viewports.length === 0 || viewports.length > MAX_RUNTIME_VIEWPORTS) {
+        throw new Error(`Provide between 1 and ${MAX_RUNTIME_VIEWPORTS} viewports`);
+    }
+    const names = new Set();
+    for (const viewport of viewports) {
+        if (!/^[a-z0-9][a-z0-9-]{0,63}$/i.test(viewport.name)) {
+            throw new Error(`Invalid viewport name: ${viewport.name}`);
+        }
+        if (names.has(viewport.name)) {
+            throw new Error(`Duplicate viewport name: ${viewport.name}`);
+        }
+        names.add(viewport.name);
+        if (viewport.width < 240 || viewport.width > 3_840) {
+            throw new Error(`Viewport width is outside 240-3840: ${viewport.width}`);
+        }
+        if (viewport.height < 240 || viewport.height > 2_160) {
+            throw new Error(`Viewport height is outside 240-2160: ${viewport.height}`);
+        }
+    }
+}
+export function validateColorSchemes(colorSchemes) {
+    if (colorSchemes.length === 0 || colorSchemes.length > 2) {
+        throw new Error("Provide one or both supported color schemes: light and dark");
+    }
+    if (new Set(colorSchemes).size !== colorSchemes.length) {
+        throw new Error("Color schemes must be unique");
+    }
+}
+//# sourceMappingURL=policy.js.map

package/dist/src/runtime/policy.js.map

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

package/dist/src/runtime/report.d.ts

@@ -0,0 +1,2 @@
+import type { RuntimeReport } from "./types.js";
+export declare function formatRuntimeReport(report: RuntimeReport): string;

package/dist/src/runtime/report.js

@@ -0,0 +1,48 @@
+function findingContext(finding) {
+    const context = [finding.viewport, finding.journey && `journey:${finding.journey}`].filter(Boolean);
+    return context.length > 0 ? ` (${context.join(", ")})` : "";
+}
+export function formatRuntimeReport(report) {
+    const lines = [
+        "# ZtotheZ Design Engineering Runtime Verification",
+        "",
+        `- URL: \`${report.url}\``,
+        `- Browser: ${report.browser}`,
+        `- Result: ${report.passed ? "PASS" : "FAIL"}`,
+        `- Findings: ${report.summary.errors} errors, ${report.summary.warnings} warnings, ${report.summary.info} info`,
+        `- Screenshots: ${report.screenshots.length}`,
+        `- Color schemes: ${(report.colorSchemes ?? ["light"]).join(", ")}`,
+        `- Screenshot regression: ${report.screenshotRegression.status}`,
+        `- Journeys: ${report.journeys.filter((journey) => journey.passed).length}/${report.journeys.length} passed`,
+        `- Expected network policies: ${report.expectedNetwork.filter((policy) => policy.satisfied).length}/${report.expectedNetwork.length} satisfied`,
+        `- Evidence directory: \`${report.outputDirectory}\``,
+    ];
+    lines.push("", "## Evidence Boundary", "", "### Verifier Limitations", "", ...report.evidenceBoundary.verifierLimitations.map((entry) => `- ${entry}`), "", "### Human Review Required", "", ...report.evidenceBoundary.humanReviewRequired.map((entry) => `- ${entry}`));
+    if (report.screenshotRegression.baselinePath) {
+        lines.push("", "## Screenshot Regression", "", `- Baseline: \`${report.screenshotRegression.baselinePath}\``, `- Compared: ${report.screenshotRegression.compared}`, `- Mismatches: ${report.screenshotRegression.mismatches.length}`, ...report.screenshotRegression.mismatches.map((entry) => `- ${entry}`));
+    }
+    if (report.expectedNetwork.length > 0) {
+        lines.push("", "## Expected Network Evidence");
+        for (const policy of report.expectedNetwork) {
+            lines.push("", `### ${policy.satisfied ? "PASS" : "FAIL"} ${policy.id}`, "", `${policy.method} URL containing \`${policy.urlIncludes}\`${policy.status ? ` with status ${policy.status}` : " with a request failure"}: ${policy.occurrences} occurrence(s).`, ...policy.evidence.map((entry) => `- ${entry}`));
+        }
+    }
+    if (report.journeys.some((journey) => (journey.checkpoints?.length ?? 0) > 0)) {
+        lines.push("", "## Interaction Checkpoints");
+        for (const journey of report.journeys) {
+            for (const checkpoint of journey.checkpoints ?? []) {
+                lines.push("", `- ${journey.name}: ${checkpoint.checkpoint} at step ${checkpoint.step} (evidence step ${checkpoint.evidenceStep}) — ${checkpoint.description}`);
+            }
+        }
+    }
+    if (report.findings.length === 0) {
+        lines.push("", "No runtime findings were detected by the configured checks.");
+        return lines.join("\n");
+    }
+    lines.push("", "## Findings");
+    for (const finding of report.findings) {
+        lines.push("", `### ${finding.severity.toUpperCase()} ${finding.checkId}${findingContext(finding)}`, "", finding.message, ...(finding.selector ? ["", `Selector: \`${finding.selector}\``] : []), "", ...finding.evidence.map((evidence) => `- ${evidence}`));
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=report.js.map

package/dist/src/runtime/report.js.map

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

package/dist/src/runtime/schema.d.ts

@@ -0,0 +1,406 @@
+import { z } from "zod";
+export declare const runtimeViewportSchema: z.ZodObject<{
+    name: z.ZodString;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+}, z.core.$strip>;
+export declare const runtimeColorSchemeSchema: z.ZodEnum<{
+    light: "light";
+    dark: "dark";
+}>;
+export declare const interactionCheckpointSchema: z.ZodEnum<{
+    error: "error";
+    start: "start";
+    success: "success";
+    failure: "failure";
+    "preserved-state": "preserved-state";
+    keyboard: "keyboard";
+    export: "export";
+    offline: "offline";
+    disconnected: "disconnected";
+    loading: "loading";
+    empty: "empty";
+    partial: "partial";
+    stale: "stale";
+    unauthorized: "unauthorized";
+}>;
+export declare const journeyStepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    action: z.ZodLiteral<"navigate">;
+    value: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"setNetwork">;
+    state: z.ZodEnum<{
+        offline: "offline";
+        online: "online";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"click">;
+    selector: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"fill">;
+    selector: z.ZodString;
+    value: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"press">;
+    selector: z.ZodOptional<z.ZodString>;
+    value: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"waitFor">;
+    selector: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"expectVisible">;
+    selector: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"expectValue">;
+    selector: z.ZodString;
+    value: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"expectAttribute">;
+    selector: z.ZodString;
+    name: z.ZodString;
+    value: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"expectJson">;
+    selector: z.ZodString;
+    path: z.ZodString;
+    value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"expectDownload">;
+    selector: z.ZodString;
+    filenameIncludes: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"expectResponse">;
+    selector: z.ZodString;
+    urlIncludes: z.ZodString;
+    status: z.ZodNumber;
+    method: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"expectText">;
+    selector: z.ZodString;
+    value: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"checkpoint">;
+    checkpoint: z.ZodEnum<{
+        error: "error";
+        start: "start";
+        success: "success";
+        failure: "failure";
+        "preserved-state": "preserved-state";
+        keyboard: "keyboard";
+        export: "export";
+        offline: "offline";
+        disconnected: "disconnected";
+        loading: "loading";
+        empty: "empty";
+        partial: "partial";
+        stale: "stale";
+        unauthorized: "unauthorized";
+    }>;
+}, z.core.$strip>], "action">;
+export declare const runtimeJourneyInteractionSchema: z.ZodObject<{
+    task: z.ZodString;
+    phases: z.ZodArray<z.ZodEnum<{
+        primary: "primary";
+        recovery: "recovery";
+    }>>;
+    applicableStates: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        error: "error";
+        disconnected: "disconnected";
+        loading: "loading";
+        empty: "empty";
+        partial: "partial";
+        stale: "stale";
+        unauthorized: "unauthorized";
+    }>>>;
+    keyboard: z.ZodOptional<z.ZodBoolean>;
+    export: z.ZodOptional<z.ZodBoolean>;
+    offline: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const runtimeJourneySchema: z.ZodObject<{
+    name: z.ZodString;
+    interaction: z.ZodOptional<z.ZodObject<{
+        task: z.ZodString;
+        phases: z.ZodArray<z.ZodEnum<{
+            primary: "primary";
+            recovery: "recovery";
+        }>>;
+        applicableStates: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            error: "error";
+            disconnected: "disconnected";
+            loading: "loading";
+            empty: "empty";
+            partial: "partial";
+            stale: "stale";
+            unauthorized: "unauthorized";
+        }>>>;
+        keyboard: z.ZodOptional<z.ZodBoolean>;
+        export: z.ZodOptional<z.ZodBoolean>;
+        offline: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    steps: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        action: z.ZodLiteral<"navigate">;
+        value: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"setNetwork">;
+        state: z.ZodEnum<{
+            offline: "offline";
+            online: "online";
+        }>;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"click">;
+        selector: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"fill">;
+        selector: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"press">;
+        selector: z.ZodOptional<z.ZodString>;
+        value: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"waitFor">;
+        selector: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"expectVisible">;
+        selector: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"expectValue">;
+        selector: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"expectAttribute">;
+        selector: z.ZodString;
+        name: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"expectJson">;
+        selector: z.ZodString;
+        path: z.ZodString;
+        value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"expectDownload">;
+        selector: z.ZodString;
+        filenameIncludes: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"expectResponse">;
+        selector: z.ZodString;
+        urlIncludes: z.ZodString;
+        status: z.ZodNumber;
+        method: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"expectText">;
+        selector: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"checkpoint">;
+        checkpoint: z.ZodEnum<{
+            error: "error";
+            start: "start";
+            success: "success";
+            failure: "failure";
+            "preserved-state": "preserved-state";
+            keyboard: "keyboard";
+            export: "export";
+            offline: "offline";
+            disconnected: "disconnected";
+            loading: "loading";
+            empty: "empty";
+            partial: "partial";
+            stale: "stale";
+            unauthorized: "unauthorized";
+        }>;
+    }, z.core.$strip>], "action">>;
+}, z.core.$strip>;
+export declare const runtimeExpectedNetworkSchema: z.ZodObject<{
+    id: z.ZodString;
+    method: z.ZodString;
+    urlIncludes: z.ZodString;
+    status: z.ZodOptional<z.ZodNumber>;
+    allowRequestFailure: z.ZodOptional<z.ZodBoolean>;
+    minOccurrences: z.ZodNumber;
+    maxOccurrences: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const runtimeFindingSchema: z.ZodObject<{
+    checkId: z.ZodString;
+    severity: z.ZodEnum<{
+        error: "error";
+        warning: "warning";
+        info: "info";
+    }>;
+    message: z.ZodString;
+    evidence: z.ZodArray<z.ZodString>;
+    viewport: z.ZodOptional<z.ZodString>;
+    journey: z.ZodOptional<z.ZodString>;
+    selector: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const runtimeScreenshotSchema: z.ZodObject<{
+    name: z.ZodString;
+    path: z.ZodString;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    fullPage: z.ZodBoolean;
+    sha256: z.ZodString;
+    dynamicSelectors: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const runtimeScreenshotBaselineSchema: z.ZodObject<{
+    version: z.ZodLiteral<"1.0">;
+    screenshots: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        sha256: z.ZodString;
+        dynamicSelectors: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const runtimeJourneyResultSchema: z.ZodObject<{
+    name: z.ZodString;
+    passed: z.ZodBoolean;
+    stepsCompleted: z.ZodNumber;
+    totalSteps: z.ZodNumber;
+    screenshot: z.ZodOptional<z.ZodString>;
+    evidence: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            checkpoint: "checkpoint";
+            download: "download";
+            response: "response";
+            json: "json";
+            attribute: "attribute";
+        }>;
+        step: z.ZodNumber;
+        description: z.ZodString;
+        path: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    checkpoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        checkpoint: z.ZodEnum<{
+            error: "error";
+            start: "start";
+            success: "success";
+            failure: "failure";
+            "preserved-state": "preserved-state";
+            keyboard: "keyboard";
+            export: "export";
+            offline: "offline";
+            disconnected: "disconnected";
+            loading: "loading";
+            empty: "empty";
+            partial: "partial";
+            stale: "stale";
+            unauthorized: "unauthorized";
+        }>;
+        step: z.ZodNumber;
+        evidenceStep: z.ZodNumber;
+        description: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const runtimeReportSchema: {
+    version: z.ZodString;
+    url: z.ZodString;
+    generatedAt: z.ZodString;
+    browser: z.ZodString;
+    outputDirectory: z.ZodString;
+    viewports: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>>;
+    colorSchemes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        light: "light";
+        dark: "dark";
+    }>>>;
+    screenshots: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        path: z.ZodString;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        fullPage: z.ZodBoolean;
+        sha256: z.ZodString;
+        dynamicSelectors: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    screenshotRegression: z.ZodObject<{
+        status: z.ZodEnum<{
+            "not-configured": "not-configured";
+            created: "created";
+            matched: "matched";
+            mismatched: "mismatched";
+        }>;
+        baselinePath: z.ZodOptional<z.ZodString>;
+        compared: z.ZodNumber;
+        mismatches: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    journeys: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        passed: z.ZodBoolean;
+        stepsCompleted: z.ZodNumber;
+        totalSteps: z.ZodNumber;
+        screenshot: z.ZodOptional<z.ZodString>;
+        evidence: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                checkpoint: "checkpoint";
+                download: "download";
+                response: "response";
+                json: "json";
+                attribute: "attribute";
+            }>;
+            step: z.ZodNumber;
+            description: z.ZodString;
+            path: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        checkpoints: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            checkpoint: z.ZodEnum<{
+                error: "error";
+                start: "start";
+                success: "success";
+                failure: "failure";
+                "preserved-state": "preserved-state";
+                keyboard: "keyboard";
+                export: "export";
+                offline: "offline";
+                disconnected: "disconnected";
+                loading: "loading";
+                empty: "empty";
+                partial: "partial";
+                stale: "stale";
+                unauthorized: "unauthorized";
+            }>;
+            step: z.ZodNumber;
+            evidenceStep: z.ZodNumber;
+            description: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    expectedNetwork: z.ZodArray<z.ZodIntersection<z.ZodObject<{
+        id: z.ZodString;
+        method: z.ZodString;
+        urlIncludes: z.ZodString;
+        status: z.ZodOptional<z.ZodNumber>;
+        allowRequestFailure: z.ZodOptional<z.ZodBoolean>;
+        minOccurrences: z.ZodNumber;
+        maxOccurrences: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        occurrences: z.ZodNumber;
+        evidence: z.ZodArray<z.ZodString>;
+        satisfied: z.ZodBoolean;
+    }, z.core.$strip>>>;
+    findings: z.ZodArray<z.ZodObject<{
+        checkId: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+            info: "info";
+        }>;
+        message: z.ZodString;
+        evidence: z.ZodArray<z.ZodString>;
+        viewport: z.ZodOptional<z.ZodString>;
+        journey: z.ZodOptional<z.ZodString>;
+        selector: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    summary: z.ZodObject<{
+        errors: z.ZodNumber;
+        warnings: z.ZodNumber;
+        info: z.ZodNumber;
+    }, z.core.$strip>;
+    passed: z.ZodBoolean;
+    evidenceBoundary: z.ZodObject<{
+        verifierLimitations: z.ZodArray<z.ZodString>;
+        humanReviewRequired: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+};