praxis-kit 6.0.0 → 6.1.1

package/dist/{chunk-P5ZJBPAR.js → chunk-OGQ7QKKP.js}

@@ -12,8 +12,11 @@ function isUndefined(value) {
 function isNull(value) {
   return value === null;
 }
+function isNonNull(value) {
+  return value != null;
+}
 
-// ../../lib/primitive/src/utils/is-object.ts
+// ../../lib/primitive/src/utils/type-guards.ts
 function isObject(value, excludeArrays = false) {
   if (value === null || typeof value !== "object") return false;
   return excludeArrays ? !Array.isArray(value) : true;
@@ -24,16 +27,11 @@ function isString(value) {
 function isNumber(value) {
   return typeof value === "number";
 }
-
-// ../../lib/primitive/src/merge/constants.ts
-var EVENT_HANDLER_RE = /^on[A-Z]/;
-
-// ../../lib/primitive/src/merge/predicates.ts
 function isFunction(value) {
   return typeof value === "function";
 }
 function isPlainObject(value) {
-  if (!isObject(value)) return false;
+  if (!isObject(value, true)) return false;
   const proto = Object.getPrototypeOf(value);
   return proto === Object.prototype || proto === null;
 }
@@ -420,6 +418,9 @@ function makeResolveTag(defaultTag) {
   };
 }
 
+// ../../lib/primitive/src/merge/constants.ts
+var EVENT_HANDLER_RE = /^on[A-Z]/;
+
 // ../../lib/primitive/src/rule/rule-brand.ts
 var RULE_BRAND = /* @__PURE__ */ Symbol("praxis-kit/dynamic-rule");
 
@@ -614,14 +615,66 @@ var iterate = Object.freeze({
   values
 });
 
+// ../../lib/primitive/src/utils/lazy.ts
+function lazy(factory) {
+  let initialized = false;
+  let value;
+  return () => {
+    if (!initialized) {
+      value = factory();
+      initialized = true;
+    }
+    return value;
+  };
+}
+
+// ../../lib/primitive/src/utils/lru-cache.ts
+var LRUCache = class {
+  #maxSize;
+  #store = /* @__PURE__ */ new Map();
+  constructor(maxSize) {
+    if (!Number.isInteger(maxSize) || maxSize < 1) {
+      throw new RangeError("LRUCache maxSize must be a positive integer.");
+    }
+    this.#maxSize = maxSize;
+  }
+  get(key) {
+    if (!this.#store.has(key)) return void 0;
+    const value = this.#store.get(key);
+    this.#store.delete(key);
+    this.#store.set(key, value);
+    return value;
+  }
+  set(key, value) {
+    this.#store.delete(key);
+    this.#store.set(key, value);
+    if (this.#store.size > this.#maxSize) {
+      const lru = this.#store.keys().next().value;
+      if (lru !== void 0) this.#store.delete(lru);
+    }
+  }
+  has(key) {
+    return this.#store.has(key);
+  }
+  delete(key) {
+    return this.#store.delete(key);
+  }
+  get size() {
+    return this.#store.size;
+  }
+  clear() {
+    this.#store.clear();
+  }
+};
+
 // ../../lib/primitive/src/utils/merge-refs.ts
 function mergeRefsCore(...refs) {
-  const active = refs.filter((r) => r != null);
-  if (active.length === 0) return null;
-  if (active.length === 1) return active[0];
+  const resolvedRefs = refs.filter((r) => r != null);
+  if (resolvedRefs.length === 0) return null;
+  if (resolvedRefs.length === 1) return resolvedRefs[0] ?? null;
   return (value) => {
-    iterate.forEach(active, (ref) => {
-      if (typeof ref === "function") {
+    iterate.forEach(resolvedRefs, (ref) => {
+      if (isFunction(ref)) {
         ref(value);
       } else {
         ref.current = value;
@@ -675,28 +728,6 @@ function isTag(...args) {
   return tag !== void 0 && set2.has(tag);
 }
 
-// ../../lib/contract/src/strict/invariant-base.ts
-var InvariantBase = class {
-  diagnostics;
-  constructor(diagnostics) {
-    this.diagnostics = diagnostics;
-  }
-  get active() {
-    return this.diagnostics.active;
-  }
-  violate(input) {
-    this.diagnostics.error(input);
-  }
-  // Always caps at warn — never throws. ARIA 'warning' violations route here
-  // so they surface even in strict='throw' mode without aborting a render.
-  warn(input) {
-    this.diagnostics.warn(input);
-  }
-  invariant(condition, input) {
-    if (!condition) this.violate(input);
-  }
-};
-
 // ../../lib/contract/src/diagnostics/aria.ts
 import { DiagnosticCategory, DiagnosticCode } from "./_shared/diagnostics.js";
 var AriaDiagnostics = {
@@ -1053,8 +1084,30 @@ var SlotDiagnostics = {
   }
 };
 
+// ../../lib/contract/src/strict/invariant-base.ts
+var InvariantBase = class {
+  diagnostics;
+  constructor(diagnostics) {
+    this.diagnostics = diagnostics;
+  }
+  get active() {
+    return this.diagnostics.active;
+  }
+  violate(input) {
+    this.diagnostics.error(input);
+  }
+  // Always caps at warn — never throws. ARIA 'warning' violations route here
+  // so they surface even in strict='throw' mode without aborting a render.
+  warn(input) {
+    this.diagnostics.warn(input);
+  }
+  invariant(condition, input) {
+    if (!condition) this.violate(input);
+  }
+};
+
 // ../../lib/contract/src/aria/polymorphic-validator.ts
-var VALID = [{ valid: true }];
+var NO_VIOLATIONS = [{ valid: true }];
 function isIntrinsicTag(tag) {
   return isString(tag);
 }
@@ -1064,8 +1117,7 @@ function omitProp(obj, key) {
 }
 var AriaPolicyEngine = class _AriaPolicyEngine extends InvariantBase {
   #extraRules;
-  #planCache = /* @__PURE__ */ new Map();
-  static #MAX_CACHE = 100;
+  #planCache = new LRUCache(100);
   // Memoized AriaFix objects keyed by attribute name — the ARIA attribute set is
   // finite so this Map is bounded and avoids recreating closures on every cache miss.
   static #removeAttributeFixCache = /* @__PURE__ */ new Map();
@@ -1097,17 +1149,20 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends InvariantBase {
   static #deriveContext(tag, props) {
     if (!isIntrinsicTag(tag)) return { proceed: false, result: { props, violations: [] } };
     const implicitRole = getImplicitRole(tag, props);
-    const hasRole2 = implicitRole != null || isString(props.role) && props.role.length > 0;
+    const hasRole2 = isNonNull(implicitRole) || isString(props.role) && props.role.length > 0;
     if (!hasRole2) return { proceed: false, result: { props, violations: [] } };
     const normalized = _AriaPolicyEngine.#normalizeEmptyRole(tag, props);
-    if (normalized.normalized) return { proceed: false, result: normalized.result };
-    const effectiveRole = props.role ?? implicitRole;
+    const workingProps = normalized.normalized ? normalized.result.props : props;
+    const preExistingViolations = normalized.normalized ? normalized.result.violations : [];
+    const effectiveRole = workingProps.role ?? implicitRole;
     return {
       proceed: true,
       tag,
       implicitRole,
       effectiveRole,
-      context: { tag, props, implicitRole, effectiveRole }
+      props: workingProps,
+      preExistingViolations,
+      context: { tag, props: workingProps, implicitRole, effectiveRole }
     };
   }
   static #runRules(rules, context) {
@@ -1122,7 +1177,7 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends InvariantBase {
         } = context;
         const { message, attribute, severity } = result;
         const resolvedMessage = message ?? result.diagnostic?.message;
-        const fallbackDiag = resolvedMessage == null ? AriaDiagnostics.invalidRole(role, tag) : void 0;
+        const fallbackDiag = isNonNull(resolvedMessage) ? void 0 : AriaDiagnostics.invalidRole(role, tag);
         violations.push({
           message: resolvedMessage ?? fallbackDiag.message,
           tag,
@@ -1130,8 +1185,8 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends InvariantBase {
           attribute,
           severity,
           phase: "evaluate",
-          ...result.diagnostic != null && { diagnostic: result.diagnostic },
-          ...fallbackDiag != null && { diagnostic: fallbackDiag }
+          ...isNonNull(result.diagnostic) && { diagnostic: result.diagnostic },
+          ...isNonNull(fallbackDiag) && { diagnostic: fallbackDiag }
         });
         if (result.fixable) fixes.push(result.fix);
       });
@@ -1139,7 +1194,7 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends InvariantBase {
     return { violations, fixes };
   }
   static #getRules(context) {
-    if (_AriaPolicyEngine.#hasRole(context.props) || context.effectiveRole != null && _AriaPolicyEngine.#LIVE_REGION_ROLES.has(context.effectiveRole)) {
+    if (_AriaPolicyEngine.#hasRole(context.props) || isNonNull(context.effectiveRole) && _AriaPolicyEngine.#LIVE_REGION_ROLES.has(context.effectiveRole)) {
       return _AriaPolicyEngine.#pipeline;
     }
     return _AriaPolicyEngine.#implicitOnlyRules;
@@ -1147,24 +1202,36 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends InvariantBase {
   static evaluate(tag, props) {
     const derived = _AriaPolicyEngine.#deriveContext(tag, props);
     if (!derived.proceed) return derived.result;
-    const { tag: narrowedTag, implicitRole, context } = derived;
+    const {
+      tag: narrowedTag,
+      implicitRole,
+      context,
+      props: workingProps,
+      preExistingViolations
+    } = derived;
     const { violations, fixes } = _AriaPolicyEngine.#runRules(
       _AriaPolicyEngine.#getRules(context),
       context
     );
-    const next = _AriaPolicyEngine.#applyFixes(narrowedTag, implicitRole, props, fixes);
-    return { props: next, violations };
+    const next = _AriaPolicyEngine.#applyFixes(narrowedTag, implicitRole, workingProps, fixes);
+    return { props: next, violations: [...preExistingViolations, ...violations] };
   }
   static #evaluateWithRules(tag, props, extraRules) {
     const derived = _AriaPolicyEngine.#deriveContext(tag, props);
     if (!derived.proceed) return derived.result;
-    const { tag: narrowedTag, implicitRole, context } = derived;
+    const {
+      tag: narrowedTag,
+      implicitRole,
+      context,
+      props: workingProps,
+      preExistingViolations
+    } = derived;
     const { violations, fixes } = _AriaPolicyEngine.#runRules(
       [..._AriaPolicyEngine.#getRules(context), ...extraRules],
       context
     );
-    const next = _AriaPolicyEngine.#applyFixes(narrowedTag, implicitRole, props, fixes);
-    return { props: next, violations };
+    const next = _AriaPolicyEngine.#applyFixes(narrowedTag, implicitRole, workingProps, fixes);
+    return { props: next, violations: [...preExistingViolations, ...violations] };
   }
   report(violations) {
     iterate.forEach(violations, (v) => {
@@ -1173,12 +1240,12 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends InvariantBase {
       else this.warn(d);
     });
   }
-  // Cache key covers only the aria-relevant subset of props (tag + role + aria-* attrs).
-  // Non-aria props (className, onClick, etc.) do not affect ARIA decisions and are excluded
-  // so cache hits survive re-renders that only change non-aria props.
-  // Note: #extraRules are NOT included in the key — each engine instance has its own Map,
-  // so two engines with different rules never share cache entries. If caching ever becomes
-  // static/shared, rule identity would need to be folded into the key.
+  // Cache key covers only the aria-relevant subset of props (tag + role + aria-* attrs) —
+  // exactly what the built-in pipeline reads. Non-aria props (className, onClick, etc.) do
+  // not affect built-in ARIA decisions and are excluded so cache hits survive re-renders
+  // that only change non-aria props. This key alone is unsound for #extraRules, which may
+  // read arbitrary props outside this set — validate() extends it with #extraRulesKeySuffix,
+  // or bypasses the cache, to account for that.
   static #createPlanKey(tag, props) {
     if (!isIntrinsicTag(tag)) return null;
     const parts = [tag];
@@ -1194,6 +1261,23 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends InvariantBase {
     if (ariaEntries.length > 0) parts.push(...ariaEntries.sort());
     return parts.join("|");
   }
+  // Extends the base cache key with the props each extra rule declares it reads (`readsProps`).
+  // Returns null — meaning "don't cache" — if any extra rule omits `readsProps` (it may read
+  // arbitrary props the key can't account for) or if a declared prop's value isn't a primitive
+  // (object/array identity isn't stably representable in a string key).
+  static #extraRulesKeySuffix(extraRules, props) {
+    const parts = [];
+    for (const rule of extraRules) {
+      const readsProps = rule.readsProps;
+      if (!isNonNull(readsProps)) return null;
+      for (const propKey of readsProps) {
+        const v = props[propKey];
+        if (v !== void 0 && !isString(v) && !isNumber(v) && typeof v !== "boolean") return null;
+        parts.push(`x:${propKey}:${String(v)}`);
+      }
+    }
+    return parts.sort().join("|");
+  }
   static #computePlan(inputProps, resultProps) {
     const removals = /* @__PURE__ */ new Set();
     const updates = {};
@@ -1217,12 +1301,15 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends InvariantBase {
     return next;
   }
   validate(tag, props) {
-    const key = _AriaPolicyEngine.#createPlanKey(tag, props);
+    const baseKey = _AriaPolicyEngine.#createPlanKey(tag, props);
+    let key = baseKey;
+    if (this.#extraRules.length > 0) {
+      const suffix = _AriaPolicyEngine.#extraRulesKeySuffix(this.#extraRules, props);
+      key = isNonNull(baseKey) && isNonNull(suffix) ? `${baseKey}|${suffix}` : null;
+    }
     if (!isNull(key)) {
       const cached = this.#planCache.get(key);
       if (cached !== void 0) {
-        this.#planCache.delete(key);
-        this.#planCache.set(key, cached);
         if (cached.violations.length > 0) this.report(cached.violations);
         return {
           props: _AriaPolicyEngine.#applyPlan(props, cached.removals, cached.updates),
@@ -1239,10 +1326,6 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends InvariantBase {
       );
       const plan = { removals, updates, violations: result.violations };
       this.#planCache.set(key, plan);
-      if (this.#planCache.size > _AriaPolicyEngine.#MAX_CACHE) {
-        const lru = this.#planCache.keys().next().value;
-        if (lru !== void 0) this.#planCache.delete(lru);
-      }
     }
     return result;
   }
@@ -1313,7 +1396,7 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends InvariantBase {
     implicitRole
   }) {
     const role = props.role;
-    if (!implicitRole || !role || role === implicitRole) return VALID;
+    if (!implicitRole || !role || role === implicitRole) return NO_VIOLATIONS;
     if (isStrongImplicitRole(tag) && role === "region") {
       return [
         {
@@ -1325,11 +1408,11 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends InvariantBase {
         }
       ];
     }
-    return VALID;
+    return NO_VIOLATIONS;
   }
   static #checkRedundantRole({ tag, props, implicitRole }) {
     const role = props.role;
-    if (!implicitRole || !role || role !== implicitRole) return VALID;
+    if (!implicitRole || !role || role !== implicitRole) return NO_VIOLATIONS;
     return [
       {
         valid: false,
@@ -1342,8 +1425,8 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends InvariantBase {
   }
   static #checkStandaloneRegion({ tag, props, implicitRole }) {
     const role = props.role;
-    if (role !== "region") return VALID;
-    if (!isStandaloneTag(tag)) return VALID;
+    if (role !== "region") return NO_VIOLATIONS;
+    if (!isStandaloneTag(tag)) return NO_VIOLATIONS;
     return [
       {
         valid: false,
@@ -1359,7 +1442,7 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends InvariantBase {
     props,
     effectiveRole
   }) {
-    if (effectiveRole === "none" || effectiveRole === "presentation") return VALID;
+    if (effectiveRole === "none" || effectiveRole === "presentation") return NO_VIOLATIONS;
     const results = [];
     iterate.forEachEntry(props, (key) => {
       if (!key.startsWith("aria-")) return;
@@ -1477,12 +1560,12 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends InvariantBase {
     }
   }
   static #checkAriaAttributeValues({ props, effectiveRole }) {
-    if (effectiveRole === "none" || effectiveRole === "presentation") return VALID;
+    if (effectiveRole === "none" || effectiveRole === "presentation") return NO_VIOLATIONS;
     const results = [];
     iterate.forEachEntry(props, (key, value) => {
       if (!key.startsWith("aria-")) return;
       const type = _AriaPolicyEngine.#ARIA_VALUE_TYPES.get(key);
-      if (type == null) return;
+      if (!isNonNull(type)) return;
       if (_AriaPolicyEngine.#isValidAriaValue(value, type)) return;
       results.push({
         valid: false,
@@ -1513,13 +1596,13 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends InvariantBase {
     props,
     effectiveRole
   }) {
-    if (effectiveRole === "none" || effectiveRole === "presentation") return VALID;
+    if (effectiveRole === "none" || effectiveRole === "presentation") return NO_VIOLATIONS;
     const implicitLevel = _AriaPolicyEngine.#HEADING_IMPLICIT_LEVELS.get(tag);
-    if (implicitLevel == null) return VALID;
+    if (!isNonNull(implicitLevel)) return NO_VIOLATIONS;
     const raw = props["aria-level"];
-    if (raw == null) return VALID;
+    if (!isNonNull(raw)) return NO_VIOLATIONS;
     const n = typeof raw === "number" ? raw : typeof raw === "string" ? parseInt(raw, 10) : NaN;
-    if (!Number.isFinite(n) || n !== implicitLevel) return VALID;
+    if (!Number.isFinite(n) || n !== implicitLevel) return NO_VIOLATIONS;
     return [
       {
         valid: false,
@@ -1542,9 +1625,10 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends InvariantBase {
     props,
     effectiveRole
   }) {
-    if (!effectiveRole || !_AriaPolicyEngine.#NAME_REQUIRED_ROLES.has(effectiveRole)) return VALID;
-    if ("aria-label" in props || "aria-labelledby" in props) return VALID;
-    if (tag === "img" && typeof props.alt === "string" && props.alt.length > 0) return VALID;
+    if (!effectiveRole || !_AriaPolicyEngine.#NAME_REQUIRED_ROLES.has(effectiveRole))
+      return NO_VIOLATIONS;
+    if ("aria-label" in props || "aria-labelledby" in props) return NO_VIOLATIONS;
+    if (tag === "img" && typeof props.alt === "string" && props.alt.length > 0) return NO_VIOLATIONS;
     return [
       {
         valid: false,
@@ -1567,9 +1651,9 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends InvariantBase {
     props,
     effectiveRole
   }) {
-    if (!effectiveRole) return VALID;
+    if (!effectiveRole) return NO_VIOLATIONS;
     const required = _AriaPolicyEngine.#REQUIRED_PROPERTIES.get(effectiveRole);
-    if (required == null) return VALID;
+    if (!isNonNull(required)) return NO_VIOLATIONS;
     const results = [];
     iterate.forEach(required, (attr) => {
       if (attr in props) return;
@@ -1593,12 +1677,12 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends InvariantBase {
   ]);
   // WAI-ARIA 1.2 §6.6: aria-hidden="true" must not be placed on focusable elements.
   static #checkAriaHiddenOnFocusable({ tag, props }) {
-    if (props["aria-hidden"] !== "true" && props["aria-hidden"] !== true) return VALID;
+    if (props["aria-hidden"] !== "true" && props["aria-hidden"] !== true) return NO_VIOLATIONS;
     const isInteractive = _AriaPolicyEngine.#INTERACTIVE_TAGS.has(tag);
     if (!isInteractive) {
       const tabindex = props.tabindex;
       const n = typeof tabindex === "number" ? tabindex : typeof tabindex === "string" ? parseInt(tabindex, 10) : NaN;
-      if (!Number.isFinite(n) || n < 0) return VALID;
+      if (!Number.isFinite(n) || n < 0) return NO_VIOLATIONS;
     }
     return [
       {
@@ -1617,7 +1701,7 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends InvariantBase {
     props,
     effectiveRole
   }) {
-    if (effectiveRole !== "none" && effectiveRole !== "presentation") return VALID;
+    if (effectiveRole !== "none" && effectiveRole !== "presentation") return NO_VIOLATIONS;
     const results = [];
     iterate.forEachEntry(props, (key) => {
       if (!key.startsWith("aria-")) return;
@@ -1641,10 +1725,10 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends InvariantBase {
     ["timer", "off"]
   ]);
   static #checkMissingLiveRegion({ effectiveRole, props }) {
-    if (!effectiveRole) return VALID;
+    if (!effectiveRole) return NO_VIOLATIONS;
     const impliedLive = _AriaPolicyEngine.#LIVE_REGION_ROLES.get(effectiveRole);
-    if (!impliedLive) return VALID;
-    if ("aria-live" in props) return VALID;
+    if (!impliedLive) return NO_VIOLATIONS;
+    if ("aria-live" in props) return NO_VIOLATIONS;
     const injectLive = {
       kind: `injectLive:${effectiveRole}`,
       apply: (ctx) => ({
@@ -1664,8 +1748,9 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends InvariantBase {
     ];
   }
   static #checkMissingAtomic({ effectiveRole, props }) {
-    if (!effectiveRole || !_AriaPolicyEngine.#LIVE_REGION_ROLES.has(effectiveRole)) return VALID;
-    if ("aria-atomic" in props) return VALID;
+    if (!effectiveRole || !_AriaPolicyEngine.#LIVE_REGION_ROLES.has(effectiveRole))
+      return NO_VIOLATIONS;
+    if ("aria-atomic" in props) return NO_VIOLATIONS;
     return [
       {
         valid: false,
@@ -1689,8 +1774,8 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends InvariantBase {
   };
   static #checkInvalidAriaRelevant({ props }) {
     const relevant = props["aria-relevant"];
-    if (relevant === void 0) return VALID;
-    if (typeof relevant !== "string") return VALID;
+    if (relevant === void 0) return NO_VIOLATIONS;
+    if (typeof relevant !== "string") return NO_VIOLATIONS;
     const tokens = relevant.trim().split(/\s+/);
     const invalid = tokens.filter((t) => !_AriaPolicyEngine.#VALID_RELEVANT_TOKENS.has(t));
     if (invalid.length > 0) {
@@ -1717,7 +1802,7 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends InvariantBase {
         }
       ];
     }
-    return VALID;
+    return NO_VIOLATIONS;
   }
 };
 
@@ -2317,7 +2402,7 @@ function cva2(base, config) {
 // ../../lib/styling/src/static-class-resolver.ts
 var StaticClassResolver = class {
   #baseClass;
-  #cache = /* @__PURE__ */ new Map();
+  #cache = new LRUCache(200);
   #resolveTag;
   constructor(baseClass, tagMap) {
     this.#baseClass = Array.isArray(baseClass) ? baseClass.join(" ") : baseClass;
@@ -2331,17 +2416,9 @@ var StaticClassResolver = class {
   resolve(tag, skipTagMap = false) {
     if (typeof tag !== "string" || skipTagMap) return this.#baseClass;
     const cached = this.#cache.get(tag);
-    if (cached !== void 0) {
-      this.#cache.delete(tag);
-      this.#cache.set(tag, cached);
-      return cached;
-    }
+    if (cached !== void 0) return cached;
     const result = this.#resolveTag(tag);
     this.#cache.set(tag, result);
-    if (this.#cache.size > 200) {
-      const lru = this.#cache.keys().next().value;
-      if (lru !== void 0) this.#cache.delete(lru);
-    }
     return result;
   }
 };
@@ -2352,7 +2429,7 @@ var VariantClassResolver = class _VariantClassResolver {
   #recipeMap;
   #variantKeys;
   #precomputedClasses;
-  #cache = /* @__PURE__ */ new Map();
+  #cache = new LRUCache(1e3);
   constructor(cvaFn, recipeMap, variantKeys, precomputedClasses) {
     this.#cvaFn = cvaFn ?? null;
     this.#recipeMap = Object.freeze(recipeMap ?? {});
@@ -2367,17 +2444,9 @@ var VariantClassResolver = class _VariantClassResolver {
       if (precomputed !== void 0) return precomputed;
     }
     const cached = this.#cache.get(cacheKey);
-    if (cached !== void 0) {
-      this.#cache.delete(cacheKey);
-      this.#cache.set(cacheKey, cached);
-      return cached;
-    }
+    if (cached !== void 0) return cached;
     const result = this.#compute(props, recipe);
     this.#cache.set(cacheKey, result);
-    if (this.#cache.size > 1e3) {
-      const lru = this.#cache.keys().next().value;
-      if (lru !== void 0) this.#cache.delete(lru);
-    }
     return result;
   }
   #compute(props, recipe) {
@@ -2434,7 +2503,7 @@ function createClassPipeline(resolved) {
     const staticClasses = staticResolver.resolve(tag, recipe !== void 0);
     const variantClasses = variantResolver.resolve({ props, recipe });
     if (!className)
-      return staticClasses && variantClasses ? `${staticClasses} ${variantClasses}` : staticClasses || variantClasses;
+      return (staticClasses && variantClasses ? `${staticClasses} ${variantClasses}` : staticClasses || variantClasses) || void 0;
     return cn(staticClasses, variantClasses, className);
   };
 }
@@ -2645,7 +2714,7 @@ function createPolymorphic2(options = {}) {
       if (process.env.NODE_ENV !== "production") {
         validateRenderProps(resolved.diagnostics, resolved, props, recipe);
       }
-      return classPipeline(tag, props, className, recipe);
+      return classPipeline(tag, props, className, recipe) || void 0;
     },
     resolveAria(tag, props) {
       return resolveAriaFn(tag, props);
@@ -3005,8 +3074,7 @@ function render({
   childrenEvaluator
 }) {
   const state = prepareRenderState(runtime, props, filterProps);
-  let cached;
-  const getNormalizedChildren = () => cached ??= normalizeChildren(state.children);
+  const getNormalizedChildren = lazy(() => normalizeChildren(state.children));
   if (process.env.NODE_ENV !== "production") {
     childrenEvaluator?.evaluate(getNormalizedChildren(), {
       tag: state.tag,

package/dist/contract/index.d.ts

@@ -138,7 +138,7 @@ interface BaseClassOptions {
     baseClassName?: ClassName;
 }
 
-type ClassPipelineFn = (tag: unknown, props: AnyRecord, className?: ClassName, recipe?: string) => string;
+type ClassPipelineFn = (tag: unknown, props: AnyRecord, className?: ClassName, recipe?: string) => string | undefined;
 
 interface RecipeOptions<TVariants extends VariantMap = VariantMap> {
     recipeMap?: Record<string, RecipeTarget<TVariants>>;
@@ -215,7 +215,9 @@ type AriaInvalidWithoutFix<M extends string = string> = AriaInvalidBase<M> & {
 type AriaInvalidResult<M extends string = string> = AriaInvalidWithFix<M> | AriaInvalidWithoutFix<M>;
 type AriaResult = ValidResult | AriaInvalidResult;
 
-type AriaRule<C extends AriaContext = AriaContext> = (context: C) => readonly AriaResult[];
+type AriaRule<C extends AriaContext = AriaContext> = ((context: C) => readonly AriaResult[]) & {
+    readonly readsProps?: readonly string[];
+};
 
 type PropNormalizer = (props: Readonly<AnyRecord & IntrinsicProps>) => Partial<AnyRecord & IntrinsicProps>;
 

package/dist/eslint/index.js

@@ -244,7 +244,7 @@ var require_eslint_utils = __commonJS({
 // ../../plugins/eslint/src/rules/no-dead-compound.ts
 var import_eslint_utils = __toESM(require_eslint_utils(), 1);
 
-// ../../lib/primitive/src/utils/is-object.ts
+// ../../lib/primitive/src/utils/type-guards.ts
 function isString(value) {
   return typeof value === "string";
 }

package/dist/guards/index.d.ts

@@ -0,0 +1,36 @@
+type StringMap<T = unknown> = Record<string, T>;
+type AnyRecord = StringMap<unknown>;
+
+/**
+ * Resolves the effective HTML tag for a vnode:
+ *   - native element: returns its type string directly
+ *   - praxis-kit component: resolves `as ?? defaultTag`, mirroring render-time logic
+ *   - anything else: returns undefined
+ */
+declare function getTag(child: unknown): string | undefined;
+/**
+ * Checks whether a vnode resolves to one of the given intrinsic tag names.
+ * Matches native elements directly, and praxis-kit components by resolving
+ * `as ?? defaultTag` — the same logic used at render time.
+ *
+ * Two call forms are supported:
+ *   isTag('img')(child)        — curried, composable with Array#filter
+ *   isTag(child, 'img')        — direct, reads naturally in if-blocks
+ */
+type TagChild = {
+    type: unknown;
+};
+declare function isTag(tag: string, ...tags: readonly string[]): (child: unknown) => child is TagChild;
+declare function isTag(child: unknown, tag: string, ...tags: readonly string[]): boolean;
+/**
+ * Checks whether a vnode is flow content per the HTML content model: text nodes
+ * (string/number) always qualify, and elements/components qualify unless their
+ * resolved tag is in the blocked set.
+ */
+declare function isFlowContent(...blockedTags: readonly string[]): (child: unknown) => boolean;
+
+declare function isObject(value: unknown, excludeArrays: true): value is AnyRecord;
+declare function isObject(value: unknown, excludeArrays?: false): value is object;
+declare function isString(value: unknown): value is string;
+
+export { getTag, isFlowContent, isObject, isString, isTag };