praxis-kit 1.1.1 → 2.0.1

package/dist/web/index.js

@@ -9,7 +9,7 @@ function applyFilter(props, filterProps, variantKeys) {
   return out;
 }
 
-// ../core/dist/chunk-US6MPMDF.js
+// ../core/dist/chunk-XFCAUPVZ.js
 function makeResolveTag(defaultTag) {
   return function tag(as) {
     return as ?? defaultTag;
@@ -244,7 +244,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,
@@ -252,9 +256,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(
@@ -570,184 +577,7 @@ function isStandaloneTag(tag) {
   return STANDALONE_ROLES_SET.has(IMPLICIT_ROLE_RECORD[tag]);
 }
 
-// ../core/dist/chunk-7YNORQXK.js
-var COMPONENT_DEFAULT_TAG = /* @__PURE__ */ Symbol("praxis.component-default-tag");
-function resolveChildTag(child) {
-  if (!isObject(child) || !("type" in child)) return void 0;
-  const t = child.type;
-  if (isString(t)) return t;
-  if (isObject(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;
-    return isString(as) ? as : defaultTag;
-  }
-  return void 0;
-}
-function isTag(...tags) {
-  const set = new Set(tags);
-  return (child) => {
-    const tag = resolveChildTag(child);
-    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 };
-}
-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 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
-};
+// ../core/dist/chunk-VU44HAB7.js
 var IMPLICIT_ROLE_RECORD2 = {
   article: "article",
   aside: "complementary",
@@ -776,6 +606,27 @@ 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;
+  const t = child.type;
+  if (isString(t)) return t;
+  if (isObject(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;
+    return isString(as) ? as : defaultTag;
+  }
+  return void 0;
+}
+function isTag(...tags) {
+  const set = new Set(tags);
+  return (child) => {
+    const tag = resolveChildTag(child);
+    return tag !== void 0 && set.has(tag);
+  };
+}
 var pendingAsyncWarns2 = /* @__PURE__ */ new Set();
 var asyncWarnScheduled2 = false;
 function flushAsyncWarns2() {
@@ -1445,8 +1296,223 @@ var ChildrenEvaluator = class extends StrictBase {
     this.invariant(errors.length === 0, this.#matchBuilder.toError(errors).message);
   }
 };
+var disabledProps = ({
+  disabled,
+  "aria-disabled": ariaDisabled,
+  "data-disabled": dataDisabled
+}) => {
+  if (!disabled) return {};
+  return {
+    ...ariaDisabled === void 0 && { "aria-disabled": "true" },
+    ...dataDisabled === void 0 && { "data-disabled": "" }
+  };
+};
+var invalidProps = ({
+  invalid,
+  "aria-invalid": ariaInvalid,
+  "data-invalid": dataInvalid
+}) => {
+  if (!invalid) return {};
+  return {
+    ...ariaInvalid === void 0 && { "aria-invalid": "true" },
+    ...dataInvalid === void 0 && { "data-invalid": "" }
+  };
+};
+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 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) => 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 };
+}
+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();
+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;
+}
 
-// ../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) => {
@@ -1612,7 +1678,12 @@ 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);
 }
@@ -1746,13 +1817,16 @@ function resolveHostState(bundle, props) {
   const { as, className, variantKey, ...rest } = props;
   const tag = bundle.runtime.resolveTag(as);
   const mergedProps = bundle.runtime.resolveProps(rest);
+  const baseProps = bundle.runtime.options.normalizeFn ? bundle.runtime.options.normalizeFn(mergedProps) : mergedProps;
+  const htmlNormalizers = bundle.runtime.options.htmlPropNormalizersFn?.(tag);
+  const normalizedProps = htmlNormalizers?.length ? htmlNormalizers.reduce((acc, fn) => ({ ...acc, ...fn(acc) }), baseProps) : baseProps;
   const resolvedClass = bundle.runtime.resolveClasses(
     tag,
-    mergedProps,
+    normalizedProps,
     className,
     variantKey
   );
-  const ariaResult = bundle.runtime.resolveAria(tag, mergedProps);
+  const ariaResult = bundle.runtime.resolveAria(tag, normalizedProps);
   const attributes = applyFilter(
     ariaResult.props,
     bundle.filterProps,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "praxis-kit",
-  "version": "1.1.1",
+  "version": "2.0.1",
   "type": "module",
   "exports": {
     "./react": {
@@ -54,6 +54,10 @@
     "./codemod": {
       "types": "./dist/codemod/index.d.ts",
       "import": "./dist/codemod/index.js"
+    },
+    "./contract": {
+      "types": "./dist/contract/index.d.ts",
+      "import": "./dist/contract/index.js"
     }
   },
   "bin": {
@@ -126,8 +130,8 @@
     "vite": "^8.0.16",
     "vue": "^3.5.38",
     "@praxis-kit/adapter-utils": "0.0.0",
-    "@praxis-kit/shared": "0.8.0-beta.4",
-    "@praxis-kit/core": "0.8.0-beta.4"
+    "@praxis-kit/core": "0.8.0-beta.4",
+    "@praxis-kit/shared": "0.8.0-beta.4"
   },
   "publishConfig": {
     "access": "public"