@webx-ui/module-audit 0.1.0

package/dist/style.css

@@ -0,0 +1 @@
+.wx-audit-places[data-v-1b5ca599]{display:flex;flex-direction:column;gap:var(--wx-space-16);min-width:0}.wx-audit-places__group[data-v-1b5ca599]{display:flex;flex-direction:column;gap:var(--wx-space-8);min-width:0}.wx-audit-places__row[data-v-1b5ca599]{display:flex;flex-wrap:wrap;align-items:center;gap:var(--wx-space-4) var(--wx-space-8);min-width:0}.wx-audit-places__url[data-v-1b5ca599]{min-width:0;overflow-wrap:anywhere}.wx-audit-hosts__host[data-v-44b7e64a]{display:inline-flex;flex-wrap:wrap;align-items:center;gap:var(--wx-space-8);min-width:0;overflow-wrap:anywhere}[data-v-44b7e64a] .is-stand>td:first-child{box-shadow:inset 3px 0 0 var(--wx-color-danger)}.wx-audit-details[data-v-55c63cfb]{display:flex;flex-direction:column;gap:var(--wx-space-8);min-width:0}.wx-audit-details__scroll[data-v-55c63cfb]{overflow-x:auto}.wx-audit-details__table[data-v-55c63cfb]{width:100%;border-collapse:collapse;font-size:var(--wx-font-size-sm)}.wx-audit-details__table th[data-v-55c63cfb]{color:var(--wx-text-muted);font-weight:400;text-align:left;white-space:nowrap}.wx-audit-details__table th[data-v-55c63cfb],.wx-audit-details__table td[data-v-55c63cfb]{padding:var(--wx-space-4) var(--wx-space-8);border-bottom:1px solid var(--wx-border-muted);vertical-align:top}.wx-audit-details__url[data-v-55c63cfb]{overflow-wrap:anywhere}.wx-audit-fix[data-v-28525af3]{display:flex;flex-direction:column;gap:var(--wx-space-16);min-width:0}.wx-audit-fix__offer[data-v-28525af3]{display:flex;flex-direction:column;gap:var(--wx-space-8);min-width:0}.wx-audit-fix__changes[data-v-28525af3]{width:100%;border-collapse:collapse;font-size:var(--wx-font-size-sm)}.wx-audit-fix__changes th[data-v-28525af3]{padding:var(--wx-space-4) var(--wx-space-8);color:var(--wx-text-muted);font-weight:var(--wx-font-weight-medium);text-align:start;border-bottom:1px solid var(--wx-border-default)}.wx-audit-fix__changes td[data-v-28525af3]{padding:var(--wx-space-6) var(--wx-space-8);vertical-align:top;border-bottom:1px solid var(--wx-border-default);overflow-wrap:anywhere}.wx-audit-fix__field[data-v-28525af3],.wx-audit-fix__count[data-v-28525af3]{color:var(--wx-text-muted)}.wx-audit-fix__value[data-v-28525af3]{white-space:pre-line}.wx-audit-fix__actions[data-v-28525af3]{display:flex;justify-content:flex-end}.wx-audit-hide[data-v-1db364c4],.wx-audit-issues[data-v-23ac6ac8]{display:flex;flex-direction:column;gap:var(--wx-space-12);min-width:0}.wx-audit-issues__item[data-v-23ac6ac8]{display:flex;flex-direction:column;gap:var(--wx-space-6);min-width:0}.wx-audit-issues__head[data-v-23ac6ac8]{display:flex;flex-wrap:wrap;align-items:center;gap:var(--wx-space-8);min-width:0}.wx-audit-issues__fix[data-v-23ac6ac8],.wx-audit-issues__end[data-v-23ac6ac8]{margin-inline-start:auto}.wx-audit-issues__url[data-v-23ac6ac8]{min-width:0;overflow-wrap:anywhere}.wx-audit-findings__filters[data-v-7f790d95]{display:flex;flex-direction:column;gap:var(--wx-space-8)}.wx-audit-findings__title[data-v-7f790d95]{display:inline-flex;flex-wrap:wrap;align-items:center;gap:var(--wx-space-6)}.wx-audit-findings__texts[data-v-7f790d95]{display:grid;gap:var(--wx-space-4);margin:0;font-size:var(--wx-font-size-sm)}.wx-audit-findings__texts dt[data-v-7f790d95]{color:var(--wx-text-muted)}.wx-audit-findings__texts dd[data-v-7f790d95]{margin:0 0 var(--wx-space-8)}.wx-audit-overview[data-v-2a1e0d61]{display:flex;flex-direction:column;gap:var(--wx-space-16);container-type:inline-size}.wx-audit-overview__row[data-v-2a1e0d61]{display:flex;flex-wrap:wrap;align-items:center;gap:var(--wx-space-8) var(--wx-space-12);margin-bottom:var(--wx-space-8)}.wx-audit-overview__end[data-v-2a1e0d61]{margin-left:auto}.wx-audit-overview__summary[data-v-2a1e0d61]{display:flex;flex-wrap:wrap;align-items:center;gap:var(--wx-space-24)}.wx-audit-overview__stats[data-v-2a1e0d61]{display:flex;flex:1 1 auto;flex-wrap:wrap;gap:var(--wx-space-16) var(--wx-space-32)}.wx-audit-overview__meta[data-v-2a1e0d61]{display:flex;flex-wrap:wrap;gap:var(--wx-space-4);margin-top:var(--wx-space-16)}.wx-audit-overview__url[data-v-2a1e0d61]{min-width:0;overflow-wrap:anywhere}.wx-audit-overview__groups[data-v-2a1e0d61]{display:flex;flex-direction:column;gap:var(--wx-space-8);margin:0;padding:0;list-style:none}.wx-audit-overview__groups li[data-v-2a1e0d61]{display:flex;flex-wrap:wrap;align-items:center;justify-content:space-between;gap:var(--wx-space-8)}.wx-audit-overview__badges[data-v-2a1e0d61],.wx-audit-overview__missing[data-v-2a1e0d61]{display:flex;flex-wrap:wrap;align-items:center;gap:var(--wx-space-6)}.wx-audit-overview__missing[data-v-2a1e0d61]{margin-top:var(--wx-space-12)}.wx-audit-card[data-v-46e97525]{display:flex;flex-direction:column;gap:var(--wx-space-12);min-width:0}.wx-audit-card__title[data-v-46e97525]{display:inline-flex;align-items:center;gap:var(--wx-space-8);min-width:0}.wx-audit-card__url[data-v-46e97525]{min-width:0;overflow-wrap:anywhere}.wx-audit-card__facts[data-v-46e97525]{display:grid;grid-template-columns:minmax(120px,max-content) minmax(0,1fr);gap:var(--wx-space-6) var(--wx-space-16);margin:var(--wx-space-12) 0 0;font-size:var(--wx-font-size-sm)}.wx-audit-card__facts dt[data-v-46e97525]{color:var(--wx-text-muted)}.wx-audit-card__facts dd[data-v-46e97525]{margin:0;overflow-wrap:anywhere;white-space:pre-line}.wx-audit-card__pairs[data-v-46e97525]{display:grid;grid-template-columns:max-content minmax(0,1fr);gap:var(--wx-space-6) var(--wx-space-8);align-items:baseline}.wx-audit-card__key[data-v-46e97525]{justify-self:end;font-family:var(--wx-font-family-mono)}.wx-audit-card__tags[data-v-46e97525]{display:flex;flex-wrap:wrap;align-items:center;gap:var(--wx-space-6)}.wx-audit-card__section[data-v-46e97525]{margin-top:var(--wx-space-12);font-weight:var(--wx-font-weight-semibold)}.wx-audit-card__code[data-v-46e97525]{font-family:var(--wx-font-family-mono)}.wx-audit-card__issues[data-v-46e97525]{display:flex;flex-direction:column;gap:var(--wx-space-16);margin-top:var(--wx-space-12)}.wx-audit-card__issue[data-v-46e97525]{display:flex;flex-direction:column;gap:var(--wx-space-6);min-width:0}.wx-audit-card__picture[data-v-46e97525]{display:flex;align-items:center;gap:var(--wx-space-12);min-width:0}.wx-audit-card__thumb[data-v-46e97525]{flex:none}.wx-audit-card__source[data-v-46e97525]{max-height:480px;margin:0;padding:var(--wx-space-8);overflow:auto;border-radius:var(--wx-radius-sm);background:var(--wx-bg-muted);font-family:var(--wx-font-family-mono);font-size:var(--wx-font-size-xs);white-space:pre-wrap;overflow-wrap:anywhere}.wx-audit-card__issue-head[data-v-46e97525]{display:flex;flex-wrap:wrap;align-items:center;gap:var(--wx-space-8)}.wx-audit-card__extra[data-v-46e97525]{display:inline-flex;flex-wrap:wrap;align-items:center;gap:var(--wx-space-8)}.wx-audit-card__recheck[data-v-46e97525]{display:flex;flex-wrap:wrap;align-items:center;gap:var(--wx-space-4) var(--wx-space-12)}.wx-audit-pages__none[data-v-7850735f]{display:block;padding:var(--wx-space-24)}.wx-audit-pages__filters[data-v-7850735f]{display:flex;flex-direction:column;gap:var(--wx-space-8)}.wx-audit-pages__filter[data-v-7850735f]{display:grid;grid-template-columns:minmax(0,1.4fr) minmax(0,1fr) minmax(0,1fr) auto;gap:var(--wx-space-4);align-items:center}.wx-audit-pages__picker[data-v-7850735f]{max-height:360px;overflow-y:auto}.wx-audit-pages__long[data-v-7850735f]{overflow-wrap:anywhere}.wx-audit-compare[data-v-02d42bdb]{display:flex;flex-direction:column;gap:var(--wx-space-12);min-width:0}.wx-audit-compare__item[data-v-02d42bdb]{display:flex;flex-direction:column;gap:var(--wx-space-6);min-width:0}.wx-audit-compare__url[data-v-02d42bdb]{min-width:0;overflow-wrap:anywhere}.wx-audit-runs[data-v-abbed1f9]{display:flex;flex-direction:column;gap:var(--wx-space-16);min-width:0}.wx-audit-runs__counts[data-v-abbed1f9]{display:inline-flex;flex-wrap:wrap;gap:var(--wx-space-4)}.wx-audit-runs__pair[data-v-abbed1f9]{display:block;margin-bottom:var(--wx-space-12)}.wx-audit-runs__note[data-v-abbed1f9]{margin-bottom:var(--wx-space-12)}.wx-audit-settings[data-v-4b3f5a3f]{display:flex;flex-direction:column;gap:var(--wx-gap, var(--wx-space-16))}

package/dist/types.d.ts

@@ -0,0 +1,356 @@
+export type AuditSeverity = 'error' | 'warning' | 'notice';
+/** `urls` is a recheck of a few addresses, started from the page's card. */
+export type AuditScope = 'full' | 'quick' | 'urls';
+export type AuditRunStatus = 'queued' | 'running' | 'done' | 'failed' | 'cancelled';
+export type AuditStage = 'probes' | 'database' | 'crawl' | 'analyse';
+/** What a run counted, once it is done. */
+export interface AuditCounts {
+    severity: Record<AuditSeverity, number>;
+    groups: Record<string, Record<AuditSeverity, number>>;
+    /** Ids of the checks that ran. */
+    checks: string[];
+    /** The worst severity of every check that found something. */
+    failed: Record<string, AuditSeverity>;
+    /** 0–100, each check weighed once by its severity. */
+    health: number;
+    new: number;
+    fixed: number;
+    previous_id: number | null;
+    sources: {
+        searched: string[];
+        missing: string[];
+    };
+}
+export interface AuditRun {
+    id: number;
+    status: AuditRunStatus;
+    scope: AuditScope;
+    base_url: string;
+    resolve_to: string | null;
+    /** The addresses of a recheck; empty for the other scopes. */
+    urls: string[];
+    progress: {
+        stage: AuditStage | null;
+        done: AuditStage[];
+        checks: number;
+        pages: {
+            crawled: number;
+            limit: number;
+        };
+        /** The phase of the crawl: `seed`, `fetch`, `resources`, `checks`. */
+        phase?: string | null;
+        /** While what the pages load is being asked. */
+        resources?: {
+            checked: number;
+            total: number;
+        } | null;
+    };
+    counts: AuditCounts | null;
+    started_by: string | null;
+    created_at: string | null;
+    started_at: string | null;
+    finished_at: string | null;
+    error: string | null;
+}
+/** The overview's one call: the run that is going, the last that finished, and the queue. */
+export interface AuditLatest {
+    active: AuditRun | null;
+    done: AuditRun | null;
+    /** The last full run — the one with pages to list. */
+    crawled: AuditRun | null;
+    /** A run that failed or was cancelled after the last good one. */
+    last: AuditRun | null;
+    queue: {
+        sync: boolean;
+    };
+}
+/** One check that found something, with its three texts in the reader's language. */
+export interface AuditCheckRow {
+    id: string;
+    group: string;
+    severity: AuditSeverity;
+    count: number;
+    new: number;
+    title: string;
+    found: string;
+    why: string;
+    fix: string;
+    /** The fixes that can close this check — the screen offers a button when there are any. */
+    fixes: string[];
+}
+export type AuditCellType = 'url' | 'status' | 'bool' | 'text' | 'missing' | 'edit';
+export interface AuditDetailsColumn {
+    key: string;
+    label: string;
+    type: AuditCellType;
+}
+/** The expansion of a finding: data, drawn by one component for every check. */
+export interface AuditDetails {
+    summary: string | null;
+    table: {
+        columns: AuditDetailsColumn[];
+        rows: Record<string, unknown>[];
+    } | null;
+}
+export interface AuditIssue {
+    id: number;
+    check: string;
+    severity: AuditSeverity;
+    url: string | null;
+    state: 'new' | 'persisting';
+    ignored: boolean;
+    /** The rule that hides it, on the list of hidden findings. */
+    ignore?: AuditIgnoreRule | null;
+    /** The fix pressed on it; the finding stays until the next run says it is gone. */
+    fixed_with: string | null;
+    fixed_at: string | null;
+    details: AuditDetails;
+}
+/** One thing a fix changes: a field with its count of replacements, or a setting before and after. */
+export interface AuditFixChange {
+    label: string;
+    field?: string | null;
+    count?: number;
+    before?: string | null;
+    after?: string | null;
+    edit_url?: string | null;
+}
+/** A fix that can close a finding, with what it would change. */
+export interface AuditFixOffer {
+    id: string;
+    title: string;
+    description: string;
+    changes: AuditFixChange[];
+    total: number;
+    note: string | null;
+}
+export interface AuditFixResult {
+    id: string;
+    applied: boolean;
+    changes: AuditFixChange[];
+    total: number;
+    note: string | null;
+}
+export interface AuditIssueQuery {
+    check?: string;
+    severity?: AuditSeverity | null;
+    group?: string | null;
+    /** `hidden` lists what the rules hide instead of what counts. */
+    state?: 'new' | 'persisting' | 'hidden' | null;
+    page?: number;
+    per_page?: number;
+}
+export interface AuditPage<T> {
+    data: T[];
+    current_page: number;
+    last_page: number;
+    per_page: number;
+    total: number;
+    from: number | null;
+    to: number | null;
+}
+export type AuditPageSource = 'home' | 'sitemap' | 'registry' | 'link' | 'list';
+export type AuditHostClass = 'own' | 'own_mirror' | 'dev' | 'external';
+/** One crawled address as the pages screen lists it — every field of the snapshot it can show. */
+export interface AuditPageRow {
+    id: number;
+    url: string;
+    status: number | null;
+    final_status: number | null;
+    redirect_to: string | null;
+    source: AuditPageSource;
+    depth: number | null;
+    indexable: boolean;
+    issues: number;
+    title: string | null;
+    description: string | null;
+    h1: string | null;
+    canonical: string | null;
+    robots_meta: string | null;
+    x_robots_tag: string | null;
+    lang: string | null;
+    content_type: string | null;
+    bytes: number | null;
+    ttfb_ms: number | null;
+    total_ms: number | null;
+    compression: string | null;
+    word_count: number | null;
+    links_in: number;
+    links_out_internal: number;
+    links_out_external: number;
+    images: number;
+    images_without_alt: number;
+    in_sitemap: boolean;
+    in_registry: boolean;
+    blocked_by_robots: boolean;
+}
+export type AuditPageField = Exclude<keyof AuditPageRow, 'id'>;
+/** How a field is drawn, filtered and compared. */
+export type AuditFieldType = 'url' | 'text' | 'number' | 'bool' | 'status' | 'source';
+export type AuditFilterOp = 'contains' | 'eq' | 'empty' | 'filled' | 'gt' | 'lt' | 'yes' | 'no';
+export interface AuditFieldFilter {
+    field: AuditPageField;
+    op: AuditFilterOp;
+    value?: string;
+}
+export interface AuditPageQuery {
+    search?: string;
+    /** `2xx`, `3xx`, `4xx`, `5xx` or `none` — nothing answered. */
+    status?: string | null;
+    indexable?: boolean | null;
+    /** Pages with a finding of this check. */
+    check?: string | null;
+    filters?: AuditFieldFilter[];
+    /** A field, `-field` for descending. */
+    sort?: string | null;
+    page?: number;
+    per_page?: number;
+}
+/** The page's card: the whole snapshot, its findings and how many links lead in and out. */
+export interface AuditPageCard {
+    page: AuditPageRow & {
+        headers: Record<string, string>;
+        h1: string[];
+        headings: Record<string, number>;
+        hreflang: {
+            lang: string;
+            url: string;
+        }[];
+        og: Record<string, string>;
+        twitter: Record<string, string>;
+        json_ld: AuditJsonLdBlock[];
+        error: string | null;
+        facts: Record<string, unknown>;
+        fetched_at: string | null;
+    };
+    issues: AuditIssue[];
+    counts: {
+        issues: number;
+        incoming: number;
+        outgoing: number;
+        images?: number;
+        css?: number;
+        js?: number;
+        microdata?: number;
+    };
+}
+/** One JSON-LD block of a page: what it is, and what the types search engines show lack. */
+export interface AuditJsonLdBlock {
+    types: string[];
+    error: string | null;
+    items?: {
+        type: string;
+        missing: string[];
+        recommended: string[];
+    }[];
+    /** The block as the page printed it, cut. */
+    source?: string;
+}
+/** The tabs of the card that list what the page loads. */
+export type AuditResourceTab = 'images' | 'css' | 'js';
+/** Something a page loads, with what it answered when the run asked. */
+export interface AuditResourceRow {
+    id: number;
+    url: string;
+    kind: string;
+    alt: string | null;
+    host_class: AuditHostClass | null;
+    /** False past the run's limit, and for a stand's address — it is not asked. */
+    checked: boolean;
+    status: number | null;
+    error: string | null;
+    location: string | null;
+    content_type: string | null;
+    bytes: number | null;
+    cache_control: string | null;
+    compression: string | null;
+    width: number | null;
+    height: number | null;
+}
+/** A link of a page: where it leads (out) or where it comes from (in). */
+export interface AuditLinkRow {
+    id: number;
+    url: string | null;
+    page_id: number | null;
+    status: number | null;
+    kind: string;
+    anchor: string | null;
+    rel: string | null;
+    target: string | null;
+    host: string | null;
+    host_class: AuditHostClass | null;
+    absolute: boolean;
+}
+/** A rule that hides findings on purpose (decision 9): a check, an address or a mask, and why. */
+export interface AuditIgnoreRule {
+    id: number;
+    check: string;
+    /** An address, a mask (`/search/**`), or empty for every finding of the check. */
+    pattern: string;
+    reason: string;
+    created_by: string | null;
+    created_at: string | null;
+    /** The check's title in the reader's language — in the list of rules. */
+    title?: string;
+    /** How many stored findings it hides — in the list of rules. */
+    hidden?: number;
+}
+export type AuditComparisonKind = 'new' | 'persisting' | 'fixed';
+/** One check of two runs compared by fingerprint. */
+export interface AuditComparisonRow {
+    check: string;
+    title: string;
+    severity: AuditSeverity;
+    new: number;
+    persisting: number;
+    fixed: number;
+}
+export interface AuditComparison {
+    from: AuditRun;
+    to: AuditRun;
+    checks: AuditComparisonRow[];
+}
+/** One host the site points at, on the «Outgoing» screen. */
+export interface AuditHostRow {
+    host: string;
+    class: AuditHostClass;
+    links: number;
+    pages: number;
+    /** Links that answered 4xx, 5xx or nothing. */
+    broken: number;
+    nofollow: number;
+    /** Fields in the database that hold an address on it. */
+    fields: number;
+    /** The earliest run among the snapshots kept that saw it. */
+    first_seen: string | null;
+}
+/** A link to a host from a crawled page. */
+export interface AuditHostPage {
+    page_id: number;
+    page: string;
+    url: string;
+    kind: string;
+    anchor: string | null;
+    rel: string | null;
+    status: number | null;
+}
+/** A field of the database that holds an address on a host. */
+export interface AuditHostField {
+    source: string;
+    record_id: string;
+    record_label: string;
+    field: string;
+    locale: string | null;
+    url: string;
+    published: boolean | number;
+    edit_url: string | null;
+}
+export interface AuditHosts {
+    crawled_run: number | null;
+    database_run: number | null;
+    classes: Partial<Record<AuditHostClass, number>>;
+    hosts: AuditHostRow[];
+    /** With `host`: where it stands. */
+    pages?: AuditHostPage[];
+    fields?: AuditHostField[];
+}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@webx-ui/module-audit",
+  "version": "0.1.0",
+  "description": "A site audit for the WebX UI admin panel: the production config, the host, and links to a development stand in the content.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": [
+    "*.css"
+  ],
+  "keywords": [
+    "webx-ui",
+    "vue",
+    "admin",
+    "seo",
+    "audit"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/webx-ui/webx-ui.git",
+    "directory": "packages/module-audit"
+  },
+  "homepage": "https://github.com/webx-ui/webx-ui/tree/main/packages/module-audit",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./style.css": "./dist/style.css",
+    "./dist/style.css": "./dist/style.css",
+    "./package.json": "./package.json"
+  },
+  "peerDependencies": {
+    "vue": "^3.5.0",
+    "vue-router": "^4.5.0"
+  },
+  "dependencies": {
+    "@webx-ui/core": "^0.36.0",
+    "@webx-ui/module-admin": "^0.23.1",
+    "@webx-ui/schema": "^0.7.2"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "@vitejs/plugin-vue": "^6.0.1",
+    "typescript": "^5.9.3",
+    "vite": "^7.1.14",
+    "vite-plugin-dts": "^4.5.4",
+    "vue": "^3.5.24",
+    "vue-router": "^4.5.1",
+    "vue-tsc": "^3.1.3"
+  },
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite build --watch",
+    "typecheck": "vue-tsc -p tsconfig.json --noEmit"
+  }
+}