npm - aria-ease - Versions diffs - 6.7.0 → 6.9.0 - Mend

aria-ease 6.7.0 → 6.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (39) hide show

package/README.md +77 -10
package/bin/AccordionComponentStrategy-4ZEIQ2V6.js +42 -0
package/bin/ComboboxComponentStrategy-OGRVZXAF.js +64 -0
package/bin/MenuComponentStrategy-JAMTCSNF.js +81 -0
package/bin/TabsComponentStrategy-3SQURPMX.js +29 -0
package/bin/buildContracts-GBOY7UXG.js +437 -0
package/bin/{chunk-VPBHLMAS.js → chunk-LMSKLN5O.js} +21 -0
package/bin/chunk-PK5L2SAF.js +17 -0
package/bin/{chunk-2TOYEY5L.js → chunk-XERMSYEH.js} +12 -3
package/bin/cli.cjs +991 -128
package/bin/cli.js +33 -2
package/bin/{configLoader-XRF6VM4J.js → configLoader-Q6A4JLKW.js} +1 -1
package/{dist/contractTestRunnerPlaywright-UAOFNS7Z.js → bin/contractTestRunnerPlaywright-ZZNWDUYP.js} +270 -219
package/bin/{test-WRIJHN6H.js → test-OND56UUL.js} +97 -10
package/dist/AccordionComponentStrategy-4ZEIQ2V6.js +42 -0
package/dist/ComboboxComponentStrategy-OGRVZXAF.js +64 -0
package/dist/MenuComponentStrategy-JAMTCSNF.js +81 -0
package/dist/TabsComponentStrategy-3SQURPMX.js +29 -0
package/dist/chunk-PK5L2SAF.js +17 -0
package/dist/{chunk-2TOYEY5L.js → chunk-XERMSYEH.js} +12 -3
package/dist/{configLoader-IT4PWCJB.js → configLoader-WTGJAP4Z.js} +21 -0
package/{bin/contractTestRunnerPlaywright-UAOFNS7Z.js → dist/contractTestRunnerPlaywright-XBWJZMR3.js} +270 -219
package/dist/index.cjs +800 -96
package/dist/index.d.cts +136 -1
package/dist/index.d.ts +136 -1
package/dist/index.js +421 -16
package/dist/src/utils/test/AccordionComponentStrategy-WRHZOEN6.js +38 -0
package/dist/src/utils/test/ComboboxComponentStrategy-5AECQSRN.js +60 -0
package/dist/src/utils/test/MenuComponentStrategy-VKZQYLBE.js +77 -0
package/dist/src/utils/test/TabsComponentStrategy-BKG53SEV.js +26 -0
package/dist/src/utils/test/aria-contracts/accordion/accordion.contract.json +5 -11
package/dist/src/utils/test/aria-contracts/combobox/combobox.listbox.contract.json +1 -1
package/dist/src/utils/test/aria-contracts/menu/menu.contract.json +1 -1
package/dist/src/utils/test/{chunk-2TOYEY5L.js → chunk-XERMSYEH.js} +12 -3
package/dist/src/utils/test/{configLoader-LD4RV2WQ.js → configLoader-YE2CYGDG.js} +21 -0
package/dist/src/utils/test/{contractTestRunnerPlaywright-IRJOAEMT.js → contractTestRunnerPlaywright-LC5OAVXB.js} +262 -200
package/dist/src/utils/test/index.cjs +472 -88
package/dist/src/utils/test/index.js +97 -12
package/package.json +7 -2

package/dist/index.d.cts CHANGED Viewed

@@ -194,6 +194,141 @@ declare function makeComboboxAccessible({ comboboxInputId, comboboxButtonId, lis
 declare function makeTabsAccessible({ tabListId, tabsClass, tabPanelsClass, orientation, activateOnFocus, callback }: TabsConfig): AccessibilityInstance;
+type Level = "required" | "recommended" | "optional";
+type ContractMeta = {
+    id?: string;
+    version?: string;
+    description?: string;
+    source?: {
+        apg?: string;
+        wcag?: string[];
+    };
+    W3CName?: string;
+};
+type SelectorsMap = Record<string, string>;
+type RelationshipInvariant = {
+    type: "aria-reference";
+    from: string;
+    attribute: string;
+    to: string;
+    level?: Level;
+} | {
+    type: "contains";
+    parent: string;
+    child: string;
+    level?: Level;
+};
+type StaticAssertion = {
+    target: string;
+    attribute: string;
+    expectedValue?: string;
+    failureMessage: string;
+    level: Level;
+};
+type DynamicAction = {
+    type: "focus" | "type" | "click" | "keypress" | "hover";
+    target: string;
+    key?: string;
+    value?: string;
+    relativeTarget?: string;
+};
+type DynamicAssertion = {
+    target: string;
+    assertion: "toBeVisible" | "notToBeVisible" | "toHaveAttribute" | "toHaveValue" | "toHaveFocus" | "toHaveRole";
+    attribute?: string;
+    expectedValue?: string;
+    failureMessage?: string;
+    relativeTarget?: string;
+    level?: Level;
+};
+type DynamicTest = {
+    description: string;
+    level?: Level;
+    action: DynamicAction[];
+    assertions: DynamicAssertion[];
+};
+type JsonContract = {
+    meta?: ContractMeta;
+    selectors: SelectorsMap;
+    relationships?: RelationshipInvariant[];
+    static: Array<{
+        assertions: StaticAssertion[];
+    }>;
+    dynamic: DynamicTest[];
+};
+declare class FluentContract {
+    private readonly jsonContract;
+    constructor(jsonContract: JsonContract);
+    toJSON(): JsonContract;
+}
+declare class StaticTargetBuilder {
+    private readonly targetName;
+    private readonly sink;
+    constructor(targetName: string, sink: StaticAssertion[]);
+    has(attribute: string, expectedValue?: string): {
+        required: () => void;
+        recommended: () => void;
+        optional: () => void;
+    };
+}
+declare class StaticBuilder {
+    private readonly sink;
+    constructor(sink: StaticAssertion[]);
+    target(targetName: string): StaticTargetBuilder;
+}
+declare class DynamicChain {
+    private readonly key;
+    private readonly testsSink;
+    private readonly selectors;
+    private selectorTarget;
+    private readonly actions;
+    private readonly assertions;
+    private explicitDescription;
+    constructor(key: string, testsSink: DynamicTest[], selectors: SelectorsMap);
+    on(target: string): this;
+    describe(description: string): this;
+    focus(targetExpression: string): this;
+    visible(target: string): this;
+    hidden(target: string): this;
+    has(target: string, attribute: string, expectedValue?: string): this;
+    required(): void;
+    recommended(): void;
+    optional(): void;
+    private finalize;
+    private parseRelativeExpression;
+}
+declare class ContractBuilder {
+    private readonly componentName;
+    private metaValue;
+    private selectorsValue;
+    private readonly relationshipInvariants;
+    private readonly staticAssertions;
+    private readonly dynamicTests;
+    constructor(componentName: string);
+    meta(meta: ContractMeta): this;
+    selectors(selectors: SelectorsMap): this;
+    relationship(invariant: RelationshipInvariant): this;
+    relationships(builderFn: (r: {
+        ariaReference: (from: string, attribute: string, to: string) => {
+            required: () => void;
+            recommended: () => void;
+            optional: () => void;
+        };
+        contains: (parent: string, child: string) => {
+            required: () => void;
+            recommended: () => void;
+            optional: () => void;
+        };
+    }) => void): this;
+    static(builderFn: (s: StaticBuilder) => void): this;
+    when(key: string): DynamicChain;
+    private validateRelationshipInvariants;
+    private validateStaticTargets;
+    private validateDynamicTargets;
+    build(): JsonContract;
+}
+declare function contract(componentName: string, define: (c: ContractBuilder) => void): FluentContract;
 type StrictnessMode = 'minimal' | 'balanced' | 'strict' | 'paranoid';
 /**
@@ -213,4 +348,4 @@ declare function testUiComponent(componentName: string, component: HTMLElement |
  */
 declare function cleanupTests(): Promise<void>;
-export { cleanupTests, makeAccordionAccessible, makeBlockAccessible, makeCheckboxAccessible, makeComboboxAccessible, makeMenuAccessible, makeRadioAccessible, makeTabsAccessible, makeToggleAccessible, testUiComponent };
+export { ContractBuilder, type JsonContract, type RelationshipInvariant, cleanupTests, contract, makeAccordionAccessible, makeBlockAccessible, makeCheckboxAccessible, makeComboboxAccessible, makeMenuAccessible, makeRadioAccessible, makeTabsAccessible, makeToggleAccessible, testUiComponent };

package/dist/index.d.ts CHANGED Viewed

@@ -194,6 +194,141 @@ declare function makeComboboxAccessible({ comboboxInputId, comboboxButtonId, lis
 declare function makeTabsAccessible({ tabListId, tabsClass, tabPanelsClass, orientation, activateOnFocus, callback }: TabsConfig): AccessibilityInstance;
+type Level = "required" | "recommended" | "optional";
+type ContractMeta = {
+    id?: string;
+    version?: string;
+    description?: string;
+    source?: {
+        apg?: string;
+        wcag?: string[];
+    };
+    W3CName?: string;
+};
+type SelectorsMap = Record<string, string>;
+type RelationshipInvariant = {
+    type: "aria-reference";
+    from: string;
+    attribute: string;
+    to: string;
+    level?: Level;
+} | {
+    type: "contains";
+    parent: string;
+    child: string;
+    level?: Level;
+};
+type StaticAssertion = {
+    target: string;
+    attribute: string;
+    expectedValue?: string;
+    failureMessage: string;
+    level: Level;
+};
+type DynamicAction = {
+    type: "focus" | "type" | "click" | "keypress" | "hover";
+    target: string;
+    key?: string;
+    value?: string;
+    relativeTarget?: string;
+};
+type DynamicAssertion = {
+    target: string;
+    assertion: "toBeVisible" | "notToBeVisible" | "toHaveAttribute" | "toHaveValue" | "toHaveFocus" | "toHaveRole";
+    attribute?: string;
+    expectedValue?: string;
+    failureMessage?: string;
+    relativeTarget?: string;
+    level?: Level;
+};
+type DynamicTest = {
+    description: string;
+    level?: Level;
+    action: DynamicAction[];
+    assertions: DynamicAssertion[];
+};
+type JsonContract = {
+    meta?: ContractMeta;
+    selectors: SelectorsMap;
+    relationships?: RelationshipInvariant[];
+    static: Array<{
+        assertions: StaticAssertion[];
+    }>;
+    dynamic: DynamicTest[];
+};
+declare class FluentContract {
+    private readonly jsonContract;
+    constructor(jsonContract: JsonContract);
+    toJSON(): JsonContract;
+}
+declare class StaticTargetBuilder {
+    private readonly targetName;
+    private readonly sink;
+    constructor(targetName: string, sink: StaticAssertion[]);
+    has(attribute: string, expectedValue?: string): {
+        required: () => void;
+        recommended: () => void;
+        optional: () => void;
+    };
+}
+declare class StaticBuilder {
+    private readonly sink;
+    constructor(sink: StaticAssertion[]);
+    target(targetName: string): StaticTargetBuilder;
+}
+declare class DynamicChain {
+    private readonly key;
+    private readonly testsSink;
+    private readonly selectors;
+    private selectorTarget;
+    private readonly actions;
+    private readonly assertions;
+    private explicitDescription;
+    constructor(key: string, testsSink: DynamicTest[], selectors: SelectorsMap);
+    on(target: string): this;
+    describe(description: string): this;
+    focus(targetExpression: string): this;
+    visible(target: string): this;
+    hidden(target: string): this;
+    has(target: string, attribute: string, expectedValue?: string): this;
+    required(): void;
+    recommended(): void;
+    optional(): void;
+    private finalize;
+    private parseRelativeExpression;
+}
+declare class ContractBuilder {
+    private readonly componentName;
+    private metaValue;
+    private selectorsValue;
+    private readonly relationshipInvariants;
+    private readonly staticAssertions;
+    private readonly dynamicTests;
+    constructor(componentName: string);
+    meta(meta: ContractMeta): this;
+    selectors(selectors: SelectorsMap): this;
+    relationship(invariant: RelationshipInvariant): this;
+    relationships(builderFn: (r: {
+        ariaReference: (from: string, attribute: string, to: string) => {
+            required: () => void;
+            recommended: () => void;
+            optional: () => void;
+        };
+        contains: (parent: string, child: string) => {
+            required: () => void;
+            recommended: () => void;
+            optional: () => void;
+        };
+    }) => void): this;
+    static(builderFn: (s: StaticBuilder) => void): this;
+    when(key: string): DynamicChain;
+    private validateRelationshipInvariants;
+    private validateStaticTargets;
+    private validateDynamicTargets;
+    build(): JsonContract;
+}
+declare function contract(componentName: string, define: (c: ContractBuilder) => void): FluentContract;
 type StrictnessMode = 'minimal' | 'balanced' | 'strict' | 'paranoid';
 /**
@@ -213,4 +348,4 @@ declare function testUiComponent(componentName: string, component: HTMLElement |
  */
 declare function cleanupTests(): Promise<void>;
-export { cleanupTests, makeAccordionAccessible, makeBlockAccessible, makeCheckboxAccessible, makeComboboxAccessible, makeMenuAccessible, makeRadioAccessible, makeTabsAccessible, makeToggleAccessible, testUiComponent };
+export { ContractBuilder, type JsonContract, type RelationshipInvariant, cleanupTests, contract, makeAccordionAccessible, makeBlockAccessible, makeCheckboxAccessible, makeComboboxAccessible, makeMenuAccessible, makeRadioAccessible, makeTabsAccessible, makeToggleAccessible, testUiComponent };