@neonwatty/limner 0.1.1 → 0.1.3

package/dist/core/workspace.js

@@ -1,4 +1,4 @@
-import { copyFile, mkdir, readFile, writeFile } from 'node:fs/promises';
+import { copyFile, mkdir, readdir, readFile, writeFile } from 'node:fs/promises';
 import path from 'node:path';
 export function resolveWorkspace(root = process.cwd()) {
     const resolvedRoot = path.resolve(root);
@@ -42,6 +42,17 @@ export function resolveTarget(workspaceRoot, target, sourceFileName = 'ideal.png
         referenceCssPath: path.join(referenceDir, 'styles.css'),
     };
 }
+export async function resolveTargetWithSource(workspaceRoot, target) {
+    const resolved = resolveTarget(workspaceRoot, target);
+    try {
+        const entries = await readdir(resolved.sourceDir);
+        const sourceFile = entries.find((entry) => /\.(avif|gif|jpe?g|png|svg|webp)$/i.test(entry));
+        return sourceFile ? resolveTarget(workspaceRoot, target, sourceFile) : resolved;
+    }
+    catch {
+        return resolved;
+    }
+}
 export async function ensureWorkspace(workspace) {
     await mkdir(workspace.targetsDir, { recursive: true });
     await mkdir(workspace.runsDir, { recursive: true });
@@ -57,7 +68,7 @@ export async function ensureTargetDirs(target) {
         mkdir(target.contractDir, { recursive: true }),
         mkdir(path.join(target.referenceDir, 'assets'), { recursive: true }),
         mkdir(path.join(target.capturesDir, 'image-reference'), { recursive: true }),
-        mkdir(path.join(target.capturesDir, 'reference-app'), { recursive: true }),
+        mkdir(path.join(target.capturesDir, 'reference-implementation'), { recursive: true }),
         mkdir(path.join(target.capturesDir, 'reference'), { recursive: true }),
         mkdir(target.reportsDir, { recursive: true }),
     ]);

package/dist/core/workspace.js.map

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

package/dist/index.d.ts

@@ -4,11 +4,13 @@ export { limnerRunEventSchema, runManifestSchema } from './schemas/events.js';
 export type { LimnerRunEvent, RunManifest } from './schemas/events.js';
 export { visualSpecBundleSchema, visualSpecDiffSchema, visualSpecSchema, createVisualSpecBundleExample, createVisualSpecJsonSchema } from './schemas/visual-spec.js';
 export type { VisualSpec, VisualSpecBundle, VisualSpecDiff } from './schemas/visual-spec.js';
+export { agentComparisonBundleSchema, imageComparisonSchema, structureComparisonSchema, createAgentComparisonBundleExample, createAgentComparisonJsonSchema, } from './schemas/comparison.js';
+export type { AgentComparisonBundle, ImageComparison, StructureComparison } from './schemas/comparison.js';
 export { initTarget } from './commands/init.js';
 export { captureReference } from './commands/capture.js';
-export { compareImageReference, compareReferenceApp } from './commands/compare.js';
-export { compareImageApp } from './commands/compare-image-app.js';
+export { compareImageReference, compareReferenceImplementation } from './commands/compare.js';
 export { createRunId, createRunLogger } from './core/run-logger.js';
 export { resolveWorkspace, validateTargetName } from './core/workspace.js';
 export { collectReferenceDomFacts } from './core/reference-dom-facts.js';
 export { writeImageReferenceSpecPack } from './core/visual-spec-agent-pack.js';
+export { writeAgentComparisonPack } from './core/agent-comparison-pack.js';

package/dist/index.js

@@ -1,12 +1,13 @@
 export { limnerRegionCheckSchema, limnerRegionContractSchema, limnerRegionSchema, limnerTokensSchema, } from './schemas/contract.js';
 export { limnerRunEventSchema, runManifestSchema } from './schemas/events.js';
 export { visualSpecBundleSchema, visualSpecDiffSchema, visualSpecSchema, createVisualSpecBundleExample, createVisualSpecJsonSchema } from './schemas/visual-spec.js';
+export { agentComparisonBundleSchema, imageComparisonSchema, structureComparisonSchema, createAgentComparisonBundleExample, createAgentComparisonJsonSchema, } from './schemas/comparison.js';
 export { initTarget } from './commands/init.js';
 export { captureReference } from './commands/capture.js';
-export { compareImageReference, compareReferenceApp } from './commands/compare.js';
-export { compareImageApp } from './commands/compare-image-app.js';
+export { compareImageReference, compareReferenceImplementation } from './commands/compare.js';
 export { createRunId, createRunLogger } from './core/run-logger.js';
 export { resolveWorkspace, validateTargetName } from './core/workspace.js';
 export { collectReferenceDomFacts } from './core/reference-dom-facts.js';
 export { writeImageReferenceSpecPack } from './core/visual-spec-agent-pack.js';
+export { writeAgentComparisonPack } from './core/agent-comparison-pack.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE9E,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAErK,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE9E,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAErK,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,yBAAyB,EACzB,kCAAkC,EAClC,+BAA+B,GAChC,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AAC9F,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/schemas/comparison.d.ts

@@ -0,0 +1,349 @@
+import { z } from 'zod';
+declare const inputFingerprintSchema: z.ZodObject<{
+    expectedImageSha256: z.ZodString;
+    actualImageSha256: z.ZodString;
+    expectedStructureSha256: z.ZodOptional<z.ZodString>;
+    actualStructureSha256: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const imageComparisonSchema: z.ZodObject<{
+    summary: z.ZodString;
+    score: z.ZodObject<{
+        overall: z.ZodNumber;
+        layout: z.ZodOptional<z.ZodNumber>;
+        hierarchy: z.ZodOptional<z.ZodNumber>;
+        typography: z.ZodOptional<z.ZodNumber>;
+        color: z.ZodOptional<z.ZodNumber>;
+        spacing: z.ZodOptional<z.ZodNumber>;
+        structure: z.ZodOptional<z.ZodNumber>;
+        semantics: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    confidence: z.ZodNumber;
+    majorDiffAreas: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        category: z.ZodEnum<{
+            typography: "typography";
+            spacing: "spacing";
+            color: "color";
+            layout: "layout";
+            hierarchy: "hierarchy";
+            "component-anatomy": "component-anatomy";
+            "copy-state": "copy-state";
+            "attention-flow": "attention-flow";
+            other: "other";
+        }>;
+        severity: z.ZodEnum<{
+            high: "high";
+            medium: "medium";
+            low: "low";
+        }>;
+        priority: z.ZodNumber;
+        expected: z.ZodString;
+        actual: z.ZodString;
+        impact: z.ZodString;
+        evidence: z.ZodArray<z.ZodObject<{
+            source: z.ZodString;
+            observation: z.ZodString;
+        }, z.core.$strip>>;
+        fixTarget: z.ZodOptional<z.ZodObject<{
+            surface: z.ZodEnum<{
+                unknown: "unknown";
+                mockup: "mockup";
+                implementation: "implementation";
+            }>;
+            region: z.ZodOptional<z.ZodString>;
+            likelyFiles: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            selectors: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        recommendedChange: z.ZodString;
+    }, z.core.$strip>>;
+    matches: z.ZodArray<z.ZodString>;
+    remarks: z.ZodObject<{
+        matches: z.ZodArray<z.ZodString>;
+        uncertainties: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        possibleIntentionalDeviations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+    systemFeedback: z.ZodObject<{
+        inputQuality: z.ZodArray<z.ZodString>;
+        missingContext: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        suggestedLimnerImprovements: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+    nextIteration: z.ZodObject<{
+        focus: z.ZodString;
+        steps: z.ZodArray<z.ZodString>;
+        avoidForNow: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        expectedImprovement: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    rationale: z.ZodString;
+    kind: z.ZodLiteral<"image-vs-image">;
+    inputs: z.ZodObject<{
+        expectedImagePath: z.ZodString;
+        actualImagePath: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const structureComparisonSchema: z.ZodObject<{
+    summary: z.ZodString;
+    score: z.ZodObject<{
+        overall: z.ZodNumber;
+        layout: z.ZodOptional<z.ZodNumber>;
+        hierarchy: z.ZodOptional<z.ZodNumber>;
+        typography: z.ZodOptional<z.ZodNumber>;
+        color: z.ZodOptional<z.ZodNumber>;
+        spacing: z.ZodOptional<z.ZodNumber>;
+        structure: z.ZodOptional<z.ZodNumber>;
+        semantics: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    confidence: z.ZodNumber;
+    majorDiffAreas: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        category: z.ZodEnum<{
+            typography: "typography";
+            spacing: "spacing";
+            color: "color";
+            layout: "layout";
+            hierarchy: "hierarchy";
+            "component-anatomy": "component-anatomy";
+            "copy-state": "copy-state";
+            "attention-flow": "attention-flow";
+            other: "other";
+        }>;
+        severity: z.ZodEnum<{
+            high: "high";
+            medium: "medium";
+            low: "low";
+        }>;
+        priority: z.ZodNumber;
+        expected: z.ZodString;
+        actual: z.ZodString;
+        impact: z.ZodString;
+        evidence: z.ZodArray<z.ZodObject<{
+            source: z.ZodString;
+            observation: z.ZodString;
+        }, z.core.$strip>>;
+        fixTarget: z.ZodOptional<z.ZodObject<{
+            surface: z.ZodEnum<{
+                unknown: "unknown";
+                mockup: "mockup";
+                implementation: "implementation";
+            }>;
+            region: z.ZodOptional<z.ZodString>;
+            likelyFiles: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            selectors: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+        recommendedChange: z.ZodString;
+    }, z.core.$strip>>;
+    matches: z.ZodArray<z.ZodString>;
+    remarks: z.ZodObject<{
+        matches: z.ZodArray<z.ZodString>;
+        uncertainties: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        possibleIntentionalDeviations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+    systemFeedback: z.ZodObject<{
+        inputQuality: z.ZodArray<z.ZodString>;
+        missingContext: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        suggestedLimnerImprovements: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+    nextIteration: z.ZodObject<{
+        focus: z.ZodString;
+        steps: z.ZodArray<z.ZodString>;
+        avoidForNow: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        expectedImprovement: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    rationale: z.ZodString;
+    kind: z.ZodLiteral<"structure-vs-structure">;
+    inputs: z.ZodObject<{
+        expectedStructurePath: z.ZodString;
+        actualStructurePath: z.ZodString;
+        structureKind: z.ZodEnum<{
+            "dom-metrics": "dom-metrics";
+            "visual-spec": "visual-spec";
+            html: "html";
+            "json-description": "json-description";
+        }>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const agentComparisonBundleSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    generatedBy: z.ZodLiteral<"agent">;
+    profile: z.ZodEnum<{
+        "ideal-to-mockup": "ideal-to-mockup";
+        "mockup-to-implementation": "mockup-to-implementation";
+    }>;
+    inputFingerprint: z.ZodObject<{
+        expectedImageSha256: z.ZodString;
+        actualImageSha256: z.ZodString;
+        expectedStructureSha256: z.ZodOptional<z.ZodString>;
+        actualStructureSha256: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    imageComparison: z.ZodObject<{
+        summary: z.ZodString;
+        score: z.ZodObject<{
+            overall: z.ZodNumber;
+            layout: z.ZodOptional<z.ZodNumber>;
+            hierarchy: z.ZodOptional<z.ZodNumber>;
+            typography: z.ZodOptional<z.ZodNumber>;
+            color: z.ZodOptional<z.ZodNumber>;
+            spacing: z.ZodOptional<z.ZodNumber>;
+            structure: z.ZodOptional<z.ZodNumber>;
+            semantics: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+        confidence: z.ZodNumber;
+        majorDiffAreas: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            category: z.ZodEnum<{
+                typography: "typography";
+                spacing: "spacing";
+                color: "color";
+                layout: "layout";
+                hierarchy: "hierarchy";
+                "component-anatomy": "component-anatomy";
+                "copy-state": "copy-state";
+                "attention-flow": "attention-flow";
+                other: "other";
+            }>;
+            severity: z.ZodEnum<{
+                high: "high";
+                medium: "medium";
+                low: "low";
+            }>;
+            priority: z.ZodNumber;
+            expected: z.ZodString;
+            actual: z.ZodString;
+            impact: z.ZodString;
+            evidence: z.ZodArray<z.ZodObject<{
+                source: z.ZodString;
+                observation: z.ZodString;
+            }, z.core.$strip>>;
+            fixTarget: z.ZodOptional<z.ZodObject<{
+                surface: z.ZodEnum<{
+                    unknown: "unknown";
+                    mockup: "mockup";
+                    implementation: "implementation";
+                }>;
+                region: z.ZodOptional<z.ZodString>;
+                likelyFiles: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                selectors: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+            recommendedChange: z.ZodString;
+        }, z.core.$strip>>;
+        matches: z.ZodArray<z.ZodString>;
+        remarks: z.ZodObject<{
+            matches: z.ZodArray<z.ZodString>;
+            uncertainties: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            possibleIntentionalDeviations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>;
+        systemFeedback: z.ZodObject<{
+            inputQuality: z.ZodArray<z.ZodString>;
+            missingContext: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            suggestedLimnerImprovements: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>;
+        nextIteration: z.ZodObject<{
+            focus: z.ZodString;
+            steps: z.ZodArray<z.ZodString>;
+            avoidForNow: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            expectedImprovement: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        rationale: z.ZodString;
+        kind: z.ZodLiteral<"image-vs-image">;
+        inputs: z.ZodObject<{
+            expectedImagePath: z.ZodString;
+            actualImagePath: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    structureComparison: z.ZodOptional<z.ZodObject<{
+        summary: z.ZodString;
+        score: z.ZodObject<{
+            overall: z.ZodNumber;
+            layout: z.ZodOptional<z.ZodNumber>;
+            hierarchy: z.ZodOptional<z.ZodNumber>;
+            typography: z.ZodOptional<z.ZodNumber>;
+            color: z.ZodOptional<z.ZodNumber>;
+            spacing: z.ZodOptional<z.ZodNumber>;
+            structure: z.ZodOptional<z.ZodNumber>;
+            semantics: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+        confidence: z.ZodNumber;
+        majorDiffAreas: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            category: z.ZodEnum<{
+                typography: "typography";
+                spacing: "spacing";
+                color: "color";
+                layout: "layout";
+                hierarchy: "hierarchy";
+                "component-anatomy": "component-anatomy";
+                "copy-state": "copy-state";
+                "attention-flow": "attention-flow";
+                other: "other";
+            }>;
+            severity: z.ZodEnum<{
+                high: "high";
+                medium: "medium";
+                low: "low";
+            }>;
+            priority: z.ZodNumber;
+            expected: z.ZodString;
+            actual: z.ZodString;
+            impact: z.ZodString;
+            evidence: z.ZodArray<z.ZodObject<{
+                source: z.ZodString;
+                observation: z.ZodString;
+            }, z.core.$strip>>;
+            fixTarget: z.ZodOptional<z.ZodObject<{
+                surface: z.ZodEnum<{
+                    unknown: "unknown";
+                    mockup: "mockup";
+                    implementation: "implementation";
+                }>;
+                region: z.ZodOptional<z.ZodString>;
+                likelyFiles: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                selectors: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+            recommendedChange: z.ZodString;
+        }, z.core.$strip>>;
+        matches: z.ZodArray<z.ZodString>;
+        remarks: z.ZodObject<{
+            matches: z.ZodArray<z.ZodString>;
+            uncertainties: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            possibleIntentionalDeviations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>;
+        systemFeedback: z.ZodObject<{
+            inputQuality: z.ZodArray<z.ZodString>;
+            missingContext: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            suggestedLimnerImprovements: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>;
+        nextIteration: z.ZodObject<{
+            focus: z.ZodString;
+            steps: z.ZodArray<z.ZodString>;
+            avoidForNow: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            expectedImprovement: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        rationale: z.ZodString;
+        kind: z.ZodLiteral<"structure-vs-structure">;
+        inputs: z.ZodObject<{
+            expectedStructurePath: z.ZodString;
+            actualStructurePath: z.ZodString;
+            structureKind: z.ZodEnum<{
+                "dom-metrics": "dom-metrics";
+                "visual-spec": "visual-spec";
+                html: "html";
+                "json-description": "json-description";
+            }>;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    recommendation: z.ZodDefault<z.ZodObject<{
+        topFix: z.ZodOptional<z.ZodString>;
+        why: z.ZodOptional<z.ZodString>;
+        expectedScoreLift: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ImageComparison = z.infer<typeof imageComparisonSchema>;
+export type StructureComparison = z.infer<typeof structureComparisonSchema>;
+export type AgentComparisonBundle = z.infer<typeof agentComparisonBundleSchema>;
+export type AgentComparisonInputFingerprint = z.infer<typeof inputFingerprintSchema>;
+export declare function createAgentComparisonBundleExample(mode: 'image-only' | 'image-and-structure', inputFingerprint?: AgentComparisonInputFingerprint): AgentComparisonBundle;
+export declare function createAgentComparisonJsonSchema(mode?: 'any' | 'image-only' | 'image-and-structure'): unknown;
+export {};

package/dist/schemas/comparison.js

@@ -0,0 +1,211 @@
+import { z } from 'zod';
+const score01Schema = z.number().min(0).max(1);
+const comparisonScoreSchema = z.object({
+    overall: score01Schema,
+    layout: score01Schema.optional(),
+    hierarchy: score01Schema.optional(),
+    typography: score01Schema.optional(),
+    color: score01Schema.optional(),
+    spacing: score01Schema.optional(),
+    structure: score01Schema.optional(),
+    semantics: score01Schema.optional(),
+});
+const hashSchema = z.string().regex(/^[a-f0-9]{64}$/);
+const inputFingerprintSchema = z.object({
+    expectedImageSha256: hashSchema,
+    actualImageSha256: hashSchema,
+    expectedStructureSha256: hashSchema.optional(),
+    actualStructureSha256: hashSchema.optional(),
+});
+const evidenceSchema = z.object({
+    source: z.string().min(1),
+    observation: z.string().min(1),
+});
+const fixTargetSchema = z.object({
+    surface: z.enum(['mockup', 'implementation', 'unknown']),
+    region: z.string().min(1).optional(),
+    likelyFiles: z.array(z.string()).default([]),
+    selectors: z.array(z.string()).default([]),
+});
+const diffAreaSchema = z.object({
+    id: z.string().min(1),
+    title: z.string().min(1),
+    category: z.enum(['layout', 'hierarchy', 'typography', 'color', 'spacing', 'component-anatomy', 'copy-state', 'attention-flow', 'other']),
+    severity: z.enum(['high', 'medium', 'low']),
+    priority: z.number().int().positive(),
+    expected: z.string().min(1),
+    actual: z.string().min(1),
+    impact: z.string().min(1),
+    evidence: z.array(evidenceSchema).min(1),
+    fixTarget: fixTargetSchema.optional(),
+    recommendedChange: z.string().min(1),
+});
+const nextIterationSchema = z.object({
+    focus: z.string().min(1),
+    steps: z.array(z.string()),
+    avoidForNow: z.array(z.string()).default([]),
+    expectedImprovement: z.string().min(1).optional(),
+});
+const remarksSchema = z.object({
+    matches: z.array(z.string()),
+    uncertainties: z.array(z.string()).default([]),
+    possibleIntentionalDeviations: z.array(z.string()).default([]),
+});
+const systemFeedbackSchema = z.object({
+    inputQuality: z.array(z.string()),
+    missingContext: z.array(z.string()).default([]),
+    suggestedLimnerImprovements: z.array(z.string()).default([]),
+});
+const baseComparisonSchema = z.object({
+    summary: z.string().min(1),
+    score: comparisonScoreSchema,
+    confidence: score01Schema,
+    majorDiffAreas: z.array(diffAreaSchema),
+    matches: z.array(z.string()),
+    remarks: remarksSchema,
+    systemFeedback: systemFeedbackSchema,
+    nextIteration: nextIterationSchema,
+    rationale: z.string().min(1),
+});
+export const imageComparisonSchema = baseComparisonSchema.extend({
+    kind: z.literal('image-vs-image'),
+    inputs: z.object({
+        expectedImagePath: z.string().min(1),
+        actualImagePath: z.string().min(1),
+    }),
+});
+export const structureComparisonSchema = baseComparisonSchema.extend({
+    kind: z.literal('structure-vs-structure'),
+    inputs: z.object({
+        expectedStructurePath: z.string().min(1),
+        actualStructurePath: z.string().min(1),
+        structureKind: z.enum(['visual-spec', 'dom-metrics', 'html', 'json-description']),
+    }),
+});
+export const agentComparisonBundleSchema = z.object({
+    version: z.literal(1),
+    generatedBy: z.literal('agent'),
+    profile: z.enum(['ideal-to-mockup', 'mockup-to-implementation']),
+    inputFingerprint: inputFingerprintSchema,
+    imageComparison: imageComparisonSchema,
+    structureComparison: structureComparisonSchema.optional(),
+    recommendation: z.object({
+        topFix: z.string().min(1).optional(),
+        why: z.string().min(1).optional(),
+        expectedScoreLift: score01Schema.optional(),
+    }).default({}),
+});
+export function createAgentComparisonBundleExample(mode, inputFingerprint = exampleFingerprint(mode)) {
+    const imageComparison = {
+        kind: 'image-vs-image',
+        inputs: {
+            expectedImagePath: 'targets/demo/source/ideal.png',
+            actualImagePath: 'targets/demo/captures/image-reference/reference.png',
+        },
+        summary: 'The screens preserve the same overall layout, with hierarchy and typography drift.',
+        score: { overall: 0.82, layout: 0.9, hierarchy: 0.74, typography: 0.76, color: 0.85, spacing: 0.8 },
+        confidence: 0.78,
+        majorDiffAreas: [exampleDiff('hero-heading', 'Hero heading lacks visual dominance', 'mockup')],
+        matches: ['Primary content appears in the same broad region.'],
+        remarks: {
+            matches: ['Overall single-column composition is similar.'],
+            uncertainties: ['Exact font family cannot be determined from screenshots alone.'],
+            possibleIntentionalDeviations: [],
+        },
+        systemFeedback: {
+            inputQuality: ['Both screenshots are readable and appear to use the same viewport.'],
+            missingContext: [],
+            suggestedLimnerImprovements: ['Include computed font metrics for the hero region when available.'],
+        },
+        nextIteration: {
+            focus: 'Tune the hero heading size, weight, and contrast.',
+            steps: ['Increase heading font size by one scale step.', 'Use a heavier font weight.'],
+            avoidForNow: ['Do not spend the next iteration on tiny border-radius differences.'],
+            expectedImprovement: 'This should improve hierarchy more than small spacing changes.',
+        },
+        rationale: 'The composition is close, but visual priority differs enough to warrant another iteration.',
+    };
+    if (mode === 'image-only') {
+        return { version: 1, generatedBy: 'agent', profile: 'ideal-to-mockup', inputFingerprint, imageComparison, recommendation: {} };
+    }
+    imageComparison.inputs = {
+        expectedImagePath: 'targets/demo/captures/reference-implementation/reference.png',
+        actualImagePath: 'targets/demo/captures/reference-implementation/implementation.png',
+    };
+    imageComparison.summary = 'The implementation preserves the mockup layout, with hierarchy and typography drift.';
+    imageComparison.majorDiffAreas = [exampleDiff('hero-heading', 'Hero heading lacks visual dominance', 'implementation')];
+    imageComparison.nextIteration = {
+        focus: 'Tune the implementation hero heading size, weight, and contrast.',
+        steps: ['Increase implementation heading font size by one scale step.', 'Use a heavier font weight.'],
+        avoidForNow: ['Do not spend the next iteration on tiny border-radius differences.'],
+        expectedImprovement: 'This should improve implementation hierarchy more than small spacing changes.',
+    };
+    return {
+        version: 1,
+        generatedBy: 'agent',
+        profile: 'mockup-to-implementation',
+        inputFingerprint,
+        imageComparison,
+        structureComparison: {
+            kind: 'structure-vs-structure',
+            inputs: {
+                expectedStructurePath: 'targets/demo/captures/reference-implementation/reference.png.metrics.json',
+                actualStructurePath: 'targets/demo/captures/reference-implementation/implementation.png.metrics.json',
+                structureKind: 'dom-metrics',
+            },
+            summary: 'The region structure is mostly preserved, but the heading style differs.',
+            score: { overall: 0.86, structure: 0.92, typography: 0.72, color: 0.84, semantics: 0.9 },
+            confidence: 0.82,
+            majorDiffAreas: [exampleDiff('heading-weight', 'Heading weight differs in computed metrics', 'implementation')],
+            matches: ['Both structures include the main content and CTA regions.'],
+            remarks: { matches: ['Major regions are present.'], uncertainties: [], possibleIntentionalDeviations: [] },
+            systemFeedback: { inputQuality: ['DOM metrics were available for both sides.'], missingContext: [], suggestedLimnerImprovements: [] },
+            nextIteration: { focus: 'Align implementation heading typography.', steps: ['Increase implementation heading font weight.'], avoidForNow: [] },
+            rationale: 'The structure matches well, but computed typography still diverges.',
+        },
+        recommendation: {
+            topFix: 'Tune the hero heading typography.',
+            why: 'Both visual and structural comparisons identify this as the highest-impact mismatch.',
+            expectedScoreLift: 0.06,
+        },
+    };
+}
+export function createAgentComparisonJsonSchema(mode = 'any') {
+    const schema = z.toJSONSchema(agentComparisonBundleSchema);
+    if (mode === 'image-and-structure') {
+        schema.required = [...new Set([...(schema.required ?? []), 'structureComparison'])];
+    }
+    if (mode === 'image-only') {
+        schema.not = { required: ['structureComparison'] };
+    }
+    return schema;
+}
+function exampleDiff(id, title, surface) {
+    return {
+        id,
+        title,
+        category: 'typography',
+        severity: 'medium',
+        priority: 1,
+        expected: 'Large, bold, visually dominant heading.',
+        actual: 'Slightly smaller heading with weaker emphasis.',
+        impact: 'The primary hierarchy is less forceful.',
+        evidence: [{ source: 'expected-image', observation: 'Heading is the strongest element in the upper content region.' }],
+        fixTarget: { surface, region: 'hero', likelyFiles: [], selectors: [] },
+        recommendedChange: 'Increase heading size and weight, then compare again.',
+    };
+}
+function exampleFingerprint(mode) {
+    const image = {
+        expectedImageSha256: '0'.repeat(64),
+        actualImageSha256: '1'.repeat(64),
+    };
+    if (mode === 'image-only')
+        return image;
+    return {
+        ...image,
+        expectedStructureSha256: '2'.repeat(64),
+        actualStructureSha256: '3'.repeat(64),
+    };
+}
+//# sourceMappingURL=comparison.js.map