cbrowser 18.13.4 → 18.14.0

package/dist/remediation/patch-generator.d.ts

@@ -0,0 +1,54 @@
+/**
+ * CBrowser - Cognitive Browser Automation
+ * Copyright 2026 Alexandria Eden alexandria.shai.eden@gmail.com
+ * Learn more at https://cbrowser.ai - MIT License
+ */
+/**
+ * Remediation Patch Generator
+ *
+ * Transforms audit issues into actionable before/after code patches.
+ * Each issue type maps to a specific fix template.
+ *
+ * @since 17.0.0
+ */
+import type { AgentReadyIssue, AgentReadyAuditResult } from "../types.js";
+/**
+ * Represents a code patch to fix an audit issue
+ */
+export interface RemediationPatch {
+    /** Issue being fixed */
+    issueId: string;
+    /** Issue category */
+    category: string;
+    /** Issue description */
+    description: string;
+    /** Original problematic code */
+    before: string;
+    /** Fixed code */
+    after: string;
+    /** Explanation of the fix */
+    explanation: string;
+    /** Effort level to implement */
+    effort: "trivial" | "easy" | "medium" | "hard";
+    /** Impact of the fix */
+    impact: "low" | "medium" | "high";
+}
+/**
+ * Generate a remediation patch for a single audit issue
+ */
+export declare function generatePatch(issue: AgentReadyIssue): RemediationPatch;
+/**
+ * Generate remediation patches for all issues in an audit result
+ */
+export declare function generateRemediationPatches(auditResult: AgentReadyAuditResult): RemediationPatch[];
+/**
+ * Get a summary of patches grouped by category
+ */
+export declare function summarizePatches(patches: RemediationPatch[]): {
+    total: number;
+    byCategory: Record<string, number>;
+    byEffort: Record<string, number>;
+    byImpact: Record<string, number>;
+    quickWins: number;
+};
+//# sourceMappingURL=patch-generator.d.ts.map

package/dist/remediation/patch-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch-generator.d.ts","sourceRoot":"","sources":["../../src/remediation/patch-generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,wBAAwB;IACxB,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACnC;AAiOD;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,gBAAgB,CAMtE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,qBAAqB,GACjC,gBAAgB,EAAE,CAmBpB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB,CA0BA"}

package/dist/remediation/patch-generator.js

@@ -0,0 +1,274 @@
+/**
+ * CBrowser - Cognitive Browser Automation
+ * Copyright 2026 Alexandria Eden alexandria.shai.eden@gmail.com
+ * Learn more at https://cbrowser.ai - MIT License
+ */
+/**
+ * Patch templates keyed by detection method
+ */
+const PATCH_TEMPLATES = {
+    "button-label-check": (issue) => ({
+        issueId: `btn-${Date.now()}`,
+        category: issue.category,
+        description: issue.description,
+        before: `<button class="icon-btn">
+  <svg>...</svg>
+</button>`,
+        after: `<button class="icon-btn" aria-label="Describe the action">
+  <svg aria-hidden="true">...</svg>
+</button>`,
+        explanation: "Add aria-label to describe the button's action. Hide decorative icons from screen readers with aria-hidden.",
+        effort: "trivial",
+        impact: "high",
+    }),
+    "input-label-check": (issue) => ({
+        issueId: `input-${Date.now()}`,
+        category: issue.category,
+        description: issue.description,
+        before: `<input type="text" name="email" placeholder="Enter email" />`,
+        after: `<label for="email-input" class="visually-hidden">Email address</label>
+<input type="text" id="email-input" name="email" placeholder="Enter email" aria-describedby="email-hint" />
+<span id="email-hint" class="hint">We'll never share your email</span>`,
+        explanation: "Add an explicit label (visible or visually-hidden). Use aria-describedby for hints. Labels provide context for both screen readers and AI agents.",
+        effort: "easy",
+        impact: "high",
+    }),
+    "custom-select-check": (issue) => ({
+        issueId: `select-${Date.now()}`,
+        category: issue.category,
+        description: issue.description,
+        before: `<div class="custom-select" onclick="toggle()">
+  <span class="selected">Select option</span>
+  <div class="options" hidden>
+    <div data-value="1">Option 1</div>
+    <div data-value="2">Option 2</div>
+  </div>
+</div>`,
+        after: `<div class="custom-select" role="combobox" aria-haspopup="listbox" aria-expanded="false" aria-label="Select an option">
+  <span class="selected" id="selected-value">Select option</span>
+  <div class="options" role="listbox" hidden>
+    <div role="option" data-value="1" tabindex="0">Option 1</div>
+    <div role="option" data-value="2" tabindex="0">Option 2</div>
+  </div>
+</div>
+
+<!-- Better: Use native select with custom styling -->
+<select name="options" class="styled-select">
+  <option value="">Select option</option>
+  <option value="1">Option 1</option>
+  <option value="2">Option 2</option>
+</select>`,
+        explanation: "Either add proper ARIA roles (combobox, listbox, option) to custom selects, or better yet, use native <select> with CSS styling. Native selects work better with AI agents.",
+        effort: "medium",
+        impact: "high",
+    }),
+    "dynamic-content-check": (issue) => ({
+        issueId: `dynamic-${Date.now()}`,
+        category: issue.category,
+        description: issue.description,
+        before: `<div class="infinite-scroll" onscroll="loadMore()">
+  <div class="items">...</div>
+  <div class="loading-spinner" hidden>Loading...</div>
+</div>`,
+        after: `<div class="paginated-content">
+  <div class="items">...</div>
+  <nav aria-label="Pagination">
+    <a href="?page=1" aria-current="page">1</a>
+    <a href="?page=2">2</a>
+    <a href="?page=3">3</a>
+    <a href="?page=4">Next</a>
+  </nav>
+</div>
+
+<!-- If infinite scroll is required, add a fallback -->
+<div class="items" aria-live="polite">...</div>
+<button id="load-more" aria-describedby="load-status">Load more items</button>
+<span id="load-status" class="visually-hidden">Loading additional items</span>`,
+        explanation: "Replace infinite scroll with pagination links that AI agents can follow. If infinite scroll is required, add a 'Load more' button as fallback and use aria-live regions.",
+        effort: "hard",
+        impact: "high",
+    }),
+    "link-text-check": (issue) => ({
+        issueId: `link-${Date.now()}`,
+        category: issue.category,
+        description: issue.description,
+        before: `<a href="/docs">Click here</a>
+<a href="/pricing">Read more</a>`,
+        after: `<a href="/docs">View documentation</a>
+<a href="/pricing">See pricing details</a>`,
+        explanation: "Use descriptive link text that explains where the link goes. Avoid 'click here', 'read more', 'learn more' - these are meaningless out of context.",
+        effort: "trivial",
+        impact: "medium",
+    }),
+    "navigation-structure-check": (issue) => ({
+        issueId: `nav-${Date.now()}`,
+        category: issue.category,
+        description: issue.description,
+        before: `<div class="nav">
+  <div class="nav-item"><a href="/">Home</a></div>
+  <div class="nav-item"><a href="/about">About</a></div>
+  <div class="nav-item"><a href="/contact">Contact</a></div>
+</div>`,
+        after: `<nav aria-label="Main navigation">
+  <ul>
+    <li><a href="/">Home</a></li>
+    <li><a href="/about">About</a></li>
+    <li><a href="/contact">Contact</a></li>
+  </ul>
+</nav>
+
+<!-- Add breadcrumbs for deep pages -->
+<nav aria-label="Breadcrumb">
+  <ol>
+    <li><a href="/">Home</a></li>
+    <li><a href="/products">Products</a></li>
+    <li aria-current="page">Widget Pro</li>
+  </ol>
+</nav>`,
+        explanation: "Use semantic <nav> with aria-label to distinguish multiple navigations. Add breadcrumbs for pages more than 2 levels deep. Use lists for nav items.",
+        effort: "easy",
+        impact: "medium",
+    }),
+    "actionable-elements-check": (issue) => ({
+        issueId: `action-${Date.now()}`,
+        category: issue.category,
+        description: issue.description,
+        before: `<div class="btn" onclick="submit()">Submit</div>
+<span class="link" onclick="navigate('/home')">Go Home</span>`,
+        after: `<button type="submit">Submit</button>
+<a href="/home">Go Home</a>
+
+<!-- If JS behavior is required -->
+<button type="button" onclick="submit()">Submit</button>`,
+        explanation: "Use native interactive elements (<button>, <a>) instead of divs/spans with click handlers. Native elements have built-in keyboard support and are easier for AI agents to identify.",
+        effort: "easy",
+        impact: "high",
+    }),
+    "state-persistence-check": (issue) => ({
+        issueId: `state-${Date.now()}`,
+        category: issue.category,
+        description: issue.description,
+        before: `<form action="/purchase" method="POST">
+  <input type="hidden" name="item" value="widget-123" />
+  <button type="submit">Buy Now</button>
+</form>`,
+        after: `<form action="/purchase" method="POST">
+  <input type="hidden" name="item" value="widget-123" />
+  <input type="hidden" name="_csrf" value="{{csrfToken}}" />
+  <button type="submit" data-action="purchase" data-confirms="true">Buy Now</button>
+</form>
+
+<!-- Add confirmation for destructive actions -->
+<button type="submit"
+  data-action="delete"
+  data-confirms="true"
+  data-confirm-message="Are you sure you want to delete this item?">
+  Delete
+</button>`,
+        explanation: "Mark non-idempotent actions with data attributes so AI agents can identify state-changing operations. Include CSRF tokens and add confirmation prompts for destructive actions.",
+        effort: "medium",
+        impact: "high",
+    }),
+    "machine-metadata-check": (issue) => ({
+        issueId: `meta-${Date.now()}`,
+        category: issue.category,
+        description: issue.description,
+        before: `<head>
+  <title>My Site</title>
+</head>`,
+        after: `<head>
+  <title>My Site - Brief description</title>
+  <meta name="description" content="Clear description of page content" />
+
+  <!-- OpenGraph for social/AI context -->
+  <meta property="og:title" content="My Site" />
+  <meta property="og:description" content="Clear description" />
+  <meta property="og:type" content="website" />
+
+  <!-- JSON-LD for structured data -->
+  <script type="application/ld+json">
+  {
+    "@context": "https://schema.org",
+    "@type": "Organization",
+    "name": "My Site",
+    "url": "https://example.com",
+    "description": "Clear description"
+  }
+  </script>
+</head>`,
+        explanation: "Add OpenGraph meta tags for social context. Include JSON-LD structured data for machine-readable semantics. Both help AI agents understand page purpose.",
+        effort: "easy",
+        impact: "high",
+    }),
+};
+/**
+ * Default patch template for unknown issue types
+ */
+function createDefaultPatch(issue) {
+    return {
+        issueId: `issue-${Date.now()}`,
+        category: issue.category,
+        description: issue.description,
+        before: issue.element || "<!-- Current implementation -->",
+        after: issue.codeExample || "<!-- See recommendation below -->",
+        explanation: issue.recommendation || "Review the element and apply accessibility best practices.",
+        effort: "medium",
+        impact: "medium",
+    };
+}
+/**
+ * Generate a remediation patch for a single audit issue
+ */
+export function generatePatch(issue) {
+    const template = PATCH_TEMPLATES[issue.detectionMethod];
+    if (template) {
+        return template(issue);
+    }
+    return createDefaultPatch(issue);
+}
+/**
+ * Generate remediation patches for all issues in an audit result
+ */
+export function generateRemediationPatches(auditResult) {
+    const patches = [];
+    for (const issue of auditResult.issues) {
+        const patch = generatePatch(issue);
+        patches.push(patch);
+    }
+    // Sort by impact (high first) then effort (easy first)
+    const impactOrder = { high: 0, medium: 1, low: 2 };
+    const effortOrder = { trivial: 0, easy: 1, medium: 2, hard: 3 };
+    patches.sort((a, b) => {
+        const impactDiff = impactOrder[a.impact] - impactOrder[b.impact];
+        if (impactDiff !== 0)
+            return impactDiff;
+        return effortOrder[a.effort] - effortOrder[b.effort];
+    });
+    return patches;
+}
+/**
+ * Get a summary of patches grouped by category
+ */
+export function summarizePatches(patches) {
+    const byCategory = {};
+    const byEffort = {};
+    const byImpact = {};
+    let quickWins = 0;
+    for (const patch of patches) {
+        byCategory[patch.category] = (byCategory[patch.category] || 0) + 1;
+        byEffort[patch.effort] = (byEffort[patch.effort] || 0) + 1;
+        byImpact[patch.impact] = (byImpact[patch.impact] || 0) + 1;
+        if ((patch.effort === "trivial" || patch.effort === "easy") &&
+            patch.impact === "high") {
+            quickWins++;
+        }
+    }
+    return {
+        total: patches.length,
+        byCategory,
+        byEffort,
+        byImpact,
+        quickWins,
+    };
+}
+//# sourceMappingURL=patch-generator.js.map

package/dist/remediation/patch-generator.js.map

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

package/dist/remediation/structured-data.d.ts

@@ -0,0 +1,64 @@
+/**
+ * CBrowser - Cognitive Browser Automation
+ * Copyright 2026 Alexandria Eden alexandria.shai.eden@gmail.com
+ * Learn more at https://cbrowser.ai - MIT License
+ */
+/**
+ * Detected page type
+ */
+export type PageType = "homepage" | "article" | "product" | "organization" | "person" | "event" | "faq" | "howto" | "recipe" | "local-business" | "unknown";
+/**
+ * Page signals used for type detection
+ */
+export interface PageSignals {
+    url: string;
+    title: string;
+    hasArticleTag: boolean;
+    hasProductSchema: boolean;
+    hasPrice: boolean;
+    hasAddToCart: boolean;
+    hasPublishDate: boolean;
+    hasAuthor: boolean;
+    hasFaqSection: boolean;
+    hasStepsList: boolean;
+    hasEventDate: boolean;
+    hasAddress: boolean;
+    hasPhone: boolean;
+    isHomepage: boolean;
+    ogType?: string;
+    existingSchema: string[];
+}
+/**
+ * Structured data suggestion
+ */
+export interface StructuredDataSuggestion {
+    pageType: PageType;
+    confidence: number;
+    existingSchema: string[];
+    suggestedSchema: object;
+    suggestedSchemaString: string;
+    reasoning: string;
+}
+/**
+ * Options for structured data suggestion
+ */
+export interface StructuredDataOptions {
+    url: string;
+    headless?: boolean;
+}
+/**
+ * Detect page type from signals
+ */
+export declare function detectPageType(signals: PageSignals): {
+    type: PageType;
+    confidence: number;
+};
+/**
+ * Generate structured data based on detected page type
+ */
+export declare function generateStructuredData(signals: PageSignals, pageType: PageType): object;
+/**
+ * Suggest structured data for a URL
+ */
+export declare function suggestStructuredData(options: StructuredDataOptions): Promise<StructuredDataSuggestion>;
+//# sourceMappingURL=structured-data.d.ts.map

package/dist/remediation/structured-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-data.d.ts","sourceRoot":"","sources":["../../src/remediation/structured-data.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAChB,UAAU,GACV,SAAS,GACT,SAAS,GACT,cAAc,GACd,QAAQ,GACR,OAAO,GACP,KAAK,GACL,OAAO,GACP,QAAQ,GACR,gBAAgB,GAChB,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,OAAO,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAuGD;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CA6D3F;AAgHD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,QAAQ,GACjB,MAAM,CAuBR;AAwCD;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,wBAAwB,CAAC,CA+BnC"}