@tayo-dev/rtl 1.0.0

package/dist/core/recording-intelligence.js

@@ -0,0 +1,178 @@
+function hasPointerMetadata(step) {
+    return [step.x, step.y, step.offsetX, step.offsetY].some((value) => typeof value === 'number');
+}
+function isDoubleClickVariant(step) {
+    return /doubleclick|dblclick|tripleclick/i.test(step.originalType);
+}
+function isMovementType(step) {
+    return /hover|mousemove|pointermove|movemouse/i.test(step.originalType);
+}
+function isCursorWanderStep(step) {
+    if (isMovementType(step)) {
+        return true;
+    }
+    if (step.action === 'unknown' && (hasPointerMetadata(step) || !step.target)) {
+        return true;
+    }
+    return step.action === 'scroll' && !step.target && !step.value;
+}
+function normalizedTarget(target) {
+    const trimmed = target?.trim();
+    return trimmed ? trimmed : undefined;
+}
+function isSameClickTarget(current, candidate) {
+    return (current.action === 'click' &&
+        candidate.action === 'click' &&
+        normalizedTarget(current.target) !== undefined &&
+        normalizedTarget(current.target) === normalizedTarget(candidate.target));
+}
+function pickRepresentativeClick(cluster) {
+    return cluster.find((step) => !isDoubleClickVariant(step)) ?? cluster[0];
+}
+function deriveIntentLabel(steps) {
+    const navigateStep = steps.find((step) => step.action === 'navigate');
+    if (navigateStep) {
+        return navigateStep.target ? `navigate to ${navigateStep.target}` : 'navigation flow';
+    }
+    const submitStep = steps.find((step) => step.action === 'click' &&
+        /save|submit|confirm|continue|done|create|update/i.test(step.target ?? ''));
+    if (submitStep?.target) {
+        return `submit ${submitStep.target}`;
+    }
+    const fillStep = steps.find((step) => step.action === 'fill' || step.action === 'select');
+    if (fillStep?.target) {
+        return `edit ${fillStep.target}`;
+    }
+    const clickStep = steps.find((step) => step.action === 'click');
+    if (clickStep?.target && steps.some((step) => step.action === 'assert')) {
+        return `confirm ${clickStep.target}`;
+    }
+    if (clickStep?.target) {
+        return `interact with ${clickStep.target}`;
+    }
+    return 'recorded flow';
+}
+function isDialogLikeText(value) {
+    return /dialog|modal|drawer|sheet|popover/i.test(value ?? '');
+}
+function findGroupSelector(group) {
+    return group.steps.find((step) => step.action !== 'navigate' && step.target)?.target;
+}
+export function inferIntentGroups(steps) {
+    if (steps.length === 0) {
+        return [];
+    }
+    const groups = [];
+    let currentGroup = [];
+    const flushGroup = () => {
+        if (currentGroup.length === 0) {
+            return;
+        }
+        groups.push({
+            name: deriveIntentLabel(currentGroup),
+            steps: [...currentGroup],
+        });
+        currentGroup = [];
+    };
+    for (const step of steps) {
+        if (step.action === 'navigate') {
+            flushGroup();
+            currentGroup = [step];
+            continue;
+        }
+        if (currentGroup.length === 1 && currentGroup[0]?.action === 'navigate') {
+            flushGroup();
+        }
+        currentGroup.push(step);
+        if (step.action === 'assert') {
+            flushGroup();
+        }
+    }
+    flushGroup();
+    return groups;
+}
+export function findVisualCaptureCandidates(analyzedRecording) {
+    return analyzedRecording.intentGroups.flatMap((group) => {
+        const joinedTargets = group.steps
+            .map((step) => step.target ?? '')
+            .join(' ');
+        const hasDialogState = isDialogLikeText(group.name) ||
+            isDialogLikeText(joinedTargets) ||
+            group.steps.some((step) => step.action === 'assert' &&
+                /open|confirm|add|dialog|modal/i.test(step.target ?? ''));
+        if (!hasDialogState) {
+            return [];
+        }
+        return [
+            {
+                groupName: group.name,
+                reason: 'dialog-state',
+                selector: findGroupSelector(group),
+            },
+        ];
+    });
+}
+export function filterNoiseSteps(steps) {
+    let removedRedundantClicks = 0;
+    let removedDoubleClickNoise = 0;
+    let removedCursorWander = 0;
+    const filtered = [];
+    for (let index = 0; index < steps.length; index += 1) {
+        const step = steps[index];
+        if (isCursorWanderStep(step)) {
+            removedCursorWander += 1;
+            continue;
+        }
+        if (step.action !== 'click' || !normalizedTarget(step.target)) {
+            filtered.push(step);
+            continue;
+        }
+        const cluster = [step];
+        for (let nextIndex = index + 1; nextIndex < steps.length; nextIndex += 1) {
+            const candidate = steps[nextIndex];
+            if (isCursorWanderStep(candidate)) {
+                removedCursorWander += 1;
+                index = nextIndex;
+                continue;
+            }
+            if (!isSameClickTarget(step, candidate)) {
+                break;
+            }
+            cluster.push(candidate);
+            index = nextIndex;
+        }
+        const extraClicks = cluster.length - 1;
+        if (extraClicks > 0) {
+            const removedDoubleClicks = cluster
+                .slice(1)
+                .filter((candidate) => isDoubleClickVariant(candidate)).length;
+            removedDoubleClickNoise += removedDoubleClicks;
+            removedRedundantClicks += extraClicks - removedDoubleClicks;
+        }
+        filtered.push(pickRepresentativeClick(cluster));
+    }
+    return {
+        steps: filtered,
+        diagnostics: {
+            removedCursorWander,
+            removedDoubleClickNoise,
+            removedRedundantClicks,
+        },
+    };
+}
+export function analyzeRecording(recording) {
+    const filtered = filterNoiseSteps(recording.steps);
+    const intentGroups = inferIntentGroups(filtered.steps);
+    return {
+        ...recording,
+        steps: filtered.steps,
+        diagnostics: {
+            ...filtered.diagnostics,
+            rawStepCount: recording.rawStepCount,
+            filteredStepCount: filtered.steps.length,
+            intentGroupCount: intentGroups.length,
+        },
+        intentGroups,
+    };
+}
+//# sourceMappingURL=recording-intelligence.js.map

package/dist/core/recording-intelligence.js.map

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

package/dist/core/resolver.d.ts

@@ -0,0 +1,58 @@
+import { Page } from 'playwright';
+import type { DialogState, ElementInfo, QueryResult, VisualState } from '../types/recording.js';
+export declare function extractDialogState(page: Page): Promise<DialogState | null>;
+export interface CaptureVisualStateOptions {
+    reason: string;
+    screenshotDir?: string;
+    selector?: string;
+    timeoutMs?: number;
+}
+/**
+ * Captures a structured visual-state artifact for a page and optional selector.
+ */
+export declare function captureVisualState(url: string, options: CaptureVisualStateOptions): Promise<VisualState | null>;
+/**
+ * Builds the highest-priority RTL query for an element based on its accessibility properties.
+ * Priority: getByRole > getByLabelText > getByText > getByPlaceholderText > getByTestId
+ *
+ * @param info - Element information from DOM inspection
+ * @param selector - Original CSS selector
+ * @returns QueryResult with query string, quality rating, and method name
+ */
+export declare function buildQuery(info: ElementInfo, selector: string): QueryResult;
+/**
+ * Selects the most appropriate RTL matcher based on element type and action.
+ *
+ * @param info - Element information from DOM inspection
+ * @param action - The action being performed (fill, assert, etc.)
+ * @returns Matcher string (e.g., '.toHaveValue()', '.toBeChecked()')
+ */
+export declare function selectMatcher(info: ElementInfo, action: string): string;
+/**
+ * Inspects a single element on a page using Playwright.
+ * Launches headless Chromium, navigates to URL, evaluates element.
+ *
+ * @param url - URL to navigate to
+ * @param cssSelector - CSS selector to locate element
+ * @param timeoutMs - Timeout for navigation (default 5000ms)
+ * @returns ElementInfo or null if element not found/error occurs
+ */
+export declare function inspectElement(url: string, cssSelector: string, timeoutMs?: number): Promise<ElementInfo | null>;
+/**
+ * Inspects multiple elements on a page using a single Playwright browser instance.
+ * More efficient than calling inspectElement multiple times.
+ *
+ * @param url - URL to navigate to
+ * @param selectors - Array of CSS selectors to locate elements
+ * @param timeoutMs - Timeout for navigation (default 5000ms)
+ * @returns Map of selector to ElementInfo (or null if not found)
+ */
+export declare function inspectElements(url: string, selectors: string[], timeoutMs?: number): Promise<Map<string, ElementInfo | null>>;
+/**
+ * Emits a warning for fragile queries (getByTestId fallback).
+ * Should be called when buildQuery returns method: 'getByTestId'.
+ *
+ * @param selector - The CSS selector that required fallback to testId
+ */
+export declare function emitQry03Warning(selector: string): void;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/core/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/core/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,IAAI,EAAE,MAAM,YAAY,CAAA;AAEpD,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,WAAW,EAEX,WAAW,EACZ,MAAM,uBAAuB,CAAA;AA4D9B,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CA8BhF;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CA6C7B;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CA+C3E;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAuBvE;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,SAAS,SAAO,GACf,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAyB7B;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EAAE,EACnB,SAAS,SAAO,GACf,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC,CAAC,CAsC1C;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAMvD"}

package/dist/core/resolver.js

@@ -0,0 +1,291 @@
+import { chromium } from 'playwright';
+import pc from 'picocolors';
+/**
+ * Maps HTML tag names to implied ARIA roles.
+ * Used by buildQuery to determine accessible query method.
+ */
+const ROLE_MAP = {
+    button: 'button',
+    a: 'link',
+    input: 'textbox',
+    select: 'combobox',
+    textarea: 'textbox',
+    h1: 'heading',
+    h2: 'heading',
+    h3: 'heading',
+    h4: 'heading',
+    h5: 'heading',
+    h6: 'heading',
+    img: 'img',
+};
+/**
+ * Escapes single quotes in strings for use in generated query code.
+ */
+function escapeSingleQuote(str) {
+    return str.replace(/'/g, "\\'");
+}
+/**
+ * Sanitizes a CSS selector to be used as a testId.
+ * Replaces non-alphanumeric characters with hyphens and trims leading/trailing hyphens.
+ */
+function sanitizeSelectorForTestId(selector) {
+    return selector.replace(/[^a-zA-Z0-9-]/g, '-').replace(/^-+|-+$/g, '');
+}
+async function readElementInfo(page, selector) {
+    const locator = page.locator(selector).first();
+    const elementInfo = await locator.evaluate((el) => {
+        const htmlEl = el;
+        return {
+            tagName: el.tagName.toLowerCase(),
+            role: el.getAttribute('role') ?? null,
+            ariaLabel: el.getAttribute('aria-label') ?? null,
+            ariaLabelledBy: el.getAttribute('aria-labelledby') ?? null,
+            innerText: htmlEl.innerText ?? '',
+            value: htmlEl.value ?? undefined,
+            type: htmlEl.type ?? undefined,
+            placeholder: htmlEl.placeholder ?? null,
+            isPresent: true,
+        };
+    });
+    return elementInfo;
+}
+function sanitizeCaptureSegment(value) {
+    return value.replace(/[^a-zA-Z0-9-_]+/g, '-').replace(/^-+|-+$/g, '') || 'capture';
+}
+export async function extractDialogState(page) {
+    try {
+        const state = await page.evaluate(() => {
+            const dialog = document.querySelector('[role="dialog"], [role="alertdialog"]');
+            if (!dialog) {
+                return null;
+            }
+            const titleNode = dialog.querySelector('h1, h2, h3, [aria-labelledby]');
+            const descriptionNode = dialog.querySelector('[aria-describedby], p');
+            const actionNodes = Array.from(dialog.querySelectorAll('button, [role="button"]'));
+            return {
+                role: dialog.getAttribute('role') ?? null,
+                title: titleNode?.textContent?.trim() ?? null,
+                description: descriptionNode?.textContent?.trim() ?? null,
+                actions: actionNodes
+                    .map((node) => node.innerText?.trim())
+                    .filter((text) => Boolean(text)),
+                isOpen: true,
+            };
+        });
+        return state;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Captures a structured visual-state artifact for a page and optional selector.
+ */
+export async function captureVisualState(url, options) {
+    const { reason, screenshotDir, selector, timeoutMs = 5000 } = options;
+    let browser = null;
+    try {
+        browser = await chromium.launch({ headless: true });
+        const page = await browser.newPage();
+        await page.goto(url, {
+            timeout: timeoutMs,
+            waitUntil: 'domcontentloaded',
+        });
+        const pageTitle = await page.title();
+        const dialog = await extractDialogState(page);
+        const element = selector ? await readElementInfo(page, selector) : null;
+        let screenshotPath;
+        if (screenshotDir) {
+            screenshotPath = `${screenshotDir}/${sanitizeCaptureSegment(pageTitle || reason)}.png`;
+            await page.screenshot({ path: screenshotPath, fullPage: true });
+        }
+        return {
+            capturedAt: new Date().toISOString(),
+            dialog,
+            element,
+            pageTitle,
+            reason,
+            screenshotPath,
+            selector,
+            url,
+        };
+    }
+    catch (error) {
+        console.warn(pc.yellow('[taro]') +
+            pc.dim(' VIS-01:') +
+            ` Failed to capture visual state for ${url}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        return null;
+    }
+    finally {
+        if (browser) {
+            await browser.close();
+        }
+    }
+}
+/**
+ * Builds the highest-priority RTL query for an element based on its accessibility properties.
+ * Priority: getByRole > getByLabelText > getByText > getByPlaceholderText > getByTestId
+ *
+ * @param info - Element information from DOM inspection
+ * @param selector - Original CSS selector
+ * @returns QueryResult with query string, quality rating, and method name
+ */
+export function buildQuery(info, selector) {
+    const impliedRole = info.role ?? ROLE_MAP[info.tagName];
+    const accessibleName = info.ariaLabel ?? info.innerText;
+    // Priority 1: getByRole when both role and accessible name exist
+    if (impliedRole && accessibleName) {
+        return {
+            method: 'getByRole',
+            quality: 'excellent',
+            query: `screen.getByRole('${impliedRole}', { name: '${escapeSingleQuote(accessibleName)}' })`,
+        };
+    }
+    // Priority 2: getByLabelText when ariaLabel exists (no role match)
+    if (info.ariaLabel) {
+        return {
+            method: 'getByLabelText',
+            quality: 'excellent',
+            query: `screen.getByLabelText('${escapeSingleQuote(info.ariaLabel)}')`,
+        };
+    }
+    // Priority 3: getByText when innerText exists
+    if (info.innerText) {
+        return {
+            method: 'getByText',
+            quality: 'good',
+            query: `screen.getByText('${escapeSingleQuote(info.innerText)}')`,
+        };
+    }
+    // Priority 4: getByPlaceholderText when placeholder exists
+    if (info.placeholder) {
+        return {
+            method: 'getByPlaceholderText',
+            quality: 'acceptable',
+            query: `screen.getByPlaceholderText('${escapeSingleQuote(info.placeholder)}')`,
+        };
+    }
+    // Priority 5: Fallback to getByTestId (fragile)
+    const sanitized = sanitizeSelectorForTestId(selector);
+    return {
+        method: 'getByTestId',
+        quality: 'fragile',
+        query: `screen.getByTestId('${sanitized}')`,
+    };
+}
+/**
+ * Selects the most appropriate RTL matcher based on element type and action.
+ *
+ * @param info - Element information from DOM inspection
+ * @param action - The action being performed (fill, assert, etc.)
+ * @returns Matcher string (e.g., '.toHaveValue()', '.toBeChecked()')
+ */
+export function selectMatcher(info, action) {
+    // checkbox → toBeChecked
+    if (info.type === 'checkbox') {
+        return '.toBeChecked()';
+    }
+    // fill with value → toHaveValue
+    if (info.value !== undefined && action === 'fill') {
+        return `.toHaveValue('${escapeSingleQuote(info.value)}')`;
+    }
+    // assert with innerText → toHaveTextContent
+    if (action === 'assert' && info.innerText) {
+        return `.toHaveTextContent('${escapeSingleQuote(info.innerText)}')`;
+    }
+    // dialog → toBeVisible
+    if (action === 'assert' && info.role === 'dialog') {
+        return '.toBeVisible()';
+    }
+    // Default → toBeInTheDocument
+    return '.toBeInTheDocument()';
+}
+/**
+ * Inspects a single element on a page using Playwright.
+ * Launches headless Chromium, navigates to URL, evaluates element.
+ *
+ * @param url - URL to navigate to
+ * @param cssSelector - CSS selector to locate element
+ * @param timeoutMs - Timeout for navigation (default 5000ms)
+ * @returns ElementInfo or null if element not found/error occurs
+ */
+export async function inspectElement(url, cssSelector, timeoutMs = 5000) {
+    let browser = null;
+    try {
+        browser = await chromium.launch({ headless: true });
+        const page = await browser.newPage();
+        await page.goto(url, {
+            timeout: timeoutMs,
+            waitUntil: 'domcontentloaded',
+        });
+        return await readElementInfo(page, cssSelector);
+    }
+    catch (error) {
+        console.warn(pc.yellow('[taro]') +
+            pc.dim(' QRY-02:') +
+            ` Failed to inspect element ${cssSelector} on ${url}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        return null;
+    }
+    finally {
+        if (browser) {
+            await browser.close();
+        }
+    }
+}
+/**
+ * Inspects multiple elements on a page using a single Playwright browser instance.
+ * More efficient than calling inspectElement multiple times.
+ *
+ * @param url - URL to navigate to
+ * @param selectors - Array of CSS selectors to locate elements
+ * @param timeoutMs - Timeout for navigation (default 5000ms)
+ * @returns Map of selector to ElementInfo (or null if not found)
+ */
+export async function inspectElements(url, selectors, timeoutMs = 5000) {
+    const result = new Map();
+    let browser = null;
+    try {
+        browser = await chromium.launch({ headless: true });
+        const page = await browser.newPage();
+        await page.goto(url, {
+            timeout: timeoutMs,
+            waitUntil: 'domcontentloaded',
+        });
+        for (const selector of selectors) {
+            try {
+                result.set(selector, await readElementInfo(page, selector));
+            }
+            catch {
+                // On individual selector failure, set to null and continue
+                result.set(selector, null);
+            }
+        }
+    }
+    catch (error) {
+        // On browser/page error, set all selectors to null
+        console.warn(pc.yellow('[taro]') +
+            pc.dim(' QRY-02:') +
+            ` Failed to inspect elements on ${url}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        for (const selector of selectors) {
+            result.set(selector, null);
+        }
+    }
+    finally {
+        if (browser) {
+            await browser.close();
+        }
+    }
+    return result;
+}
+/**
+ * Emits a warning for fragile queries (getByTestId fallback).
+ * Should be called when buildQuery returns method: 'getByTestId'.
+ *
+ * @param selector - The CSS selector that required fallback to testId
+ */
+export function emitQry03Warning(selector) {
+    console.warn(pc.yellow('[taro]') +
+        pc.dim(' QRY-03:') +
+        ` No accessible query for ${pc.bold(selector)} — consider adding aria-label or data-testid to this element`);
+}
+//# sourceMappingURL=resolver.js.map

package/dist/core/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../src/core/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAiB,MAAM,YAAY,CAAA;AACpD,OAAO,EAAE,MAAM,YAAY,CAAA;AAS3B;;;GAGG;AACH,MAAM,QAAQ,GAA2B;IACvC,MAAM,EAAE,QAAQ;IAChB,CAAC,EAAE,MAAM;IACT,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,UAAU;IAClB,QAAQ,EAAE,SAAS;IACnB,EAAE,EAAE,SAAS;IACb,EAAE,EAAE,SAAS;IACb,EAAE,EAAE,SAAS;IACb,EAAE,EAAE,SAAS;IACb,EAAE,EAAE,SAAS;IACb,EAAE,EAAE,SAAS;IACb,GAAG,EAAE,KAAK;CACX,CAAA;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,GAAW;IACpC,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;AACjC,CAAC;AAED;;;GAGG;AACH,SAAS,yBAAyB,CAAC,QAAgB;IACjD,OAAO,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAA;AACxE,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,IAAU,EAAE,QAAgB;IACzD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,CAAA;IAC9C,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAW,EAAE,EAAE;QACzD,MAAM,MAAM,GAAG,EAAiB,CAAA;QAChC,OAAO;YACL,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE;YACjC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,IAAI;YACrC,SAAS,EAAE,EAAE,CAAC,YAAY,CAAC,YAAY,CAAC,IAAI,IAAI;YAChD,cAAc,EAAE,EAAE,CAAC,YAAY,CAAC,iBAAiB,CAAC,IAAI,IAAI;YAC1D,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE;YACjC,KAAK,EAAG,MAA2B,CAAC,KAAK,IAAI,SAAS;YACtD,IAAI,EAAG,MAA2B,CAAC,IAAI,IAAI,SAAS;YACpD,WAAW,EAAG,MAA2B,CAAC,WAAW,IAAI,IAAI;YAC7D,SAAS,EAAE,IAAI;SAChB,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,OAAO,WAA0B,CAAA;AACnC,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAa;IAC3C,OAAO,KAAK,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,SAAS,CAAA;AACpF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAU;IACjD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE;YACrC,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,uCAAuC,CAAC,CAAA;YAC9E,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,IAAI,CAAA;YACb,CAAC;YAED,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,CAAC,+BAA+B,CAAC,CAAA;YACvE,MAAM,eAAe,GAAG,MAAM,CAAC,aAAa,CAAC,uBAAuB,CAAC,CAAA;YACrE,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAC5B,MAAM,CAAC,gBAAgB,CAAC,yBAAyB,CAAC,CAClC,CAAA;YAElB,OAAO;gBACL,IAAI,EACD,MAAM,CAAC,YAAY,CAAC,MAAM,CAAqC,IAAI,IAAI;gBAC1E,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,IAAI;gBAC7C,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,IAAI;gBACzD,OAAO,EAAE,WAAW;qBACjB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC;qBACrC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBAClD,MAAM,EAAE,IAAI;aACb,CAAA;QACH,CAAC,CAAC,CAAA;QAEF,OAAO,KAA2B,CAAA;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AASD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAW,EACX,OAAkC;IAElC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,GAAG,IAAI,EAAE,GAAG,OAAO,CAAA;IACrE,IAAI,OAAO,GAAmB,IAAI,CAAA;IAElC,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;QACnD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAA;QAEpC,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;YACnB,OAAO,EAAE,SAAS;YAClB,SAAS,EAAE,kBAAkB;SAC9B,CAAC,CAAA;QAEF,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAA;QACpC,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAA;QAC7C,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QAEvE,IAAI,cAAkC,CAAA;QACtC,IAAI,aAAa,EAAE,CAAC;YAClB,cAAc,GAAG,GAAG,aAAa,IAAI,sBAAsB,CAAC,SAAS,IAAI,MAAM,CAAC,MAAM,CAAA;YACtF,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;QACjE,CAAC;QAED,OAAO;YACL,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,MAAM;YACN,OAAO;YACP,SAAS;YACT,MAAM;YACN,cAAc;YACd,QAAQ;YACR,GAAG;SACJ,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CACV,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC;YACjB,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC;YAClB,uCAAuC,GAAG,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAC5G,CAAA;QACD,OAAO,IAAI,CAAA;IACb,CAAC;YAAS,CAAC;QACT,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,OAAO,CAAC,KAAK,EAAE,CAAA;QACvB,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,IAAiB,EAAE,QAAgB;IAC5D,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACvD,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAA;IAEvD,iEAAiE;IACjE,IAAI,WAAW,IAAI,cAAc,EAAE,CAAC;QAClC,OAAO;YACL,MAAM,EAAE,WAAW;YACnB,OAAO,EAAE,WAA2B;YACpC,KAAK,EAAE,qBAAqB,WAAW,eAAe,iBAAiB,CAAC,cAAc,CAAC,MAAM;SAC9F,CAAA;IACH,CAAC;IAED,mEAAmE;IACnE,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,OAAO;YACL,MAAM,EAAE,gBAAgB;YACxB,OAAO,EAAE,WAA2B;YACpC,KAAK,EAAE,0BAA0B,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI;SACvE,CAAA;IACH,CAAC;IAED,8CAA8C;IAC9C,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,OAAO;YACL,MAAM,EAAE,WAAW;YACnB,OAAO,EAAE,MAAsB;YAC/B,KAAK,EAAE,qBAAqB,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI;SAClE,CAAA;IACH,CAAC;IAED,2DAA2D;IAC3D,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,OAAO;YACL,MAAM,EAAE,sBAAsB;YAC9B,OAAO,EAAE,YAA4B;YACrC,KAAK,EAAE,gCAAgC,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI;SAC/E,CAAA;IACH,CAAC;IAED,gDAAgD;IAChD,MAAM,SAAS,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAA;IACrD,OAAO;QACL,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE,SAAyB;QAClC,KAAK,EAAE,uBAAuB,SAAS,IAAI;KAC5C,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,IAAiB,EAAE,MAAc;IAC7D,yBAAyB;IACzB,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC7B,OAAO,gBAAgB,CAAA;IACzB,CAAC;IAED,gCAAgC;IAChC,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QAClD,OAAO,iBAAiB,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAA;IAC3D,CAAC;IAED,4CAA4C;IAC5C,IAAI,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QAC1C,OAAO,uBAAuB,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAA;IACrE,CAAC;IAED,uBAAuB;IACvB,IAAI,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAClD,OAAO,gBAAgB,CAAA;IACzB,CAAC;IAED,8BAA8B;IAC9B,OAAO,sBAAsB,CAAA;AAC/B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAW,EACX,WAAmB,EACnB,SAAS,GAAG,IAAI;IAEhB,IAAI,OAAO,GAAmB,IAAI,CAAA;IAElC,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;QACnD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAA;QAEpC,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;YACnB,OAAO,EAAE,SAAS;YAClB,SAAS,EAAE,kBAAkB;SAC9B,CAAC,CAAA;QAEF,OAAO,MAAM,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;IACjD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CACV,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC;YACjB,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC;YAClB,8BAA8B,WAAW,OAAO,GAAG,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CACrH,CAAA;QACD,OAAO,IAAI,CAAA;IACb,CAAC;YAAS,CAAC;QACT,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,OAAO,CAAC,KAAK,EAAE,CAAA;QACvB,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAW,EACX,SAAmB,EACnB,SAAS,GAAG,IAAI;IAEhB,MAAM,MAAM,GAAG,IAAI,GAAG,EAA8B,CAAA;IACpD,IAAI,OAAO,GAAmB,IAAI,CAAA;IAElC,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;QACnD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAA;QAEpC,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;YACnB,OAAO,EAAE,SAAS;YAClB,SAAS,EAAE,kBAAkB;SAC9B,CAAC,CAAA;QAEF,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAA;YAC7D,CAAC;YAAC,MAAM,CAAC;gBACP,2DAA2D;gBAC3D,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,mDAAmD;QACnD,OAAO,CAAC,IAAI,CACV,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC;YACjB,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC;YAClB,kCAAkC,GAAG,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CACvG,CAAA;QACD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;QAC5B,CAAC;IACH,CAAC;YAAS,CAAC;QACT,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,OAAO,CAAC,KAAK,EAAE,CAAA;QACvB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,CAAC,IAAI,CACV,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC;QACjB,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC;QAClB,4BAA4B,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,8DAA8D,CAC9G,CAAA;AACH,CAAC"}

package/dist/core/scanner.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Codebase convention scanner
+ * Scans project for test file conventions and persists to .taro/conventions.json
+ */
+import type { ConventionsSchema, ConventionFile } from '../types/conventions.js';
+/**
+ * Recursively find all test files in a directory
+ * @param root - Root directory to scan
+ * @returns Array of absolute paths to test files
+ */
+export declare function findTestFiles(root: string): Promise<string[]>;
+export interface TestFileContent {
+    path: string;
+    content: string;
+}
+/**
+ * Load discovered test files with content for downstream analyzers.
+ */
+export declare function readTestFiles(root: string): Promise<TestFileContent[]>;
+/**
+ * Derive conventions from analyzed files
+ * @param files - Array of analyzed ConventionFile objects
+ * @param projectRoot - Root directory of the project
+ * @returns ConventionsSchema with derived conventions
+ */
+export declare function deriveConventions(files: ConventionFile[], projectRoot: string): ConventionsSchema;
+/**
+ * Read conventions from .taro/conventions.json
+ * @param projectRoot - Root directory of the project
+ * @returns ConventionsSchema or null if not found
+ */
+export declare function readConventions(projectRoot: string): Promise<ConventionsSchema | null>;
+/**
+ * Scan project for test conventions
+ * @param projectRoot - Root directory of the project
+ * @returns ConventionsSchema with detected conventions
+ */
+export declare function scanConventions(projectRoot: string): Promise<ConventionsSchema>;
+/**
+ * Persist conventions to .taro/conventions.json
+ */
+export declare function persistConventions(projectRoot: string, conventions: ConventionsSchema): Promise<void>;
+/**
+ * Merge new file conventions into the persisted conventions store.
+ */
+export declare function mergeConventions(projectRoot: string, newPatterns: ConventionFile): Promise<void>;
+/**
+ * Analyze a single test file without rescanning the whole project.
+ */
+export declare function analyzeSingleTestFile(projectRoot: string, filePath: string): Promise<ConventionFile>;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/core/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/core/scanner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAA4B,MAAM,yBAAyB,CAAA;AAc1G;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA2BnE;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAc5E;AAoED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,cAAc,EAAE,EACvB,WAAW,EAAE,MAAM,GAClB,iBAAiB,CAuCnB;AAgED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAWnC;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,CAAC,CAgD5B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,iBAAiB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,cAAc,GAC1B,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,CAAC,CAMzB"}