praxis-kit 1.1.0 → 2.0.0

package/dist/{chunk-KDUNVQK2.js → chunk-ACAKUHH5.js}

@@ -1,4 +1,131 @@
-// ../core/dist/chunk-US6MPMDF.js
+// ../../adapters/react/src/shared/merge-refs.ts
+function mergeRefs(...refs) {
+  const active = refs.filter((r2) => r2 != null);
+  if (active.length === 0) return null;
+  if (active.length === 1) return active[0];
+  return (value) => {
+    for (const ref of active) {
+      if (typeof ref === "function") {
+        ref(value);
+      } else {
+        ref.current = value;
+      }
+    }
+  };
+}
+
+// ../../adapters/react/src/shared/slot/Slottable.tsx
+import { Fragment } from "react";
+import { jsx } from "react/jsx-runtime";
+function Slottable({ children }) {
+  return /* @__PURE__ */ jsx(Fragment, { children });
+}
+
+// ../../lib/primitive/src/utils/is-object.ts
+function isNull(value) {
+  return value === null;
+}
+function isObject(value) {
+  return !isNull(value) && typeof value === "object";
+}
+
+// ../../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;
+  const proto = Object.getPrototypeOf(value);
+  return proto === Object.prototype || proto === null;
+}
+
+// ../shared/src/constants/primitive/slot-name.ts
+var SLOT_NAME = "Slot";
+
+// ../../adapters/react/src/shared/slot/clone.ts
+import { cloneElement } from "react";
+function cloneWithProps(child, props, ref) {
+  return cloneElement(child, ref !== null ? { ...props, ref } : props);
+}
+
+// ../../adapters/react/src/shared/slot/invariant.ts
+function panic(message) {
+  throw new Error(message);
+}
+function invariant(condition, message) {
+  if (!condition) panic(message);
+}
+
+// ../../adapters/react/src/shared/slot/applySlot.ts
+import { isValidElement as isValidElement3 } from "react";
+
+// ../../adapters/react/src/shared/slot/extractSlottable.ts
+import { createElement, Fragment as Fragment2, isValidElement as isValidElement2 } from "react";
+
+// ../../adapters/react/src/shared/slot/predicates.ts
+import { isValidElement } from "react";
+function isSlottableElement(value) {
+  return isValidElement(value) && value.type === Slottable;
+}
+
+// ../../adapters/react/src/shared/slot/extractSlottable.ts
+function extractSlottable(children) {
+  const childrenArray = Array.isArray(children) ? children : [children];
+  const slottables = childrenArray.filter(isSlottableElement);
+  invariant(slottables.length <= 1, "Slot: multiple Slottable children are not allowed");
+  if (slottables.length === 0) {
+    return null;
+  }
+  const [slottable] = slottables;
+  invariant(slottable, "Missing Slottable element");
+  const child = slottable.props.children;
+  invariant(
+    child !== null && child !== void 0,
+    "Slottable expects exactly one React element child, received null"
+  );
+  invariant(
+    typeof child !== "string" && typeof child !== "number",
+    "Slottable expects exactly one React element child, received text content"
+  );
+  invariant(isValidElement2(child), "Slottable expects exactly one React element child");
+  invariant(child.type !== Fragment2, "Slottable child cannot be a Fragment");
+  const index = childrenArray.indexOf(slottable);
+  return {
+    child,
+    // Fragment wrapper: Slot owns no DOM node; ref composition happens only on the merge target.
+    rebuild(merged) {
+      const out = childrenArray.map((node, i) => i === index ? merged : node);
+      return createElement(Fragment2, null, ...out);
+    }
+  };
+}
+
+// ../../adapters/react/src/shared/slot/applySlot.ts
+function applySlot(children, slotProps, ref, cloneSlotChild) {
+  const extraction = extractSlottable(children);
+  if (extraction) {
+    const merged = cloneSlotChild({ child: extraction.child, slotProps, ref });
+    return extraction.rebuild(merged);
+  }
+  invariant(isValidElement3(children), "Slot: child must be a valid React element");
+  return cloneSlotChild({ child: children, slotProps, ref });
+}
+
+// ../../lib/adapter-utils/src/apply-filter.ts
+function applyFilter(props, filterProps, variantKeys) {
+  const out = {};
+  for (const k in props) {
+    if (!Object.hasOwn(props, k)) continue;
+    if (filterProps(k, variantKeys)) continue;
+    out[k] = props[k];
+  }
+  return out;
+}
+
+// ../core/dist/chunk-XFCAUPVZ.js
 function makeResolveTag(defaultTag) {
   return function tag(as) {
     return as ?? defaultTag;
@@ -29,11 +156,11 @@ function mergeProps(defaultProps, props) {
     ...props
   };
 }
-function isNull(value) {
+function isNull2(value) {
   return value === null;
 }
-function isObject(value) {
-  return !isNull(value) && typeof value === "object";
+function isObject2(value) {
+  return !isNull2(value) && typeof value === "object";
 }
 function isString(value) {
   return typeof value === "string";
@@ -169,7 +296,7 @@ function validateRenderProps(options, props, presetKey) {
     }
   }
 }
-function panic(message) {
+function panic2(message) {
   throw new Error(message);
 }
 function describe(value) {
@@ -179,12 +306,12 @@ function describe(value) {
 }
 function assertPluginShape(result) {
   if (result === null || typeof result !== "object")
-    panic(
+    panic2(
       `[praxis-kit] Plugin factory must return an object with a 'pipeline' function. Got: ${result === null ? "null" : typeof result}.`
     );
   const plugin = result;
   if (typeof plugin.pipeline !== "function")
-    panic(
+    panic2(
       `[praxis-kit] Plugin factory return value is missing a 'pipeline' function. Got pipeline: ${typeof plugin.pipeline}.`
     );
 }
@@ -193,7 +320,7 @@ function guardPipeline(pipeline) {
   return function guardedPipeline(tag, props, className, variantKey) {
     const result = pipeline(tag, props, className, variantKey);
     if (typeof result !== "string")
-      panic(`[praxis-kit] Plugin pipeline must return a string. Got: ${describe(result)}.`);
+      panic2(`[praxis-kit] Plugin pipeline must return a string. Got: ${describe(result)}.`);
     return result;
   };
 }
@@ -233,7 +360,11 @@ function createRuntimeObject(methods, resolved, pluginResult) {
   return pluginResult ? { ...methods, options: resolved, hasStyling: true, classPlugin: pluginResult } : { ...methods, options: resolved };
 }
 function createPolymorphic(options = {}, capabilities) {
-  const resolved = resolveFactoryOptions(options);
+  const baseResolved = resolveFactoryOptions(options);
+  const resolved = capabilities?.htmlPropNormalizersFn !== void 0 ? Object.freeze({
+    ...baseResolved,
+    htmlPropNormalizersFn: capabilities.htmlPropNormalizersFn
+  }) : baseResolved;
   if (process.env.NODE_ENV !== "production") validateFactoryOptions(resolved);
   const { pluginResult, classPipeline } = resolveClassPipeline(
     options,
@@ -241,9 +372,12 @@ function createPolymorphic(options = {}, capabilities) {
     resolved.strict,
     capabilities
   );
+  const allAriaRules = [
+    .../* @__PURE__ */ new Set([...capabilities?.htmlAriaRules ?? [], ...resolved.ariaRules ?? []])
+  ];
   const engine = options.enforcement !== void 0 && capabilities?.AriaEngine ? new capabilities.AriaEngine(
     resolved.strict,
-    resolved.ariaRules?.length ? { rules: resolved.ariaRules } : void 0
+    allAriaRules.length ? { rules: allAriaRules } : void 0
   ) : null;
   const methods = createRuntimeMethods(resolved, classPipeline, engine);
   return createRuntimeObject(
@@ -562,17 +696,45 @@ function isKnownAriaRole(value) {
   return isString(value) && KNOWN_ARIA_ROLES_SET.has(value);
 }
 
-// ../core/dist/chunk-7YNORQXK.js
+// ../core/dist/chunk-VU44HAB7.js
+var IMPLICIT_ROLE_RECORD2 = {
+  article: "article",
+  aside: "complementary",
+  footer: "contentinfo",
+  header: "banner",
+  main: "main",
+  nav: "navigation",
+  button: "button",
+  a: "link",
+  select: "listbox",
+  h1: "heading",
+  h2: "heading",
+  h3: "heading",
+  h4: "heading",
+  h5: "heading",
+  h6: "heading",
+  ul: "list",
+  ol: "list",
+  li: "listitem",
+  table: "table",
+  tr: "row",
+  td: "cell",
+  th: "columnheader"
+};
+function getImplicitRole(tag) {
+  if (tag in IMPLICIT_ROLE_RECORD2) return IMPLICIT_ROLE_RECORD2[tag];
+  return void 0;
+}
 var COMPONENT_DEFAULT_TAG = /* @__PURE__ */ Symbol("praxis.component-default-tag");
 function resolveChildTag(child) {
-  if (!isObject(child) || !("type" in child)) return void 0;
+  if (!isObject2(child) || !("type" in child)) return void 0;
   const t = child.type;
   if (isString(t)) return t;
-  if (isObject(t) && COMPONENT_DEFAULT_TAG in t) {
+  if (isObject2(t) && COMPONENT_DEFAULT_TAG in t) {
     const defaultTag = t[COMPONENT_DEFAULT_TAG];
     if (!isString(defaultTag)) return void 0;
     const props = child.props;
-    const as = isObject(props) && "as" in props ? props.as : void 0;
+    const as = isObject2(props) && "as" in props ? props.as : void 0;
     return isString(as) ? as : defaultTag;
   }
   return void 0;
@@ -584,245 +746,61 @@ function isTag(...tags) {
     return tag !== void 0 && set.has(tag);
   };
 }
-function isOpenContent(...blockedTags) {
-  const set = new Set(blockedTags);
-  return (child) => isObject(child) && "type" in child && (!isString(child.type) || !set.has(child.type));
-}
-var METADATA_TAGS = ["script", "template"];
-var metadataMatch = isTag(...METADATA_TAGS);
-function metadata(name = "metadata") {
-  return { name, match: metadataMatch };
+var pendingAsyncWarns2 = /* @__PURE__ */ new Set();
+var asyncWarnScheduled2 = false;
+function flushAsyncWarns2() {
+  asyncWarnScheduled2 = false;
+  const messages = [...pendingAsyncWarns2];
+  pendingAsyncWarns2.clear();
+  for (const msg of messages) {
+    console.warn(msg);
+  }
 }
-function firstOptional(name, tag) {
-  return { name, match: isTag(tag), cardinality: { max: 1 }, position: "first" };
+function scheduleAsyncWarn(message) {
+  if (pendingAsyncWarns2.has(message)) return;
+  pendingAsyncWarns2.add(message);
+  if (!asyncWarnScheduled2) {
+    asyncWarnScheduled2 = true;
+    queueMicrotask(flushAsyncWarns2);
+  }
 }
-function contract(children) {
-  return { strict: "warn", children };
+var StrictBase = class {
+  strict;
+  constructor(strict) {
+    this.strict = strict;
+  }
+  violate(message) {
+    if (this.strict === true || this.strict === "throw") {
+      throw new Error(message);
+    }
+    this.warn(message);
+  }
+  // Always caps at console.warn — never throws. ARIA 'warning' violations route here
+  // so they surface even in strict='throw' mode without aborting a render.
+  warn(message) {
+    if (!this.strict) return;
+    if (this.strict === "async-warn") {
+      scheduleAsyncWarn(message);
+      return;
+    }
+    console.warn(message);
+  }
+  invariant(condition, message) {
+    if (!condition) {
+      this.violate(message);
+    }
+  }
+};
+function isNull3(value) {
+  return value === null;
 }
-function ariaContract(aria) {
-  return { strict: "warn", aria };
+var VALID = [{ valid: true }];
+function isIntrinsicTag(tag) {
+  return isString(tag);
 }
-function firstChildContract(name, tag) {
-  return contract([firstOptional(name, tag), { name: "content", match: isOpenContent(tag) }]);
-}
-var VOID_TAGS = [
-  "area",
-  "base",
-  "br",
-  "col",
-  "embed",
-  "hr",
-  "img",
-  "input",
-  "link",
-  "meta",
-  "param",
-  "source",
-  "track",
-  "wbr"
-];
-var TEXT_ONLY_TAGS = ["option", "script", "style", "textarea", "title"];
-var LANDMARK_TAGS = ["article", "aside", "footer", "header", "main", "nav"];
-var listContract = contract([{ name: "list-item", match: isTag("li", ...METADATA_TAGS) }]);
-var tableContract = contract([
-  firstOptional("caption", "caption"),
-  { name: "colgroup", match: isTag("colgroup") },
-  { name: "thead", match: isTag("thead"), cardinality: { max: 1 } },
-  { name: "tbody", match: isTag("tbody") },
-  { name: "tfoot", match: isTag("tfoot"), cardinality: { max: 1 } },
-  { name: "table-row", match: isTag("tr", ...METADATA_TAGS) }
-]);
-var tableBodyContract = contract([
-  { name: "table-row", match: isTag("tr", ...METADATA_TAGS) }
-]);
-var tableRowContract = contract([
-  { name: "table-cell", match: isTag("td", "th", ...METADATA_TAGS) }
-]);
-var colgroupContract = contract([{ name: "column", match: isTag("col", "template") }]);
-var dlContract = contract([
-  { name: "term", match: isTag("dt") },
-  { name: "description", match: isTag("dd") },
-  { name: "group", match: isTag("div") },
-  metadata()
-]);
-var selectContract = contract([
-  { name: "option", match: isTag("option", "optgroup", "hr", ...METADATA_TAGS) }
-]);
-var optgroupContract = contract([
-  { name: "option", match: isTag("option", ...METADATA_TAGS) }
-]);
-var datalistContract = contract([
-  { name: "option", match: isTag("option", ...METADATA_TAGS) }
-]);
-var pictureContract = contract([
-  { name: "source", match: isTag("source", ...METADATA_TAGS) },
-  { name: "image", match: isTag("img"), cardinality: { min: 1, max: 1 }, position: "last" }
-]);
-var figureContract = contract([
-  { name: "caption", match: isTag("figcaption"), cardinality: { max: 1 } },
-  { name: "content", match: isOpenContent("figcaption") }
-]);
-var detailsContract = firstChildContract("summary", "summary");
-var fieldsetContract = firstChildContract("legend", "legend");
-var mediaContract = contract([
-  { name: "source", match: isTag("source") },
-  { name: "track", match: isTag("track") },
-  metadata(),
-  { name: "content", match: isOpenContent("source", "track", ...METADATA_TAGS) }
-]);
-var headContract = contract([
-  {
-    name: "metadata",
-    match: isTag("base", "link", "meta", "noscript", "script", "style", "template", "title")
-  }
-]);
-var htmlContract = contract([
-  { name: "head", match: isTag("head"), cardinality: { min: 1, max: 1 }, position: "first" },
-  { name: "body", match: isTag("body"), cardinality: { min: 1, max: 1 } }
-]);
-var voidContract = contract([]);
-var textOnlyContract = contract([
-  {
-    name: "text",
-    match: (child) => isString(child) || isNumber(child)
-  }
-]);
-var LANDMARK_TAG_SET = new Set(LANDMARK_TAGS);
-var removeLandmarkRoleOverride = {
-  kind: "removeRole",
-  apply: ({ props }) => {
-    if (!("role" in props)) return { applied: false, next: props };
-    const { role: _r, ...rest } = props;
-    return { applied: true, next: rest, previous: props };
-  }
-};
-function landmarkRoleRule({ tag, props, implicitRole }) {
-  if (!LANDMARK_TAG_SET.has(tag) || !implicitRole) return [];
-  const role = props.role;
-  if (!role || role === implicitRole) return [];
-  return [
-    {
-      valid: false,
-      fixable: true,
-      severity: "error",
-      fix: removeLandmarkRoleOverride,
-      message: `<${tag}> has a fixed landmark role="${implicitRole}". role="${role}" overrides it and confuses assistive technology. The override has been removed.`
-    }
-  ];
-}
-var landmarkContract = ariaContract([landmarkRoleRule]);
-var CONTRACT_GROUPS = [
-  [VOID_TAGS, voidContract],
-  [TEXT_ONLY_TAGS, textOnlyContract],
-  [LANDMARK_TAGS, landmarkContract],
-  [["ul", "ol", "menu"], listContract],
-  [["audio", "video"], mediaContract],
-  [["thead", "tbody", "tfoot"], tableBodyContract]
-];
-function contractMap(groups) {
-  return Object.fromEntries(
-    groups.flatMap(([tags, enforcement]) => tags.map((tag) => [tag, enforcement]))
-  );
-}
-var htmlContracts = {
-  ...contractMap(CONTRACT_GROUPS),
-  table: tableContract,
-  tr: tableRowContract,
-  colgroup: colgroupContract,
-  dl: dlContract,
-  select: selectContract,
-  optgroup: optgroupContract,
-  datalist: datalistContract,
-  picture: pictureContract,
-  figure: figureContract,
-  details: detailsContract,
-  fieldset: fieldsetContract,
-  head: headContract,
-  html: htmlContract
-};
-var IMPLICIT_ROLE_RECORD2 = {
-  article: "article",
-  aside: "complementary",
-  footer: "contentinfo",
-  header: "banner",
-  main: "main",
-  nav: "navigation",
-  button: "button",
-  a: "link",
-  select: "listbox",
-  h1: "heading",
-  h2: "heading",
-  h3: "heading",
-  h4: "heading",
-  h5: "heading",
-  h6: "heading",
-  ul: "list",
-  ol: "list",
-  li: "listitem",
-  table: "table",
-  tr: "row",
-  td: "cell",
-  th: "columnheader"
-};
-function getImplicitRole(tag) {
-  if (tag in IMPLICIT_ROLE_RECORD2) return IMPLICIT_ROLE_RECORD2[tag];
-  return void 0;
-}
-var pendingAsyncWarns2 = /* @__PURE__ */ new Set();
-var asyncWarnScheduled2 = false;
-function flushAsyncWarns2() {
-  asyncWarnScheduled2 = false;
-  const messages = [...pendingAsyncWarns2];
-  pendingAsyncWarns2.clear();
-  for (const msg of messages) {
-    console.warn(msg);
-  }
-}
-function scheduleAsyncWarn(message) {
-  if (pendingAsyncWarns2.has(message)) return;
-  pendingAsyncWarns2.add(message);
-  if (!asyncWarnScheduled2) {
-    asyncWarnScheduled2 = true;
-    queueMicrotask(flushAsyncWarns2);
-  }
-}
-var StrictBase = class {
-  strict;
-  constructor(strict) {
-    this.strict = strict;
-  }
-  violate(message) {
-    if (this.strict === true || this.strict === "throw") {
-      throw new Error(message);
-    }
-    this.warn(message);
-  }
-  // Always caps at console.warn — never throws. ARIA 'warning' violations route here
-  // so they surface even in strict='throw' mode without aborting a render.
-  warn(message) {
-    if (!this.strict) return;
-    if (this.strict === "async-warn") {
-      scheduleAsyncWarn(message);
-      return;
-    }
-    console.warn(message);
-  }
-  invariant(condition, message) {
-    if (!condition) {
-      this.violate(message);
-    }
-  }
-};
-function isNull2(value) {
-  return value === null;
-}
-var VALID = [{ valid: true }];
-function isIntrinsicTag(tag) {
-  return isString(tag);
-}
-function omitProp(obj, key) {
-  const { [key]: _, ...rest } = obj;
-  return rest;
+function omitProp(obj, key) {
+  const { [key]: _, ...rest } = obj;
+  return rest;
 }
 var AriaPolicyEngine = class _AriaPolicyEngine extends StrictBase {
   #extraRules;
@@ -968,7 +946,7 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends StrictBase {
   }
   validate(tag, props) {
     const key = _AriaPolicyEngine.#createPlanKey(tag, props);
-    if (!isNull2(key)) {
+    if (!isNull3(key)) {
       const cached = this.#planCache.get(key);
       if (cached !== void 0) {
         this.#planCache.delete(key);
@@ -982,7 +960,7 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends StrictBase {
     }
     const result = this.#extraRules.length ? _AriaPolicyEngine.#evaluateWithRules(tag, props, this.#extraRules) : _AriaPolicyEngine.evaluate(tag, props);
     if (result.violations.length > 0) this.report(result.violations);
-    if (!isNull2(key)) {
+    if (!isNull3(key)) {
       const { removals, updates } = _AriaPolicyEngine.#computePlan(
         props,
         result.props
@@ -1265,7 +1243,7 @@ function normalizeChildRule(rule) {
   };
 }
 function getChildType(child) {
-  if (!isObject(child) || !("type" in child)) return void 0;
+  if (!isObject2(child) || !("type" in child)) return void 0;
   return child.type;
 }
 function buildPartialIndex(rules) {
@@ -1437,6 +1415,21 @@ var ChildrenEvaluator = class extends StrictBase {
     this.invariant(errors.length === 0, this.#matchBuilder.toError(errors).message);
   }
 };
+var activeProps = ({
+  active,
+  "aria-current": ariaCurrent,
+  "data-active": dataActive
+}) => {
+  if (!active) return {};
+  return {
+    ...ariaCurrent === void 0 && {
+      "aria-current": "true"
+    },
+    ...dataActive === void 0 && {
+      "data-active": ""
+    }
+  };
+};
 var disabledProps = ({
   disabled,
   "aria-disabled": ariaDisabled,
@@ -1448,6 +1441,21 @@ var disabledProps = ({
     ...dataDisabled === void 0 && { "data-disabled": "" }
   };
 };
+var expandedProps = ({
+  expanded,
+  "aria-expanded": ariaExpanded,
+  "data-expanded": dataExpanded
+}) => {
+  if (!expanded) return {};
+  return {
+    ...ariaExpanded === void 0 && {
+      "aria-expanded": "true"
+    },
+    ...dataExpanded === void 0 && {
+      "data-expanded": ""
+    }
+  };
+};
 var invalidProps = ({
   invalid,
   "aria-invalid": ariaInvalid,
@@ -1459,6 +1467,247 @@ var invalidProps = ({
     ...dataInvalid === void 0 && { "data-invalid": "" }
   };
 };
+var loadingProps = ({
+  loading,
+  "aria-busy": ariaBusy,
+  "data-loading": dataLoading
+}) => {
+  if (!loading) return {};
+  return {
+    ...ariaBusy === void 0 && {
+      "aria-busy": "true"
+    },
+    ...dataLoading === void 0 && {
+      "data-loading": ""
+    }
+  };
+};
+var pressedProps = ({
+  pressed,
+  "aria-pressed": ariaPressed,
+  "data-pressed": dataPressed
+}) => {
+  if (!pressed) return {};
+  return {
+    ...ariaPressed === void 0 && {
+      "aria-pressed": "true"
+    },
+    ...dataPressed === void 0 && {
+      "data-pressed": ""
+    }
+  };
+};
+var readonlyProps = ({
+  readOnly,
+  "aria-readonly": ariaReadonly,
+  "data-readonly": dataReadonly
+}) => {
+  if (!readOnly) return {};
+  return {
+    ...ariaReadonly === void 0 && {
+      "aria-readonly": "true"
+    },
+    ...dataReadonly === void 0 && {
+      "data-readonly": ""
+    }
+  };
+};
+var selectedProps = ({
+  selected,
+  "aria-selected": ariaSelected,
+  "data-selected": dataSelected
+}) => {
+  if (!selected) return {};
+  return {
+    ...ariaSelected === void 0 && {
+      "aria-selected": "true"
+    },
+    ...dataSelected === void 0 && {
+      "data-selected": ""
+    }
+  };
+};
+var LANDMARK_TAG_SET = /* @__PURE__ */ new Set(["article", "aside", "footer", "header", "main", "nav"]);
+var removeLandmarkRoleOverride = {
+  kind: "removeRole",
+  apply: ({ props }) => {
+    if (!("role" in props)) return { applied: false, next: props };
+    const { role: _r, ...rest } = props;
+    return { applied: true, next: rest, previous: props };
+  }
+};
+function landmarkRoleRule({ tag, props, implicitRole }) {
+  if (!LANDMARK_TAG_SET.has(tag) || !implicitRole) return [];
+  const role = props.role;
+  if (!role || role === implicitRole) return [];
+  return [
+    {
+      valid: false,
+      fixable: true,
+      severity: "error",
+      fix: removeLandmarkRoleOverride,
+      message: `<${tag}> has a fixed landmark role="${implicitRole}". role="${role}" overrides it and confuses assistive technology. The override has been removed.`
+    }
+  ];
+}
+var HTML_ARIA_RULES = [landmarkRoleRule];
+function isOpenContent(...blockedTags) {
+  const set = new Set(blockedTags);
+  return (child) => isObject2(child) && "type" in child && (!isString(child.type) || !set.has(child.type));
+}
+var METADATA_TAGS = ["script", "template"];
+var metadataMatch = isTag(...METADATA_TAGS);
+function metadata(name = "metadata") {
+  return { name, match: metadataMatch };
+}
+function firstOptional(name, tag) {
+  return { name, match: isTag(tag), cardinality: { max: 1 }, position: "first" };
+}
+function contract(children) {
+  return { strict: "warn", children };
+}
+function ariaContract(aria) {
+  return { strict: "warn", aria };
+}
+function firstChildContract(name, tag) {
+  return contract([firstOptional(name, tag), { name: "content", match: isOpenContent(tag) }]);
+}
+var VOID_TAGS = [
+  "area",
+  "base",
+  "br",
+  "col",
+  "embed",
+  "hr",
+  "img",
+  "input",
+  "link",
+  "meta",
+  "param",
+  "source",
+  "track",
+  "wbr"
+];
+var TEXT_ONLY_TAGS = ["option", "script", "style", "textarea", "title"];
+var LANDMARK_TAGS = ["article", "aside", "footer", "header", "main", "nav"];
+var listContract = contract([{ name: "list-item", match: isTag("li", ...METADATA_TAGS) }]);
+var tableContract = contract([
+  firstOptional("caption", "caption"),
+  { name: "colgroup", match: isTag("colgroup") },
+  { name: "thead", match: isTag("thead"), cardinality: { max: 1 } },
+  { name: "tbody", match: isTag("tbody") },
+  { name: "tfoot", match: isTag("tfoot"), cardinality: { max: 1 } },
+  { name: "table-row", match: isTag("tr", ...METADATA_TAGS) }
+]);
+var tableBodyContract = contract([
+  { name: "table-row", match: isTag("tr", ...METADATA_TAGS) }
+]);
+var tableRowContract = contract([
+  { name: "table-cell", match: isTag("td", "th", ...METADATA_TAGS) }
+]);
+var colgroupContract = contract([{ name: "column", match: isTag("col", "template") }]);
+var dlContract = contract([
+  { name: "term", match: isTag("dt") },
+  { name: "description", match: isTag("dd") },
+  { name: "group", match: isTag("div") },
+  metadata()
+]);
+var selectContract = contract([
+  { name: "option", match: isTag("option", "optgroup", "hr", ...METADATA_TAGS) }
+]);
+var optgroupContract = contract([
+  { name: "option", match: isTag("option", ...METADATA_TAGS) }
+]);
+var datalistContract = contract([
+  { name: "option", match: isTag("option", ...METADATA_TAGS) }
+]);
+var pictureContract = contract([
+  { name: "source", match: isTag("source", ...METADATA_TAGS) },
+  { name: "image", match: isTag("img"), cardinality: { min: 1, max: 1 }, position: "last" }
+]);
+var figureContract = contract([
+  { name: "caption", match: isTag("figcaption"), cardinality: { max: 1 } },
+  { name: "content", match: isOpenContent("figcaption") }
+]);
+var detailsContract = firstChildContract("summary", "summary");
+var fieldsetContract = firstChildContract("legend", "legend");
+var mediaContract = contract([
+  { name: "source", match: isTag("source") },
+  { name: "track", match: isTag("track") },
+  metadata(),
+  { name: "content", match: isOpenContent("source", "track", ...METADATA_TAGS) }
+]);
+var headContract = contract([
+  {
+    name: "metadata",
+    match: isTag("base", "link", "meta", "noscript", "script", "style", "template", "title")
+  }
+]);
+var htmlContract = contract([
+  { name: "head", match: isTag("head"), cardinality: { min: 1, max: 1 }, position: "first" },
+  { name: "body", match: isTag("body"), cardinality: { min: 1, max: 1 } }
+]);
+var voidContract = contract([]);
+var textOnlyContract = contract([
+  {
+    name: "text",
+    match: (child) => isString(child) || isNumber(child)
+  }
+]);
+var landmarkContract = ariaContract([landmarkRoleRule]);
+var CONTRACT_GROUPS = [
+  [VOID_TAGS, voidContract],
+  [TEXT_ONLY_TAGS, textOnlyContract],
+  [LANDMARK_TAGS, landmarkContract],
+  [["ul", "ol", "menu"], listContract],
+  [["audio", "video"], mediaContract],
+  [["thead", "tbody", "tfoot"], tableBodyContract]
+];
+function contractMap(groups) {
+  return Object.fromEntries(
+    groups.flatMap(([tags, enforcement]) => tags.map((tag) => [tag, enforcement]))
+  );
+}
+var htmlContracts = {
+  ...contractMap(CONTRACT_GROUPS),
+  table: tableContract,
+  tr: tableRowContract,
+  colgroup: colgroupContract,
+  dl: dlContract,
+  select: selectContract,
+  optgroup: optgroupContract,
+  datalist: datalistContract,
+  picture: pictureContract,
+  figure: figureContract,
+  details: detailsContract,
+  fieldset: fieldsetContract,
+  head: headContract,
+  html: htmlContract
+};
+function buildEvaluatorMap() {
+  const map = /* @__PURE__ */ new Map();
+  for (const [tag, { children }] of Object.entries(htmlContracts)) {
+    if (children?.length) {
+      map.set(tag, new ChildrenEvaluator(children, "warn", `<${tag}>`));
+    }
+  }
+  return map;
+}
+var HTML_EVALUATORS = buildEvaluatorMap();
+function getHtmlChildrenEvaluator(tag) {
+  return typeof tag === "string" ? HTML_EVALUATORS.get(tag) : void 0;
+}
+var HTML_FORM_NORMALIZERS = /* @__PURE__ */ new Map([
+  ["button", [disabledProps]],
+  ["input", [disabledProps, readonlyProps, invalidProps]],
+  ["select", [disabledProps]],
+  ["textarea", [disabledProps, readonlyProps]],
+  ["fieldset", [disabledProps]],
+  ["optgroup", [disabledProps]]
+]);
+function getHtmlPropNormalizers(tag) {
+  return typeof tag === "string" ? HTML_FORM_NORMALIZERS.get(tag) : void 0;
+}
 function enforceAllowedAs(tag, allowedAs, strict, displayName) {
   if (allowedAs.includes(tag)) return;
   const component = displayName ? `<${displayName}>` : "component";
@@ -1472,7 +1721,7 @@ function enforceAllowedAs(tag, allowedAs, strict, displayName) {
   }
 }
 
-// ../core/dist/chunk-RHOMAG5Q.js
+// ../core/dist/chunk-EHCOMLJ4.js
 var falsyToString = (value) => typeof value === "boolean" ? `${value}` : value === 0 ? "0" : value;
 var cx = clsx;
 var cva = (base, config) => (props) => {
@@ -1638,138 +1887,16 @@ function createClassPipeline(resolved) {
 }
 
 // ../core/dist/index.js
-var FULL_CAPABILITIES = { createClassPipeline, AriaEngine: AriaPolicyEngine };
+var FULL_CAPABILITIES = {
+  createClassPipeline,
+  AriaEngine: AriaPolicyEngine,
+  htmlAriaRules: HTML_ARIA_RULES,
+  htmlPropNormalizersFn: getHtmlPropNormalizers
+};
 function createPolymorphic2(options = {}) {
   return createPolymorphic(options, FULL_CAPABILITIES);
 }
 
-// ../../adapters/react/src/shared/merge-refs.ts
-function mergeRefs(...refs) {
-  const active = refs.filter((r2) => r2 != null);
-  if (active.length === 0) return null;
-  if (active.length === 1) return active[0];
-  return (value) => {
-    for (const ref of active) {
-      if (typeof ref === "function") {
-        ref(value);
-      } else {
-        ref.current = value;
-      }
-    }
-  };
-}
-
-// ../../adapters/react/src/shared/slot/Slottable.tsx
-import { Fragment } from "react";
-import { jsx } from "react/jsx-runtime";
-function Slottable({ children }) {
-  return /* @__PURE__ */ jsx(Fragment, { children });
-}
-
-// ../../lib/primitive/src/utils/is-object.ts
-function isNull3(value) {
-  return value === null;
-}
-function isObject2(value) {
-  return !isNull3(value) && typeof value === "object";
-}
-
-// ../../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 (!isObject2(value)) return false;
-  const proto = Object.getPrototypeOf(value);
-  return proto === Object.prototype || proto === null;
-}
-
-// ../shared/src/constants/primitive/slot-name.ts
-var SLOT_NAME = "Slot";
-
-// ../../adapters/react/src/shared/slot/clone.ts
-import { cloneElement } from "react";
-function cloneWithProps(child, props, ref) {
-  return cloneElement(child, ref !== null ? { ...props, ref } : props);
-}
-
-// ../../adapters/react/src/shared/slot/invariant.ts
-function panic2(message) {
-  throw new Error(message);
-}
-function invariant(condition, message) {
-  if (!condition) panic2(message);
-}
-
-// ../../adapters/react/src/shared/slot/applySlot.ts
-import { isValidElement as isValidElement3 } from "react";
-
-// ../../adapters/react/src/shared/slot/extractSlottable.ts
-import { createElement, Fragment as Fragment2, isValidElement as isValidElement2 } from "react";
-
-// ../../adapters/react/src/shared/slot/predicates.ts
-import { isValidElement } from "react";
-function isSlottableElement(value) {
-  return isValidElement(value) && value.type === Slottable;
-}
-
-// ../../adapters/react/src/shared/slot/extractSlottable.ts
-function extractSlottable(children) {
-  const childrenArray = Array.isArray(children) ? children : [children];
-  const slottables = childrenArray.filter(isSlottableElement);
-  invariant(slottables.length <= 1, "Slot: multiple Slottable children are not allowed");
-  if (slottables.length === 0) {
-    return null;
-  }
-  const [slottable] = slottables;
-  invariant(slottable, "Missing Slottable element");
-  const child = slottable.props.children;
-  invariant(
-    child !== null && child !== void 0,
-    "Slottable expects exactly one React element child, received null"
-  );
-  invariant(
-    typeof child !== "string" && typeof child !== "number",
-    "Slottable expects exactly one React element child, received text content"
-  );
-  invariant(isValidElement2(child), "Slottable expects exactly one React element child");
-  invariant(child.type !== Fragment2, "Slottable child cannot be a Fragment");
-  const index = childrenArray.indexOf(slottable);
-  return {
-    child,
-    // Fragment wrapper: Slot owns no DOM node; ref composition happens only on the merge target.
-    rebuild(merged) {
-      const out = childrenArray.map((node, i) => i === index ? merged : node);
-      return createElement(Fragment2, null, ...out);
-    }
-  };
-}
-
-// ../../adapters/react/src/shared/slot/applySlot.ts
-function applySlot(children, slotProps, ref, cloneSlotChild) {
-  const extraction = extractSlottable(children);
-  if (extraction) {
-    const merged = cloneSlotChild({ child: extraction.child, slotProps, ref });
-    return extraction.rebuild(merged);
-  }
-  invariant(isValidElement3(children), "Slot: child must be a valid React element");
-  return cloneSlotChild({ child: children, slotProps, ref });
-}
-
-// ../../lib/adapter-utils/src/apply-filter.ts
-function applyFilter(props, filterProps, variantKeys) {
-  const out = {};
-  for (const k in props) {
-    if (!Object.hasOwn(props, k)) continue;
-    if (filterProps(k, variantKeys)) continue;
-    out[k] = props[k];
-  }
-  return out;
-}
-
 // ../../lib/adapter-utils/src/build-core-runtime.ts
 var EMPTY_SET = /* @__PURE__ */ new Set();
 function buildCoreRuntime(normalized) {
@@ -1942,7 +2069,9 @@ function resolveRenderState(runtime, props, filterProps) {
     );
   }
   const mergedProps = runtime.resolveProps(rest);
-  const normalizedProps = runtime.options.normalizeFn ? runtime.options.normalizeFn(mergedProps) : mergedProps;
+  const baseProps = runtime.options.normalizeFn ? runtime.options.normalizeFn(mergedProps) : mergedProps;
+  const htmlNormalizers = runtime.options.htmlPropNormalizersFn?.(tag);
+  const normalizedProps = htmlNormalizers?.length ? htmlNormalizers.reduce((acc, fn) => ({ ...acc, ...fn(acc) }), baseProps) : baseProps;
   const resolvedClass = runtime.resolveClasses(tag, normalizedProps, className, variantKey);
   const filteredProps = applyFilter(normalizedProps, filterProps, runtime.options.variantKeys);
   return buildRenderState(tag, buildDirectives(as, asChild), filteredProps, resolvedClass, children);
@@ -2022,7 +2151,10 @@ function render({
   const state = resolveRenderState(runtime, props, filterProps);
   let cached;
   const once = () => cached ??= normalizeChildren(state.children);
-  if (process.env.NODE_ENV !== "production") childrenEvaluator?.evaluate(once());
+  if (process.env.NODE_ENV !== "production") {
+    childrenEvaluator?.evaluate(once());
+    getHtmlChildrenEvaluator(state.tag)?.evaluate(once());
+  }
   if (typeof props.render === "function") {
     return props.render({ ...state.props, className: state.className, ref });
   }
@@ -2031,15 +2163,28 @@ function render({
 }
 
 // ../core/dist/contract.js
-var CONTRACTED_CAPABILITIES = { AriaEngine: AriaPolicyEngine };
+function stateContract(props) {
+  return { props };
+}
+var activeContract = stateContract([activeProps]);
+var disabledContract = stateContract([disabledProps]);
+var expandedContract = stateContract([expandedProps]);
+var invalidContract = stateContract([invalidProps]);
+var loadingContract = stateContract([loadingProps]);
+var pressedContract = stateContract([pressedProps]);
+var readonlyContract = stateContract([readonlyProps]);
+var selectedContract = stateContract([selectedProps]);
+var CONTRACTED_CAPABILITIES = {
+  AriaEngine: AriaPolicyEngine,
+  htmlAriaRules: HTML_ARIA_RULES,
+  htmlPropNormalizersFn: getHtmlPropNormalizers
+};
 function createContractedPolymorphic(options = {}) {
   return createPolymorphic(options, CONTRACTED_CAPABILITIES);
 }
 
 export {
   createPolymorphic,
-  disabledProps,
-  invalidProps,
   createContractedPolymorphic,
   buildEngines,
   composeFilter,