@rivi-software/agentic-seo-check 0.0.0-stage → 0.1.0

package/dist/core/rules/response.js

@@ -0,0 +1,59 @@
+import { isLocalHost } from './canonical.js';
+import { defineRule, GOOGLE_DOCS } from './rule.js';
+export const responseRules = [
+    defineRule({
+        id: 'response.error-status',
+        category: 'response',
+        severity: 'error',
+        description: 'The URL returned a 4xx or 5xx status code.',
+        recommendation: 'Fix the route or server error. If the page was removed on purpose, return 410 (or 404) and remove internal links and sitemap entries pointing to it.',
+    }, ({ response }, make) => (response?.status && response.status >= 400 ? make(`URL returned HTTP ${response.status}.`, { evidence: { status: response.status, finalUrl: response.finalUrl } }) : null)),
+    defineRule({
+        id: 'response.redirected',
+        category: 'response',
+        severity: 'info',
+        description: 'The requested URL redirected to another URL.',
+        recommendation: 'Link directly to the final URL (internal links, sitemap, canonical) so crawlers and users skip the redirect.',
+        docs: GOOGLE_DOCS.redirects,
+    }, ({ response }, make) => response && response.redirectChain.length === 1
+        ? make(`Request redirected (${response.redirectChain[0].status}) to ${response.finalUrl}.`, { evidence: { chain: response.redirectChain, finalUrl: response.finalUrl } })
+        : null),
+    defineRule({
+        id: 'response.redirect-chain',
+        category: 'response',
+        severity: 'warning',
+        description: 'The URL goes through two or more redirects before reaching the final page.',
+        recommendation: 'Collapse the chain so the first URL redirects straight to the final destination. Each hop costs crawl budget and loses some signal.',
+        docs: GOOGLE_DOCS.redirects,
+    }, ({ response }, make) => response && response.redirectChain.length >= 2
+        ? make(`Redirect chain of ${response.redirectChain.length} hops ends at ${response.finalUrl}.`, { evidence: { chain: response.redirectChain, finalUrl: response.finalUrl } })
+        : null),
+    defineRule({
+        id: 'response.slow',
+        category: 'response',
+        severity: 'warning',
+        description: 'The HTML response took longer than the configured threshold (default 2000 ms).',
+        recommendation: 'Reduce server response time: cache the HTML, avoid blocking data fetches during render, use a CDN. Google recommends TTFB under 800 ms.',
+        docs: GOOGLE_DOCS.cwv,
+    }, ({ response, thresholds }, make) => response?.timeMs !== null && response?.timeMs !== undefined && response.timeMs > thresholds.slowResponseMs
+        ? make(`HTML response took ${response.timeMs} ms (single measurement; threshold ${thresholds.slowResponseMs} ms).`, { evidence: { timeMs: response.timeMs } })
+        : null),
+    defineRule({
+        id: 'response.not-html',
+        category: 'response',
+        severity: 'warning',
+        description: 'The response Content-Type is not HTML.',
+        recommendation: 'Serve pages with Content-Type: text/html; charset=utf-8.',
+    }, ({ response }, make) => {
+        const ct = response?.contentType?.toLowerCase();
+        return ct && !ct.includes('html') && !ct.includes('xhtml') ? make(`Content-Type is "${response.contentType}", not HTML.`, { evidence: { contentType: response.contentType } }) : null;
+    }),
+    defineRule({
+        id: 'response.not-https',
+        category: 'response',
+        severity: 'warning',
+        description: 'The final URL is served over plain http.',
+        recommendation: 'Serve the site over https and redirect http to https. HTTPS is a (light) ranking signal and required for many browser features.',
+    }, ({ response, source }, make) => source === 'url' && response && response.finalUrl.startsWith('http://') && !isLocalHost(response.finalUrl) ? make('Page is served over http:// instead of https://.', { evidence: { finalUrl: response.finalUrl } }) : null),
+];
+//# sourceMappingURL=response.js.map

package/dist/core/rules/response.js.map

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

package/dist/core/rules/rule.d.ts

@@ -0,0 +1,42 @@
+import type { ExtractedPage, Finding, PageSource, ResponseInfo, RuleMeta, Severity, Thresholds } from '../types.js';
+export interface PageContext {
+    page: ExtractedPage;
+    source: PageSource;
+    response?: ResponseInfo;
+    keyword?: string;
+    thresholds: Thresholds;
+    depth?: number;
+}
+export interface Rule {
+    meta: RuleMeta;
+    check(ctx: PageContext): Finding[];
+}
+export interface FindingExtras {
+    severity?: Severity;
+    recommendation?: string;
+    selector?: string;
+    evidence?: Record<string, unknown>;
+}
+/** Build a finding from rule metadata, overriding only what differs for this instance. */
+export declare function finding(meta: RuleMeta, message: string, extras?: FindingExtras): Finding;
+export declare function defineRule(meta: RuleMeta, check: (ctx: PageContext, make: (message: string, extras?: FindingExtras) => Finding) => Finding[] | Finding | null | undefined | void): Rule;
+export declare function cap<T>(items: T[], max?: number): T[];
+export declare const GOOGLE_DOCS: {
+    readonly titles: "https://developers.google.com/search/docs/appearance/title-link";
+    readonly snippets: "https://developers.google.com/search/docs/appearance/snippet";
+    readonly canonical: "https://developers.google.com/search/docs/crawling-indexing/consolidate-duplicate-urls";
+    readonly robotsMeta: "https://developers.google.com/search/docs/crawling-indexing/robots-meta-tag";
+    readonly robotsTxt: "https://developers.google.com/search/docs/crawling-indexing/robots/intro";
+    readonly sitemaps: "https://developers.google.com/search/docs/crawling-indexing/sitemaps/overview";
+    readonly hreflang: "https://developers.google.com/search/docs/specialty/international/localized-versions";
+    readonly images: "https://developers.google.com/search/docs/appearance/google-images";
+    readonly links: "https://developers.google.com/search/docs/crawling-indexing/links-crawlable";
+    readonly structuredData: "https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data";
+    readonly javascript: "https://developers.google.com/search/docs/crawling-indexing/javascript/javascript-seo-basics";
+    readonly cwv: "https://web.dev/articles/vitals";
+    readonly mobile: "https://developers.google.com/search/docs/crawling-indexing/mobile/mobile-sites-mobile-first-indexing";
+    readonly redirects: "https://developers.google.com/search/docs/crawling-indexing/301-redirects";
+    readonly softs404: "https://developers.google.com/search/docs/crawling-indexing/http-network-errors#soft-404-errors";
+    readonly og: "https://ogp.me/";
+    readonly twitter: "https://developer.x.com/en/docs/x-for-websites/cards/overview/markup";
+};

package/dist/core/rules/rule.js

@@ -0,0 +1,51 @@
+/** Build a finding from rule metadata, overriding only what differs for this instance. */
+export function finding(meta, message, extras = {}) {
+    const f = {
+        rule: meta.id,
+        severity: extras.severity ?? meta.severity,
+        category: meta.category,
+        message,
+        recommendation: extras.recommendation ?? meta.recommendation,
+    };
+    if (extras.selector)
+        f.selector = extras.selector;
+    if (extras.evidence)
+        f.evidence = extras.evidence;
+    if (meta.docs)
+        f.docs = meta.docs;
+    return f;
+}
+export function defineRule(meta, check) {
+    return {
+        meta,
+        check(ctx) {
+            const result = check(ctx, (message, extras) => finding(meta, message, extras));
+            if (!result)
+                return [];
+            return Array.isArray(result) ? result : [result];
+        },
+    };
+}
+export function cap(items, max = 10) {
+    return items.length > max ? items.slice(0, max) : items;
+}
+export const GOOGLE_DOCS = {
+    titles: 'https://developers.google.com/search/docs/appearance/title-link',
+    snippets: 'https://developers.google.com/search/docs/appearance/snippet',
+    canonical: 'https://developers.google.com/search/docs/crawling-indexing/consolidate-duplicate-urls',
+    robotsMeta: 'https://developers.google.com/search/docs/crawling-indexing/robots-meta-tag',
+    robotsTxt: 'https://developers.google.com/search/docs/crawling-indexing/robots/intro',
+    sitemaps: 'https://developers.google.com/search/docs/crawling-indexing/sitemaps/overview',
+    hreflang: 'https://developers.google.com/search/docs/specialty/international/localized-versions',
+    images: 'https://developers.google.com/search/docs/appearance/google-images',
+    links: 'https://developers.google.com/search/docs/crawling-indexing/links-crawlable',
+    structuredData: 'https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data',
+    javascript: 'https://developers.google.com/search/docs/crawling-indexing/javascript/javascript-seo-basics',
+    cwv: 'https://web.dev/articles/vitals',
+    mobile: 'https://developers.google.com/search/docs/crawling-indexing/mobile/mobile-sites-mobile-first-indexing',
+    redirects: 'https://developers.google.com/search/docs/crawling-indexing/301-redirects',
+    softs404: 'https://developers.google.com/search/docs/crawling-indexing/http-network-errors#soft-404-errors',
+    og: 'https://ogp.me/',
+    twitter: 'https://developer.x.com/en/docs/x-for-websites/cards/overview/markup',
+};
+//# sourceMappingURL=rule.js.map

package/dist/core/rules/rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule.js","sourceRoot":"","sources":["../../../src/core/rules/rule.ts"],"names":[],"mappings":"AAuBA,0FAA0F;AAC1F,MAAM,UAAU,OAAO,CAAC,IAAc,EAAE,OAAe,EAAE,SAAwB,EAAE;IACjF,MAAM,CAAC,GAAY;QACjB,IAAI,EAAE,IAAI,CAAC,EAAE;QACb,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ;QAC1C,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,OAAO;QACP,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,IAAI,CAAC,cAAc;KAC7D,CAAC;IACF,IAAI,MAAM,CAAC,QAAQ;QAAE,CAAC,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAClD,IAAI,MAAM,CAAC,QAAQ;QAAE,CAAC,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAClD,IAAI,IAAI,CAAC,IAAI;QAAE,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IAClC,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,IAAc,EACd,KAAsI;IAEtI,OAAO;QACL,IAAI;QACJ,KAAK,CAAC,GAAG;YACP,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;YAC/E,IAAI,CAAC,MAAM;gBAAE,OAAO,EAAE,CAAC;YACvB,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACnD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,GAAG,CAAI,KAAU,EAAE,GAAG,GAAG,EAAE;IACzC,OAAO,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM,EAAE,iEAAiE;IACzE,QAAQ,EAAE,8DAA8D;IACxE,SAAS,EAAE,wFAAwF;IACnG,UAAU,EAAE,6EAA6E;IACzF,SAAS,EAAE,0EAA0E;IACrF,QAAQ,EAAE,+EAA+E;IACzF,QAAQ,EAAE,sFAAsF;IAChG,MAAM,EAAE,oEAAoE;IAC5E,KAAK,EAAE,6EAA6E;IACpF,cAAc,EAAE,4FAA4F;IAC5G,UAAU,EAAE,8FAA8F;IAC1G,GAAG,EAAE,iCAAiC;IACtC,MAAM,EAAE,uGAAuG;IAC/G,SAAS,EAAE,2EAA2E;IACtF,QAAQ,EAAE,iGAAiG;IAC3G,EAAE,EAAE,iBAAiB;IACrB,OAAO,EAAE,sEAAsE;CACvE,CAAC"}

package/dist/core/rules/social.d.ts

@@ -0,0 +1 @@
+export declare const socialRules: import("./rule.js").Rule[];

package/dist/core/rules/social.js

@@ -0,0 +1,74 @@
+import { normalizeUrl } from '../url.js';
+import { defineRule, GOOGLE_DOCS } from './rule.js';
+const OG_CORE = ['title', 'description', 'image'];
+const OG_RECOMMENDED = ['title', 'description', 'image', 'url', 'type'];
+const TWITTER_CARDS = new Set(['summary', 'summary_large_image', 'app', 'player']);
+export const socialRules = [
+    defineRule({
+        id: 'og.missing',
+        category: 'social',
+        severity: 'warning',
+        description: 'No Open Graph tags (og:title, og:description, og:image) are present.',
+        recommendation: 'Add og:title, og:description, og:image (absolute URL, at least 1200x630), og:url and og:type so shares on social platforms and chat apps render a rich preview.',
+        docs: GOOGLE_DOCS.og,
+    }, ({ page }, make) => (OG_CORE.some((k) => page.og[k]) ? null : make('Page has no Open Graph tags.', { selector: 'head > meta[property^="og:"]' }))),
+    defineRule({
+        id: 'og.incomplete',
+        category: 'social',
+        severity: 'info',
+        description: 'Some Open Graph tags are present but one or more of og:title, og:description, og:image, og:url, og:type is missing.',
+        recommendation: 'Fill in the missing Open Graph properties. og:image and og:description have the biggest effect on share previews.',
+        docs: GOOGLE_DOCS.og,
+    }, ({ page }, make) => {
+        if (!OG_CORE.some((k) => page.og[k]))
+            return null;
+        const missing = OG_RECOMMENDED.filter((k) => !page.og[k]);
+        return missing.length ? make(`Open Graph is missing: ${missing.map((m) => `og:${m}`).join(', ')}.`, { selector: 'head > meta[property^="og:"]', evidence: { missing, present: Object.keys(page.og) } }) : null;
+    }),
+    defineRule({
+        id: 'og.image-not-absolute',
+        category: 'social',
+        severity: 'warning',
+        description: 'og:image is not an absolute URL.',
+        recommendation: 'Use a full https:// URL for og:image; most platforms ignore relative image paths.',
+        docs: GOOGLE_DOCS.og,
+    }, ({ page }, make) => {
+        const img = page.og['image'];
+        return img && !/^https?:\/\//i.test(img) ? make(`og:image "${img}" is not an absolute URL.`, { selector: 'head > meta[property="og:image"]', evidence: { image: img } }) : null;
+    }),
+    defineRule({
+        id: 'og.url-mismatch',
+        category: 'social',
+        severity: 'info',
+        description: 'og:url differs from the canonical URL.',
+        recommendation: 'Set og:url to the same URL as the canonical so share counts and previews consolidate.',
+        docs: GOOGLE_DOCS.og,
+    }, ({ page }, make) => {
+        const ogUrl = page.og['url'];
+        if (!ogUrl || !page.canonical)
+            return null;
+        const a = normalizeUrl(ogUrl);
+        const b = normalizeUrl(page.canonical);
+        return a && b && a !== b ? make('og:url does not match the canonical URL.', { selector: 'head > meta[property="og:url"]', evidence: { ogUrl, canonical: page.canonical } }) : null;
+    }),
+    defineRule({
+        id: 'twitter.card-missing',
+        category: 'social',
+        severity: 'info',
+        description: 'No twitter:card meta tag is present.',
+        recommendation: 'Add <meta name="twitter:card" content="summary_large_image">; X/Twitter falls back to Open Graph for the other fields.',
+        docs: GOOGLE_DOCS.twitter,
+    }, ({ page }, make) => (page.twitter['card'] ? null : make('Page has no twitter:card tag.', { selector: 'head > meta[name="twitter:card"]' }))),
+    defineRule({
+        id: 'twitter.card-invalid',
+        category: 'social',
+        severity: 'warning',
+        description: 'twitter:card has a value other than summary, summary_large_image, app or player.',
+        recommendation: 'Use one of the supported card types, usually summary_large_image.',
+        docs: GOOGLE_DOCS.twitter,
+    }, ({ page }, make) => {
+        const card = page.twitter['card'];
+        return card && !TWITTER_CARDS.has(card.toLowerCase()) ? make(`twitter:card "${card}" is not a valid card type.`, { selector: 'head > meta[name="twitter:card"]', evidence: { card } }) : null;
+    }),
+];
+//# sourceMappingURL=social.js.map

package/dist/core/rules/social.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"social.js","sourceRoot":"","sources":["../../../src/core/rules/social.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAEpD,MAAM,OAAO,GAAG,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAU,CAAC;AAC3D,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAU,CAAC;AACjF,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,qBAAqB,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEnF,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,UAAU,CACR;QACE,EAAE,EAAE,YAAY;QAChB,QAAQ,EAAE,QAAQ;QAClB,QAAQ,EAAE,SAAS;QACnB,WAAW,EAAE,sEAAsE;QACnF,cAAc,EAAE,iKAAiK;QACjL,IAAI,EAAE,WAAW,CAAC,EAAE;KACrB,EACD,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,8BAA8B,EAAE,EAAE,QAAQ,EAAE,8BAA8B,EAAE,CAAC,CAAC,CAClJ;IACD,UAAU,CACR;QACE,EAAE,EAAE,eAAe;QACnB,QAAQ,EAAE,QAAQ;QAClB,QAAQ,EAAE,MAAM;QAChB,WAAW,EAAE,qHAAqH;QAClI,cAAc,EAAE,mHAAmH;QACnI,IAAI,EAAE,WAAW,CAAC,EAAE;KACrB,EACD,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE;QACjB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAClD,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1D,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,0BAA0B,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,8BAA8B,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACjN,CAAC,CACF;IACD,UAAU,CACR;QACE,EAAE,EAAE,uBAAuB;QAC3B,QAAQ,EAAE,QAAQ;QAClB,QAAQ,EAAE,SAAS;QACnB,WAAW,EAAE,kCAAkC;QAC/C,cAAc,EAAE,mFAAmF;QACnG,IAAI,EAAE,WAAW,CAAC,EAAE;KACrB,EACD,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE;QACjB,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;QAC7B,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,GAAG,2BAA2B,EAAE,EAAE,QAAQ,EAAE,kCAAkC,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClL,CAAC,CACF;IACD,UAAU,CACR;QACE,EAAE,EAAE,iBAAiB;QACrB,QAAQ,EAAE,QAAQ;QAClB,QAAQ,EAAE,MAAM;QAChB,WAAW,EAAE,wCAAwC;QACrD,cAAc,EAAE,uFAAuF;QACvG,IAAI,EAAE,WAAW,CAAC,EAAE;KACrB,EACD,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE;QACjB,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QAC3C,MAAM,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QAC9B,MAAM,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACvC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,0CAA0C,EAAE,EAAE,QAAQ,EAAE,gCAAgC,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACrL,CAAC,CACF;IACD,UAAU,CACR;QACE,EAAE,EAAE,sBAAsB;QAC1B,QAAQ,EAAE,QAAQ;QAClB,QAAQ,EAAE,MAAM;QAChB,WAAW,EAAE,sCAAsC;QACnD,cAAc,EAAE,wHAAwH;QACxI,IAAI,EAAE,WAAW,CAAC,OAAO;KAC1B,EACD,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,+BAA+B,EAAE,EAAE,QAAQ,EAAE,kCAAkC,EAAE,CAAC,CAAC,CAC5I;IACD,UAAU,CACR;QACE,EAAE,EAAE,sBAAsB;QAC1B,QAAQ,EAAE,QAAQ;QAClB,QAAQ,EAAE,SAAS;QACnB,WAAW,EAAE,kFAAkF;QAC/F,cAAc,EAAE,mEAAmE;QACnF,IAAI,EAAE,WAAW,CAAC,OAAO;KAC1B,EACD,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,IAAI,6BAA6B,EAAE,EAAE,QAAQ,EAAE,kCAAkC,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAChM,CAAC,CACF;CACF,CAAC"}

package/dist/core/rules/structured-data.d.ts

@@ -0,0 +1,23 @@
+import type { StructuredDataItem } from '../types.js';
+interface SchemaSpec {
+    required: string[];
+    recommended: string[];
+    /** At least one of these groups must be present (each group = list of alternatives). */
+    oneOf?: string[][];
+    docs?: string;
+}
+export declare const SCHEMA_SPECS: Record<string, SchemaSpec>;
+interface Issue {
+    type: string;
+    missing: string[];
+    path: string;
+}
+/** Walk one structured-data item (and nested typed objects) collecting spec violations. */
+export declare function validateItem(item: StructuredDataItem): {
+    required: Issue[];
+    recommended: Issue[];
+    badDates: string[];
+    unknownTypes: string[];
+};
+export declare const structuredDataRules: import("./rule.js").Rule[];
+export {};

package/dist/core/rules/structured-data.js

@@ -0,0 +1,169 @@
+import { typesOf } from '../html/structured-data.js';
+import { cap, defineRule, GOOGLE_DOCS } from './rule.js';
+const G = 'https://developers.google.com/search/docs/appearance/structured-data/';
+const ARTICLE = { required: [], recommended: ['headline', 'image', 'datePublished', 'dateModified', 'author'], docs: `${G}article` };
+export const SCHEMA_SPECS = {
+    Article: ARTICLE,
+    NewsArticle: ARTICLE,
+    BlogPosting: ARTICLE,
+    TechArticle: ARTICLE,
+    Product: { required: ['name'], recommended: ['image', 'description', 'brand', 'sku', 'offers'], oneOf: [['offers', 'review', 'aggregateRating']], docs: `${G}product` },
+    Offer: { required: ['price', 'priceCurrency'], recommended: ['availability', 'url', 'priceValidUntil'], docs: `${G}product` },
+    AggregateOffer: { required: ['lowPrice', 'priceCurrency'], recommended: ['highPrice', 'offerCount'], docs: `${G}product` },
+    Organization: { required: ['name'], recommended: ['url', 'logo', 'sameAs'], docs: `${G}organization` },
+    WebSite: { required: ['name', 'url'], recommended: [], docs: `${G}sitelinks-searchbox` },
+    WebPage: { required: [], recommended: ['name'] },
+    BreadcrumbList: { required: ['itemListElement'], recommended: [], docs: `${G}breadcrumb` },
+    ListItem: { required: ['position'], recommended: ['name', 'item'], docs: `${G}breadcrumb` },
+    ItemList: { required: ['itemListElement'], recommended: [], docs: `${G}carousel` },
+    FAQPage: { required: ['mainEntity'], recommended: [], docs: `${G}faqpage` },
+    Question: { required: ['name', 'acceptedAnswer'], recommended: [], docs: `${G}faqpage` },
+    Answer: { required: ['text'], recommended: [], docs: `${G}faqpage` },
+    LocalBusiness: { required: ['name', 'address'], recommended: ['telephone', 'url', 'image', 'openingHoursSpecification', 'priceRange', 'geo'], docs: `${G}local-business` },
+    Event: { required: ['name', 'startDate', 'location'], recommended: ['endDate', 'description', 'image', 'offers', 'performer', 'organizer', 'eventStatus', 'eventAttendanceMode'], docs: `${G}event` },
+    Recipe: { required: ['name', 'image'], recommended: ['author', 'datePublished', 'description', 'prepTime', 'cookTime', 'totalTime', 'recipeYield', 'recipeIngredient', 'recipeInstructions', 'aggregateRating'], docs: `${G}recipe` },
+    VideoObject: { required: ['name', 'thumbnailUrl', 'uploadDate'], recommended: ['description', 'duration', 'contentUrl', 'embedUrl'], docs: `${G}video` },
+    Person: { required: ['name'], recommended: ['url', 'sameAs', 'jobTitle'] },
+    JobPosting: { required: ['title', 'description', 'datePosted', 'hiringOrganization', 'jobLocation'], recommended: ['validThrough', 'employmentType', 'baseSalary', 'identifier'], docs: `${G}job-posting` },
+    HowTo: { required: ['name', 'step'], recommended: ['image', 'totalTime', 'estimatedCost', 'supply', 'tool'], docs: `${G}how-to` },
+    Review: { required: ['itemReviewed', 'reviewRating', 'author'], recommended: ['datePublished', 'reviewBody'], docs: `${G}review-snippet` },
+    Rating: { required: ['ratingValue'], recommended: ['bestRating', 'worstRating'], docs: `${G}review-snippet` },
+    AggregateRating: { required: ['ratingValue'], recommended: ['bestRating'], oneOf: [['ratingCount', 'reviewCount']], docs: `${G}review-snippet` },
+    SoftwareApplication: { required: ['name'], recommended: ['applicationCategory', 'operatingSystem', 'offers', 'aggregateRating'], oneOf: [['offers', 'aggregateRating']], docs: `${G}software-app` },
+    Course: { required: ['name', 'description', 'provider'], recommended: [], docs: `${G}course` },
+    Dataset: { required: ['name', 'description'], recommended: ['url', 'creator', 'license', 'distribution'], docs: `${G}dataset` },
+    ImageObject: { required: [], recommended: ['contentUrl', 'license', 'creator'], oneOf: [['contentUrl', 'url']], docs: `${G}image-license-metadata` },
+    PostalAddress: { required: [], recommended: ['streetAddress', 'addressLocality', 'postalCode', 'addressCountry'] },
+};
+const DATE_PROPS = new Set(['datePublished', 'dateModified', 'startDate', 'endDate', 'uploadDate', 'datePosted', 'validThrough', 'dateCreated', 'expires']);
+const ISO_DATE = /^\d{4}-\d{2}-\d{2}([T ]\d{2}:\d{2}(:\d{2}(\.\d+)?)?(Z|[+-]\d{2}:?\d{2})?)?$/;
+function isPresent(value) {
+    if (value === null || value === undefined)
+        return false;
+    if (typeof value === 'string')
+        return value.trim().length > 0;
+    if (Array.isArray(value))
+        return value.length > 0;
+    return true;
+}
+/** Walk one structured-data item (and nested typed objects) collecting spec violations. */
+export function validateItem(item) {
+    const required = [];
+    const recommended = [];
+    const badDates = [];
+    const unknownTypes = [];
+    const visited = new Set();
+    const walk = (node, path, depth) => {
+        if (depth > 6 || !node || typeof node !== 'object' || visited.has(node))
+            return;
+        visited.add(node);
+        if (Array.isArray(node)) {
+            node.forEach((n, i) => walk(n, `${path}[${i}]`, depth));
+            return;
+        }
+        const obj = node;
+        const types = typesOf(obj['@type']);
+        for (const type of types) {
+            const spec = SCHEMA_SPECS[type];
+            if (!spec) {
+                unknownTypes.push(type);
+                continue;
+            }
+            const missingReq = spec.required.filter((p) => !isPresent(obj[p]));
+            for (const group of spec.oneOf ?? []) {
+                if (!group.some((p) => isPresent(obj[p])))
+                    missingReq.push(`one of: ${group.join(' | ')}`);
+            }
+            if (missingReq.length)
+                required.push({ type, missing: missingReq, path });
+            const missingRec = spec.recommended.filter((p) => !isPresent(obj[p]));
+            if (missingRec.length)
+                recommended.push({ type, missing: missingRec, path });
+        }
+        for (const [key, value] of Object.entries(obj)) {
+            if (DATE_PROPS.has(key) && typeof value === 'string' && !ISO_DATE.test(value.trim()))
+                badDates.push(`${path ? `${path}.` : ''}${key}="${value}"`);
+            if (value && typeof value === 'object')
+                walk(value, path ? `${path}.${key}` : key, depth + 1);
+        }
+    };
+    walk(item.data, '', 0);
+    return { required, recommended, badDates, unknownTypes };
+}
+export const structuredDataRules = [
+    defineRule({
+        id: 'structured-data.invalid-json',
+        category: 'structured-data',
+        severity: 'error',
+        description: 'A JSON-LD <script> block contains invalid JSON and will be ignored entirely.',
+        recommendation: 'Fix the JSON syntax (trailing commas, unescaped quotes, HTML comments inside the script). Serialise with JSON.stringify instead of hand-writing it.',
+        docs: GOOGLE_DOCS.structuredData,
+    }, ({ page }, make) => page.structuredDataErrors.map((e) => make(`Invalid JSON-LD: ${e.message}`, { selector: 'script[type="application/ld+json"]', evidence: { snippet: e.snippet } }))),
+    defineRule({
+        id: 'structured-data.missing',
+        category: 'structured-data',
+        severity: 'info',
+        description: 'The page has no structured data (JSON-LD or microdata).',
+        recommendation: 'Add JSON-LD for the page type (Article, Product, Organization, BreadcrumbList, FAQPage, ...) to qualify for rich results.',
+        docs: GOOGLE_DOCS.structuredData,
+    }, ({ page }, make) => (page.structuredData.length === 0 && page.structuredDataErrors.length === 0 ? make('Page has no structured data.') : null)),
+    defineRule({
+        id: 'structured-data.missing-context',
+        category: 'structured-data',
+        severity: 'warning',
+        description: 'A JSON-LD item has no @context or a context other than schema.org.',
+        recommendation: 'Set "@context": "https://schema.org" on every top-level JSON-LD object.',
+        docs: GOOGLE_DOCS.structuredData,
+    }, ({ page }, make) => {
+        const bad = page.structuredData.filter((i) => i.source === 'json-ld' && !(i.context ?? '').toLowerCase().includes('schema.org'));
+        return bad.length ? make(`${bad.length} JSON-LD item(s) lack a schema.org @context.`, { selector: 'script[type="application/ld+json"]', evidence: { contexts: cap(bad.map((i) => i.context)), types: cap(bad.flatMap((i) => i.types)) } }) : null;
+    }),
+    defineRule({
+        id: 'structured-data.missing-type',
+        category: 'structured-data',
+        severity: 'warning',
+        description: 'A structured data item has no @type (or itemtype).',
+        recommendation: 'Add "@type" (e.g. "Article") to every structured data object.',
+        docs: GOOGLE_DOCS.structuredData,
+    }, ({ page }, make) => {
+        const bad = page.structuredData.filter((i) => i.types.length === 0);
+        return bad.length ? make(`${bad.length} structured data item(s) have no @type.`, { evidence: { sources: cap(bad.map((i) => i.source)), keys: cap(bad.map((i) => Object.keys(i.data).slice(0, 8))) } }) : null;
+    }),
+    defineRule({
+        id: 'structured-data.missing-required',
+        category: 'structured-data',
+        severity: 'warning',
+        description: 'A structured data item of a known type is missing properties Google requires for rich results.',
+        recommendation: 'Add the missing properties listed in evidence. Validate with https://search.google.com/test/rich-results after fixing.',
+        docs: GOOGLE_DOCS.structuredData,
+    }, ({ page }, make) => page.structuredData.flatMap((item) => {
+        const { required } = validateItem(item);
+        return required.map((iss) => make(`${iss.type} is missing required: ${iss.missing.join(', ')}.`, {
+            selector: item.source === 'json-ld' ? 'script[type="application/ld+json"]' : `[itemtype*="${iss.type}"]`,
+            evidence: { type: iss.type, missing: iss.missing, path: iss.path || '(root)', source: item.source, docs: SCHEMA_SPECS[iss.type]?.docs },
+        }));
+    })),
+    defineRule({
+        id: 'structured-data.missing-recommended',
+        category: 'structured-data',
+        severity: 'info',
+        description: 'A structured data item is missing properties Google recommends for richer results.',
+        recommendation: 'Add the recommended properties where the data exists; they unlock additional rich-result features.',
+        docs: GOOGLE_DOCS.structuredData,
+    }, ({ page }, make) => page.structuredData.flatMap((item) => {
+        const { recommended } = validateItem(item);
+        return recommended.map((iss) => make(`${iss.type} is missing recommended: ${iss.missing.join(', ')}.`, { evidence: { type: iss.type, missing: iss.missing, path: iss.path || '(root)', source: item.source } }));
+    })),
+    defineRule({
+        id: 'structured-data.invalid-date',
+        category: 'structured-data',
+        severity: 'warning',
+        description: 'Date properties in structured data that are not ISO 8601.',
+        recommendation: 'Use ISO 8601 dates such as 2026-03-14 or 2026-03-14T09:30:00+01:00.',
+        docs: GOOGLE_DOCS.structuredData,
+    }, ({ page }, make) => {
+        const bad = page.structuredData.flatMap((i) => validateItem(i).badDates);
+        return bad.length ? make(`${bad.length} structured data date(s) are not ISO 8601.`, { evidence: { examples: cap(bad) } }) : null;
+    }),
+];
+//# sourceMappingURL=structured-data.js.map

package/dist/core/rules/structured-data.js.map

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

package/dist/core/rules/title.d.ts

@@ -0,0 +1 @@
+export declare const titleRules: import("./rule.js").Rule[];

package/dist/core/rules/title.js

@@ -0,0 +1,59 @@
+import { isGenericTitle } from '../html/text.js';
+import { defineRule, GOOGLE_DOCS } from './rule.js';
+export const titleRules = [
+    defineRule({
+        id: 'title.missing',
+        category: 'title',
+        severity: 'error',
+        description: 'The page has no <title> element or it is empty.',
+        recommendation: 'Add a unique, descriptive <title> in <head> (about 30-60 characters) that states what the page is about.',
+        docs: GOOGLE_DOCS.titles,
+    }, ({ page }, make) => (page.title ? null : make('Page has no <title> or the title is empty.', { selector: 'head > title' }))),
+    defineRule({
+        id: 'title.multiple',
+        category: 'title',
+        severity: 'warning',
+        description: 'More than one <title> element is present.',
+        recommendation: 'Keep exactly one <title>. Browsers and crawlers may pick different ones when several exist.',
+        docs: GOOGLE_DOCS.titles,
+    }, ({ page }, make) => page.titles.length > 1
+        ? make(`Page has ${page.titles.length} <title> elements.`, { selector: 'title', evidence: { titles: page.titles } })
+        : null),
+    defineRule({
+        id: 'title.too-long',
+        category: 'title',
+        severity: 'warning',
+        description: 'Title is longer than the configured maximum (default 60 characters) and will be truncated in search results.',
+        recommendation: 'Shorten the title to roughly 60 characters or fewer, keeping the most important words first.',
+        docs: GOOGLE_DOCS.titles,
+    }, ({ page, thresholds }, make) => page.title && page.title.length > thresholds.titleMaxChars
+        ? make(`Title is ${page.title.length} characters (max ${thresholds.titleMaxChars}).`, {
+            selector: 'head > title',
+            evidence: { title: page.title, length: page.title.length, max: thresholds.titleMaxChars },
+        })
+        : null),
+    defineRule({
+        id: 'title.too-short',
+        category: 'title',
+        severity: 'info',
+        description: 'Title is shorter than the configured minimum (default 30 characters).',
+        recommendation: 'Consider a more descriptive title that includes the page topic and, where sensible, the brand.',
+        docs: GOOGLE_DOCS.titles,
+    }, ({ page, thresholds }, make) => page.title && page.title.length < thresholds.titleMinChars
+        ? make(`Title is only ${page.title.length} characters (recommended at least ${thresholds.titleMinChars}).`, {
+            selector: 'head > title',
+            evidence: { title: page.title, length: page.title.length, min: thresholds.titleMinChars },
+        })
+        : null),
+    defineRule({
+        id: 'title.generic',
+        category: 'title',
+        severity: 'warning',
+        description: 'Title is a framework default or placeholder such as "React App", "Create Next App", "Home" or "Untitled".',
+        recommendation: 'Replace the placeholder with a title that describes this page. In frameworks, set it per route (metadata export, <Head>, useHead, <svelte:head>, etc.).',
+        docs: GOOGLE_DOCS.titles,
+    }, ({ page }, make) => page.title && isGenericTitle(page.title)
+        ? make(`Title "${page.title}" looks like a placeholder or framework default.`, { selector: 'head > title', evidence: { title: page.title } })
+        : null),
+];
+//# sourceMappingURL=title.js.map

package/dist/core/rules/title.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"title.js","sourceRoot":"","sources":["../../../src/core/rules/title.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAEpD,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,UAAU,CACR;QACE,EAAE,EAAE,eAAe;QACnB,QAAQ,EAAE,OAAO;QACjB,QAAQ,EAAE,OAAO;QACjB,WAAW,EAAE,iDAAiD;QAC9D,cAAc,EAAE,0GAA0G;QAC1H,IAAI,EAAE,WAAW,CAAC,MAAM;KACzB,EACD,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,4CAA4C,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,CAAC,CAC3H;IACD,UAAU,CACR;QACE,EAAE,EAAE,gBAAgB;QACpB,QAAQ,EAAE,OAAO;QACjB,QAAQ,EAAE,SAAS;QACnB,WAAW,EAAE,2CAA2C;QACxD,cAAc,EAAE,6FAA6F;QAC7G,IAAI,EAAE,WAAW,CAAC,MAAM;KACzB,EACD,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CACjB,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QACpB,CAAC,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,MAAM,CAAC,MAAM,oBAAoB,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QACpH,CAAC,CAAC,IAAI,CACX;IACD,UAAU,CACR;QACE,EAAE,EAAE,gBAAgB;QACpB,QAAQ,EAAE,OAAO;QACjB,QAAQ,EAAE,SAAS;QACnB,WAAW,EAAE,8GAA8G;QAC3H,cAAc,EAAE,8FAA8F;QAC9G,IAAI,EAAE,WAAW,CAAC,MAAM;KACzB,EACD,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,CAC7B,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC,aAAa;QACxD,CAAC,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,KAAK,CAAC,MAAM,oBAAoB,UAAU,CAAC,aAAa,IAAI,EAAE;YAClF,QAAQ,EAAE,cAAc;YACxB,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,CAAC,aAAa,EAAE;SAC1F,CAAC;QACJ,CAAC,CAAC,IAAI,CACX;IACD,UAAU,CACR;QACE,EAAE,EAAE,iBAAiB;QACrB,QAAQ,EAAE,OAAO;QACjB,QAAQ,EAAE,MAAM;QAChB,WAAW,EAAE,uEAAuE;QACpF,cAAc,EAAE,gGAAgG;QAChH,IAAI,EAAE,WAAW,CAAC,MAAM;KACzB,EACD,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,CAC7B,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC,aAAa;QACxD,CAAC,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,KAAK,CAAC,MAAM,qCAAqC,UAAU,CAAC,aAAa,IAAI,EAAE;YACxG,QAAQ,EAAE,cAAc;YACxB,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,CAAC,aAAa,EAAE;SAC1F,CAAC;QACJ,CAAC,CAAC,IAAI,CACX;IACD,UAAU,CACR;QACE,EAAE,EAAE,eAAe;QACnB,QAAQ,EAAE,OAAO;QACjB,QAAQ,EAAE,SAAS;QACnB,WAAW,EAAE,2GAA2G;QACxH,cAAc,EAAE,yJAAyJ;QACzK,IAAI,EAAE,WAAW,CAAC,MAAM;KACzB,EACD,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CACjB,IAAI,CAAC,KAAK,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC;QACtC,CAAC,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK,kDAAkD,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;QAC7I,CAAC,CAAC,IAAI,CACX;CACF,CAAC"}

package/dist/core/score.d.ts

@@ -0,0 +1,3 @@
+import type { Finding, PageAudit, SeverityCounts } from './types.js';
+export declare function pageScore(counts: SeverityCounts): number;
+export declare function siteScore(pages: PageAudit[], siteFindings: Finding[]): number;

package/dist/core/score.js

@@ -0,0 +1,15 @@
+const PAGE_WEIGHTS = { error: 15, warning: 5, info: 1 };
+const SITE_WEIGHTS = { error: 10, warning: 3, info: 0.5 };
+export function pageScore(counts) {
+    const deduction = counts.error * PAGE_WEIGHTS.error + counts.warning * PAGE_WEIGHTS.warning + counts.info * PAGE_WEIGHTS.info;
+    return clamp(Math.round(100 - deduction));
+}
+export function siteScore(pages, siteFindings) {
+    const avg = pages.length ? pages.reduce((sum, p) => sum + p.score, 0) / pages.length : 100;
+    const deduction = siteFindings.reduce((sum, f) => sum + SITE_WEIGHTS[f.severity], 0);
+    return clamp(Math.round(avg - deduction));
+}
+function clamp(n) {
+    return Math.max(0, Math.min(100, n));
+}
+//# sourceMappingURL=score.js.map

package/dist/core/score.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.js","sourceRoot":"","sources":["../../src/core/score.ts"],"names":[],"mappings":"AAEA,MAAM,YAAY,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAW,CAAC;AACjE,MAAM,YAAY,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAW,CAAC;AAEnE,MAAM,UAAU,SAAS,CAAC,MAAsB;IAC9C,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,GAAG,YAAY,CAAC,KAAK,GAAG,MAAM,CAAC,OAAO,GAAG,YAAY,CAAC,OAAO,GAAG,MAAM,CAAC,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC;IAC9H,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAkB,EAAE,YAAuB;IACnE,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;IAC3F,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IACrF,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,KAAK,CAAC,CAAS;IACtB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC"}