praxis-kit 6.1.0 → 6.2.0

package/dist/svelte/index.js

@@ -3,6 +3,16 @@ function defineContractComponent(options) {
   return (factory) => factory(options);
 }
 
+// ../../lib/primitive/src/tag/resolve-tag.ts
+function makeResolveTag(defaultTag) {
+  return function tag(as) {
+    return as ?? defaultTag;
+  };
+}
+
+// ../../lib/primitive/src/rule/rule-brand.ts
+var RULE_BRAND = /* @__PURE__ */ Symbol("praxis-kit/dynamic-rule");
+
 // ../../lib/primitive/src/guards/foundational/is-defined.ts
 function isUndefined(value) {
   return value === void 0;
@@ -12,8 +22,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;
@@ -25,6 +38,244 @@ function isNumber(value) {
   return typeof value === "number";
 }
 
+// ../../lib/primitive/src/rule/is-dynamic-rule.ts
+function isDynamicRule(rule) {
+  return isObject(rule, true) && rule[RULE_BRAND] === true;
+}
+
+// ../../lib/primitive/src/rule/resolve-rule.ts
+function resolveRule(rule, context) {
+  return isDynamicRule(rule) ? rule.resolve(context) : rule;
+}
+
+// ../../lib/primitive/src/utils/assert-never.ts
+function assertNever(value) {
+  throw new Error(`Unexpected value: ${String(value)}`);
+}
+
+// ../../lib/primitive/src/utils/cn.ts
+import { clsx } from "clsx";
+function cn(...inputs) {
+  return clsx(...inputs);
+}
+
+// ../../lib/primitive/src/utils/iterate.ts
+function find(iterable, callback) {
+  for (const value of iterable) {
+    const result = callback(value);
+    if (result != null) {
+      return result;
+    }
+  }
+  return null;
+}
+function some(iterable, predicate) {
+  for (const value of iterable) {
+    if (predicate(value)) return true;
+  }
+  return false;
+}
+function every(iterable, predicate) {
+  let index = 0;
+  for (const value of iterable) {
+    if (!predicate(value, index++)) {
+      return false;
+    }
+  }
+  return true;
+}
+function* filter(iterable, predicate) {
+  let index = 0;
+  for (const value of iterable) {
+    if (predicate(value, index++)) {
+      yield value;
+    }
+  }
+}
+function* map(iterable, callback) {
+  let index = 0;
+  for (const value of iterable) {
+    yield callback(value, index++);
+  }
+}
+function forEach(iterable, callback) {
+  let index = 0;
+  for (const value of iterable) {
+    callback(value, index++);
+  }
+}
+function reduce(iterable, initial, callback) {
+  let accumulator = initial;
+  let index = 0;
+  for (const value of iterable) {
+    accumulator = callback(accumulator, value, index++);
+  }
+  return accumulator;
+}
+function collect(iterable, callback) {
+  const result = {};
+  let index = 0;
+  for (const value of iterable) {
+    const entry = callback(value, index++);
+    if (entry === null) {
+      return null;
+    }
+    result[entry[0]] = entry[1];
+  }
+  return result;
+}
+function findLast(value, callback) {
+  for (let index = value.length - 1; index >= 0; index--) {
+    const result = callback(value[index], index);
+    if (result != null) {
+      return result;
+    }
+  }
+  return null;
+}
+function* items(collection) {
+  for (let i = 0; i < collection.length; i++) {
+    const item = collection.item(i);
+    if (item !== null) {
+      yield item;
+    }
+  }
+}
+function nodeList(list) {
+  return {
+    *[Symbol.iterator]() {
+      for (let i = 0; i < list.length; i++) {
+        const node = list.item(i);
+        if (node !== null) {
+          yield node;
+        }
+      }
+    }
+  };
+}
+function mapEntries(m) {
+  return m.entries();
+}
+function set(s) {
+  return s.values();
+}
+function hasOwn(object, key) {
+  return Object.hasOwn(object, key);
+}
+function* entries(object) {
+  for (const key in object) {
+    if (!hasOwn(object, key)) continue;
+    yield [key, object[key]];
+  }
+}
+function* keys(object) {
+  for (const [key] of entries(object)) {
+    yield key;
+  }
+}
+function* values(object) {
+  for (const [, value] of entries(object)) {
+    yield value;
+  }
+}
+function mapValues(object, callback) {
+  const result = {};
+  for (const [key, value] of entries(object)) {
+    result[key] = callback(value, key);
+  }
+  return result;
+}
+function forEachEntry(object, callback) {
+  for (const [key, value] of entries(object)) {
+    callback(key, value);
+  }
+}
+function forEachKey(object, callback) {
+  for (const key of keys(object)) {
+    callback(key);
+  }
+}
+function forEachValue(object, callback) {
+  for (const value of values(object)) {
+    callback(value);
+  }
+}
+function forEachSet(s, callback) {
+  for (const value of s) {
+    callback(value);
+  }
+}
+var iterate = Object.freeze({
+  entries,
+  filter,
+  find,
+  findLast,
+  forEach,
+  forEachEntry,
+  forEachKey,
+  forEachSet,
+  forEachValue,
+  items,
+  keys,
+  map,
+  mapEntries,
+  mapValues,
+  nodeList,
+  reduce,
+  collect,
+  set,
+  some,
+  every,
+  values
+});
+
+// ../../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-props.ts
+function mergeProps(defaultProps, props) {
+  return {
+    ...defaultProps ?? {},
+    ...props
+  };
+}
+
 // ../../lib/primitive/src/constants/aria/global-aria-attributes.ts
 var GLOBAL_ARIA_ATTRIBUTES = /* @__PURE__ */ new Set([
   "aria-atomic",
@@ -260,298 +511,39 @@ var ROLE_RESTRICTED_ATTRIBUTES = /* @__PURE__ */ new Map([
   [
     "aria-valuetext",
     /* @__PURE__ */ new Set(["meter", "progressbar", "scrollbar", "separator", "slider", "spinbutton"])
-  ]
-]);
-
-// ../../lib/primitive/src/guards/aria/is-aria-attribute.ts
-function isGlobalAriaAttribute(attr) {
-  return GLOBAL_ARIA_ATTRIBUTES.has(attr);
-}
-function isAriaAttributeValidForRole(attr, role) {
-  const allowedRoles = ROLE_RESTRICTED_ATTRIBUTES.get(attr);
-  if (isUndefined(allowedRoles)) return true;
-  if (isUndefined(role)) return false;
-  return allowedRoles.has(role);
-}
-
-// ../../lib/primitive/src/guards/aria/is-aria-role.ts
-function isStrongImplicitRole(tag) {
-  if (!(tag in IMPLICIT_ROLE_RECORD)) return false;
-  return STRONG_ROLES_SET.has(IMPLICIT_ROLE_RECORD[tag]);
-}
-function isStandaloneTag(tag) {
-  if (!(tag in IMPLICIT_ROLE_RECORD)) return false;
-  return STANDALONE_ROLES_SET.has(IMPLICIT_ROLE_RECORD[tag]);
-}
-function getInputImplicitRole(type) {
-  if (!isString(type) || !(type in INPUT_TYPE_ROLE_MAP)) return void 0;
-  return INPUT_TYPE_ROLE_MAP[type];
-}
-function getConditionalImplicitRole(tag, ariaLabel, ariaLabelledBy) {
-  const isNamed = isString(ariaLabel) || isString(ariaLabelledBy);
-  if (!isNamed) return void 0;
-  if (tag === "section") return "region";
-  if (tag === "form") return "form";
-  return void 0;
-}
-
-// ../../lib/contract/src/aria/aria-role-policy.ts
-function getImplicitRole(tag, props) {
-  if (tag in IMPLICIT_ROLE_RECORD) return IMPLICIT_ROLE_RECORD[tag];
-  if (tag === "input") return getInputImplicitRole(props?.type);
-  if (tag === "img") return props?.alt === "" ? "none" : "img";
-  if (tag === "section" || tag === "form") {
-    return getConditionalImplicitRole(tag, props?.["aria-label"], props?.["aria-labelledby"]);
-  }
-  return void 0;
-}
-
-// ../../lib/primitive/src/tag/resolve-tag.ts
-function makeResolveTag(defaultTag) {
-  return function tag(as) {
-    return as ?? defaultTag;
-  };
-}
-
-// ../../lib/primitive/src/rule/rule-brand.ts
-var RULE_BRAND = /* @__PURE__ */ Symbol("praxis-kit/dynamic-rule");
-
-// ../../lib/primitive/src/rule/is-dynamic-rule.ts
-function isDynamicRule(rule) {
-  return isObject(rule, true) && rule[RULE_BRAND] === true;
-}
-
-// ../../lib/primitive/src/rule/resolve-rule.ts
-function resolveRule(rule, context) {
-  return isDynamicRule(rule) ? rule.resolve(context) : rule;
-}
-
-// ../../lib/primitive/src/utils/assert-never.ts
-function assertNever(value) {
-  throw new Error(`Unexpected value: ${String(value)}`);
-}
-
-// ../../lib/primitive/src/utils/cn.ts
-import { clsx } from "clsx";
-function cn(...inputs) {
-  return clsx(...inputs);
-}
+  ]
+]);
 
-// ../../lib/primitive/src/utils/iterate.ts
-function find(iterable, callback) {
-  for (const value of iterable) {
-    const result = callback(value);
-    if (result != null) {
-      return result;
-    }
-  }
-  return null;
-}
-function some(iterable, predicate) {
-  for (const value of iterable) {
-    if (predicate(value)) return true;
-  }
-  return false;
-}
-function every(iterable, predicate) {
-  let index = 0;
-  for (const value of iterable) {
-    if (!predicate(value, index++)) {
-      return false;
-    }
-  }
-  return true;
-}
-function* filter(iterable, predicate) {
-  let index = 0;
-  for (const value of iterable) {
-    if (predicate(value, index++)) {
-      yield value;
-    }
-  }
-}
-function* map(iterable, callback) {
-  let index = 0;
-  for (const value of iterable) {
-    yield callback(value, index++);
-  }
-}
-function forEach(iterable, callback) {
-  let index = 0;
-  for (const value of iterable) {
-    callback(value, index++);
-  }
-}
-function reduce(iterable, initial, callback) {
-  let accumulator = initial;
-  let index = 0;
-  for (const value of iterable) {
-    accumulator = callback(accumulator, value, index++);
-  }
-  return accumulator;
-}
-function collect(iterable, callback) {
-  const result = {};
-  let index = 0;
-  for (const value of iterable) {
-    const entry = callback(value, index++);
-    if (entry === null) {
-      return null;
-    }
-    result[entry[0]] = entry[1];
-  }
-  return result;
-}
-function findLast(value, callback) {
-  for (let index = value.length - 1; index >= 0; index--) {
-    const result = callback(value[index], index);
-    if (result != null) {
-      return result;
-    }
-  }
-  return null;
-}
-function* items(collection) {
-  for (let i = 0; i < collection.length; i++) {
-    const item = collection.item(i);
-    if (item !== null) {
-      yield item;
-    }
-  }
-}
-function nodeList(list) {
-  return {
-    *[Symbol.iterator]() {
-      for (let i = 0; i < list.length; i++) {
-        const node = list.item(i);
-        if (node !== null) {
-          yield node;
-        }
-      }
-    }
-  };
-}
-function mapEntries(m) {
-  return m.entries();
-}
-function set(s) {
-  return s.values();
-}
-function hasOwn(object, key) {
-  return Object.hasOwn(object, key);
-}
-function* entries(object) {
-  for (const key in object) {
-    if (!hasOwn(object, key)) continue;
-    yield [key, object[key]];
-  }
-}
-function* keys(object) {
-  for (const [key] of entries(object)) {
-    yield key;
-  }
-}
-function* values(object) {
-  for (const [, value] of entries(object)) {
-    yield value;
-  }
-}
-function mapValues(object, callback) {
-  const result = {};
-  for (const [key, value] of entries(object)) {
-    result[key] = callback(value, key);
-  }
-  return result;
+// ../../lib/primitive/src/guards/aria/is-aria-attribute.ts
+function isGlobalAriaAttribute(attr) {
+  return GLOBAL_ARIA_ATTRIBUTES.has(attr);
 }
-function forEachEntry(object, callback) {
-  for (const [key, value] of entries(object)) {
-    callback(key, value);
-  }
+function isAriaAttributeValidForRole(attr, role) {
+  const allowedRoles = ROLE_RESTRICTED_ATTRIBUTES.get(attr);
+  if (isUndefined(allowedRoles)) return true;
+  if (isUndefined(role)) return false;
+  return allowedRoles.has(role);
 }
-function forEachKey(object, callback) {
-  for (const key of keys(object)) {
-    callback(key);
-  }
+
+// ../../lib/primitive/src/guards/aria/is-aria-role.ts
+function isStrongImplicitRole(tag) {
+  if (!(tag in IMPLICIT_ROLE_RECORD)) return false;
+  return STRONG_ROLES_SET.has(IMPLICIT_ROLE_RECORD[tag]);
 }
-function forEachValue(object, callback) {
-  for (const value of values(object)) {
-    callback(value);
-  }
+function isStandaloneTag(tag) {
+  if (!(tag in IMPLICIT_ROLE_RECORD)) return false;
+  return STANDALONE_ROLES_SET.has(IMPLICIT_ROLE_RECORD[tag]);
 }
-function forEachSet(s, callback) {
-  for (const value of s) {
-    callback(value);
-  }
+function getInputImplicitRole(type) {
+  if (!isString(type) || !(type in INPUT_TYPE_ROLE_MAP)) return void 0;
+  return INPUT_TYPE_ROLE_MAP[type];
 }
-var iterate = Object.freeze({
-  entries,
-  filter,
-  find,
-  findLast,
-  forEach,
-  forEachEntry,
-  forEachKey,
-  forEachSet,
-  forEachValue,
-  items,
-  keys,
-  map,
-  mapEntries,
-  mapValues,
-  nodeList,
-  reduce,
-  collect,
-  set,
-  some,
-  every,
-  values
-});
-
-// ../../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-props.ts
-function mergeProps(defaultProps, props) {
-  return {
-    ...defaultProps ?? {},
-    ...props
-  };
+function getConditionalImplicitRole(tag, ariaLabel, ariaLabelledBy) {
+  const isNamed = isString(ariaLabel) || isString(ariaLabelledBy);
+  if (!isNamed) return void 0;
+  if (tag === "section") return "region";
+  if (tag === "form") return "form";
+  return void 0;
 }
 
 // ../../lib/primitive/src/guards/children/component-id.ts
@@ -590,6 +582,17 @@ function isTag(...args) {
   return tag !== void 0 && set2.has(tag);
 }
 
+// ../../lib/contract/src/aria/aria-role-policy.ts
+function getImplicitRole(tag, props) {
+  if (tag in IMPLICIT_ROLE_RECORD) return IMPLICIT_ROLE_RECORD[tag];
+  if (tag === "input") return getInputImplicitRole(props?.type);
+  if (tag === "img") return props?.alt === "" ? "none" : "img";
+  if (tag === "section" || tag === "form") {
+    return getConditionalImplicitRole(tag, props?.["aria-label"], props?.["aria-labelledby"]);
+  }
+  return void 0;
+}
+
 // ../../lib/contract/src/diagnostics/aria.ts
 import { DiagnosticCategory, DiagnosticCode } from "../_shared/diagnostics.js";
 var AriaDiagnostics = {
@@ -969,7 +972,7 @@ var InvariantBase = class {
 };
 
 // ../../lib/contract/src/aria/polymorphic-validator.ts
-var VALID = [{ valid: true }];
+var NO_VIOLATIONS = [{ valid: true }];
 function isIntrinsicTag(tag) {
   return isString(tag);
 }
@@ -1011,17 +1014,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 hasRole = implicitRole != null || isString(props.role) && props.role.length > 0;
+    const hasRole = isNonNull(implicitRole) || isString(props.role) && props.role.length > 0;
     if (!hasRole) 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) {
@@ -1036,7 +1042,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,
@@ -1044,8 +1050,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);
       });
@@ -1053,7 +1059,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;
@@ -1061,24 +1067,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) => {
@@ -1087,12 +1105,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];
@@ -1108,6 +1126,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 = {};
@@ -1131,7 +1166,12 @@ 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) {
@@ -1221,7 +1261,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 [
         {
@@ -1233,11 +1273,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,
@@ -1250,8 +1290,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,
@@ -1267,7 +1307,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;
@@ -1385,12 +1425,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,
@@ -1421,13 +1461,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,
@@ -1450,9 +1490,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,
@@ -1475,9 +1516,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;
@@ -1501,12 +1542,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 [
       {
@@ -1525,7 +1566,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;
@@ -1549,10 +1590,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) => ({
@@ -1572,8 +1613,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,
@@ -1597,8 +1639,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) {
@@ -1625,7 +1667,7 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends InvariantBase {
         }
       ];
     }
-    return VALID;
+    return NO_VIOLATIONS;
   }
 };
 
@@ -2326,7 +2368,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);
   };
 }
@@ -2366,7 +2408,10 @@ function resolveFactoryOptions(options = {}) {
   const variantKeys = styling?.variants === void 0 ? EMPTY_VARIANT_KEYS : new Set(Object.keys(styling.variants));
   return Object.freeze({
     defaultTag: options.tag ?? "div",
-    diagnostics: resolveDiagnostics(enforcement?.diagnostics, silentDiagnostics),
+    diagnostics: resolveDiagnostics(
+      enforcement?.diagnostics,
+      options.diagnostics ?? silentDiagnostics
+    ),
     variantKeys,
     ...whenDefined("displayName", options.name),
     ...whenDefined("defaultProps", options.defaults),
@@ -2537,7 +2582,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);