praxis-kit 6.5.0 → 6.6.1

package/dist/html/index.d.ts

@@ -0,0 +1,98 @@
+import { ReadonlyDeep } from 'type-fest';
+import { DiagnosticInput } from '../_shared/diagnostics.js';
+
+type StringMap<T = unknown> = Record<string, T>;
+type AnyRecord = StringMap<unknown>;
+
+type IntrinsicTag = keyof HTMLElementTagNameMap;
+
+declare const KNOWN_ARIA_ROLES: readonly ["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeitem"];
+type KnownAriaRole = (typeof KNOWN_ARIA_ROLES)[number];
+
+type AriaRole = KnownAriaRole | (string & {});
+type IntrinsicProps = AnyRecord & {
+    role?: AriaRole;
+};
+
+type ValidResult = {
+    valid: true;
+};
+
+type AriaContext = {
+    readonly tag: IntrinsicTag;
+    readonly implicitRole: AriaRole | undefined;
+    readonly effectiveRole: string | undefined;
+    readonly props: ReadonlyDeep<IntrinsicProps>;
+};
+
+type RemoveAttributeFixKind = `removeAttribute:${string}`;
+type InjectLiveFixKind = `injectLive:${string}`;
+type FixKind = 'removeRole' | 'setRole' | 'normalizeRelevantAll' | RemoveAttributeFixKind | InjectLiveFixKind;
+
+type AriaFixResult = {
+    applied: false;
+    next: ReadonlyDeep<IntrinsicProps>;
+} | {
+    applied: true;
+    next: ReadonlyDeep<IntrinsicProps>;
+    previous: ReadonlyDeep<IntrinsicProps>;
+};
+type AriaFix = {
+    readonly kind: FixKind;
+    readonly priority?: number;
+    readonly source?: string;
+    readonly apply: (context: AriaContext) => AriaFixResult;
+};
+
+type Severity = 'error' | 'warning' | (string & {});
+
+type AriaInvalidBase<M extends string = string> = {
+    valid: false;
+    severity: Severity;
+    message?: M;
+    attribute?: string;
+    diagnostic?: DiagnosticInput;
+};
+type AriaInvalidWithFix<M extends string = string> = AriaInvalidBase<M> & {
+    fixable: true;
+    fix: AriaFix;
+};
+type AriaInvalidWithoutFix<M extends string = string> = AriaInvalidBase<M> & {
+    fixable: false;
+};
+type AriaInvalidResult<M extends string = string> = AriaInvalidWithFix<M> | AriaInvalidWithoutFix<M>;
+type AriaResult = ValidResult | AriaInvalidResult;
+
+type AriaRule<C extends AriaContext = AriaContext> = ((context: C) => readonly AriaResult[]) & {
+    readonly readsProps?: readonly string[];
+    readonly tags?: readonly string[];
+};
+
+declare const landmarkRoleRule: AriaRule;
+declare function requireAccessibleName({ tag, props }: AriaContext): readonly AriaResult[];
+declare const landmarkAccessibleNameRule: AriaRule;
+declare const HTML_ARIA_RULES: readonly AriaRule[];
+
+declare const roleNotPermittedRule: AriaRule;
+
+declare const supportedInputTypeRule: AriaRule;
+declare const checkedRequiresCheckableTypeRule: AriaRule;
+declare const multipleRequiresSupportedTypeRule: AriaRule;
+declare const maxLengthRequiresTextTypeRule: AriaRule;
+declare const minLengthRequiresTextTypeRule: AriaRule;
+declare const patternRequiresTextTypeRule: AriaRule;
+declare const minRequiresNumericTypeRule: AriaRule;
+declare const maxRequiresNumericTypeRule: AriaRule;
+declare const stepRequiresNumericTypeRule: AriaRule;
+declare const acceptRequiresFileTypeRule: AriaRule;
+declare const captureRequiresFileTypeRule: AriaRule;
+declare const sizeRequiresTextTypeRule: AriaRule;
+declare const altRequiresImageTypeRule: AriaRule;
+declare const heightRequiresImageTypeRule: AriaRule;
+declare const widthRequiresImageTypeRule: AriaRule;
+declare const inputAccessibleNameRule: AriaRule;
+declare const passwordAutocompleteRule: AriaRule;
+declare const requiredReadOnlyConflictRule: AriaRule;
+declare const INPUT_RULES: readonly AriaRule[];
+
+export { HTML_ARIA_RULES, INPUT_RULES, acceptRequiresFileTypeRule, altRequiresImageTypeRule, captureRequiresFileTypeRule, checkedRequiresCheckableTypeRule, heightRequiresImageTypeRule, inputAccessibleNameRule, landmarkAccessibleNameRule, landmarkRoleRule, maxLengthRequiresTextTypeRule, maxRequiresNumericTypeRule, minLengthRequiresTextTypeRule, minRequiresNumericTypeRule, multipleRequiresSupportedTypeRule, passwordAutocompleteRule, patternRequiresTextTypeRule, requireAccessibleName, requiredReadOnlyConflictRule, roleNotPermittedRule, sizeRequiresTextTypeRule, stepRequiresNumericTypeRule, supportedInputTypeRule, widthRequiresImageTypeRule };