@kintsugi-ai/core 0.1.0

package/dist/comparator.js.map

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

package/dist/comparator.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=comparator.test.d.ts.map

package/dist/comparator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparator.test.d.ts","sourceRoot":"","sources":["../src/comparator.test.ts"],"names":[],"mappings":""}

package/dist/comparator.test.js

@@ -0,0 +1,73 @@
+import { test, describe } from 'node:test';
+import assert from 'node:assert/strict';
+import { createSyntheticUiPng, computePixelDiff, compareScreenshots, diffAriaSnapshots, parseVerdict, DiffResult } from './index.js';
+describe('Kintsugi Visual Comparator Engine', () => {
+    test('identical images return 0% diff and IDENTICAL status', async () => {
+        const img1 = createSyntheticUiPng();
+        const img2 = createSyntheticUiPng();
+        const pixelResult = await computePixelDiff(img1, img2);
+        assert.equal(pixelResult.diffPercent, 0);
+        const comp = await compareScreenshots(img1, img2);
+        assert.equal(comp.result, DiffResult.IDENTICAL);
+        assert.equal(comp.pixelDiffPercent, 0);
+    });
+    test('large pixel diff without a classifier escalates as CHANGED', async () => {
+        const baseline = createSyntheticUiPng({ removeButton: false });
+        const regressed = createSyntheticUiPng({ removeButton: true });
+        const pixelResult = await computePixelDiff(baseline, regressed);
+        assert.ok(pixelResult.diffPercent > 0.5, 'Pixel diff should exceed 0.5%');
+        const comp = await compareScreenshots(baseline, regressed);
+        assert.equal(comp.result, DiffResult.CHANGED, 'Missing button should escalate as CHANGED');
+    });
+    test('sub-threshold noise is classified as MINOR', async () => {
+        const baseline = createSyntheticUiPng();
+        const withNoise = createSyntheticUiPng({ addNoise: true, noiseAmount: 0.0002 });
+        const comp = await compareScreenshots(baseline, withNoise);
+        assert.ok(comp.result === DiffResult.IDENTICAL || comp.result === DiffResult.MINOR, 'Subpixel noise should be classified as IDENTICAL or MINOR, not BROKEN');
+    });
+    test('aria snapshot diff reports removed and added lines', () => {
+        const baseline = [
+            '- button "Complete Purchase ($89.00)"',
+            '- text "Free shipping"',
+        ].join('\n');
+        const current = [
+            '- text "Free shipping"',
+            '- textbox "Email"',
+        ].join('\n');
+        const diff = diffAriaSnapshots(baseline, current);
+        assert.ok(diff.includes('REMOVED: - button "Complete Purchase ($89.00)"'), 'Removed button should appear as removed');
+        assert.ok(diff.includes('textbox "Email"') && diff.includes('ADDED:'), 'Added textbox should appear as added');
+        assert.ok(!diff.includes('no line-level differences'));
+    });
+    test('aria snapshot diff of identical snapshots reports no differences', () => {
+        const snap = '- button "Buy"\n- text "Hello"';
+        assert.ok(diffAriaSnapshots(snap, snap).includes('no line-level differences'));
+    });
+});
+describe('Classifier verdict parsing', () => {
+    test('parses the JSON verdict format', () => {
+        const v = parseVerdict('{"intentional": true, "confidence": 0.92, "reasoning": "Matches the requested recolor."}');
+        assert.equal(v.intentional, true);
+        assert.equal(v.confidence, 0.92);
+        assert.ok(v.reasoning.includes('recolor'));
+    });
+    test('parses JSON embedded in chatter', () => {
+        const v = parseVerdict('Sure! {"intentional": false, "confidence": 0.85, "reasoning": "The checkout button was removed; re-add it."} hope that helps');
+        assert.equal(v.intentional, false);
+        assert.equal(v.confidence, 0.85);
+        assert.ok(v.reasoning.includes('re-add'));
+    });
+    test('defaults missing confidence and reasoning conservatively', () => {
+        const v = parseVerdict('{"intentional": true}');
+        assert.equal(v.intentional, true);
+        assert.equal(v.confidence, 0.5);
+        assert.ok(v.reasoning.length > 0);
+    });
+    test('fails safe to not-intentional on unparseable output', () => {
+        const v = parseVerdict('I cannot tell what changed here, sorry.');
+        assert.equal(v.intentional, false);
+        assert.ok(v.confidence <= 0.7);
+        assert.ok(v.reasoning.length > 0);
+    });
+});
+//# sourceMappingURL=comparator.test.js.map

package/dist/comparator.test.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,6 @@
+import type { KintsugiConfig } from './types.js';
+export declare function getDefaultConfig(): KintsugiConfig;
+export declare function ensureKintsugiDir(projectDir: string): Promise<void>;
+export declare function loadConfig(projectDir: string): Promise<KintsugiConfig>;
+export declare function saveConfig(projectDir: string, config: KintsugiConfig): Promise<void>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,wBAAgB,gBAAgB,IAAI,cAAc,CAmCjD;AAED,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQzE;AAED,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAyB5E;AAED,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAI1F"}

package/dist/config.js

@@ -0,0 +1,79 @@
+import { promises as fs } from 'fs';
+import path from 'path';
+export function getDefaultConfig() {
+    return {
+        version: 1,
+        devServerUrl: 'http://localhost:3000',
+        viewport: { width: 1280, height: 720 },
+        thresholds: {
+            pixelDiffPercent: 0.1,
+            ssimScore: 0.98,
+            maxCheckLatencyMs: 5000,
+        },
+        llm: {
+            provider: 'claude',
+            model: 'claude-3-5-sonnet-20241022',
+            apiKeyEnvVar: 'ANTHROPIC_API_KEY',
+        },
+        classifier: {
+            enabled: true,
+            provider: 'kintsugi',
+            endpoint: process.env.KINTSUGI_API_URL ?? 'https://api.kintsugi.dev/v1',
+            model: 'kintsugi-hosted',
+            tokenEnvVar: 'KINTSUGI_API_KEY',
+            pixelDiffThreshold: 0.5,
+            confidenceThreshold: 0.7,
+            timeoutMs: 20000,
+        },
+        agent: {
+            type: 'auto',
+            maxRetries: 3,
+        },
+        recording: {
+            passive: true,
+            collectorPort: 4321,
+        },
+        uiFilePatterns: ['src/**/*.tsx', 'src/**/*.ts', 'src/**/*.jsx', 'src/**/*.js'],
+    };
+}
+export async function ensureKintsugiDir(projectDir) {
+    const kintsugiDir = path.join(projectDir, '.kintsugi');
+    const flowsDir = path.join(kintsugiDir, 'flows');
+    const recordingsDir = path.join(kintsugiDir, 'recordings');
+    await fs.mkdir(kintsugiDir, { recursive: true });
+    await fs.mkdir(flowsDir, { recursive: true });
+    await fs.mkdir(recordingsDir, { recursive: true });
+}
+export async function loadConfig(projectDir) {
+    const configPath = path.join(projectDir, '.kintsugi', 'config.json');
+    const defaultConfig = getDefaultConfig();
+    try {
+        const data = await fs.readFile(configPath, 'utf-8');
+        const userConfig = JSON.parse(data);
+        const classifier = {
+            ...defaultConfig.classifier,
+            ...(userConfig.classifier ?? {}),
+        };
+        // Migration: configs written before the provider field pointed at
+        // OpenAI-compatible endpoints (HF router). Keep them working unchanged.
+        if (userConfig.classifier && userConfig.classifier.provider === undefined) {
+            if (!classifier.endpoint.includes('kintsugi')) {
+                classifier.provider = 'openai-compatible';
+            }
+        }
+        return {
+            ...defaultConfig,
+            ...userConfig,
+            classifier,
+        };
+    }
+    catch (error) {
+        return defaultConfig;
+    }
+}
+export async function saveConfig(projectDir, config) {
+    await ensureKintsugiDir(projectDir);
+    const configPath = path.join(projectDir, '.kintsugi', 'config.json');
+    await fs.writeFile(configPath, JSON.stringify(config, null, 2), 'utf-8');
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.test.d.ts.map

package/dist/config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.d.ts","sourceRoot":"","sources":["../src/config.test.ts"],"names":[],"mappings":""}

package/dist/config.test.js

@@ -0,0 +1,67 @@
+import { test, describe } from 'node:test';
+import assert from 'node:assert/strict';
+import os from 'node:os';
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { getDefaultConfig, saveConfig, loadConfig, ensureKintsugiDir, formatAgentFeedback, formatUserSummary, DiffResult } from './index.js';
+describe('Kintsugi Config & Feedback Formatter', () => {
+    test('generates valid default config', () => {
+        const config = getDefaultConfig();
+        assert.equal(config.version, 1);
+        assert.equal(config.viewport.width, 1280);
+        assert.equal(config.viewport.height, 720);
+        assert.ok(config.thresholds.pixelDiffPercent > 0);
+    });
+    test('saves and loads config from disk', async () => {
+        const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'kintsugi-test-'));
+        try {
+            await ensureKintsugiDir(tmpDir);
+            const config = getDefaultConfig();
+            config.devServerUrl = 'http://localhost:5173';
+            await saveConfig(tmpDir, config);
+            const loaded = await loadConfig(tmpDir);
+            assert.equal(loaded.devServerUrl, 'http://localhost:5173');
+        }
+        finally {
+            await fs.rm(tmpDir, { recursive: true, force: true });
+        }
+    });
+    test('formats actionable agent feedback on regression', () => {
+        const mockResult = {
+            result: DiffResult.BROKEN,
+            pixelDiffPercent: 3.42,
+            ssimScore: 1,
+            failedStep: 2,
+            stepResults: [
+                {
+                    step: 2,
+                    pixelDiffPercent: 3.42,
+                    ssimScore: 1,
+                    result: DiffResult.BROKEN,
+                }
+            ],
+            classifications: [
+                {
+                    step: 2,
+                    intentional: false,
+                    confidence: 0.9,
+                    reasoning: 'The checkout button was removed; re-add it to the order summary.',
+                    ariaDiff: 'REMOVED: - button "Complete Purchase ($89.00)"',
+                    oldImagePath: '/baseline/step_2.png',
+                    newImagePath: '/tmp/step_2.png',
+                }
+            ]
+        };
+        const feedback = formatAgentFeedback(mockResult, 'checkout-flow');
+        assert.ok(feedback.includes('checkout-flow is broken'), 'Should state the flow is broken');
+        assert.ok(feedback.includes('aria diffs:'), 'Should include aria diffs');
+        assert.ok(feedback.includes('REMOVED: - button'), 'Should include the aria diff content');
+        assert.ok(feedback.includes('image pairs (old image | new image):'), 'Should include image pairs');
+        assert.ok(feedback.includes('/baseline/step_2.png | /tmp/step_2.png'), 'Should include both image paths');
+        assert.ok(feedback.includes('suggested fixes:'), 'Should include suggested fixes');
+        assert.ok(feedback.includes('re-add it to the order summary'), 'Should include the classifier fix');
+        const summary = formatUserSummary(mockResult, 'checkout-flow');
+        assert.ok(summary.includes('checkout-flow'), 'Summary should include flow name');
+    });
+});
+//# sourceMappingURL=config.test.js.map

package/dist/config.test.js.map

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

package/dist/domdiff.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Line diff for Playwright aria snapshots (YAML). Produces a compact
+ * removed/added summary suitable as classifier input.
+ */
+export declare function diffAriaSnapshots(baseline: string, current: string): string;
+//# sourceMappingURL=domdiff.d.ts.map

package/dist/domdiff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domdiff.d.ts","sourceRoot":"","sources":["../src/domdiff.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAsD3E"}

package/dist/domdiff.js

@@ -0,0 +1,71 @@
+/**
+ * Line diff for Playwright aria snapshots (YAML). Produces a compact
+ * removed/added summary suitable as classifier input.
+ */
+const MAX_DIFF_LINES = 80;
+export function diffAriaSnapshots(baseline, current) {
+    const a = baseline.split('\n');
+    const b = current.split('\n');
+    // LCS table (snapshots are small — a few hundred lines max)
+    const m = a.length, n = b.length;
+    const dp = Array.from({ length: m + 1 }, () => new Array(n + 1).fill(0));
+    for (let i = m - 1; i >= 0; i--) {
+        for (let j = n - 1; j >= 0; j--) {
+            dp[i][j] = a[i] === b[j] ? dp[i + 1][j + 1] + 1 : Math.max(dp[i + 1][j], dp[i][j + 1]);
+        }
+    }
+    const ops = [];
+    let i = 0, j = 0;
+    while (i < m && j < n) {
+        if (a[i] === b[j]) {
+            ops.push({ type: ' ', line: a[i] });
+            i++;
+            j++;
+        }
+        else if (dp[i + 1][j] >= dp[i][j + 1]) {
+            ops.push({ type: '-', line: a[i] });
+            i++;
+        }
+        else {
+            ops.push({ type: '+', line: b[j] });
+            j++;
+        }
+    }
+    while (i < m) {
+        ops.push({ type: '-', line: a[i++] });
+    }
+    while (j < n) {
+        ops.push({ type: '+', line: b[j++] });
+    }
+    // Emit only changed hunks (with 1 line of context), trimmed.
+    // Prefixes are words, not +/-, because aria snapshot lines themselves
+    // start with YAML list markers ("- ").
+    const out = [];
+    let changes = 0;
+    let lastContextIndex = -1;
+    for (let k = 0; k < ops.length; k++) {
+        if (ops[k].type === ' ')
+            continue;
+        if (out.length > 0 && out[out.length - 1] !== '…' && ops[k - 1]?.type === ' ' && (k - 1) !== lastContextIndex) {
+            out.push('  ctx: ' + ops[k - 1].line);
+        }
+        while (k < ops.length && ops[k].type !== ' ') {
+            out.push((ops[k].type === '-' ? 'REMOVED: ' : 'ADDED:   ') + ops[k].line);
+            changes++;
+            k++;
+        }
+        if (k < ops.length) {
+            out.push('  ctx: ' + ops[k].line);
+            lastContextIndex = k;
+        }
+        out.push('');
+        if (out.length >= MAX_DIFF_LINES) {
+            out.push('… (diff truncated, more changes below)');
+            break;
+        }
+    }
+    if (changes === 0)
+        return '(no line-level differences — change is purely visual/rendered)';
+    return out.join('\n').trim();
+}
+//# sourceMappingURL=domdiff.js.map

package/dist/domdiff.js.map

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

package/dist/feedback.d.ts

@@ -0,0 +1,9 @@
+import { type ComparisonResult } from './types.js';
+/**
+ * Fix-it feedback in the agent-facing format:
+ * "{flow name} is broken, aria diffs: [...], [sets of (new image and old image)],
+ *   suggested fixes: [fixes from the classifier per image pair]"
+ */
+export declare function formatAgentFeedback(result: ComparisonResult, flowName: string): string;
+export declare function formatUserSummary(result: ComparisonResult, flowName: string): string;
+//# sourceMappingURL=feedback.d.ts.map

package/dist/feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../src/feedback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE/D;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA2CtF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWpF"}

package/dist/feedback.js

@@ -0,0 +1,57 @@
+import { DiffResult } from './types.js';
+/**
+ * Fix-it feedback in the agent-facing format:
+ * "{flow name} is broken, aria diffs: [...], [sets of (new image and old image)],
+ *   suggested fixes: [fixes from the classifier per image pair]"
+ */
+export function formatAgentFeedback(result, flowName) {
+    const lines = [];
+    lines.push(`${flowName} is broken.`);
+    // aria diffs per classified pair
+    lines.push('aria diffs:');
+    const classifications = result.classifications ?? [];
+    if (classifications.length === 0) {
+        lines.push('  (none captured — flow failed during replay; check selectors and page load)');
+    }
+    for (const c of classifications) {
+        lines.push(`  step ${c.step}:`);
+        for (const line of c.ariaDiff.split('\n')) {
+            lines.push(`    ${line}`);
+        }
+    }
+    // sets of (old image, new image)
+    lines.push('image pairs (old image | new image):');
+    if (classifications.length === 0) {
+        lines.push('  (none — flow failed during replay)');
+    }
+    for (const c of classifications) {
+        lines.push(`  step ${c.step}: ${c.oldImagePath ?? '(unavailable)'} | ${c.newImagePath ?? '(unavailable)'}`);
+    }
+    // suggested fixes — the classifier's reasoning per non-intentional pair
+    lines.push('suggested fixes:');
+    const regressions = classifications.filter(c => !c.intentional || c.confidence <= 0.7);
+    if (classifications.length === 0) {
+        lines.push('  - re-run the flow and verify the page loads; an element selector likely changed');
+    }
+    for (const c of regressions) {
+        lines.push(`  step ${c.step}: ${c.reasoning}`);
+    }
+    if (classifications.length > 0 && regressions.length === 0) {
+        lines.push('  - (classifier found no intentional-only pairs, but the flow still failed — see replay errors)');
+    }
+    if (result.diffImagePath) {
+        lines.push(`diff heatmap: ${result.diffImagePath}`);
+    }
+    return lines.join('\n');
+}
+export function formatUserSummary(result, flowName) {
+    if (result.result === DiffResult.IDENTICAL) {
+        return `✅ Flow "${flowName}" passed. No visual differences detected.`;
+    }
+    let summary = `⚠️ Flow "${flowName}" resulted in ${result.result.toUpperCase()}.\n`;
+    if (result.failedStep !== undefined) {
+        summary += `Step ${result.failedStep} failed with a pixel difference of ${result.pixelDiffPercent.toFixed(2)}%.`;
+    }
+    return summary;
+}
+//# sourceMappingURL=feedback.js.map

package/dist/feedback.js.map

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

package/dist/flowid.d.ts

@@ -0,0 +1,3 @@
+import type { FlowStep } from './types.js';
+export declare function flowFingerprint(name: string, steps: FlowStep[]): string;
+//# sourceMappingURL=flowid.d.ts.map

package/dist/flowid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flowid.d.ts","sourceRoot":"","sources":["../src/flowid.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAKvE"}

package/dist/flowid.js

@@ -0,0 +1,11 @@
+/**
+ * Stable per-flow fingerprint used by the hosted API's flow gate: hashed from
+ * the flow name + step actions/selectors/urls — NOT from screenshots or
+ * timestamps — so replays count once and renames can't evade the limit.
+ */
+import { createHash } from 'node:crypto';
+export function flowFingerprint(name, steps) {
+    const canonical = JSON.stringify(steps.map(s => [s.action, s.selector ?? null, s.url ?? null, s.value ?? null]));
+    return createHash('sha256').update(`${name}\n${canonical}`).digest('hex').slice(0, 40);
+}
+//# sourceMappingURL=flowid.js.map

package/dist/flowid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flowid.js","sourceRoot":"","sources":["../src/flowid.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,KAAiB;IAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAC9B,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAC/E,CAAC;IACF,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,IAAI,KAAK,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACzF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export * from './types.js';
+export * from './config.js';
+export * from './setupPrompt.js';
+export * from './baseline.js';
+export * from './capturer.js';
+export * from './comparator.js';
+export * from './feedback.js';
+export * from './recorder.js';
+export * from './benchmark.js';
+export * from './classifier.js';
+export * from './auth.js';
+export * from './flowid.js';
+export * from './domdiff.js';
+//# 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,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+export * from './types.js';
+export * from './config.js';
+export * from './setupPrompt.js';
+export * from './baseline.js';
+export * from './capturer.js';
+export * from './comparator.js';
+export * from './feedback.js';
+export * from './recorder.js';
+export * from './benchmark.js';
+export * from './classifier.js';
+export * from './auth.js';
+export * from './flowid.js';
+export * from './domdiff.js';
+//# 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,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist/recorder.d.ts

@@ -0,0 +1,12 @@
+import type { FlowRecording, FlowStep } from './types.js';
+export declare function recordFlow(options: {
+    name: string;
+    url: string;
+    outputDir: string;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+}): Promise<FlowRecording>;
+export declare function generateStepsFromScript(scriptPath: string): FlowStep[];
+//# sourceMappingURL=recorder.d.ts.map

package/dist/recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../src/recorder.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAgB,MAAM,YAAY,CAAC;AAExE,wBAAsB,UAAU,CAAC,OAAO,EAAE;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C,GAAG,OAAO,CAAC,aAAa,CAAC,CAiFzB;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,EAAE,CAEtE"}

package/dist/recorder.js

@@ -0,0 +1,86 @@
+import { chromium } from 'playwright';
+import { promises as fs } from 'fs';
+import path from 'path';
+export async function recordFlow(options) {
+    const browser = await chromium.launch({ headless: false });
+    const context = await browser.newContext({ viewport: options.viewport || { width: 1280, height: 720 } });
+    const page = await context.newPage();
+    const steps = [];
+    const startTime = Date.now();
+    steps.push({ action: 'navigate', url: options.url });
+    await page.goto(options.url);
+    await page.exposeFunction('trackAction', (action) => {
+        steps.push(action);
+    });
+    await page.addInitScript(() => {
+        document.addEventListener('click', (e) => {
+            const target = e.target;
+            let selector;
+            if (target.id) {
+                selector = `#${target.id}`;
+            }
+            else if (target.getAttribute('data-testid')) {
+                selector = `[data-testid="${target.getAttribute('data-testid')}"]`;
+            }
+            else if (target.name) {
+                selector = `${target.tagName.toLowerCase()}[name="${target.name}"]`;
+            }
+            else if (target.textContent && target.textContent.trim().length > 0 && target.textContent.trim().length < 80 && target.children.length === 0) {
+                selector = `text=${target.textContent.trim()}`;
+            }
+            else {
+                const parent = target.parentElement;
+                const siblings = parent ? Array.from(parent.children).filter(c => c.tagName === target.tagName) : [];
+                const idx = siblings.indexOf(target) + 1;
+                selector = siblings.length > 1 ? `${target.tagName.toLowerCase()}:nth-of-type(${idx})` : target.tagName.toLowerCase();
+            }
+            window.trackAction({ action: 'click', selector });
+        }, true);
+        document.addEventListener('change', (e) => {
+            const target = e.target;
+            let selector;
+            if (target.id) {
+                selector = `#${target.id}`;
+            }
+            else if (target.getAttribute('data-testid')) {
+                selector = `[data-testid="${target.getAttribute('data-testid')}"]`;
+            }
+            else if (target.name) {
+                selector = `${target.tagName.toLowerCase()}[name="${target.name}"]`;
+            }
+            else {
+                selector = target.tagName.toLowerCase();
+            }
+            if (target.type === 'checkbox' || target.type === 'radio') {
+                window.trackAction({ action: 'click', selector });
+            }
+            else {
+                window.trackAction({ action: 'type', selector, value: target.value });
+            }
+        }, true);
+    });
+    await page.waitForEvent('close', { timeout: 0 });
+    await browser.close();
+    const duration = Date.now() - startTime;
+    const metadata = {
+        name: options.name,
+        url: options.url,
+        viewport: options.viewport || { width: 1280, height: 720 },
+        recordedAt: new Date().toISOString(),
+        duration,
+        stepCount: steps.length,
+    };
+    const recording = {
+        metadata,
+        steps,
+        screenshotPaths: [],
+    };
+    await fs.mkdir(options.outputDir, { recursive: true });
+    await fs.writeFile(path.join(options.outputDir, 'metadata.json'), JSON.stringify(metadata, null, 2));
+    await fs.writeFile(path.join(options.outputDir, 'steps.json'), JSON.stringify(steps, null, 2));
+    return recording;
+}
+export function generateStepsFromScript(scriptPath) {
+    return [];
+}
+//# sourceMappingURL=recorder.js.map