/* WPSiteBeam Scanner — AI Readiness Tab (SEO-003 / api #84) ───────────────────────────────────────────────────────────────────── Surfaces the site-level `ai_readiness` payload (schema.org structured data → how well AI search engines / LLM crawlers / AI Overviews can understand the site) that /brain/scan returns alongside scan results. Sibling tab to the other scan-result tabs. Reads ONLY what /brain/scan returns (no second data source — Provenance, locked rule #14): data._raw.ai_readiness — site-level { score, band, complete, partial_reason, score_basis, present_types, formats_found, readable_formats, breakdown, type_report, recommendations, jsonld_parse_errors, weights, pages_analyzed, note } data._raw.pages[].schema — per-page { formats, types, detected, jsonld_parse_errors } (Task C drilldown, site-level otherwise) Bands: high ≥75 / medium ≥40 / low. `score` MAY be null (SPA/blocked). ── Radical Transparency (locked rule #13 — NO false zeros) ── When score === null OR complete === false we render the honest-incomplete state from partial_reason, NEVER a 0 or a fabricated ring: · client_rendered + score_basis json_ld_only → partial score, labelled "head-only" (JSON-LD in the served HTML read; body-rendered schema not) · blocked / unreachable / unreadable → no score, honest message Recommendations are rendered as guidance, never guarantees. ── Role / plan ── No new entitlement, no NAV/ALLOWED widening — renders within the existing scan-results surface gating (the API attaches ai_readiness to the scan response it already authorised). If the running API predates #84 the field is absent and we render the honest "not in this scan yet" state. ── Analytics (locked rule #32) ── `seo.ai_readiness.viewed` is now RESERVED server-side in analytics.js KNOWN_EVENT_TYPES (alongside seo.rank.viewed / seo.keyword.opened — api #86), so the deferred emit is wired: a fire-and-forget POST to the customer-scoped /client/events/track (requireJWT('wpsb-app'); account_id + user_id come FROM the JWT, never the body; unknown keys dropped; 202, never blocks render). Emitted once on mount when the tab is viewed. Honest props (`scored`/`band`) so an open of the not-served/no-score state isn't counted as a real score view. NOT the SA-only /events/track (would drop a customer JWT's event). v1.1.0 — 2026-06-25. CSS var() tokens only; WCAG 2.1 AA. IIFE, JSX. Registers window.ScannerAiReadinessTab. */ (function () { 'use strict'; const Icon = window.Icon; const { useEffect } = React; function apiBase() { return (window.WPSBD && window.WPSBD.apiBase) || 'https://api.wpsitebeam.io'; } function authToken() { return (window.WPSB && window.WPSB.getToken && window.WPSB.getToken()) || (function () { try { return localStorage.getItem('wpsb-auth-token'); } catch (e) { return null; } })(); } /* Customer-scoped client analytics ingest. account_id + user_id come from the JWT server-side — we NEVER send account_id in the body. Fire-and-forget: any failure is swallowed so analytics can never block or break the tab. Targets /client/events/track (NOT the SA-only /events/track, which would silently drop a customer JWT's event). */ function emitClientEvent(eventType, props) { try { const token = authToken(); if (!token) return; fetch(apiBase() + '/client/events/track', { method: 'POST', headers: { 'Content-Type': 'application/json', Authorization: 'Bearer ' + token }, body: JSON.stringify({ event_type: eventType, props: props || {} }), }).catch(function () {}); } catch (_) { /* swallow — analytics never blocks the tab */ } } /* Band → semantic color (high ≥75 / medium ≥40 / low). Mirrors the API bands, not ScoreRing's own green≥80 default — pass the colour through. */ function bandColor(band) { return band === 'high' ? 'var(--green)' : band === 'medium' ? 'var(--warn)' : 'var(--red)'; } function bandLabel(band) { return band === 'high' ? 'High' : band === 'medium' ? 'Medium' : band === 'low' ? 'Low' : 'Unknown'; } /* Human labels for the deterministic breakdown components. */ const COMPONENT_LABELS = { identity: 'Entity identity', site_definition: 'Site definition', navigation: 'Navigation context', primary_content: 'Primary content', format_quality: 'Format quality', completeness: 'Schema completeness', }; function Chip({ ok, label, title }) { const tone = ok ? 'var(--green)' : 'var(--dim)'; return ( {Icon ? : null}{label} ); } /* Honest "no score" panel — rendered when score === null (blocked / unreachable / unreadable). NEVER a 0 ring. */ function NoScorePanel({ ar }) { const reason = ar.partial_reason || 'unknown'; const headline = reason === 'blocked' ? 'The page blocked our public crawler' : reason === 'unreachable' ? 'The page wasn’t reachable' : 'Structured data couldn’t be read'; const readable = Array.isArray(ar.readable_formats) ? ar.readable_formats : []; return (
{Icon ? : '!'}
{headline}

{ar.note || 'No score is shown rather than a misleading 0.'}

{readable.length ? (

We could still read: {readable.join(', ')}.

) : null}
status: {reason}{ar.score_basis ? ' · basis: ' + ar.score_basis : ''}
); } /* Hero — score ring (band-coloured) + band + partial/head-only disclosure. */ function Hero({ ar }) { const score = ar.score; const color = bandColor(ar.band); const headOnly = ar.complete === false && ar.score_basis === 'json_ld_only'; return (
{window.ScoreRing ? :
{score}/100
}
AI Readiness {bandLabel(ar.band)} {headOnly ? ( Partial · head-only ) : null}

How well AI search engines (LLM crawlers, AI Overviews) can understand this site from its public structured data. Deterministic, AI-free — read straight from the served HTML.

{headOnly ? (

This page is client-rendered. We read the JSON-LD in the served HTML; body-rendered microdata/RDFa couldn’t be read, so this score reflects readable JSON-LD only.

) : null}
); } /* Deterministic score breakdown — earned/max per weighted component. */ function Breakdown({ ar }) { const rows = Array.isArray(ar.breakdown) ? ar.breakdown : []; if (!rows.length) return null; return (
Score breakdown
How the 0–100 score is composed (weighted categories).
{rows.map(function (b, i) { const max = b.max || 0; const earned = b.earned || 0; const pct = max ? Math.round((earned / max) * 100) : 0; const tone = pct >= 75 ? 'var(--green)' : pct >= 40 ? 'var(--warn)' : 'var(--red)'; return (
{COMPONENT_LABELS[b.component] || b.component} {earned} / {max}
{b.why ?
{b.why}
: null}
); })}
); } /* Formats found + schema types present (the two read-from-payload lists). */ function FormatsAndTypes({ ar }) { const f = ar.formats_found || {}; const types = Array.isArray(ar.present_types) ? ar.present_types : []; const parseErrors = ar.jsonld_parse_errors || 0; return (
Structured-data formats
{parseErrors ? (
{Icon ? : null} {parseErrors} JSON-LD block{parseErrors !== 1 ? 's' : ''} couldn’t be parsed (invalid JSON).
) : null}
Schema types detected{types.length ? ' (' + types.length + ')' : ''}
{types.length ? (
{types.map(function (t) { return ( {t} ); })}
) : (
No schema.org types were detected in the served HTML.
)}
); } /* Per-type completeness (type_report) — missing required/recommended props. */ function TypeReport({ ar }) { const rows = (Array.isArray(ar.type_report) ? ar.type_report : []).filter(function (t) { return t && t.known; }); if (!rows.length) return null; return (
Completeness by type
Required + recommended properties present, per detected type.
{rows.map(function (t, i) { const c = typeof t.completeness === 'number' ? t.completeness : null; const tone = c == null ? 'var(--dim)' : c >= 75 ? 'var(--green)' : c >= 40 ? 'var(--warn)' : 'var(--red)'; const missReq = Array.isArray(t.missing_required) ? t.missing_required : []; const missRec = Array.isArray(t.missing_recommended) ? t.missing_recommended : []; return (
{t.type} {c == null ? '—' : c + '%'}
{missReq.length ? (
Missing required: {missReq.join(', ')}
) : null} {missRec.length ? (
Missing recommended: {missRec.join(', ')}
) : null}
); })}
); } /* Recommendations — guidance, NOT guarantees (Radical Transparency). */ function Recommendations({ ar }) { const recs = Array.isArray(ar.recommendations) ? ar.recommendations : []; if (!recs.length) return null; return (
{Icon ? : null} Recommendations
Guidance to improve AI comprehension — not a guarantee of ranking or inclusion.
{recs.map(function (r, i) { return (
{r.type} {r.reason}
); })}
); } /* Per-page schema drilldown (Task C) — reads pages[].schema directly. */ function PerPageSchema({ pages }) { const rows = (pages || []).filter(function (p) { return p && p.schema; }); if (!rows.length) return null; return (
Schema by page
Structured-data types found on each crawled page.
{rows.map(function (p, i) { const s = p.schema || {}; const f = s.formats || {}; const fmts = [f.json_ld && 'JSON-LD', f.microdata && 'Microdata', f.rdfa && 'RDFa'].filter(Boolean); const types = Array.isArray(s.types) ? s.types : []; let path = p.url || ''; try { path = new URL(p.url).pathname || p.url; } catch (e) {} return ( ); })}
Page Formats Types
{path} {fmts.length ? fmts.join(' · ') : '—'} {types.length ? types.join(', ') : '—'}
); } function ScannerAiReadinessTab({ data }) { const ar = (data && data.aiReadiness) || (data && data._raw && data._raw.ai_readiness) || null; const pages = (data && data._raw && Array.isArray(data._raw.pages)) ? data._raw.pages : []; // seo.ai_readiness.viewed — AI Readiness tab opened/viewed. Fire-and-forget, // fail-soft, once on mount. Honest props: `scored` reflects whether a real // score was present (so opening the not-served / no-score state is not // counted as a score view — no false signal). Key reserved server-side in // analytics.js KNOWN_EVENT_TYPES; a typo would be dropped silently. useEffect(function () { emitClientEvent('seo.ai_readiness.viewed', { surface: 'scanner_ai_readiness', scored: typeof (ar && ar.score) === 'number', band: (ar && ar.band) || null, }); }, []); /* Not-served-yet — the running API predates #84 (field absent). Honest. */ if (!ar) { return (
{Icon ? : '✦'}
AI Readiness isn’t in this scan yet
The AI Readiness score (schema.org structured data → how AI search engines understand your site) arrives with the latest scan engine. Run a fresh full scan to populate it.
); } const hasScore = typeof ar.score === 'number'; return (
{hasScore ? : } {hasScore ? : null} {hasScore ? : null} {/* Honest footer — what this is, and what it isn't. */}
{ar.note ? {ar.note} : null} Deterministic, AI-free — based on the public structured data in the served HTML {typeof ar.pages_analyzed === 'number' ? ' across ' + ar.pages_analyzed + ' page' + (ar.pages_analyzed !== 1 ? 's' : '') : ''}. Recommendations are guidance, not guarantees.
); } window.ScannerAiReadinessTab = ScannerAiReadinessTab; console.log('[WPSB] ScannerAiReadinessTab v1.1.0 loaded (seo.ai_readiness.viewed client emit wired)'); })();