@answerable-kit/audit 0.1.0

package/dist/checks/e1-review-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"e1-review-profile.js","sourceRoot":"","sources":["../../src/checks/e1-review-profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,MAAM,YAAY,GAAG;IACnB,QAAQ;IACR,iBAAiB;IACjB,cAAc;IACd,gBAAgB;IAChB,eAAe;IACf,oBAAoB;IACpB,YAAY;CACJ,CAAC;AAEX,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAW;IACnD,EAAE,EAAE,IAAI;IACR,QAAQ,EAAE,mBAAmB;IAC7B,QAAQ,EAAE,QAAQ;IAClB,MAAM,EAAE,CAAC;IACT,WAAW,EAAE,0EAA0E;IACvF,SAAS,EACP,+MAA+M;IACjN,OAAO,EAAE,uCAAuC;IAChD,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;QACf,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE;YAC5B,MAAM,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACxC,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;gBAChC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;oBACtC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACpB,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO;gBACL,MAAM,EAAE,MAAM;gBACd,iBAAiB,EAAE,kCAAkC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,iEAAiE;aAC1J,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,0BAA0B,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;IAC3F,CAAC;CACF,CAAC,CAAC"}

package/dist/checks/e10-same-as-three.d.ts

@@ -0,0 +1,2 @@
+export declare const e10SameAsThree: import("@answerable-kit/core").Check<import("cheerio").CheerioAPI>;
+//# sourceMappingURL=e10-same-as-three.d.ts.map

package/dist/checks/e10-same-as-three.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"e10-same-as-three.d.ts","sourceRoot":"","sources":["../../src/checks/e10-same-as-three.ts"],"names":[],"mappings":"AA0CA,eAAO,MAAM,cAAc,oEAuCzB,CAAC"}

package/dist/checks/e10-same-as-three.js

@@ -0,0 +1,81 @@
+import { defineCheck } from '@answerable-kit/core';
+const MIN_SAME_AS = 3;
+/**
+ * Recursively walk a JSON-LD value looking for an `Organization` node
+ * (plain object, member of an array, or nested under `@graph`) and
+ * return its `sameAs` value as a string[]. The first Organization
+ * with a non-empty sameAs wins.
+ */
+function findSameAs(parsed) {
+    if (Array.isArray(parsed)) {
+        for (const item of parsed) {
+            const out = findSameAs(item);
+            if (out.length > 0)
+                return out;
+        }
+        return [];
+    }
+    if (parsed === null || typeof parsed !== 'object')
+        return [];
+    const node = parsed;
+    const typeField = node['@type'];
+    const isOrg = typeField === 'Organization' ||
+        (Array.isArray(typeField) && typeField.includes('Organization'));
+    if (isOrg) {
+        const sameAs = node.sameAs;
+        if (Array.isArray(sameAs)) {
+            return sameAs.filter((v) => typeof v === 'string');
+        }
+        if (typeof sameAs === 'string')
+            return [sameAs];
+    }
+    const graph = node['@graph'];
+    if (Array.isArray(graph)) {
+        for (const child of graph) {
+            const out = findSameAs(child);
+            if (out.length > 0)
+                return out;
+        }
+    }
+    return [];
+}
+export const e10SameAsThree = defineCheck({
+    id: 'E10',
+    category: 'offsite-citations',
+    severity: 'medium',
+    points: 2,
+    description: 'Organization JSON-LD sameAs has ≥3 authoritative profile URLs',
+    rationale: 'The sameAs property on Organization JSON-LD is the most direct entity-graph signal you control. Three or more authoritative profiles (Twitter, LinkedIn, GitHub, Wikipedia, Crunchbase) ties your brand into the wider knowledge graph.',
+    docsUrl: 'https://answerable.dev/docs/checks/E10',
+    run: ({ dom }) => {
+        let best = [];
+        dom('script[type="application/ld+json"]').each((_, el) => {
+            const raw = dom(el).text();
+            try {
+                const parsed = JSON.parse(raw);
+                const sameAs = findSameAs(parsed);
+                if (sameAs.length > best.length) {
+                    best = sameAs;
+                }
+            }
+            catch {
+                // Invalid JSON handled by C1.
+            }
+        });
+        if (best.length === 0) {
+            return {
+                status: 'fail',
+                fixRecommendation: `Add a sameAs array to your Organization JSON-LD with ≥${MIN_SAME_AS} authoritative profile URLs. Use organization({ sameAs: [...] }) from @answerable-kit/schemas.`,
+            };
+        }
+        if (best.length < MIN_SAME_AS) {
+            return {
+                status: 'warn',
+                evidence: `sameAs has ${best.length} entr${best.length === 1 ? 'y' : 'ies'} (need ≥${MIN_SAME_AS})`,
+                fixRecommendation: `Add more sameAs URLs (target ≥${MIN_SAME_AS}). Common picks: Twitter/X, LinkedIn, GitHub, Wikipedia.`,
+            };
+        }
+        return { status: 'pass', evidence: `sameAs has ${best.length} entries` };
+    },
+});
+//# sourceMappingURL=e10-same-as-three.js.map

package/dist/checks/e10-same-as-three.js.map

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

package/dist/checks/e11-linkedin-linked.d.ts

@@ -0,0 +1,2 @@
+export declare const e11LinkedinLinked: import("@answerable-kit/core").Check<import("cheerio").CheerioAPI>;
+//# sourceMappingURL=e11-linkedin-linked.d.ts.map

package/dist/checks/e11-linkedin-linked.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"e11-linkedin-linked.d.ts","sourceRoot":"","sources":["../../src/checks/e11-linkedin-linked.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,iBAAiB,oEAuB5B,CAAC"}

package/dist/checks/e11-linkedin-linked.js

@@ -0,0 +1,24 @@
+import { defineCheck } from '@answerable-kit/core';
+export const e11LinkedinLinked = defineCheck({
+    id: 'E11',
+    category: 'offsite-citations',
+    severity: 'low',
+    points: 1,
+    description: 'LinkedIn company or personal profile linked',
+    rationale: 'LinkedIn is the highest-authority "who works here" signal. For B2B-leaning products, a LinkedIn link in the footer or About page improves entity-graph completeness with minimal effort.',
+    docsUrl: 'https://answerable.dev/docs/checks/E11',
+    run: ({ dom }) => {
+        const links = dom('a[href]').filter((_, el) => {
+            const href = (dom(el).attr('href') ?? '').toLowerCase();
+            return href.includes('linkedin.com');
+        });
+        if (links.length === 0) {
+            return {
+                status: 'warn',
+                fixRecommendation: 'Link your LinkedIn company or personal profile from the footer or About page.',
+            };
+        }
+        return { status: 'pass', evidence: `${links.length} linkedin.com link(s)` };
+    },
+});
+//# sourceMappingURL=e11-linkedin-linked.js.map

package/dist/checks/e11-linkedin-linked.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"e11-linkedin-linked.js","sourceRoot":"","sources":["../../src/checks/e11-linkedin-linked.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAAW;IACrD,EAAE,EAAE,KAAK;IACT,QAAQ,EAAE,mBAAmB;IAC7B,QAAQ,EAAE,KAAK;IACf,MAAM,EAAE,CAAC;IACT,WAAW,EAAE,6CAA6C;IAC1D,SAAS,EACP,0LAA0L;IAC5L,OAAO,EAAE,wCAAwC;IACjD,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;QACf,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE;YAC5C,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;YACxD,OAAO,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QACH,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO;gBACL,MAAM,EAAE,MAAM;gBACd,iBAAiB,EACf,+EAA+E;aAClF,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC,MAAM,uBAAuB,EAAE,CAAC;IAC9E,CAAC;CACF,CAAC,CAAC"}

package/dist/checks/e7-github-linked.d.ts

@@ -0,0 +1,2 @@
+export declare const e7GithubLinked: import("@answerable-kit/core").Check<import("cheerio").CheerioAPI>;
+//# sourceMappingURL=e7-github-linked.d.ts.map

package/dist/checks/e7-github-linked.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"e7-github-linked.d.ts","sourceRoot":"","sources":["../../src/checks/e7-github-linked.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,cAAc,oEAuBzB,CAAC"}

package/dist/checks/e7-github-linked.js

@@ -0,0 +1,24 @@
+import { defineCheck } from '@answerable-kit/core';
+export const e7GithubLinked = defineCheck({
+    id: 'E7',
+    category: 'offsite-citations',
+    severity: 'medium',
+    points: 2,
+    description: 'GitHub profile / repository linked from the page',
+    rationale: 'For technical products, GitHub is the canonical proof-of-work surface. A visible GitHub link tells AI engines (and developer users) you ship real code; absence is a soft red flag for any dev-tools product.',
+    docsUrl: 'https://answerable.dev/docs/checks/E7',
+    run: ({ dom }) => {
+        const links = dom('a[href]').filter((_, el) => {
+            const href = (dom(el).attr('href') ?? '').toLowerCase();
+            return href.includes('github.com');
+        });
+        if (links.length === 0) {
+            return {
+                status: 'warn',
+                fixRecommendation: "Link your GitHub from somewhere visible (footer or 'About' page). Skip this check for non-technical products by setting the audit to ignore E7.",
+            };
+        }
+        return { status: 'pass', evidence: `${links.length} github.com link(s)` };
+    },
+});
+//# sourceMappingURL=e7-github-linked.js.map

package/dist/checks/e7-github-linked.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"e7-github-linked.js","sourceRoot":"","sources":["../../src/checks/e7-github-linked.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAW;IAClD,EAAE,EAAE,IAAI;IACR,QAAQ,EAAE,mBAAmB;IAC7B,QAAQ,EAAE,QAAQ;IAClB,MAAM,EAAE,CAAC;IACT,WAAW,EAAE,kDAAkD;IAC/D,SAAS,EACP,+MAA+M;IACjN,OAAO,EAAE,uCAAuC;IAChD,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;QACf,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE;YAC5C,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;YACxD,OAAO,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QACH,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO;gBACL,MAAM,EAAE,MAAM;gBACd,iBAAiB,EACf,iJAAiJ;aACpJ,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC,MAAM,qBAAqB,EAAE,CAAC;IAC5E,CAAC;CACF,CAAC,CAAC"}

package/dist/checks/f1-og-title.d.ts

@@ -0,0 +1,2 @@
+export declare const f1OgTitle: import("@answerable-kit/core").Check<import("cheerio").CheerioAPI>;
+//# sourceMappingURL=f1-og-title.d.ts.map

package/dist/checks/f1-og-title.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"f1-og-title.d.ts","sourceRoot":"","sources":["../../src/checks/f1-og-title.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,SAAS,oEAoBpB,CAAC"}

package/dist/checks/f1-og-title.js

@@ -0,0 +1,21 @@
+import { defineCheck } from '@answerable-kit/core';
+export const f1OgTitle = defineCheck({
+    id: 'F1',
+    category: 'og-and-social',
+    severity: 'high',
+    points: 1,
+    description: 'og:title set',
+    rationale: 'Open Graph title is what appears when your page is shared on Facebook, LinkedIn, Slack, iMessage, and dozens of other platforms. Without it, those platforms fall back to the <title> tag — which often differs from how you want the shared link to read.',
+    docsUrl: 'https://answerable.dev/docs/checks/F1',
+    run: ({ dom }) => {
+        const content = dom('meta[property="og:title"]').attr('content')?.trim() ?? '';
+        if (!content) {
+            return {
+                status: 'fail',
+                fixRecommendation: 'Add <meta property="og:title" content="..."> inside <head>. defineSeo() emits this automatically.',
+            };
+        }
+        return { status: 'pass', evidence: `og:title="${content}"` };
+    },
+});
+//# sourceMappingURL=f1-og-title.js.map

package/dist/checks/f1-og-title.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"f1-og-title.js","sourceRoot":"","sources":["../../src/checks/f1-og-title.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAW;IAC7C,EAAE,EAAE,IAAI;IACR,QAAQ,EAAE,eAAe;IACzB,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,CAAC;IACT,WAAW,EAAE,cAAc;IAC3B,SAAS,EACP,4PAA4P;IAC9P,OAAO,EAAE,uCAAuC;IAChD,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;QACf,MAAM,OAAO,GAAG,GAAG,CAAC,2BAA2B,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC/E,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,MAAM,EAAE,MAAM;gBACd,iBAAiB,EACf,mGAAmG;aACtG,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,OAAO,GAAG,EAAE,CAAC;IAC/D,CAAC;CACF,CAAC,CAAC"}

package/dist/checks/f2-og-description.d.ts

@@ -0,0 +1,2 @@
+export declare const f2OgDescription: import("@answerable-kit/core").Check<import("cheerio").CheerioAPI>;
+//# sourceMappingURL=f2-og-description.d.ts.map

package/dist/checks/f2-og-description.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"f2-og-description.d.ts","sourceRoot":"","sources":["../../src/checks/f2-og-description.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,eAAe,oEAoB1B,CAAC"}

package/dist/checks/f2-og-description.js

@@ -0,0 +1,21 @@
+import { defineCheck } from '@answerable-kit/core';
+export const f2OgDescription = defineCheck({
+    id: 'F2',
+    category: 'og-and-social',
+    severity: 'high',
+    points: 1,
+    description: 'og:description set',
+    rationale: 'Open Graph description is the body text underneath the link preview when your page is shared. Without it, social platforms either pull from meta description (if you have one) or leave the snippet blank — which kills click-through.',
+    docsUrl: 'https://answerable.dev/docs/checks/F2',
+    run: ({ dom }) => {
+        const content = dom('meta[property="og:description"]').attr('content')?.trim() ?? '';
+        if (!content) {
+            return {
+                status: 'fail',
+                fixRecommendation: 'Add <meta property="og:description" content="..."> inside <head>. defineSeo() emits this automatically.',
+            };
+        }
+        return { status: 'pass', evidence: `og:description="${content}"` };
+    },
+});
+//# sourceMappingURL=f2-og-description.js.map

package/dist/checks/f2-og-description.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"f2-og-description.js","sourceRoot":"","sources":["../../src/checks/f2-og-description.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAW;IACnD,EAAE,EAAE,IAAI;IACR,QAAQ,EAAE,eAAe;IACzB,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,CAAC;IACT,WAAW,EAAE,oBAAoB;IACjC,SAAS,EACP,wOAAwO;IAC1O,OAAO,EAAE,uCAAuC;IAChD,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;QACf,MAAM,OAAO,GAAG,GAAG,CAAC,iCAAiC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACrF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,MAAM,EAAE,MAAM;gBACd,iBAAiB,EACf,yGAAyG;aAC5G,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,OAAO,GAAG,EAAE,CAAC;IACrE,CAAC;CACF,CAAC,CAAC"}

package/dist/checks/f3-og-image.d.ts

@@ -0,0 +1,2 @@
+export declare const f3OgImage: import("@answerable-kit/core").Check<import("cheerio").CheerioAPI>;
+//# sourceMappingURL=f3-og-image.d.ts.map

package/dist/checks/f3-og-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"f3-og-image.d.ts","sourceRoot":"","sources":["../../src/checks/f3-og-image.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,SAAS,oEA4BpB,CAAC"}

package/dist/checks/f3-og-image.js

@@ -0,0 +1,28 @@
+import { defineCheck } from '@answerable-kit/core';
+export const f3OgImage = defineCheck({
+    id: 'F3',
+    category: 'og-and-social',
+    severity: 'high',
+    points: 2,
+    description: 'og:image declared with an absolute http(s) URL',
+    rationale: 'The Open Graph image is the single biggest driver of social-share click-through. A 1200×630 dedicated image roughly triples engagement vs no image. Relative URLs are valid spec but crawled inconsistently — Facebook and LinkedIn both prefer absolute.',
+    docsUrl: 'https://answerable.dev/docs/checks/F3',
+    run: ({ dom }) => {
+        const content = dom('meta[property="og:image"]').attr('content')?.trim() ?? '';
+        if (!content) {
+            return {
+                status: 'fail',
+                fixRecommendation: 'Add <meta property="og:image" content="https://example.com/og.png">. Target 1200×630 px.',
+            };
+        }
+        if (!/^https?:\/\//i.test(content)) {
+            return {
+                status: 'warn',
+                evidence: `og:image="${content}" (relative)`,
+                fixRecommendation: 'Use an absolute https URL for og:image. Facebook and LinkedIn crawlers handle absolute paths most reliably.',
+            };
+        }
+        return { status: 'pass', evidence: `og:image="${content}"` };
+    },
+});
+//# sourceMappingURL=f3-og-image.js.map

package/dist/checks/f3-og-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"f3-og-image.js","sourceRoot":"","sources":["../../src/checks/f3-og-image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAW;IAC7C,EAAE,EAAE,IAAI;IACR,QAAQ,EAAE,eAAe;IACzB,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,CAAC;IACT,WAAW,EAAE,gDAAgD;IAC7D,SAAS,EACP,2PAA2P;IAC7P,OAAO,EAAE,uCAAuC;IAChD,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;QACf,MAAM,OAAO,GAAG,GAAG,CAAC,2BAA2B,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC/E,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,MAAM,EAAE,MAAM;gBACd,iBAAiB,EACf,0FAA0F;aAC7F,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACnC,OAAO;gBACL,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,aAAa,OAAO,cAAc;gBAC5C,iBAAiB,EACf,6GAA6G;aAChH,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,OAAO,GAAG,EAAE,CAAC;IAC/D,CAAC;CACF,CAAC,CAAC"}

package/dist/checks/f5-og-url.d.ts

@@ -0,0 +1,2 @@
+export declare const f5OgUrl: import("@answerable-kit/core").Check<import("cheerio").CheerioAPI>;
+//# sourceMappingURL=f5-og-url.d.ts.map

package/dist/checks/f5-og-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"f5-og-url.d.ts","sourceRoot":"","sources":["../../src/checks/f5-og-url.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,OAAO,oEA2BlB,CAAC"}

package/dist/checks/f5-og-url.js

@@ -0,0 +1,28 @@
+import { defineCheck } from '@answerable-kit/core';
+export const f5OgUrl = defineCheck({
+    id: 'F5',
+    category: 'og-and-social',
+    severity: 'medium',
+    points: 1,
+    description: 'og:url declared as the canonical absolute URL',
+    rationale: "og:url lets social platforms know which canonical URL to associate share counts and link metadata with. Without it, the same page reachable via UTM-tagged links accumulates separate share counts. Should match the page's canonical link.",
+    docsUrl: 'https://answerable.dev/docs/checks/F5',
+    run: ({ dom }) => {
+        const content = dom('meta[property="og:url"]').attr('content')?.trim() ?? '';
+        if (!content) {
+            return {
+                status: 'fail',
+                fixRecommendation: 'Add <meta property="og:url" content="https://example.com/page">. Should match the canonical link.',
+            };
+        }
+        if (!/^https?:\/\//i.test(content)) {
+            return {
+                status: 'warn',
+                evidence: `og:url="${content}" (relative)`,
+                fixRecommendation: 'Use an absolute https URL for og:url.',
+            };
+        }
+        return { status: 'pass', evidence: `og:url="${content}"` };
+    },
+});
+//# sourceMappingURL=f5-og-url.js.map

package/dist/checks/f5-og-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"f5-og-url.js","sourceRoot":"","sources":["../../src/checks/f5-og-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,MAAM,CAAC,MAAM,OAAO,GAAG,WAAW,CAAW;IAC3C,EAAE,EAAE,IAAI;IACR,QAAQ,EAAE,eAAe;IACzB,QAAQ,EAAE,QAAQ;IAClB,MAAM,EAAE,CAAC;IACT,WAAW,EAAE,+CAA+C;IAC5D,SAAS,EACP,6OAA6O;IAC/O,OAAO,EAAE,uCAAuC;IAChD,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;QACf,MAAM,OAAO,GAAG,GAAG,CAAC,yBAAyB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC7E,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,MAAM,EAAE,MAAM;gBACd,iBAAiB,EACf,mGAAmG;aACtG,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACnC,OAAO;gBACL,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,WAAW,OAAO,cAAc;gBAC1C,iBAAiB,EAAE,uCAAuC;aAC3D,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,OAAO,GAAG,EAAE,CAAC;IAC7D,CAAC;CACF,CAAC,CAAC"}

package/dist/checks/f6-twitter-card.d.ts

@@ -0,0 +1,2 @@
+export declare const f6TwitterCard: import("@answerable-kit/core").Check<import("cheerio").CheerioAPI>;
+//# sourceMappingURL=f6-twitter-card.d.ts.map

package/dist/checks/f6-twitter-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"f6-twitter-card.d.ts","sourceRoot":"","sources":["../../src/checks/f6-twitter-card.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,aAAa,oEA2BxB,CAAC"}

package/dist/checks/f6-twitter-card.js

@@ -0,0 +1,29 @@
+import { defineCheck } from '@answerable-kit/core';
+const VALID_CARDS = new Set(['summary', 'summary_large_image', 'app', 'player']);
+export const f6TwitterCard = defineCheck({
+    id: 'F6',
+    category: 'og-and-social',
+    severity: 'high',
+    points: 1,
+    description: 'twitter:card set to a recognised card type',
+    rationale: 'twitter:card controls how the page renders when shared on X (Twitter). Without it, the platform falls back to a tiny text-only card. `summary_large_image` is the default people actually want — full-bleed image and prominent title.',
+    docsUrl: 'https://answerable.dev/docs/checks/F6',
+    run: ({ dom }) => {
+        const content = dom('meta[name="twitter:card"]').attr('content')?.trim().toLowerCase() ?? '';
+        if (!content) {
+            return {
+                status: 'fail',
+                fixRecommendation: 'Add <meta name="twitter:card" content="summary_large_image"> inside <head>.',
+            };
+        }
+        if (!VALID_CARDS.has(content)) {
+            return {
+                status: 'warn',
+                evidence: `twitter:card="${content}"`,
+                fixRecommendation: `Use one of: summary, summary_large_image, app, player. Got "${content}".`,
+            };
+        }
+        return { status: 'pass', evidence: `twitter:card="${content}"` };
+    },
+});
+//# sourceMappingURL=f6-twitter-card.js.map

package/dist/checks/f6-twitter-card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"f6-twitter-card.js","sourceRoot":"","sources":["../../src/checks/f6-twitter-card.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,qBAAqB,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEjF,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAW;IACjD,EAAE,EAAE,IAAI;IACR,QAAQ,EAAE,eAAe;IACzB,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,CAAC;IACT,WAAW,EAAE,4CAA4C;IACzD,SAAS,EACP,wOAAwO;IAC1O,OAAO,EAAE,uCAAuC;IAChD,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;QACf,MAAM,OAAO,GAAG,GAAG,CAAC,2BAA2B,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;QAC7F,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,MAAM,EAAE,MAAM;gBACd,iBAAiB,EACf,6EAA6E;aAChF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,OAAO;gBACL,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,iBAAiB,OAAO,GAAG;gBACrC,iBAAiB,EAAE,+DAA+D,OAAO,IAAI;aAC9F,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,OAAO,GAAG,EAAE,CAAC;IACnE,CAAC;CACF,CAAC,CAAC"}

package/dist/checks/f7-twitter-image.d.ts

@@ -0,0 +1,2 @@
+export declare const f7TwitterImage: import("@answerable-kit/core").Check<import("cheerio").CheerioAPI>;
+//# sourceMappingURL=f7-twitter-image.d.ts.map

package/dist/checks/f7-twitter-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"f7-twitter-image.d.ts","sourceRoot":"","sources":["../../src/checks/f7-twitter-image.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,cAAc,oEAgCzB,CAAC"}

package/dist/checks/f7-twitter-image.js

@@ -0,0 +1,33 @@
+import { defineCheck } from '@answerable-kit/core';
+export const f7TwitterImage = defineCheck({
+    id: 'F7',
+    category: 'og-and-social',
+    severity: 'medium',
+    points: 1,
+    description: 'twitter:image declared (or og:image fallback acceptable)',
+    rationale: 'X (Twitter) falls back to og:image when twitter:image is missing, which is fine for most cases. Set a dedicated twitter:image only when the share preview should differ from the OG image (e.g. text-optimised crop for the 2:1 Twitter aspect).',
+    docsUrl: 'https://answerable.dev/docs/checks/F7',
+    run: ({ dom }) => {
+        const twitterImage = dom('meta[name="twitter:image"]').attr('content')?.trim();
+        if (twitterImage !== undefined && twitterImage !== '') {
+            if (!/^https?:\/\//i.test(twitterImage)) {
+                return {
+                    status: 'warn',
+                    evidence: `twitter:image="${twitterImage}" (relative)`,
+                    fixRecommendation: 'Use an absolute https URL for twitter:image.',
+                };
+            }
+            return { status: 'pass', evidence: `twitter:image="${twitterImage}"` };
+        }
+        // Twitter falls back to og:image when twitter:image is missing — acceptable.
+        const ogImage = dom('meta[property="og:image"]').attr('content')?.trim();
+        if (ogImage !== undefined && ogImage !== '') {
+            return { status: 'pass', evidence: 'Falls back to og:image' };
+        }
+        return {
+            status: 'fail',
+            fixRecommendation: 'Add <meta name="twitter:image" content="https://example.com/og.png"> or set og:image as the fallback.',
+        };
+    },
+});
+//# sourceMappingURL=f7-twitter-image.js.map

package/dist/checks/f7-twitter-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"f7-twitter-image.js","sourceRoot":"","sources":["../../src/checks/f7-twitter-image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAW;IAClD,EAAE,EAAE,IAAI;IACR,QAAQ,EAAE,eAAe;IACzB,QAAQ,EAAE,QAAQ;IAClB,MAAM,EAAE,CAAC;IACT,WAAW,EAAE,0DAA0D;IACvE,SAAS,EACP,kPAAkP;IACpP,OAAO,EAAE,uCAAuC;IAChD,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;QACf,MAAM,YAAY,GAAG,GAAG,CAAC,4BAA4B,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;QAC/E,IAAI,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,EAAE,EAAE,CAAC;YACtD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;gBACxC,OAAO;oBACL,MAAM,EAAE,MAAM;oBACd,QAAQ,EAAE,kBAAkB,YAAY,cAAc;oBACtD,iBAAiB,EAAE,8CAA8C;iBAClE,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,YAAY,GAAG,EAAE,CAAC;QACzE,CAAC;QACD,6EAA6E;QAC7E,MAAM,OAAO,GAAG,GAAG,CAAC,2BAA2B,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;QACzE,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;YAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,wBAAwB,EAAE,CAAC;QAChE,CAAC;QACD,OAAO;YACL,MAAM,EAAE,MAAM;YACd,iBAAiB,EACf,uGAAuG;SAC1G,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/checks/registry.d.ts

@@ -0,0 +1,10 @@
+import type { Check } from '@answerable-kit/core';
+import type { AuditDom } from '../parser.js';
+/**
+ * Every check registered with the audit engine, in stable AUDIT-FRAMEWORK
+ * order. Subsequent PRs append to this list — never reorder, never
+ * renumber. Stable IDs (`A1`, `A3`, ...) are part of the public API
+ * (users pin `--ignore A4` in CI).
+ */
+export declare const DEFAULT_CHECKS: readonly Check<AuditDom>[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/checks/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/checks/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAmC7C;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,KAAK,CAAC,QAAQ,CAAC,EAkCpD,CAAC"}

package/dist/checks/registry.js

@@ -0,0 +1,75 @@
+import { a1Title } from './a1-title.js';
+import { a3Description } from './a3-description.js';
+import { a4Canonical } from './a4-canonical.js';
+import { a5HtmlLang } from './a5-html-lang.js';
+import { a6Viewport } from './a6-viewport.js';
+import { a7Charset } from './a7-charset.js';
+import { a8Robots } from './a8-robots.js';
+import { a9Favicon } from './a9-favicon.js';
+import { a10AppleTouchIcon } from './a10-apple-touch.js';
+import { b1SingleH1 } from './b1-single-h1.js';
+import { b3HeadingHierarchy } from './b3-heading-hierarchy.js';
+import { b4H2Sections } from './b4-h2-sections.js';
+import { b8ExternalCitations } from './b8-external-citations.js';
+import { b11InternalLinks } from './b11-internal-links.js';
+import { b14ListsOrTables } from './b14-lists-or-tables.js';
+import { c1JsonLd } from './c1-json-ld.js';
+import { c2Organization } from './c2-organization.js';
+import { d1AboutPageLinked } from './d1-about-page-linked.js';
+import { d2PrivacyLinked } from './d2-privacy-linked.js';
+import { d3TermsLinked } from './d3-terms-linked.js';
+import { d4ContactAccessible } from './d4-contact-accessible.js';
+import { d5ChromeTrustLink } from './d5-chrome-trust-link.js';
+import { d6FooterTrustLinks } from './d6-footer-trust-links.js';
+import { e1ReviewProfile } from './e1-review-profile.js';
+import { e7GithubLinked } from './e7-github-linked.js';
+import { e10SameAsThree } from './e10-same-as-three.js';
+import { e11LinkedinLinked } from './e11-linkedin-linked.js';
+import { f1OgTitle } from './f1-og-title.js';
+import { f2OgDescription } from './f2-og-description.js';
+import { f3OgImage } from './f3-og-image.js';
+import { f5OgUrl } from './f5-og-url.js';
+import { f6TwitterCard } from './f6-twitter-card.js';
+import { f7TwitterImage } from './f7-twitter-image.js';
+/**
+ * Every check registered with the audit engine, in stable AUDIT-FRAMEWORK
+ * order. Subsequent PRs append to this list — never reorder, never
+ * renumber. Stable IDs (`A1`, `A3`, ...) are part of the public API
+ * (users pin `--ignore A4` in CI).
+ */
+export const DEFAULT_CHECKS = [
+    a1Title,
+    a3Description,
+    a4Canonical,
+    a5HtmlLang,
+    a6Viewport,
+    a7Charset,
+    a8Robots,
+    a9Favicon,
+    a10AppleTouchIcon,
+    b1SingleH1,
+    b3HeadingHierarchy,
+    b4H2Sections,
+    b8ExternalCitations,
+    b11InternalLinks,
+    b14ListsOrTables,
+    c1JsonLd,
+    c2Organization,
+    d1AboutPageLinked,
+    d2PrivacyLinked,
+    d3TermsLinked,
+    d4ContactAccessible,
+    d5ChromeTrustLink,
+    d6FooterTrustLinks,
+    e1ReviewProfile,
+    e7GithubLinked,
+    e10SameAsThree,
+    e11LinkedinLinked,
+    f1OgTitle,
+    f2OgDescription,
+    f3OgImage,
+    f5OgUrl,
+    f6TwitterCard,
+    f7TwitterImage,
+];
+//# sourceMappingURL=registry.js.map

package/dist/checks/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/checks/registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAA+B;IACxD,OAAO;IACP,aAAa;IACb,WAAW;IACX,UAAU;IACV,UAAU;IACV,SAAS;IACT,QAAQ;IACR,SAAS;IACT,iBAAiB;IACjB,UAAU;IACV,kBAAkB;IAClB,YAAY;IACZ,mBAAmB;IACnB,gBAAgB;IAChB,gBAAgB;IAChB,QAAQ;IACR,cAAc;IACd,iBAAiB;IACjB,eAAe;IACf,aAAa;IACb,mBAAmB;IACnB,iBAAiB;IACjB,kBAAkB;IAClB,eAAe;IACf,cAAc;IACd,cAAc;IACd,iBAAiB;IACjB,SAAS;IACT,eAAe;IACf,SAAS;IACT,OAAO;IACP,aAAa;IACb,cAAc;CACf,CAAC"}

package/dist/crawler.d.ts

@@ -0,0 +1,40 @@
+import { AnswerableError } from '@answerable-kit/core';
+import { type AuditDom } from './parser.js';
+export declare const DEFAULT_USER_AGENT = "Answerable/0.0.0 (+https://github.com/Anuj7411/answerable)";
+export declare const DEFAULT_TIMEOUT_MS = 15000;
+export interface FetchAndParseOptions {
+    readonly userAgent?: string;
+    readonly timeoutMs?: number;
+    /** Test-injection seam. Defaults to the global `fetch`. */
+    readonly fetchImpl?: typeof fetch;
+}
+export interface FetchAndParseResult {
+    readonly url: string;
+    readonly finalUrl: string;
+    readonly status: number;
+    readonly html: string;
+    readonly dom: AuditDom;
+}
+/**
+ * Thrown when the crawler can't reach the target URL or the response
+ * isn't a 2xx with HTML-shaped content.
+ */
+export declare class CrawlError extends AnswerableError {
+    readonly url: string;
+    readonly httpStatus: number | undefined;
+    constructor(message: string, options: {
+        readonly url: string;
+        readonly status?: number;
+        readonly cause?: unknown;
+    });
+}
+/**
+ * Fetch a URL and parse the response into a cheerio DOM. Follows
+ * redirects (delegated to native fetch). Sets a polite User-Agent.
+ * Throws `CrawlError` on network failure or non-2xx response.
+ *
+ * @throws InvalidUrlError if `url` is not a valid absolute http(s) URL.
+ * @throws CrawlError on network failure, timeout, or non-2xx response.
+ */
+export declare function fetchAndParse(url: string, options?: FetchAndParseOptions): Promise<FetchAndParseResult>;
+//# sourceMappingURL=crawler.d.ts.map

package/dist/crawler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crawler.d.ts","sourceRoot":"","sources":["../src/crawler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAoB,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,KAAK,QAAQ,EAAY,MAAM,aAAa,CAAC;AAEtD,eAAO,MAAM,kBAAkB,+DAA+D,CAAC;AAE/F,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAEzC,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;CACxB;AAED;;;GAGG;AACH,qBAAa,UAAW,SAAQ,eAAe;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;gBAGtC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAOxF;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAwC9B"}