@nativemason/contracts 0.0.0-stage → 0.3.0

package/dist/evidence.js

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+import { SpatialSnapshotSchema } from './graph.js';
+import { ConstraintResultSchema } from './constraints.js';
+import { CommitReceiptSchema } from './source.js';
+/** Public CI reports exclude physical-target evidence by construction. */
+export const VisualEvidenceRunSchema = z.object({
+    id: z.string().regex(/^[A-Za-z0-9_-]+$/), title: z.string(),
+    target: z.enum(['web', 'android-emulator', 'ios-simulator']),
+    before: SpatialSnapshotSchema, after: SpatialSnapshotSchema,
+    results: z.array(ConstraintResultSchema), receipt: CommitReceiptSchema.optional(),
+    nativeStatus: z.enum(['passed', 'failed', 'pending', 'unavailable']), notes: z.array(z.string()),
+}).strict().superRefine((run, ctx) => {
+    const platform = run.target === 'android-emulator' ? 'android' : run.target === 'ios-simulator' ? 'ios' : 'web';
+    for (const snapshot of [run.before, run.after]) {
+        if (snapshot.platform !== platform)
+            ctx.addIssue({ code: 'custom', message: 'Evidence target and measured platform disagree' });
+        if (snapshot.nativeTarget?.kind === 'physical')
+            ctx.addIssue({ code: 'custom', message: 'Physical-target evidence is not public report input' });
+        if (platform !== 'web' && snapshot.nativeTarget?.kind !== (platform === 'android' ? 'emulator' : 'simulator'))
+            ctx.addIssue({ code: 'custom', message: 'Native CI report requires explicit simulator/emulator identity' });
+    }
+    if (run.before.scenarioId !== run.after.scenarioId)
+        ctx.addIssue({ code: 'custom', message: 'Comparison scenarios must match' });
+    if (platform !== 'web' && run.before.nativeTarget?.targetId !== run.after.nativeTarget?.targetId)
+        ctx.addIssue({ code: 'custom', message: 'Comparison native targets must match' });
+    if (run.nativeStatus === 'passed') {
+        if (platform === 'web' || run.after.status !== 'stable' || !run.results.length || run.results.some(result => result.status !== 'pass') || run.receipt?.nativeStatus !== 'passed')
+            ctx.addIssue({ code: 'custom', message: 'Native pass requires stable native measurements, passing constraints, and a verified receipt' });
+        const measuredIds = new Set(run.after.nodes.map(node => node.id));
+        if (run.results.some(result => result.elementIds.some(id => !measuredIds.has(id))))
+            ctx.addIssue({ code: 'custom', message: 'Passing constraint evidence references an unmeasured element' });
+        for (const file of (run.receipt?.files?.length ? run.receipt.files : (run.receipt ? [run.receipt] : [])))
+            if (run.after.revisions[file.path] !== file.newHash)
+                ctx.addIssue({ code: 'custom', message: 'Native evidence revisions do not match the verified receipt' });
+    }
+});
+export const VisualEvidenceReportSchema = z.object({
+    schemaVersion: z.literal(1), repository: z.string().regex(/^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/),
+    revision: z.string().regex(/^[a-f0-9]{40,64}$/), pullRequest: z.number().int().positive().optional(),
+    runs: z.array(VisualEvidenceRunSchema).max(20), notes: z.array(z.string()),
+}).strict();
+export const EvidenceInputsSchema = VisualEvidenceReportSchema.pick({ repository: true, revision: true, pullRequest: true }).extend({
+    webFile: z.string().min(1).optional(), androidDirectory: z.string().min(1).optional(), iosDirectory: z.string().min(1).optional(),
+}).strict();

package/dist/geometry.d.ts

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+export declare const RectSchema: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+}, z.core.$strict>;
+export type Rect = z.infer<typeof RectSchema>;
+export declare const InsetsSchema: z.ZodObject<{
+    top: z.ZodNumber;
+    right: z.ZodNumber;
+    bottom: z.ZodNumber;
+    left: z.ZodNumber;
+}, z.core.$strict>;
+export declare const DeviceProfileSchema: z.ZodObject<{
+    window: z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strict>;
+    pixelRatio: z.ZodNumber;
+    fontScale: z.ZodNumber;
+    insets: z.ZodObject<{
+        top: z.ZodNumber;
+        right: z.ZodNumber;
+        bottom: z.ZodNumber;
+        left: z.ZodNumber;
+    }, z.core.$strict>;
+    root: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strict>;
+    orientation: z.ZodEnum<{
+        portrait: "portrait";
+        landscape: "landscape";
+    }>;
+}, z.core.$strict>;
+export type DeviceProfile = z.infer<typeof DeviceProfileSchema>;

package/dist/geometry.js

@@ -0,0 +1,4 @@
+import { z } from 'zod';
+export const RectSchema = z.object({ x: z.number().finite(), y: z.number().finite(), width: z.number().finite().nonnegative(), height: z.number().finite().nonnegative() }).strict();
+export const InsetsSchema = z.object({ top: z.number().finite().nonnegative(), right: z.number().finite().nonnegative(), bottom: z.number().finite().nonnegative(), left: z.number().finite().nonnegative() }).strict();
+export const DeviceProfileSchema = z.object({ window: z.object({ width: z.number().finite().positive(), height: z.number().finite().positive() }).strict(), pixelRatio: z.number().finite().positive(), fontScale: z.number().finite().positive(), insets: InsetsSchema, root: RectSchema, orientation: z.enum(['portrait', 'landscape']) }).strict();

package/dist/graph.d.ts

@@ -0,0 +1,456 @@
+import { type LayoutMutation } from './workflow.js';
+import { z } from 'zod';
+import { DeviceProfileSchema } from './geometry.js';
+import { SourceRevisionsSchema } from './source.js';
+import { RnStylePatchSchema } from './styles.js';
+export declare const AuthoredTextPropsSchema: z.ZodObject<{
+    fontSize: z.ZodOptional<z.ZodNumber>;
+    lineHeight: z.ZodOptional<z.ZodNumber>;
+    numberOfLines: z.ZodOptional<z.ZodNumber>;
+    allowFontScaling: z.ZodOptional<z.ZodBoolean>;
+    ellipsizeMode: z.ZodOptional<z.ZodEnum<{
+        head: "head";
+        middle: "middle";
+        tail: "tail";
+        clip: "clip";
+    }>>;
+}, z.core.$strict>;
+export declare const TextMetricsSchema: z.ZodObject<{
+    lineCount: z.ZodNumber;
+}, z.core.$strict>;
+export declare const DiagnosticEvidenceSchema: z.ZodEnum<{
+    unknown: "unknown";
+    confirmed: "confirmed";
+    clear: "clear";
+}>;
+export declare const WebNodeDiagnosticsSchema: z.ZodObject<{
+    clipping: z.ZodEnum<{
+        unknown: "unknown";
+        confirmed: "confirmed";
+        clear: "clear";
+    }>;
+    centerHitTest: z.ZodEnum<{
+        unknown: "unknown";
+        confirmed: "confirmed";
+        clear: "clear";
+    }>;
+    scrollOverflow: z.ZodObject<{
+        horizontal: z.ZodBoolean;
+        vertical: z.ZodBoolean;
+    }, z.core.$strict>;
+    paintOrder: z.ZodNullable<z.ZodNumber>;
+    fonts: z.ZodArray<z.ZodObject<{
+        family: z.ZodString;
+        glyphCount: z.ZodNumber;
+        isCustom: z.ZodNullable<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    lineBoxCount: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const WebDiagnosticsSchema: z.ZodObject<{
+    nodes: z.ZodRecord<z.ZodString, z.ZodObject<{
+        clipping: z.ZodEnum<{
+            unknown: "unknown";
+            confirmed: "confirmed";
+            clear: "clear";
+        }>;
+        centerHitTest: z.ZodEnum<{
+            unknown: "unknown";
+            confirmed: "confirmed";
+            clear: "clear";
+        }>;
+        scrollOverflow: z.ZodObject<{
+            horizontal: z.ZodBoolean;
+            vertical: z.ZodBoolean;
+        }, z.core.$strict>;
+        paintOrder: z.ZodNullable<z.ZodNumber>;
+        fonts: z.ZodArray<z.ZodObject<{
+            family: z.ZodString;
+            glyphCount: z.ZodNumber;
+            isCustom: z.ZodNullable<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        lineBoxCount: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>>;
+    warnings: z.ZodArray<z.ZodObject<{
+        elementId: z.ZodString;
+        code: z.ZodEnum<{
+            CLIPPED: "CLIPPED";
+            OCCLUDED: "OCCLUDED";
+            FONT_LOAD_FAILED: "FONT_LOAD_FAILED";
+            EVIDENCE_UNAVAILABLE: "EVIDENCE_UNAVAILABLE";
+        }>;
+        severity: z.ZodEnum<{
+            confirmed: "confirmed";
+            uncertain: "uncertain";
+        }>;
+        message: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type WebDiagnostics = z.infer<typeof WebDiagnosticsSchema>;
+export declare const SpatialNodeSchema: z.ZodObject<{
+    id: z.ZodString;
+    parentId: z.ZodNullable<z.ZodString>;
+    kind: z.ZodEnum<{
+        View: "View";
+        Text: "Text";
+        Pressable: "Pressable";
+        TextInput: "TextInput";
+        ScrollView: "ScrollView";
+        Image: "Image";
+    }>;
+    role: z.ZodNullable<z.ZodString>;
+    rect: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strict>;
+    styles: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    source: z.ZodNullable<z.ZodObject<{
+        path: z.ZodString;
+        styleForm: z.ZodOptional<z.ZodLiteral<"pressable-state">>;
+        dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        hash: z.ZodString;
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+        line: z.ZodNumber;
+        column: z.ZodNumber;
+    }, z.core.$strict>>;
+    editable: z.ZodBoolean;
+    editReason: z.ZodNullable<z.ZodString>;
+    pressableState: z.ZodOptional<z.ZodEnum<{
+        pressed: "pressed";
+        rest: "rest";
+    }>>;
+    accessibility: z.ZodOptional<z.ZodObject<{
+        authoredLabel: z.ZodOptional<z.ZodString>;
+        authoredHint: z.ZodOptional<z.ZodString>;
+        accessible: z.ZodOptional<z.ZodBoolean>;
+        focusable: z.ZodOptional<z.ZodBoolean>;
+        hidden: z.ZodOptional<z.ZodBoolean>;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+        direction: z.ZodEnum<{
+            unknown: "unknown";
+            ltr: "ltr";
+            rtl: "rtl";
+        }>;
+        directionSource: z.ZodOptional<z.ZodEnum<{
+            unknown: "unknown";
+            authored: "authored";
+            "native-global": "native-global";
+            "browser-computed": "browser-computed";
+        }>>;
+        browser: z.ZodOptional<z.ZodObject<{
+            name: z.ZodNullable<z.ZodString>;
+            focusOrder: z.ZodNullable<z.ZodNumber>;
+            focusOrderSource: z.ZodLiteral<"dom-sequential-estimate">;
+            contrast: z.ZodObject<{
+                status: z.ZodEnum<{
+                    measured: "measured";
+                    unavailable: "unavailable";
+                }>;
+                ratio: z.ZodOptional<z.ZodNumber>;
+                requiredRatio: z.ZodOptional<z.ZodNumber>;
+                reason: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    textFit: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<{
+            unavailable: "unavailable";
+            supported: "supported";
+        }>;
+        fullLineCount: z.ZodOptional<z.ZodNumber>;
+        limitedLineCount: z.ZodOptional<z.ZodNumber>;
+        fullHeight: z.ZodOptional<z.ZodNumber>;
+        availableHeight: z.ZodOptional<z.ZodNumber>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    authoredTextProps: z.ZodOptional<z.ZodObject<{
+        fontSize: z.ZodOptional<z.ZodNumber>;
+        lineHeight: z.ZodOptional<z.ZodNumber>;
+        numberOfLines: z.ZodOptional<z.ZodNumber>;
+        allowFontScaling: z.ZodOptional<z.ZodBoolean>;
+        ellipsizeMode: z.ZodOptional<z.ZodEnum<{
+            head: "head";
+            middle: "middle";
+            tail: "tail";
+            clip: "clip";
+        }>>;
+    }, z.core.$strict>>;
+    measuredLineCount: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type SpatialNode = z.infer<typeof SpatialNodeSchema>;
+export declare const SpatialSnapshotSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    sessionId: z.ZodString;
+    snapshotId: z.ZodString;
+    platform: z.ZodEnum<{
+        web: "web";
+        android: "android";
+        ios: "ios";
+    }>;
+    scenarioId: z.ZodString;
+    profile: z.ZodObject<{
+        window: z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>;
+        pixelRatio: z.ZodNumber;
+        fontScale: z.ZodNumber;
+        insets: z.ZodObject<{
+            top: z.ZodNumber;
+            right: z.ZodNumber;
+            bottom: z.ZodNumber;
+            left: z.ZodNumber;
+        }, z.core.$strict>;
+        root: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>;
+        orientation: z.ZodEnum<{
+            portrait: "portrait";
+            landscape: "landscape";
+        }>;
+    }, z.core.$strict>;
+    revisions: z.ZodRecord<z.ZodString, z.ZodString>;
+    nodes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        parentId: z.ZodNullable<z.ZodString>;
+        kind: z.ZodEnum<{
+            View: "View";
+            Text: "Text";
+            Pressable: "Pressable";
+            TextInput: "TextInput";
+            ScrollView: "ScrollView";
+            Image: "Image";
+        }>;
+        role: z.ZodNullable<z.ZodString>;
+        rect: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>;
+        styles: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        source: z.ZodNullable<z.ZodObject<{
+            path: z.ZodString;
+            styleForm: z.ZodOptional<z.ZodLiteral<"pressable-state">>;
+            dependencies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            hash: z.ZodString;
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+            line: z.ZodNumber;
+            column: z.ZodNumber;
+        }, z.core.$strict>>;
+        editable: z.ZodBoolean;
+        editReason: z.ZodNullable<z.ZodString>;
+        pressableState: z.ZodOptional<z.ZodEnum<{
+            pressed: "pressed";
+            rest: "rest";
+        }>>;
+        accessibility: z.ZodOptional<z.ZodObject<{
+            authoredLabel: z.ZodOptional<z.ZodString>;
+            authoredHint: z.ZodOptional<z.ZodString>;
+            accessible: z.ZodOptional<z.ZodBoolean>;
+            focusable: z.ZodOptional<z.ZodBoolean>;
+            hidden: z.ZodOptional<z.ZodBoolean>;
+            disabled: z.ZodOptional<z.ZodBoolean>;
+            direction: z.ZodEnum<{
+                unknown: "unknown";
+                ltr: "ltr";
+                rtl: "rtl";
+            }>;
+            directionSource: z.ZodOptional<z.ZodEnum<{
+                unknown: "unknown";
+                authored: "authored";
+                "native-global": "native-global";
+                "browser-computed": "browser-computed";
+            }>>;
+            browser: z.ZodOptional<z.ZodObject<{
+                name: z.ZodNullable<z.ZodString>;
+                focusOrder: z.ZodNullable<z.ZodNumber>;
+                focusOrderSource: z.ZodLiteral<"dom-sequential-estimate">;
+                contrast: z.ZodObject<{
+                    status: z.ZodEnum<{
+                        measured: "measured";
+                        unavailable: "unavailable";
+                    }>;
+                    ratio: z.ZodOptional<z.ZodNumber>;
+                    requiredRatio: z.ZodOptional<z.ZodNumber>;
+                    reason: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        textFit: z.ZodOptional<z.ZodObject<{
+            status: z.ZodEnum<{
+                unavailable: "unavailable";
+                supported: "supported";
+            }>;
+            fullLineCount: z.ZodOptional<z.ZodNumber>;
+            limitedLineCount: z.ZodOptional<z.ZodNumber>;
+            fullHeight: z.ZodOptional<z.ZodNumber>;
+            availableHeight: z.ZodOptional<z.ZodNumber>;
+            reason: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        authoredTextProps: z.ZodOptional<z.ZodObject<{
+            fontSize: z.ZodOptional<z.ZodNumber>;
+            lineHeight: z.ZodOptional<z.ZodNumber>;
+            numberOfLines: z.ZodOptional<z.ZodNumber>;
+            allowFontScaling: z.ZodOptional<z.ZodBoolean>;
+            ellipsizeMode: z.ZodOptional<z.ZodEnum<{
+                head: "head";
+                middle: "middle";
+                tail: "tail";
+                clip: "clip";
+            }>>;
+        }, z.core.$strict>>;
+        measuredLineCount: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    status: z.ZodEnum<{
+        stable: "stable";
+        unstable: "unstable";
+    }>;
+    generation: z.ZodNumber;
+    nativeTarget: z.ZodOptional<z.ZodObject<{
+        targetId: z.ZodString;
+        platform: z.ZodEnum<{
+            android: "android";
+            ios: "ios";
+        }>;
+        kind: z.ZodEnum<{
+            physical: "physical";
+            emulator: "emulator";
+            simulator: "simulator";
+        }>;
+    }, z.core.$strict>>;
+    webDiagnostics: z.ZodOptional<z.ZodObject<{
+        nodes: z.ZodRecord<z.ZodString, z.ZodObject<{
+            clipping: z.ZodEnum<{
+                unknown: "unknown";
+                confirmed: "confirmed";
+                clear: "clear";
+            }>;
+            centerHitTest: z.ZodEnum<{
+                unknown: "unknown";
+                confirmed: "confirmed";
+                clear: "clear";
+            }>;
+            scrollOverflow: z.ZodObject<{
+                horizontal: z.ZodBoolean;
+                vertical: z.ZodBoolean;
+            }, z.core.$strict>;
+            paintOrder: z.ZodNullable<z.ZodNumber>;
+            fonts: z.ZodArray<z.ZodObject<{
+                family: z.ZodString;
+                glyphCount: z.ZodNumber;
+                isCustom: z.ZodNullable<z.ZodBoolean>;
+            }, z.core.$strict>>;
+            lineBoxCount: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strict>>;
+        warnings: z.ZodArray<z.ZodObject<{
+            elementId: z.ZodString;
+            code: z.ZodEnum<{
+                CLIPPED: "CLIPPED";
+                OCCLUDED: "OCCLUDED";
+                FONT_LOAD_FAILED: "FONT_LOAD_FAILED";
+                EVIDENCE_UNAVAILABLE: "EVIDENCE_UNAVAILABLE";
+            }>;
+            severity: z.ZodEnum<{
+                confirmed: "confirmed";
+                uncertain: "uncertain";
+            }>;
+            message: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type SpatialSnapshot = z.infer<typeof SpatialSnapshotSchema>;
+export declare const SpatialDeltaSchema: z.ZodObject<{
+    added: z.ZodArray<z.ZodString>;
+    removed: z.ZodArray<z.ZodString>;
+    changed: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        before: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>;
+        after: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>;
+        delta: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SpatialDelta = z.infer<typeof SpatialDeltaSchema>;
+export interface BrowserPort {
+    captureAccessibility?(): Promise<SpatialSnapshot>;
+    runScenario?(script: import('./workflow.js').ScenarioScript): Promise<void>;
+    trialBatch?(mutations: readonly LayoutMutation[], profileOverrides?: z.infer<typeof ProfileOverridesSchema>): Promise<SpatialSnapshot>;
+    capture(profileOverrides?: z.infer<typeof ProfileOverridesSchema>): Promise<SpatialSnapshot>;
+    trial(elementId: string, patch: z.infer<typeof RnStylePatchSchema>, profileOverrides?: z.infer<typeof ProfileOverridesSchema>): Promise<SpatialSnapshot>;
+    resetTrial(): Promise<void>;
+    screenshot(): Promise<Uint8Array>;
+    close(): Promise<void>;
+}
+export interface NativePort {
+    runHook?(name: string, value?: unknown): Promise<void>;
+    capture(expectedRevisions: z.infer<typeof SourceRevisionsSchema>): Promise<SpatialSnapshot>;
+}
+export declare const OverlaySceneSchema: z.ZodObject<{
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    marks: z.ZodArray<z.ZodObject<{
+        label: z.ZodNumber;
+        id: z.ZodString;
+        rect: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>;
+    }, z.core.$strip>>;
+    targets: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        rect: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type OverlayScene = z.infer<typeof OverlaySceneSchema>;
+export declare const ProfileOverridesSchema: z.ZodObject<{
+    fontScale: z.ZodOptional<z.ZodNumber>;
+    orientation: z.ZodOptional<z.ZodEnum<{
+        portrait: "portrait";
+        landscape: "landscape";
+    }>>;
+}, z.core.$strict>;
+export type ProfileOverrides = z.infer<typeof ProfileOverridesSchema>;
+export interface BrowserRuntime {
+    runHook?(name: string, value?: unknown): Promise<void>;
+    applyTrialBatch?(mutations: readonly LayoutMutation[]): Promise<void>;
+    configure(input: {
+        sessionId: string;
+        scenarioId: string;
+        profile: z.infer<typeof DeviceProfileSchema>;
+    }): void;
+    capture(): Promise<SpatialSnapshot>;
+    applyTrial(id: string, patch: z.infer<typeof RnStylePatchSchema>): Promise<void>;
+    resetTrial(): Promise<void>;
+    getDiagnosticTargets(): readonly {
+        id: string;
+        element: unknown;
+    }[];
+}

package/dist/graph.js

@@ -0,0 +1,36 @@
+import { AccessibilityEvidenceSchema } from './accessibility.js';
+import { TextFitEvidenceSchema, NativeTargetSchema } from './workflow.js';
+import { z } from 'zod';
+import { DeviceProfileSchema, RectSchema } from './geometry.js';
+import { SourceRefSchema, SourceRevisionsSchema } from './source.js';
+export const AuthoredTextPropsSchema = z.object({ fontSize: z.number().nonnegative().optional(), lineHeight: z.number().nonnegative().optional(), numberOfLines: z.number().int().positive().optional(), allowFontScaling: z.boolean().optional(), ellipsizeMode: z.enum(['head', 'middle', 'tail', 'clip']).optional() }).strict();
+export const TextMetricsSchema = z.object({ lineCount: z.number().int().nonnegative() }).strict();
+export const DiagnosticEvidenceSchema = z.enum(['confirmed', 'clear', 'unknown']);
+export const WebNodeDiagnosticsSchema = z.object({
+    clipping: DiagnosticEvidenceSchema,
+    centerHitTest: DiagnosticEvidenceSchema,
+    scrollOverflow: z.object({ horizontal: z.boolean(), vertical: z.boolean() }).strict(),
+    paintOrder: z.number().int().nullable(),
+    fonts: z.array(z.object({ family: z.string(), glyphCount: z.number().int().nonnegative(), isCustom: z.boolean().nullable() }).strict()),
+    lineBoxCount: z.number().int().nonnegative().nullable(),
+}).strict();
+export const WebDiagnosticsSchema = z.object({ nodes: z.record(z.string(), WebNodeDiagnosticsSchema), warnings: z.array(z.object({ elementId: z.string(), code: z.enum(['CLIPPED', 'OCCLUDED', 'FONT_LOAD_FAILED', 'EVIDENCE_UNAVAILABLE']), severity: z.enum(['confirmed', 'uncertain']), message: z.string() }).strict()) }).strict();
+export const SpatialNodeSchema = z.object({ id: z.string().min(1), parentId: z.string().nullable(), kind: z.enum(['View', 'Text', 'Pressable', 'TextInput', 'ScrollView', 'Image']), role: z.string().nullable(), rect: RectSchema, styles: z.record(z.string(), z.unknown()), source: SourceRefSchema.nullable(), editable: z.boolean(), editReason: z.string().nullable(), pressableState: z.enum(['pressed', 'rest']).optional(), accessibility: AccessibilityEvidenceSchema.optional(), textFit: TextFitEvidenceSchema.optional(), authoredTextProps: AuthoredTextPropsSchema.optional(), measuredLineCount: z.number().int().nonnegative().optional() }).strict();
+export const SpatialSnapshotSchema = z.object({ schemaVersion: z.literal(1), sessionId: z.string(), snapshotId: z.string(), platform: z.enum(['web', 'android', 'ios']), scenarioId: z.string(), profile: DeviceProfileSchema, revisions: SourceRevisionsSchema, nodes: z.array(SpatialNodeSchema), status: z.enum(['stable', 'unstable']), generation: z.number().int().nonnegative(), nativeTarget: NativeTargetSchema.optional(), webDiagnostics: WebDiagnosticsSchema.optional() }).strict().superRefine((snapshot, ctx) => {
+    if (snapshot.platform !== 'web' && snapshot.webDiagnostics)
+        ctx.addIssue({ code: 'custom', message: 'Web diagnostics cannot appear in Android snapshots', path: ['webDiagnostics'] });
+    snapshot.nodes.forEach((node, i) => {
+        if (snapshot.platform !== 'web' && node.accessibility?.directionSource === 'browser-computed')
+            ctx.addIssue({ code: 'custom', message: 'Browser direction evidence cannot appear in native snapshots', path: ['nodes', i, 'accessibility', 'directionSource'] });
+        if (snapshot.platform !== 'web' && node.accessibility?.browser)
+            ctx.addIssue({ code: 'custom', message: 'Browser accessibility evidence cannot appear in native snapshots', path: ['nodes', i, 'accessibility', 'browser'] });
+        for (const dependency of node.source?.dependencies ?? [])
+            if (!snapshot.revisions[dependency])
+                ctx.addIssue({ code: 'custom', message: 'Required style dependency revision is missing', path: ['nodes', i, 'source', 'dependencies'], params: { bridgeCode: 'STALE_SOURCE' } });
+        if (node.source && snapshot.revisions[node.source.path] !== node.source.hash)
+            ctx.addIssue({ code: 'custom', message: 'Node source hash disagrees with snapshot revisions', path: ['nodes', i, 'source', 'hash'], params: { bridgeCode: 'STALE_SOURCE' } });
+    });
+});
+export const SpatialDeltaSchema = z.object({ added: z.array(z.string()), removed: z.array(z.string()), changed: z.array(z.object({ id: z.string(), before: RectSchema, after: RectSchema, delta: RectSchema.extend({ width: z.number(), height: z.number() }) })) });
+export const OverlaySceneSchema = z.object({ width: z.number(), height: z.number(), marks: z.array(z.object({ label: z.number(), id: z.string(), rect: RectSchema })), targets: z.array(z.object({ id: z.string(), rect: RectSchema })) });
+export const ProfileOverridesSchema = z.object({ fontScale: z.number().positive().optional(), orientation: z.enum(['portrait', 'landscape']).optional() }).strict().refine(value => Object.keys(value).length > 0, 'Profile override must set a value');

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export * from './geometry.js';
+export * from './styles.js';
+export * from './source.js';
+export * from './graph.js';
+export * from './constraints.js';
+export * from './native-protocol.js';
+export * from './tools.js';
+export * from './workflow.js';
+export * from './diagnostics.js';
+export * from './design.js';
+export * from './accessibility.js';
+export * from './evidence.js';

package/dist/index.js

@@ -0,0 +1,12 @@
+export * from './geometry.js';
+export * from './styles.js';
+export * from './source.js';
+export * from './graph.js';
+export * from './constraints.js';
+export * from './native-protocol.js';
+export * from './tools.js';
+export * from './workflow.js';
+export * from './diagnostics.js';
+export * from './design.js';
+export * from './accessibility.js';
+export * from './evidence.js';