uxinspect 0.2.0 → 0.11.0

package/dist/page-object.js

@@ -0,0 +1,346 @@
+export async function scanPageObject(page, opts = {}) {
+    const flags = {
+        includeForms: opts.includeForms ?? true,
+        includeRoles: opts.includeRoles ?? true,
+        includeTestIds: opts.includeTestIds ?? true,
+        maxElements: opts.maxElements ?? 40,
+    };
+    const raw = await page.evaluate(collectElements, flags);
+    const seen = new Set();
+    const nameCounts = new Map();
+    const elements = [];
+    for (const item of raw) {
+        const dedupKey = `${item.kind}::${item.description.toLowerCase()}`;
+        if (seen.has(dedupKey))
+            continue;
+        seen.add(dedupKey);
+        const baseName = buildName(item.description, item.kind);
+        const count = nameCounts.get(baseName) ?? 0;
+        nameCounts.set(baseName, count + 1);
+        const finalName = count === 0 ? baseName : `${baseName}${count + 1}`;
+        elements.push({
+            name: finalName,
+            kind: item.kind,
+            locator: item.locator,
+            description: item.description,
+        });
+        if (elements.length >= flags.maxElements)
+            break;
+    }
+    return elements;
+}
+export function renderPageObjectClass(elements, className) {
+    const safeClassName = pascalize(className) || 'GeneratedPage';
+    const lines = [];
+    lines.push(`import type { Page, Locator } from 'playwright';`);
+    lines.push('');
+    lines.push(`export class ${safeClassName} {`);
+    lines.push('  constructor(private page: Page) {}');
+    for (const el of elements) {
+        lines.push('');
+        lines.push(`  // ${sanitizeComment(el.description)} (${el.kind})`);
+        lines.push(`  get ${el.name}(): Locator {`);
+        lines.push(`    return this.page.${el.locator};`);
+        lines.push('  }');
+        const helpers = renderHelpers(el);
+        for (const helper of helpers) {
+            lines.push('');
+            lines.push(helper);
+        }
+    }
+    lines.push('}');
+    lines.push('');
+    return lines.join('\n');
+}
+export async function generatePageObject(page, opts = {}) {
+    const elements = await scanPageObject(page, opts);
+    const className = opts.className ?? deriveClassNameFromUrl(page.url());
+    return renderPageObjectClass(elements, className);
+}
+function renderHelpers(el) {
+    const cap = capitalize(el.name);
+    const out = [];
+    if (el.kind === 'button' || el.kind === 'link') {
+        out.push(`  async click${cap}(): Promise<void> {`);
+        out.push(`    await this.${el.name}.click();`);
+        out.push('  }');
+    }
+    else if (el.kind === 'input' || el.kind === 'textbox') {
+        out.push(`  async fill${cap}(value: string): Promise<void> {`);
+        out.push(`    await this.${el.name}.fill(value);`);
+        out.push('  }');
+    }
+    else if (el.kind === 'select') {
+        out.push(`  async select${cap}(value: string): Promise<void> {`);
+        out.push(`    await this.${el.name}.selectOption(value);`);
+        out.push('  }');
+    }
+    else if (el.kind === 'checkbox') {
+        out.push(`  async check${cap}(): Promise<void> {`);
+        out.push(`    await this.${el.name}.check();`);
+        out.push('  }');
+        out.push(`  async uncheck${cap}(): Promise<void> {`);
+        out.push(`    await this.${el.name}.uncheck();`);
+        out.push('  }');
+    }
+    else if (el.kind === 'radio') {
+        out.push(`  async check${cap}(): Promise<void> {`);
+        out.push(`    await this.${el.name}.check();`);
+        out.push('  }');
+    }
+    return out;
+}
+function buildName(description, kind) {
+    const cleaned = description
+        .replace(/[^A-Za-z0-9\s]/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+    const words = cleaned.split(' ').filter((w) => w.length > 0).slice(0, 5);
+    if (words.length === 0) {
+        return `element${capitalize(kind)}`;
+    }
+    const first = words[0].toLowerCase();
+    const rest = words.slice(1).map((w) => capitalize(w.toLowerCase())).join('');
+    const base = first + rest;
+    const suffix = kindSuffix(kind);
+    if (base.toLowerCase().endsWith(suffix.toLowerCase())) {
+        return sanitizeIdentifier(base);
+    }
+    return sanitizeIdentifier(base + suffix);
+}
+function kindSuffix(kind) {
+    switch (kind) {
+        case 'button':
+            return 'Button';
+        case 'link':
+            return 'Link';
+        case 'input':
+        case 'textbox':
+            return 'Input';
+        case 'heading':
+            return 'Heading';
+        case 'checkbox':
+            return 'Checkbox';
+        case 'radio':
+            return 'Radio';
+        case 'select':
+            return 'Select';
+        case 'testid':
+            return 'Element';
+        default:
+            return 'Element';
+    }
+}
+function sanitizeIdentifier(raw) {
+    let s = raw.replace(/[^A-Za-z0-9_]/g, '');
+    if (!s)
+        s = 'element';
+    if (/^[0-9]/.test(s))
+        s = 'el' + s;
+    return s;
+}
+function capitalize(s) {
+    if (!s)
+        return s;
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+function pascalize(raw) {
+    const parts = raw
+        .replace(/[^A-Za-z0-9\s]/g, ' ')
+        .split(/\s+/)
+        .filter((p) => p.length > 0);
+    if (parts.length === 0)
+        return '';
+    return parts.map((p) => capitalize(p.toLowerCase())).join('');
+}
+function sanitizeComment(s) {
+    return s.replace(/\r?\n/g, ' ').replace(/\*\//g, '*\\/').slice(0, 120);
+}
+function deriveClassNameFromUrl(url) {
+    try {
+        const u = new URL(url);
+        const segments = u.pathname.split('/').filter((p) => p.length > 0);
+        const base = segments.length > 0 ? segments[segments.length - 1] : u.hostname.split('.')[0];
+        const className = pascalize(base);
+        return (className || 'GeneratedPage') + 'Page';
+    }
+    catch {
+        return 'GeneratedPage';
+    }
+}
+function collectElements(flags) {
+    const out = [];
+    const max = flags.maxElements;
+    const isVisible = (el) => {
+        const node = el;
+        const style = window.getComputedStyle(node);
+        if (style.display === 'none' || style.visibility === 'hidden')
+            return false;
+        if (Number(style.opacity) === 0)
+            return false;
+        const rect = node.getBoundingClientRect();
+        return rect.width > 0 || rect.height > 0;
+    };
+    const textOf = (el) => {
+        const node = el;
+        const aria = node.getAttribute('aria-label') || '';
+        if (aria)
+            return aria.trim();
+        const t = (node.innerText || node.textContent || '').trim().replace(/\s+/g, ' ');
+        return t.slice(0, 80);
+    };
+    const labelFor = (el) => {
+        const input = el;
+        const labels = input.labels;
+        if (labels && labels.length > 0) {
+            return Array.from(labels)
+                .map((l) => (l.textContent || '').trim())
+                .join(' ')
+                .replace(/\s+/g, ' ')
+                .trim();
+        }
+        const id = input.id;
+        if (id) {
+            const explicit = document.querySelector(`label[for=${JSON.stringify(id)}]`);
+            if (explicit)
+                return (explicit.textContent || '').trim().replace(/\s+/g, ' ');
+        }
+        return '';
+    };
+    const headingLevel = (el) => {
+        const m = /^h([1-6])$/i.exec(el.tagName);
+        return m ? Number(m[1]) : 0;
+    };
+    const pushItem = (item) => {
+        out.push(item);
+        return out.length < max;
+    };
+    if (flags.includeRoles) {
+        const buttons = document.querySelectorAll('button, [role="button"], input[type="submit"], input[type="button"]');
+        for (const b of Array.from(buttons)) {
+            if (!isVisible(b))
+                continue;
+            const name = textOf(b) || b.value || '';
+            if (!name)
+                continue;
+            const locator = `getByRole('button', { name: ${JSON.stringify(name)} })`;
+            if (!pushItem({ kind: 'button', locator, description: name }))
+                return out;
+        }
+        const links = document.querySelectorAll('a[href]');
+        for (const a of Array.from(links)) {
+            if (!isVisible(a))
+                continue;
+            const name = textOf(a);
+            if (!name)
+                continue;
+            const locator = `getByRole('link', { name: ${JSON.stringify(name)} })`;
+            if (!pushItem({ kind: 'link', locator, description: name }))
+                return out;
+        }
+        const headings = document.querySelectorAll('h1, h2, h3, h4, h5, h6');
+        for (const h of Array.from(headings)) {
+            if (!isVisible(h))
+                continue;
+            const name = textOf(h);
+            const level = headingLevel(h);
+            if (!name || !level)
+                continue;
+            const locator = `getByRole('heading', { name: ${JSON.stringify(name)}, level: ${level} })`;
+            if (!pushItem({ kind: 'heading', locator, description: name }))
+                return out;
+        }
+    }
+    if (flags.includeForms) {
+        const textSelector = 'input[type="text"], input[type="email"], input[type="password"], input[type="search"], input:not([type]), textarea';
+        const textInputs = document.querySelectorAll(textSelector);
+        for (const input of Array.from(textInputs)) {
+            if (!isVisible(input))
+                continue;
+            const el = input;
+            const label = labelFor(el);
+            const placeholder = el.getAttribute('placeholder') || '';
+            const testId = el.getAttribute('data-testid') || '';
+            const nameAttr = el.getAttribute('name') || '';
+            let locator = '';
+            let description = '';
+            if (label) {
+                locator = `getByLabel(${JSON.stringify(label)})`;
+                description = label;
+            }
+            else if (placeholder) {
+                locator = `getByPlaceholder(${JSON.stringify(placeholder)})`;
+                description = placeholder;
+            }
+            else if (testId) {
+                locator = `getByTestId(${JSON.stringify(testId)})`;
+                description = testId;
+            }
+            else if (nameAttr) {
+                locator = `locator('[name=${cssEscape(nameAttr)}]')`;
+                description = nameAttr;
+            }
+            else {
+                continue;
+            }
+            const kind = el.tagName.toLowerCase() === 'textarea' ? 'textbox' : 'input';
+            if (!pushItem({ kind, locator, description }))
+                return out;
+        }
+        const labeledField = (el, kind, fallbackPrefix) => {
+            const label = labelFor(el);
+            const testId = el.getAttribute('data-testid') || '';
+            const nameAttr = el.getAttribute('name') || '';
+            if (label)
+                return { kind, locator: `getByLabel(${JSON.stringify(label)})`, description: label };
+            if (testId)
+                return { kind, locator: `getByTestId(${JSON.stringify(testId)})`, description: testId };
+            if (nameAttr)
+                return { kind, locator: `locator('${fallbackPrefix}[name=${cssEscape(nameAttr)}]')`, description: nameAttr };
+            return null;
+        };
+        const checkboxes = document.querySelectorAll('input[type="checkbox"]');
+        for (const cb of Array.from(checkboxes)) {
+            if (!isVisible(cb))
+                continue;
+            const hit = labeledField(cb, 'checkbox', '');
+            if (hit && !pushItem(hit))
+                return out;
+        }
+        const radios = document.querySelectorAll('input[type="radio"]');
+        for (const rd of Array.from(radios)) {
+            if (!isVisible(rd))
+                continue;
+            const hit = labeledField(rd, 'radio', '');
+            if (hit && !pushItem(hit))
+                return out;
+        }
+        const selects = document.querySelectorAll('select');
+        for (const sel of Array.from(selects)) {
+            if (!isVisible(sel))
+                continue;
+            const hit = labeledField(sel, 'select', 'select');
+            if (hit && !pushItem(hit))
+                return out;
+        }
+    }
+    if (flags.includeTestIds) {
+        const withTestId = document.querySelectorAll('[data-testid]');
+        for (const el of Array.from(withTestId)) {
+            if (!isVisible(el))
+                continue;
+            const id = el.getAttribute('data-testid') || '';
+            if (!id)
+                continue;
+            const locator = `getByTestId(${JSON.stringify(id)})`;
+            if (!pushItem({ kind: 'testid', locator, description: id }))
+                return out;
+        }
+    }
+    return out;
+}
+function cssEscape(value) {
+    const safe = value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+    return `"${safe}"`;
+}
+//# sourceMappingURL=page-object.js.map

package/dist/page-object.js.map

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

package/dist/pagination-audit.d.ts

@@ -0,0 +1,24 @@
+import type { Page } from 'playwright';
+export type PaginationKind = 'numbered' | 'prev-next' | 'load-more' | 'infinite-scroll' | 'none';
+export type PaginationIssueType = 'no-nav-landmark' | 'missing-aria-label' | 'current-page-not-marked' | 'link-without-href' | 'infinite-scroll-no-load-more' | 'infinite-scroll-no-url-update' | 'infinite-scroll-traps-focus' | 'load-more-without-aria-live' | 'back-button-broken' | 'no-total-count';
+export interface PaginationIssue {
+    type: PaginationIssueType;
+    severity: 'info' | 'warn' | 'error';
+    selector?: string;
+    detail: string;
+}
+export interface PaginationResult {
+    page: string;
+    kind: PaginationKind;
+    detected: boolean;
+    pageCountDetected?: number;
+    hasNavLandmark: boolean;
+    supportsKeyboard: boolean;
+    updatesUrl: boolean;
+    issues: PaginationIssue[];
+    passed: boolean;
+}
+export declare function auditPagination(page: Page, opts?: {
+    scrollProbes?: number;
+}): Promise<PaginationResult>;
+//# sourceMappingURL=pagination-audit.d.ts.map

package/dist/pagination-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination-audit.d.ts","sourceRoot":"","sources":["../src/pagination-audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,GAAG,iBAAiB,GAAG,MAAM,CAAC;AAEjG,MAAM,MAAM,mBAAmB,GAC3B,iBAAiB,GACjB,oBAAoB,GACpB,yBAAyB,GACzB,mBAAmB,GACnB,8BAA8B,GAC9B,+BAA+B,GAC/B,6BAA6B,GAC7B,6BAA6B,GAC7B,oBAAoB,GACpB,gBAAgB,CAAC;AAErB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;CACjB;AAgCD,wBAAsB,eAAe,CACnC,IAAI,EAAE,IAAI,EACV,IAAI,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B,OAAO,CAAC,gBAAgB,CAAC,CAkR3B"}