praxis-kit 6.2.3 → 6.6.0

package/dist/preact/index.d.ts

@@ -236,6 +236,7 @@ type AriaResult = ValidResult | AriaInvalidResult;
 
 type AriaRule<C extends AriaContext = AriaContext> = ((context: C) => readonly AriaResult[]) & {
     readonly readsProps?: readonly string[];
+    readonly tags?: readonly string[];
 };
 
 type PropNormalizer = (props: Readonly<AnyRecord & IntrinsicProps>) => Partial<AnyRecord & IntrinsicProps>;
@@ -248,6 +249,16 @@ type EnforcementOptions<TAllowed extends ElementType = ElementType> = {
      */
     readonly diagnostics?: Diagnostics | DiagnosticsMode;
     readonly aria?: readonly AriaRule[];
+    /**
+     * Rules that need `AriaPolicyEngine`'s fix-application/caching machinery
+     * (`AriaRule`'s `readsProps`, fixable `AriaFix` results) but have no
+     * relationship to ARIA semantics — an HTML fact or a security check like a
+     * dangerous-URL-scheme guard, for example. Evaluated together with `aria`
+     * (both run through the same engine, merged into one rule set) — this is a
+     * separate bucket purely so a non-ARIA rule doesn't have to sit under the
+     * misleading `aria` name to get the machinery it needs.
+     */
+    readonly rules?: readonly AriaRule[];
     readonly children?: readonly ChildRuleInput[];
     /**
      * When true, only children matching a `children` rule (or text, per `allowText`)
@@ -336,6 +347,15 @@ type PolymorphicWithAsChild<G extends PolymorphicGenerics, TAs extends ElementTy
 type PolymorphicComponent<G extends PolymorphicGenerics> = {
     <TAs extends ElementType = DefaultOf<G>>(props: PolymorphicWithAsChild<G, TAs>): AnyVNode;
     <TAs extends ElementType = DefaultOf<G>>(props: PolymorphicProps<G, TAs>): AnyVNode;
+    /**
+     * Non-generic fallback overload used for type extraction.
+     *
+     * TypeScript resolves conditional types such as
+     * `ComponentProps<typeof Component>` against only the final overload.
+     * Anchoring that overload to the default element preserves correct prop
+     * inference for tools such as Storybook and `ComponentProps`.
+     */
+    (props: PolymorphicProps<G, DefaultOf<G>>): AnyVNode;
     displayName?: string;
 };