# Conformance rules > Plainkit 0.28.0. Generated by scripts/build-skills.mjs from core/tools/audit/rules.mjs and core/tools/audit/examples.mjs. Do not edit: change the source and run the generator. Every rule `npx plainkit audit` can report, one row per id: the CLI is the same rule table, so `--list-rules` lists these exact ids and `--explain ` shows the same detects/severity/docs. "normal" and "strict" are the finding's severity in the two modes (`off` means the rule does not run at all in that mode); run `--strict` before finishing to see errors and warnings both. ## A — accessibility attributes an element needs to have an accessible name or state | id | normal | strict | detects | |---|---|---|---| | A1 | error | error | an icon-only pk-button with no accessible name | | A2 | warn | error | a form control with neither a label attribute nor aria-label | | A3 | error | error | a dialog/drawer without a title, a tab without text, a frame/iframe without a title, or an image without alt | | A4 | warn | error | a positive tabindex, or a click handler on a non-interactive tag | | A5 | warn | warn | skipped heading levels or more than one h1 in a file | | A6 | warn | warn | a badge/alert whose variant conveys state with no text child (colour-only status) | | A7 | warn | error | a page shell missing lang, a viewport meta, or a main landmark | | A8 | warn | warn | a reduced-motion or touch-target override on a PlainKit element (heuristic) | ### A1 an icon-only pk-button with no accessible name Docs: `core/elements/button/button.meta.json#a11y` Wrong: ```text ``` Right: ```text ``` ### A2 a form control with neither a label attribute nor aria-label Docs: `docs/superpowers/specs/2026-09-28-conformance-audit-cli-design.md#25-family-a-accessibility-attributes-owner-goal-3` Wrong: ```text ``` Right: ```text ``` ### A3 a dialog/drawer without a title, a tab without text, a frame/iframe without a title, or an image without alt Docs: `docs/superpowers/specs/2026-09-28-conformance-audit-cli-design.md#25-family-a-accessibility-attributes-owner-goal-3` Wrong: ```text ``` Right: ```text ``` ### A4 a positive tabindex, or a click handler on a non-interactive tag Docs: `docs/superpowers/specs/2026-09-28-conformance-audit-cli-design.md#25-family-a-accessibility-attributes-owner-goal-3` Wrong: ```text

``` Right: ```text Go ``` ### A5 skipped heading levels or more than one h1 in a file Docs: `docs/superpowers/specs/2026-09-28-conformance-audit-cli-design.md#25-family-a-accessibility-attributes-owner-goal-3` Wrong: ```text

One

Two

``` Right: ```text

One

Two

``` ### A6 a badge/alert whose variant conveys state with no text child (colour-only status) Docs: `docs/superpowers/specs/2026-09-28-conformance-audit-cli-design.md#25-family-a-accessibility-attributes-owner-goal-3` Wrong: ```text ``` Right: ```text Failed ``` ### A7 a page shell missing lang, a viewport meta, or a main landmark Docs: `docs/superpowers/specs/2026-09-28-conformance-audit-cli-design.md#25-family-a-accessibility-attributes-owner-goal-3` Wrong: ```text ``` Right: ```text

``` ### A8 a reduced-motion or touch-target override on a PlainKit element (heuristic) Docs: `docs/superpowers/specs/2026-09-28-conformance-audit-cli-design.md#25-family-a-accessibility-attributes-owner-goal-3` Wrong: ```text pk-button { min-height: 0; } ``` Right: ```text pk-button { min-height: 44px; } ``` ## B — Blazor and Razor only: a raw tag or a hand-styled/unknown Pk* component, a Razor-only syntax shape | id | normal | strict | detects | |---|---|---|---| | B2 | warn | error | class=/style= on markup, or Class/Style on a Pk* component (S1-S3 counterpart) | | B3 | error | error | an unknown Pk* component, or an unknown parameter on a known one (typo or removed parameter) | | B4 | warn | warn | a @page component that does not derive from the SDK's page base | | B5 | warn | warn | JS interop for a behaviour a component already owns (a hint, never an error: D7's Blazor counterpart) | | B6 | warn | error | a ``` Right: ```text ``` ### P2 mountApp with no defineModule modules, or a defineModule missing id/title/routes Docs: `docs/superpowers/specs/2026-09-28-conformance-audit-cli-design.md#23-family-p-pages-and-app-structure-owner-goal-2` Wrong: ```text mountApp(document.body, { pages: { home: {} } }); ``` Right: ```text mountApp(document.body, { modules: [orders] }); defineModule({ id: 'orders', title: 'Orders', routes: [] }); ``` ### P3 a custom mount (or moduleFromMount) whose element mix matches a built-in page type (inference; owner: stays a warning even in strict, like D2/D9) Docs: `docs/superpowers/specs/2026-09-28-conformance-audit-cli-design.md#23-family-p-pages-and-app-structure-owner-goal-2` Wrong: ```text defineModule({ id: 'orders', routes: [{ path: '/', page: 'custom', config: { mount(host) { host.innerHTML = ''; } } }] }); ``` Right: ```text defineModule({ id: 'orders', routes: [{ path: '/', page: 'list', config: { columns: [] } }] }); ``` ### P4 hand-built header/side nav/breadcrumbs/footer next to pk-app-shell (or its parts) Docs: `docs/superpowers/specs/2026-09-28-conformance-audit-cli-design.md#23-family-p-pages-and-app-structure-owner-goal-2` Wrong: ```text

Custom header

``` Right: ```text

``` ### P5 a list/record route rendering its own filter bar, pager, empty state or loading skeleton by hand Docs: `docs/superpowers/specs/2026-09-28-conformance-audit-cli-design.md#23-family-p-pages-and-app-structure-owner-goal-2` Wrong: ```text defineModule({ routes: [{ path: '/', page: 'list', config: { mount(host) { host.innerHTML = ''; } } }] }); ``` Right: ```text defineModule({ routes: [{ path: '/', page: 'list', config: { columns: [], empty: 'None yet' } }] }); ``` ### P6 localStorage/sessionStorage/history.pushState/location.hash used in app-framework code instead of defineModule({ state }) and the router Docs: `docs/superpowers/specs/2026-09-28-conformance-audit-cli-design.md#23-family-p-pages-and-app-structure-owner-goal-2` Wrong: ```text mountApp(document.body, {}); const q = localStorage.getItem('q'); ``` Right: ```text defineModule({ id: 'orders', state: { defaults: { q: '' } } }); ``` ### P7 a list/record route config with no empty, error or loading handling Docs: `docs/superpowers/specs/2026-09-28-conformance-audit-cli-design.md#23-family-p-pages-and-app-structure-owner-goal-2` Wrong: ```text defineModule({ routes: [{ path: '/', page: 'list', config: { columns: [] } }] }); ``` Right: ```text defineModule({ routes: [{ path: '/', page: 'list', config: { columns: [], empty: 'No rows', error: 'Failed', loading: true } }] }); ``` ### P8 an unknown page-type id in a route (typo, or a removed built-in id) Docs: `docs/superpowers/specs/2026-09-28-conformance-audit-cli-design.md#23-family-p-pages-and-app-structure-owner-goal-2` Wrong: ```text defineModule({ routes: [{ path: '/', page: 'lsit', config: {} }] }); ``` Right: ```text defineModule({ routes: [{ path: '/', page: 'list', config: {} }] }); ``` ### P9 a hand-written hash-route href/location instead of module nav/routes and ctx.navigate Docs: `docs/superpowers/specs/2026-09-28-conformance-audit-cli-design.md#23-family-p-pages-and-app-structure-owner-goal-2` Wrong: ```text Order ``` Right: ```text Order ``` ### P10 a page factory that hand-rolls an AbortController, a busy/loading flag and its own dispose instead of createLifecycle Docs: `docs/superpowers/specs/2026-10-11-page-base-design.md#34-audit` Wrong: ```text let busy = false; const ac = new AbortController(); function destroy() { ac.abort(); } ``` Right: ```text import { createLifecycle } from 'plainkit/page-lifecycle.js'; const life = createLifecycle({ page, signal }); ``` ## S — strict-module standards (security, styling, structure) carried over for a consumer app | id | normal | strict | detects | |---|---|---|---| | S1 | warn | error | own CSS files, @import, , adoptedStyleSheets,