@answerable-kit/core 0.1.0

package/README.md

@@ -0,0 +1,15 @@
+# @answerable-kit/core
+
+Shared types, utilities, and error classes for the [Answerable](https://github.com/Anuj7411/answerable) SEO toolkit.
+
+> **Pre-alpha.** This package is a placeholder. Real exports land in Phase 1.
+
+## Install
+
+```bash
+pnpm add @answerable-kit/core
+```
+
+## License
+
+[MIT](../../LICENSE) © 2026 Anuj Ojha

package/dist/category.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+/**
+ * The six audit categories defined in AUDIT-FRAMEWORK.md.
+ * Stored as kebab-case for use in config files; the public-facing
+ * single-letter prefix (A/B/C/D/E/F) lives on each check's `id`.
+ */
+export declare const CategorySchema: z.ZodEnum<["meta-and-technical", "content-structure", "structured-data", "eeat-and-authority", "offsite-citations", "og-and-social"]>;
+export type Category = z.infer<typeof CategorySchema>;
+/**
+ * Maps each category to the single-letter prefix used in check IDs.
+ * Example: `B5` → `content-structure`.
+ */
+export declare const CATEGORY_ID_PREFIX: {
+    readonly 'meta-and-technical': "A";
+    readonly 'content-structure': "B";
+    readonly 'structured-data': "C";
+    readonly 'eeat-and-authority': "D";
+    readonly 'offsite-citations': "E";
+    readonly 'og-and-social': "F";
+};
+export type CategoryIdPrefix = (typeof CATEGORY_ID_PREFIX)[Category];
+/**
+ * Per-category point budget. Sums to exactly 100.
+ * Source: docs/internal/AUDIT-FRAMEWORK.md §1.
+ */
+export declare const CATEGORY_POINT_BUDGET: {
+    readonly 'meta-and-technical': 20;
+    readonly 'content-structure': 20;
+    readonly 'structured-data': 18;
+    readonly 'eeat-and-authority': 22;
+    readonly 'offsite-citations': 12;
+    readonly 'og-and-social': 8;
+};
+//# sourceMappingURL=category.d.ts.map

package/dist/category.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"category.d.ts","sourceRoot":"","sources":["../src/category.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,cAAc,uIAOzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;CAOc,CAAC;AAE9C,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,QAAQ,CAAC,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;CAOW,CAAC"}

package/dist/category.js

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+/**
+ * The six audit categories defined in AUDIT-FRAMEWORK.md.
+ * Stored as kebab-case for use in config files; the public-facing
+ * single-letter prefix (A/B/C/D/E/F) lives on each check's `id`.
+ */
+export const CategorySchema = z.enum([
+    'meta-and-technical',
+    'content-structure',
+    'structured-data',
+    'eeat-and-authority',
+    'offsite-citations',
+    'og-and-social',
+]);
+/**
+ * Maps each category to the single-letter prefix used in check IDs.
+ * Example: `B5` → `content-structure`.
+ */
+export const CATEGORY_ID_PREFIX = {
+    'meta-and-technical': 'A',
+    'content-structure': 'B',
+    'structured-data': 'C',
+    'eeat-and-authority': 'D',
+    'offsite-citations': 'E',
+    'og-and-social': 'F',
+};
+/**
+ * Per-category point budget. Sums to exactly 100.
+ * Source: docs/internal/AUDIT-FRAMEWORK.md §1.
+ */
+export const CATEGORY_POINT_BUDGET = {
+    'meta-and-technical': 20,
+    'content-structure': 20,
+    'structured-data': 18,
+    'eeat-and-authority': 22,
+    'offsite-citations': 12,
+    'og-and-social': 8,
+};
+//# sourceMappingURL=category.js.map

package/dist/category.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"category.js","sourceRoot":"","sources":["../src/category.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC;IACnC,oBAAoB;IACpB,mBAAmB;IACnB,iBAAiB;IACjB,oBAAoB;IACpB,mBAAmB;IACnB,eAAe;CAChB,CAAC,CAAC;AAGH;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,oBAAoB,EAAE,GAAG;IACzB,mBAAmB,EAAE,GAAG;IACxB,iBAAiB,EAAE,GAAG;IACtB,oBAAoB,EAAE,GAAG;IACzB,mBAAmB,EAAE,GAAG;IACxB,eAAe,EAAE,GAAG;CACuB,CAAC;AAI9C;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,oBAAoB,EAAE,EAAE;IACxB,mBAAmB,EAAE,EAAE;IACvB,iBAAiB,EAAE,EAAE;IACrB,oBAAoB,EAAE,EAAE;IACxB,mBAAmB,EAAE,EAAE;IACvB,eAAe,EAAE,CAAC;CACyB,CAAC"}

package/dist/check.d.ts

@@ -0,0 +1,83 @@
+import type { Category } from './category.js';
+import type { Severity } from './severity.js';
+import type { AbsoluteUrl } from './url.js';
+/**
+ * Input handed to a check's `run` function by the audit engine.
+ *
+ * Generic over `TDom` so engines built on different parsers (cheerio,
+ * playwright, JSDOM) can supply their own typed handle without forcing
+ * `@answerable-kit/core` to depend on a parser.
+ */
+export interface CheckInput<TDom = unknown> {
+    readonly url: AbsoluteUrl;
+    readonly html: string;
+    readonly dom: TDom;
+}
+/**
+ * Outcome of a single check run.
+ */
+export interface CheckResult {
+    readonly status: 'pass' | 'fail' | 'warn' | 'skip';
+    /** Concrete evidence from the page (snippet, count, attribute value). */
+    readonly evidence?: string | undefined;
+    /** Human-readable next step for the developer. */
+    readonly fixRecommendation?: string | undefined;
+}
+/**
+ * Context passed to `autoFix` when the engine writes changes back into
+ * the user's project. Filled out further as auto-fix capabilities land.
+ */
+export interface ProjectContext {
+    readonly cwd: string;
+    readonly framework: 'nextjs-app' | 'unknown';
+}
+/**
+ * A single audit check. The full set of 50 checks Phase 1 ships with
+ * is enumerated in docs/internal/AUDIT-FRAMEWORK.md.
+ */
+export interface Check<TDom = unknown> {
+    /** Stable ID, e.g. `B5`. Part of the public API — never renumbered. */
+    readonly id: string;
+    readonly category: Category;
+    readonly severity: Severity;
+    /** Point weight toward the 100-point total. */
+    readonly points: number;
+    /** One-sentence summary shown in console reports. */
+    readonly description: string;
+    /** Long-form explanation of why this check matters. */
+    readonly rationale: string;
+    /** URL to the doc page explaining this check. */
+    readonly docsUrl: string;
+    /** Runs the check against a parsed page. */
+    run: (input: CheckInput<TDom>) => CheckResult | Promise<CheckResult>;
+    /** Optional auto-fix that patches the user's project. */
+    autoFix?: ((project: ProjectContext) => Promise<void>) | undefined;
+}
+/**
+ * Identity helper that gives TypeScript a chance to infer the generic
+ * parameter on `Check` and surface type errors at definition time.
+ *
+ * @example
+ * ```ts
+ * import { defineCheck } from '@answerable-kit/core';
+ *
+ * export const titlePresent = defineCheck({
+ *   id: 'A1',
+ *   category: 'meta-and-technical',
+ *   severity: 'critical',
+ *   points: 3,
+ *   description: '<title> present, 30-60 chars',
+ *   rationale: 'Search and AI engines surface the title verbatim.',
+ *   docsUrl: 'https://answerable.dev/docs/checks/A1',
+ *   run: ({ html }) => {
+ *     const match = html.match(/<title>([^<]*)<\/title>/i);
+ *     if (!match) return { status: 'fail', fixRecommendation: 'Add a <title> tag.' };
+ *     const len = (match[1] ?? '').trim().length;
+ *     if (len < 30 || len > 60) return { status: 'warn', evidence: `Length: ${len}` };
+ *     return { status: 'pass' };
+ *   },
+ * });
+ * ```
+ */
+export declare function defineCheck<TDom = unknown>(check: Check<TDom>): Check<TDom>;
+//# sourceMappingURL=check.d.ts.map

package/dist/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../src/check.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,WAAW,UAAU,CAAC,IAAI,GAAG,OAAO;IACxC,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACnD,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,kDAAkD;IAClD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjD;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,YAAY,GAAG,SAAS,CAAC;CAC9C;AAED;;;GAGG;AACH,MAAM,WAAW,KAAK,CAAC,IAAI,GAAG,OAAO;IACnC,uEAAuE;IACvE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,uDAAuD;IACvD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,GAAG,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACrE,yDAAyD;IACzD,OAAO,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;CACpE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,WAAW,CAAC,IAAI,GAAG,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAE3E"}

package/dist/check.js

@@ -0,0 +1,30 @@
+/**
+ * Identity helper that gives TypeScript a chance to infer the generic
+ * parameter on `Check` and surface type errors at definition time.
+ *
+ * @example
+ * ```ts
+ * import { defineCheck } from '@answerable-kit/core';
+ *
+ * export const titlePresent = defineCheck({
+ *   id: 'A1',
+ *   category: 'meta-and-technical',
+ *   severity: 'critical',
+ *   points: 3,
+ *   description: '<title> present, 30-60 chars',
+ *   rationale: 'Search and AI engines surface the title verbatim.',
+ *   docsUrl: 'https://answerable.dev/docs/checks/A1',
+ *   run: ({ html }) => {
+ *     const match = html.match(/<title>([^<]*)<\/title>/i);
+ *     if (!match) return { status: 'fail', fixRecommendation: 'Add a <title> tag.' };
+ *     const len = (match[1] ?? '').trim().length;
+ *     if (len < 30 || len > 60) return { status: 'warn', evidence: `Length: ${len}` };
+ *     return { status: 'pass' };
+ *   },
+ * });
+ * ```
+ */
+export function defineCheck(check) {
+    return check;
+}
+//# sourceMappingURL=check.js.map

package/dist/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../src/check.ts"],"names":[],"mappings":"AA4DA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,WAAW,CAAiB,KAAkB;IAC5D,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Base class for all errors thrown by Answerable packages.
+ *
+ * Subclasses set a stable `code` string so consumers can branch on error
+ * kind without relying on `instanceof` (which breaks across realms /
+ * bundler boundaries).
+ */
+export declare class AnswerableError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string, options?: ErrorOptions);
+}
+/**
+ * Thrown when a value that claimed to be a URL fails validation.
+ */
+export declare class InvalidUrlError extends AnswerableError {
+    readonly input: string;
+    constructor(input: string, reason?: string, options?: ErrorOptions);
+}
+/**
+ * Thrown when a schema (zod, JSON-LD, etc.) fails validation.
+ * The full list of individual issues is preserved on `issues`.
+ */
+export declare class SchemaValidationError extends AnswerableError {
+    readonly issues: readonly string[];
+    constructor(issues: readonly string[], options?: ErrorOptions);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAKlE;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,eAAe;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAMnE;AAED;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,eAAe;IACxD,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;gBAEvB,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,YAAY;CAS9D"}

package/dist/errors.js

@@ -0,0 +1,40 @@
+/**
+ * Base class for all errors thrown by Answerable packages.
+ *
+ * Subclasses set a stable `code` string so consumers can branch on error
+ * kind without relying on `instanceof` (which breaks across realms /
+ * bundler boundaries).
+ */
+export class AnswerableError extends Error {
+    code;
+    constructor(code, message, options) {
+        super(message, options);
+        this.code = code;
+        this.name = 'AnswerableError';
+    }
+}
+/**
+ * Thrown when a value that claimed to be a URL fails validation.
+ */
+export class InvalidUrlError extends AnswerableError {
+    input;
+    constructor(input, reason, options) {
+        const detail = reason ? `: ${reason}` : '';
+        super('ANSWERABLE_INVALID_URL', `Invalid URL "${input}"${detail}`, options);
+        this.input = input;
+        this.name = 'InvalidUrlError';
+    }
+}
+/**
+ * Thrown when a schema (zod, JSON-LD, etc.) fails validation.
+ * The full list of individual issues is preserved on `issues`.
+ */
+export class SchemaValidationError extends AnswerableError {
+    issues;
+    constructor(issues, options) {
+        super('ANSWERABLE_SCHEMA_VALIDATION', `Schema validation failed:\n  - ${issues.join('\n  - ')}`, options);
+        this.issues = issues;
+        this.name = 'SchemaValidationError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,IAAI,CAAS;IAEtB,YAAY,IAAY,EAAE,OAAe,EAAE,OAAsB;QAC/D,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,eAAe;IACzC,KAAK,CAAS;IAEvB,YAAY,KAAa,EAAE,MAAe,EAAE,OAAsB;QAChE,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3C,KAAK,CAAC,wBAAwB,EAAE,gBAAgB,KAAK,IAAI,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;QAC5E,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,qBAAsB,SAAQ,eAAe;IAC/C,MAAM,CAAoB;IAEnC,YAAY,MAAyB,EAAE,OAAsB;QAC3D,KAAK,CACH,8BAA8B,EAC9B,kCAAkC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EACzD,OAAO,CACR,CAAC;QACF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @answerable-kit/core — shared types, utilities, and error classes
+ * used across the Answerable SEO toolkit.
+ */
+export declare const VERSION = "0.0.0";
+export { AnswerableError, InvalidUrlError, SchemaValidationError } from './errors.js';
+export { SEVERITY_ORDER, SeveritySchema, severityRank, type Severity } from './severity.js';
+export { CATEGORY_ID_PREFIX, CATEGORY_POINT_BUDGET, CategorySchema, type Category, type CategoryIdPrefix, } from './category.js';
+export { AbsoluteUrlSchema, parseAbsoluteUrl, tryParseAbsoluteUrl, URLStringSchema, type AbsoluteUrl, type URLString, } from './url.js';
+export { defineCheck, type Check, type CheckInput, type CheckResult, type ProjectContext, } from './check.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEtF,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE5F,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,EACd,KAAK,QAAQ,EACb,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,SAAS,GACf,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,WAAW,EACX,KAAK,KAAK,EACV,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * @answerable-kit/core — shared types, utilities, and error classes
+ * used across the Answerable SEO toolkit.
+ */
+export const VERSION = '0.0.0';
+export { AnswerableError, InvalidUrlError, SchemaValidationError } from './errors.js';
+export { SEVERITY_ORDER, SeveritySchema, severityRank } from './severity.js';
+export { CATEGORY_ID_PREFIX, CATEGORY_POINT_BUDGET, CategorySchema, } from './category.js';
+export { AbsoluteUrlSchema, parseAbsoluteUrl, tryParseAbsoluteUrl, URLStringSchema, } from './url.js';
+export { defineCheck, } from './check.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEtF,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAiB,MAAM,eAAe,CAAC;AAE5F,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,GAGf,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,GAGhB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,WAAW,GAKZ,MAAM,YAAY,CAAC"}

package/dist/severity.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+/**
+ * The four severity levels every audit check ships with.
+ * Independent of point weight: a low-point check can still be critical.
+ */
+export declare const SeveritySchema: z.ZodEnum<["critical", "high", "medium", "low"]>;
+export type Severity = z.infer<typeof SeveritySchema>;
+/**
+ * Severities in descending order of urgency (most severe first).
+ * Stable order — relied on by reporters and CI summaries.
+ */
+export declare const SEVERITY_ORDER: readonly Severity[];
+/**
+ * Numeric rank for sorting. Lower number = more severe.
+ * `critical` → 0, `low` → 3.
+ */
+export declare function severityRank(s: Severity): number;
+//# sourceMappingURL=severity.d.ts.map

package/dist/severity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"severity.d.ts","sourceRoot":"","sources":["../src/severity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,cAAc,kDAAgD,CAAC;AAC5E,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,QAAQ,EAA0C,CAAC;AAEzF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,CAEhD"}

package/dist/severity.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+/**
+ * The four severity levels every audit check ships with.
+ * Independent of point weight: a low-point check can still be critical.
+ */
+export const SeveritySchema = z.enum(['critical', 'high', 'medium', 'low']);
+/**
+ * Severities in descending order of urgency (most severe first).
+ * Stable order — relied on by reporters and CI summaries.
+ */
+export const SEVERITY_ORDER = ['critical', 'high', 'medium', 'low'];
+/**
+ * Numeric rank for sorting. Lower number = more severe.
+ * `critical` → 0, `low` → 3.
+ */
+export function severityRank(s) {
+    return SEVERITY_ORDER.indexOf(s);
+}
+//# sourceMappingURL=severity.js.map

package/dist/severity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"severity.js","sourceRoot":"","sources":["../src/severity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;AAG5E;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAwB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;AAEzF;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,CAAW;IACtC,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC"}

package/dist/url.d.ts

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+/**
+ * A URL string that has passed zod's URL validation (any scheme).
+ * Branded so `string` literals can't accidentally substitute.
+ */
+export declare const URLStringSchema: z.ZodBranded<z.ZodString, "URLString">;
+export type URLString = z.infer<typeof URLStringSchema>;
+/**
+ * An absolute http(s) URL — the strictest form, used wherever Answerable
+ * fetches or audits a target site.
+ */
+export declare const AbsoluteUrlSchema: z.ZodBranded<z.ZodEffects<z.ZodString, string, string>, "AbsoluteUrl">;
+export type AbsoluteUrl = z.infer<typeof AbsoluteUrlSchema>;
+/**
+ * Parse an input string into an AbsoluteUrl. Throws `InvalidUrlError`
+ * on failure with the original zod issue preserved on `.cause`.
+ */
+export declare function parseAbsoluteUrl(input: string): AbsoluteUrl;
+/**
+ * Non-throwing variant of `parseAbsoluteUrl`. Returns `null` on failure.
+ */
+export declare function tryParseAbsoluteUrl(input: string): AbsoluteUrl | null;
+//# sourceMappingURL=url.d.ts.map

package/dist/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../src/url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AACH,eAAO,MAAM,eAAe,wCAAwC,CAAC;AACrE,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,wEAIL,CAAC;AAC1B,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAO3D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAGrE"}

package/dist/url.js

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import { InvalidUrlError } from './errors.js';
+/**
+ * A URL string that has passed zod's URL validation (any scheme).
+ * Branded so `string` literals can't accidentally substitute.
+ */
+export const URLStringSchema = z.string().url().brand();
+/**
+ * An absolute http(s) URL — the strictest form, used wherever Answerable
+ * fetches or audits a target site.
+ */
+export const AbsoluteUrlSchema = z
+    .string()
+    .url()
+    .refine((s) => /^https?:\/\//i.test(s), { message: 'must use http or https' })
+    .brand();
+/**
+ * Parse an input string into an AbsoluteUrl. Throws `InvalidUrlError`
+ * on failure with the original zod issue preserved on `.cause`.
+ */
+export function parseAbsoluteUrl(input) {
+    const result = AbsoluteUrlSchema.safeParse(input);
+    if (!result.success) {
+        const reason = result.error.issues.map((i) => i.message).join('; ');
+        throw new InvalidUrlError(input, reason, { cause: result.error });
+    }
+    return result.data;
+}
+/**
+ * Non-throwing variant of `parseAbsoluteUrl`. Returns `null` on failure.
+ */
+export function tryParseAbsoluteUrl(input) {
+    const result = AbsoluteUrlSchema.safeParse(input);
+    return result.success ? result.data : null;
+}
+//# sourceMappingURL=url.js.map

package/dist/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../src/url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,EAAe,CAAC;AAGrE;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,MAAM,EAAE;KACR,GAAG,EAAE;KACL,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,wBAAwB,EAAE,CAAC;KAC7E,KAAK,EAAiB,CAAC;AAG1B;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAClD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpE,MAAM,IAAI,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAClD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@answerable-kit/core",
+  "version": "0.1.0",
+  "description": "Shared types, utilities, and error classes for the Answerable SEO toolkit.",
+  "license": "MIT",
+  "author": "Anuj Ojha",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Anuj7411/answerable.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/Anuj7411/answerable/tree/main/packages/core#readme",
+  "bugs": "https://github.com/Anuj7411/answerable/issues",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "README.md"],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist .tsbuildinfo"
+  },
+  "dependencies": {
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "rimraf": "^6.0.1",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.5"
+  }
+}