praxis-kit 6.1.1 → 6.2.0

package/dist/contract/index.d.ts

@@ -214,6 +214,7 @@ type AriaInvalidWithoutFix<M extends string = string> = AriaInvalidBase<M> & {
 };
 type AriaInvalidResult<M extends string = string> = AriaInvalidWithFix<M> | AriaInvalidWithoutFix<M>;
 type AriaResult = ValidResult | AriaInvalidResult;
+type AriaPhase = 'evaluate' | 'fix';
 
 type AriaRule<C extends AriaContext = AriaContext> = ((context: C) => readonly AriaResult[]) & {
     readonly readsProps?: readonly string[];
@@ -268,6 +269,11 @@ type FactoryOptions<TDefault extends ElementType = ElementType, Props extends An
     readonly normalize?: NormalizeFn<NoInfer<Props>>;
     readonly styling?: StylingOptions<V, TPreset, TPlugin>;
     readonly enforcement?: EnforcementOptions<TAllowed>;
+    /**
+     * Adapter-resolved diagnostics default, spread in by `resolveAdapterCommonOptions`. Not meant to
+     * be set directly by component authors — use `enforcement.diagnostics` to override per component.
+     */
+    readonly diagnostics?: Diagnostics$1;
 };
 
 declare const activeProps: PropNormalizer;
@@ -299,4 +305,4 @@ declare function mergeContracts(...contracts: readonly EnforcementOptions[]): En
 
 type Diagnostics = Diagnostics$1;
 
-export { type AnyFactoryOptions, type Diagnostics, type PropNormalizer, activeContract, activeProps, disabledContract, disabledProps, expandedContract, expandedProps, invalidContract, invalidProps, loadingContract, loadingProps, mergeContracts, pressedContract, pressedProps, readonlyContract, readonlyProps, selectedContract, selectedProps };
+export { type AnyFactoryOptions, type AriaContext, type AriaFix, type AriaFixResult, type AriaPhase, type AriaResult, type AriaRule, type Diagnostics, type FixKind, type AriaInvalidResult as InvalidResult, type AriaInvalidWithFix as InvalidWithFix, type AriaInvalidWithoutFix as InvalidWithoutFix, type PropNormalizer, type RemoveAttributeFixKind, type Severity, type ValidResult, activeContract, activeProps, disabledContract, disabledProps, expandedContract, expandedProps, invalidContract, invalidProps, loadingContract, loadingProps, mergeContracts, pressedContract, pressedProps, readonlyContract, readonlyProps, selectedContract, selectedProps };

package/dist/lit/index.d.ts

@@ -270,6 +270,11 @@ type FactoryOptions<TDefault extends ElementType = ElementType, Props extends An
     readonly normalize?: NormalizeFn<NoInfer<Props>>;
     readonly styling?: StylingOptions<V, TPreset, TPlugin>;
     readonly enforcement?: EnforcementOptions<TAllowed>;
+    /**
+     * Adapter-resolved diagnostics default, spread in by `resolveAdapterCommonOptions`. Not meant to
+     * be set directly by component authors — use `enforcement.diagnostics` to override per component.
+     */
+    readonly diagnostics?: Diagnostics;
 };
 
 type FilterPredicate = (key: string, variantKeys: ReadonlySet<string>) => boolean;

package/dist/lit/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;
@@ -28,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",
@@ -298,265 +546,6 @@ function getConditionalImplicitRole(tag, ariaLabel, ariaLabelledBy) {
   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;
-}
-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/guards/children/component-id.ts
 var COMPONENT_DEFAULT_TAG = /* @__PURE__ */ Symbol.for("praxis.component-default-tag");
 
@@ -593,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 = {
@@ -2362,7 +2362,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),

package/dist/preact/index.d.ts

@@ -287,6 +287,11 @@ type FactoryOptions<TDefault extends ElementType = ElementType, Props extends An
     readonly normalize?: NormalizeFn<NoInfer<Props>>;
     readonly styling?: StylingOptions<V, TPreset, TPlugin>;
     readonly enforcement?: EnforcementOptions<TAllowed>;
+    /**
+     * Adapter-resolved diagnostics default, spread in by `resolveAdapterCommonOptions`. Not meant to
+     * be set directly by component authors — use `enforcement.diagnostics` to override per component.
+     */
+    readonly diagnostics?: Diagnostics;
 };
 
 declare function defineContractComponent<O extends FactoryOptions>(options: O): <R>(factory: (options: O) => R) => R;