@visual-layer/core 1.0.0

package/dist/ids.js

@@ -0,0 +1,21 @@
+/**
+ * Stable-ish ID generation. Uses crypto randomness so IDs are unique across
+ * runs within a machine without depending on wall-clock monotonicity.
+ */
+import { randomBytes } from 'node:crypto';
+import { createHash } from 'node:crypto';
+/** e.g. makeId('sg') -> "sg_a1b2c3d4e5f6g7h8" */
+export function makeId(prefix) {
+    const rand = randomBytes(8).toString('hex');
+    return `${prefix}_${rand}`;
+}
+/** Short stable ID derived from content. Deterministic for identical input. */
+export function deterministicId(prefix, content) {
+    const hash = createHash('sha256').update(content).digest('hex').slice(0, 12);
+    return `${prefix}_${hash}`;
+}
+/** sha256 hex of a string/buffer. */
+export function sha256(content) {
+    return createHash('sha256').update(content).digest('hex');
+}
+//# sourceMappingURL=ids.js.map

package/dist/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,iDAAiD;AACjD,MAAM,UAAU,MAAM,CAAC,MAAc;IACnC,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5C,OAAO,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC;AAC7B,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,OAAe;IAC7D,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7E,OAAO,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC;AAC7B,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,MAAM,CAAC,OAAqC;IAC1D,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @visual-layer/core public surface.
+ */
+export * from './schema/index.js';
+export * from './geometry/index.js';
+export * from './text/index.js';
+export * from './confidence.js';
+export * from './ids.js';
+export * from './warnings.js';
+export * from './provenance.js';
+export * from './errors.js';
+export * from './redaction/index.js';
+export * from './artifact-store/index.js';
+export * from './trace/index.js';
+export * from './browser-adapter.js';
+export declare const CORE_VERSION = "0.1.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AAErC,eAAO,MAAM,YAAY,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * @visual-layer/core public surface.
+ */
+export * from './schema/index.js';
+export * from './geometry/index.js';
+export * from './text/index.js';
+export * from './confidence.js';
+export * from './ids.js';
+export * from './warnings.js';
+export * from './provenance.js';
+export * from './errors.js';
+export * from './redaction/index.js';
+export * from './artifact-store/index.js';
+export * from './trace/index.js';
+export * from './browser-adapter.js';
+export const CORE_VERSION = '0.1.0';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AAErC,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC"}

package/dist/provenance.d.ts

@@ -0,0 +1,7 @@
+/** Provenance constructors. */
+import type { Provenance, InteractableSource } from './schema/index.js';
+export declare function provenance(field: string, source: InteractableSource | string, opts?: {
+    confidence?: number;
+    note?: string;
+}): Provenance;
+//# sourceMappingURL=provenance.d.ts.map

package/dist/provenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.d.ts","sourceRoot":"","sources":["../src/provenance.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAExE,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,kBAAkB,GAAG,MAAM,EACnC,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAChD,UAAU,CAKZ"}

package/dist/provenance.js

@@ -0,0 +1,9 @@
+export function provenance(field, source, opts = {}) {
+    const p = { field, source };
+    if (opts.confidence !== undefined)
+        p.confidence = opts.confidence;
+    if (opts.note !== undefined)
+        p.note = opts.note;
+    return p;
+}
+//# sourceMappingURL=provenance.js.map

package/dist/provenance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance.js","sourceRoot":"","sources":["../src/provenance.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,UAAU,CACxB,KAAa,EACb,MAAmC,EACnC,OAA+C,EAAE;IAEjD,MAAM,CAAC,GAAe,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IACxC,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;QAAE,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IAClE,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;QAAE,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IAChD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/redaction/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Secret redaction. Used before any value is written to artifact store,
+ * trace, warnings, or error details.
+ *
+ * Fail-closed: if redaction itself throws, callers must NOT persist the
+ * unredacted value — emit `redaction_failed` and discard the sensitive blob.
+ */
+export interface RedactionResult {
+    /** Redacted copy of the input. */
+    redacted: string;
+    /** Number of substitutions made. */
+    count: number;
+    /** Names of patterns that fired (deduped). */
+    matchedPatterns: string[];
+}
+export declare function redactString(input: string): RedactionResult;
+/** Deep-clone a JSON-ish value, redacting every string along the way. */
+export declare function redactJson<T>(value: T): T;
+/**
+ * Fail-closed guard. Runs the redactor; if it throws, rethrows as a typed
+ * `RedactionError` so callers can emit `redaction_failed` and discard.
+ */
+export declare class RedactionError extends Error {
+    readonly code: "redaction_failed";
+    constructor(cause: unknown);
+}
+export declare function redactJsonFailClosed<T>(value: T): T;
+//# sourceMappingURL=index.d.ts.map

package/dist/redaction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/redaction/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoBH,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAa3D;AAeD,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAEzC;AA0BD;;;GAGG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAG,kBAAkB,CAAU;gBAChC,KAAK,EAAE,OAAO;CAI3B;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAMnD"}

package/dist/redaction/index.js

@@ -0,0 +1,97 @@
+/**
+ * Secret redaction. Used before any value is written to artifact store,
+ * trace, warnings, or error details.
+ *
+ * Fail-closed: if redaction itself throws, callers must NOT persist the
+ * unredacted value — emit `redaction_failed` and discard the sensitive blob.
+ */
+/** Patterns matched against raw strings. Order matters: longest first. */
+const SECRET_PATTERNS = [
+    // Known vendor token shapes
+    { name: 'openai-key', re: /\bsk-[A-Za-z0-9_-]{20,}\b/g, replacement: 'sk-[REDACTED]' },
+    { name: 'anthropic-key', re: /\bsk-ant-[A-Za-z0-9_-]{20,}\b/g, replacement: 'sk-ant-[REDACTED]' },
+    { name: 'figma-token', re: /\bfigd_[A-Za-z0-9_-]{20,}\b/g, replacement: 'figd_[REDACTED]' },
+    // Bearer / Authorization header values
+    { name: 'bearer', re: /\b(Bearer)\s+[A-Za-z0-9._\-]+/gi, replacement: '$1 [REDACTED]' },
+    // key= / token: / secret: assignments (capture value after the label)
+    {
+        name: 'secret-assignment',
+        re: /\b(api[_-]?key|apikey|access[_-]?token|auth[_-]?token|token|secret|password|passwd|client[_-]?secret|private[_-]?key)(["']?\s*[:=]\s*["']?)([^\s"'&]+)/gi,
+        replacement: '$1$2[REDACTED]',
+    },
+    // Generic long opaque blobs (hex/base64, 40+ chars) — conservative, may also mask hashes
+    { name: 'opaque-blob', re: /\b[A-Za-z0-9+/]{40,}={0,2}\b/g, replacement: '[REDACTED]' },
+];
+export function redactString(input) {
+    let redacted = input;
+    let count = 0;
+    const matched = new Set();
+    for (const p of SECRET_PATTERNS) {
+        const before = redacted;
+        redacted = redacted.replace(p.re, p.replacement);
+        if (redacted !== before) {
+            count += countSubstitutions(before, redacted);
+            matched.add(p.name);
+        }
+    }
+    return { redacted, count, matchedPatterns: [...matched] };
+}
+function countSubstitutions(before, after) {
+    // Count the [REDACTED] occurrences introduced by THIS pattern pass (delta),
+    // not the total — earlier patterns' substitutions are already in `before`.
+    const a = countRedacted(before);
+    const b = countRedacted(after);
+    return Math.max(0, b - a);
+}
+function countRedacted(s) {
+    const m = s.match(/\[REDACTED\]/g);
+    return m ? m.length : 0;
+}
+/** Deep-clone a JSON-ish value, redacting every string along the way. */
+export function redactJson(value) {
+    return redactJsonImpl(value);
+}
+function redactJsonImpl(value) {
+    if (typeof value === 'string')
+        return redactString(value).redacted;
+    if (Array.isArray(value))
+        return value.map(redactJsonImpl);
+    if (value && typeof value === 'object') {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            // key-level masking: sensitive keys get fully redacted regardless of value type
+            if (isSensitiveKey(k)) {
+                out[k] = '[REDACTED]';
+            }
+            else {
+                out[k] = redactJsonImpl(v);
+            }
+        }
+        return out;
+    }
+    return value;
+}
+const SENSITIVE_KEY_RE = /^(api[_-]?key|apikey|access[_-]?token|auth[_-]?token|token|secret|password|passwd|client[_-]?secret|private[_-]?key|authorization|cookie|figma[_-]?token)$/i;
+function isSensitiveKey(key) {
+    return SENSITIVE_KEY_RE.test(key);
+}
+/**
+ * Fail-closed guard. Runs the redactor; if it throws, rethrows as a typed
+ * `RedactionError` so callers can emit `redaction_failed` and discard.
+ */
+export class RedactionError extends Error {
+    code = 'redaction_failed';
+    constructor(cause) {
+        super(`redaction failed: ${cause instanceof Error ? cause.message : String(cause)}`);
+        this.name = 'RedactionError';
+    }
+}
+export function redactJsonFailClosed(value) {
+    try {
+        return redactJson(value);
+    }
+    catch (e) {
+        throw new RedactionError(e);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/redaction/index.js.map

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

package/dist/schema/index.d.ts

@@ -0,0 +1,383 @@
+/**
+ * ScreenGraph schema — the canonical v0 data contract.
+ *
+ * See VISION_LAYER_MVP_PLAN.md §6 and §18.2 for the accepted contract decisions:
+ *  - bbox is always [x, y, width, height] in the declared coordinate space.
+ *  - confidence is always a finite number in [0, 1].
+ *  - compare_graphs output fields are missingFromActual / extraInActual.
+ */
+import { z } from 'zod';
+/** `[x, y, width, height]`. width/height must be non-negative. */
+export declare const Bbox: z.ZodEffects<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>, [number, number, number, number], [number, number, number, number]>;
+export type Bbox = z.infer<typeof Bbox>;
+export declare const CoordinateSpace: z.ZodEnum<["viewport", "screenshot", "figma"]>;
+export type CoordinateSpace = z.infer<typeof CoordinateSpace>;
+export declare const ScreenGraphSource: z.ZodEnum<["browser", "figma", "image", "hybrid"]>;
+export type ScreenGraphSource = z.infer<typeof ScreenGraphSource>;
+export declare const InteractableSource: z.ZodEnum<["dom", "ax", "figma", "ocr", "vision"]>;
+export type InteractableSource = z.infer<typeof InteractableSource>;
+export declare const WarningSeverity: z.ZodEnum<["info", "warning", "error"]>;
+export type WarningSeverity = z.infer<typeof WarningSeverity>;
+/** Finite number in [0, 1]. */
+export declare const Confidence: z.ZodNumber;
+export type Confidence = z.infer<typeof Confidence>;
+/** Per-dimension grounding scores, each in [0, 1]. */
+export declare const ScoreBreakdown: z.ZodObject<{
+    text: z.ZodOptional<z.ZodNumber>;
+    role: z.ZodOptional<z.ZodNumber>;
+    bbox: z.ZodOptional<z.ZodNumber>;
+    source: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodNumber, z.objectOutputType<{
+    text: z.ZodOptional<z.ZodNumber>;
+    role: z.ZodOptional<z.ZodNumber>;
+    bbox: z.ZodOptional<z.ZodNumber>;
+    source: z.ZodOptional<z.ZodNumber>;
+}, z.ZodNumber, "strip">, z.objectInputType<{
+    text: z.ZodOptional<z.ZodNumber>;
+    role: z.ZodOptional<z.ZodNumber>;
+    bbox: z.ZodOptional<z.ZodNumber>;
+    source: z.ZodOptional<z.ZodNumber>;
+}, z.ZodNumber, "strip">>;
+export type ScoreBreakdown = z.infer<typeof ScoreBreakdown>;
+export declare const Viewport: z.ZodObject<{
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    dpr: z.ZodOptional<z.ZodNumber>;
+    url: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    width: number;
+    height: number;
+    dpr?: number | undefined;
+    url?: string | undefined;
+}, {
+    width: number;
+    height: number;
+    dpr?: number | undefined;
+    url?: string | undefined;
+}>;
+export type Viewport = z.infer<typeof Viewport>;
+export declare const Screenshot: z.ZodObject<{
+    artifactId: z.ZodString;
+    sha256: z.ZodString;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    mimeType: z.ZodEnum<["image/png", "image/jpeg"]>;
+}, "strip", z.ZodTypeAny, {
+    width: number;
+    height: number;
+    artifactId: string;
+    sha256: string;
+    mimeType: "image/png" | "image/jpeg";
+}, {
+    width: number;
+    height: number;
+    artifactId: string;
+    sha256: string;
+    mimeType: "image/png" | "image/jpeg";
+}>;
+export type Screenshot = z.infer<typeof Screenshot>;
+export declare const AttributeValue: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+export type AttributeValue = z.infer<typeof AttributeValue>;
+export declare const Interactable: z.ZodObject<{
+    id: z.ZodString;
+    role: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+    bbox: z.ZodEffects<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>, [number, number, number, number], [number, number, number, number]>;
+    coordinateSpace: z.ZodEnum<["viewport", "screenshot", "figma"]>;
+    source: z.ZodArray<z.ZodEnum<["dom", "ax", "figma", "ocr", "vision"]>, "many">;
+    confidence: z.ZodNumber;
+    domPath: z.ZodOptional<z.ZodString>;
+    axRef: z.ZodOptional<z.ZodString>;
+    figmaNodeId: z.ZodOptional<z.ZodString>;
+    attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+}, "strip", z.ZodTypeAny, {
+    bbox: [number, number, number, number];
+    source: ("figma" | "dom" | "ax" | "ocr" | "vision")[];
+    id: string;
+    coordinateSpace: "viewport" | "screenshot" | "figma";
+    confidence: number;
+    text?: string | undefined;
+    role?: string | undefined;
+    name?: string | undefined;
+    domPath?: string | undefined;
+    axRef?: string | undefined;
+    figmaNodeId?: string | undefined;
+    attributes?: Record<string, string | number | boolean> | undefined;
+}, {
+    bbox: [number, number, number, number];
+    source: ("figma" | "dom" | "ax" | "ocr" | "vision")[];
+    id: string;
+    coordinateSpace: "viewport" | "screenshot" | "figma";
+    confidence: number;
+    text?: string | undefined;
+    role?: string | undefined;
+    name?: string | undefined;
+    domPath?: string | undefined;
+    axRef?: string | undefined;
+    figmaNodeId?: string | undefined;
+    attributes?: Record<string, string | number | boolean> | undefined;
+}>;
+export type Interactable = z.infer<typeof Interactable>;
+export declare const Warning: z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+    severity: z.ZodEnum<["info", "warning", "error"]>;
+    targetId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    message: string;
+    severity: "info" | "warning" | "error";
+    targetId?: string | undefined;
+}, {
+    code: string;
+    message: string;
+    severity: "info" | "warning" | "error";
+    targetId?: string | undefined;
+}>;
+export type Warning = z.infer<typeof Warning>;
+export declare const Provenance: z.ZodObject<{
+    /** Dotted path to the field this provenance describes, e.g. `interactables[3].bbox`. */
+    field: z.ZodString;
+    /** Origin of the value. Either a known source or a free-form adapter label. */
+    source: z.ZodUnion<[z.ZodEnum<["dom", "ax", "figma", "ocr", "vision"]>, z.ZodString]>;
+    confidence: z.ZodOptional<z.ZodNumber>;
+    note: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    source: string;
+    field: string;
+    confidence?: number | undefined;
+    note?: string | undefined;
+}, {
+    source: string;
+    field: string;
+    confidence?: number | undefined;
+    note?: string | undefined;
+}>;
+export type Provenance = z.infer<typeof Provenance>;
+/**
+ * The MVP freezes domNodes / axNodes / figmaNodes / ocrBlocks / mappings as
+ * opaque `unknown[]` — adapters may attach raw upstream payloads, but core
+ * only reasons over `interactables`. Concrete shapes land in later versions.
+ */
+export declare const ScreenGraph: z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodLiteral<"0.1">;
+    source: z.ZodEnum<["browser", "figma", "image", "hybrid"]>;
+    createdAt: z.ZodString;
+    viewport: z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        dpr: z.ZodOptional<z.ZodNumber>;
+        url: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        width: number;
+        height: number;
+        dpr?: number | undefined;
+        url?: string | undefined;
+    }, {
+        width: number;
+        height: number;
+        dpr?: number | undefined;
+        url?: string | undefined;
+    }>>;
+    screenshot: z.ZodOptional<z.ZodObject<{
+        artifactId: z.ZodString;
+        sha256: z.ZodString;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        mimeType: z.ZodEnum<["image/png", "image/jpeg"]>;
+    }, "strip", z.ZodTypeAny, {
+        width: number;
+        height: number;
+        artifactId: string;
+        sha256: string;
+        mimeType: "image/png" | "image/jpeg";
+    }, {
+        width: number;
+        height: number;
+        artifactId: string;
+        sha256: string;
+        mimeType: "image/png" | "image/jpeg";
+    }>>;
+    interactables: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        role: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        bbox: z.ZodEffects<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>, [number, number, number, number], [number, number, number, number]>;
+        coordinateSpace: z.ZodEnum<["viewport", "screenshot", "figma"]>;
+        source: z.ZodArray<z.ZodEnum<["dom", "ax", "figma", "ocr", "vision"]>, "many">;
+        confidence: z.ZodNumber;
+        domPath: z.ZodOptional<z.ZodString>;
+        axRef: z.ZodOptional<z.ZodString>;
+        figmaNodeId: z.ZodOptional<z.ZodString>;
+        attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    }, "strip", z.ZodTypeAny, {
+        bbox: [number, number, number, number];
+        source: ("figma" | "dom" | "ax" | "ocr" | "vision")[];
+        id: string;
+        coordinateSpace: "viewport" | "screenshot" | "figma";
+        confidence: number;
+        text?: string | undefined;
+        role?: string | undefined;
+        name?: string | undefined;
+        domPath?: string | undefined;
+        axRef?: string | undefined;
+        figmaNodeId?: string | undefined;
+        attributes?: Record<string, string | number | boolean> | undefined;
+    }, {
+        bbox: [number, number, number, number];
+        source: ("figma" | "dom" | "ax" | "ocr" | "vision")[];
+        id: string;
+        coordinateSpace: "viewport" | "screenshot" | "figma";
+        confidence: number;
+        text?: string | undefined;
+        role?: string | undefined;
+        name?: string | undefined;
+        domPath?: string | undefined;
+        axRef?: string | undefined;
+        figmaNodeId?: string | undefined;
+        attributes?: Record<string, string | number | boolean> | undefined;
+    }>, "many">;
+    domNodes: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+    axNodes: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+    figmaNodes: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+    ocrBlocks: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+    mappings: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+    warnings: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        severity: z.ZodEnum<["info", "warning", "error"]>;
+        targetId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        message: string;
+        severity: "info" | "warning" | "error";
+        targetId?: string | undefined;
+    }, {
+        code: string;
+        message: string;
+        severity: "info" | "warning" | "error";
+        targetId?: string | undefined;
+    }>, "many">>;
+    provenance: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        /** Dotted path to the field this provenance describes, e.g. `interactables[3].bbox`. */
+        field: z.ZodString;
+        /** Origin of the value. Either a known source or a free-form adapter label. */
+        source: z.ZodUnion<[z.ZodEnum<["dom", "ax", "figma", "ocr", "vision"]>, z.ZodString]>;
+        confidence: z.ZodOptional<z.ZodNumber>;
+        note: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        source: string;
+        field: string;
+        confidence?: number | undefined;
+        note?: string | undefined;
+    }, {
+        source: string;
+        field: string;
+        confidence?: number | undefined;
+        note?: string | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    source: "figma" | "browser" | "image" | "hybrid";
+    id: string;
+    version: "0.1";
+    createdAt: string;
+    interactables: {
+        bbox: [number, number, number, number];
+        source: ("figma" | "dom" | "ax" | "ocr" | "vision")[];
+        id: string;
+        coordinateSpace: "viewport" | "screenshot" | "figma";
+        confidence: number;
+        text?: string | undefined;
+        role?: string | undefined;
+        name?: string | undefined;
+        domPath?: string | undefined;
+        axRef?: string | undefined;
+        figmaNodeId?: string | undefined;
+        attributes?: Record<string, string | number | boolean> | undefined;
+    }[];
+    mappings: unknown[];
+    warnings: {
+        code: string;
+        message: string;
+        severity: "info" | "warning" | "error";
+        targetId?: string | undefined;
+    }[];
+    provenance: {
+        source: string;
+        field: string;
+        confidence?: number | undefined;
+        note?: string | undefined;
+    }[];
+    viewport?: {
+        width: number;
+        height: number;
+        dpr?: number | undefined;
+        url?: string | undefined;
+    } | undefined;
+    screenshot?: {
+        width: number;
+        height: number;
+        artifactId: string;
+        sha256: string;
+        mimeType: "image/png" | "image/jpeg";
+    } | undefined;
+    domNodes?: unknown[] | undefined;
+    axNodes?: unknown[] | undefined;
+    figmaNodes?: unknown[] | undefined;
+    ocrBlocks?: unknown[] | undefined;
+}, {
+    source: "figma" | "browser" | "image" | "hybrid";
+    id: string;
+    version: "0.1";
+    createdAt: string;
+    interactables: {
+        bbox: [number, number, number, number];
+        source: ("figma" | "dom" | "ax" | "ocr" | "vision")[];
+        id: string;
+        coordinateSpace: "viewport" | "screenshot" | "figma";
+        confidence: number;
+        text?: string | undefined;
+        role?: string | undefined;
+        name?: string | undefined;
+        domPath?: string | undefined;
+        axRef?: string | undefined;
+        figmaNodeId?: string | undefined;
+        attributes?: Record<string, string | number | boolean> | undefined;
+    }[];
+    viewport?: {
+        width: number;
+        height: number;
+        dpr?: number | undefined;
+        url?: string | undefined;
+    } | undefined;
+    screenshot?: {
+        width: number;
+        height: number;
+        artifactId: string;
+        sha256: string;
+        mimeType: "image/png" | "image/jpeg";
+    } | undefined;
+    domNodes?: unknown[] | undefined;
+    axNodes?: unknown[] | undefined;
+    figmaNodes?: unknown[] | undefined;
+    ocrBlocks?: unknown[] | undefined;
+    mappings?: unknown[] | undefined;
+    warnings?: {
+        code: string;
+        message: string;
+        severity: "info" | "warning" | "error";
+        targetId?: string | undefined;
+    }[] | undefined;
+    provenance?: {
+        source: string;
+        field: string;
+        confidence?: number | undefined;
+        note?: string | undefined;
+    }[] | undefined;
+}>;
+export type ScreenGraph = z.infer<typeof ScreenGraph>;
+export declare const SCHEMA_VERSION: "0.1";
+//# sourceMappingURL=index.d.ts.map

package/dist/schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,kEAAkE;AAClE,eAAO,MAAM,IAAI,0JAE0F,CAAC;AAC5G,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC,eAAO,MAAM,eAAe,gDAA8C,CAAC;AAC3E,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,iBAAiB,oDAAkD,CAAC;AACjF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,eAAO,MAAM,kBAAkB,oDAAkD,CAAC;AAClF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE,eAAO,MAAM,eAAe,yCAAuC,CAAC;AACpE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,+BAA+B;AAC/B,eAAO,MAAM,UAAU,aAAoC,CAAC;AAC5D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,sDAAsD;AACtD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;yBAOU,CAAC;AACtC,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAI5D,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;EAKnB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;EAMrB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,eAAO,MAAM,cAAc,sDAAiD,CAAC;AAC7E,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAavB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;EAKlB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,CAAC;AAE9C,eAAO,MAAM,UAAU;IACrB,wFAAwF;;IAExF,+EAA+E;;;;;;;;;;;;;;EAI/E,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAIpD;;;;GAIG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAhBtB,wFAAwF;;QAExF,+EAA+E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6B/E,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,cAAc,EAAG,KAAc,CAAC"}