praxis-kit 1.1.1 → 2.0.1

package/dist/solid/index.js

@@ -17,7 +17,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;
@@ -252,7 +252,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,
@@ -260,9 +264,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(
@@ -581,184 +588,7 @@ function isKnownAriaRole(value) {
   return isString(value) && KNOWN_ARIA_ROLES_SET.has(value);
 }
 
-// ../core/dist/chunk-7YNORQXK.js
-var COMPONENT_DEFAULT_TAG2 = /* @__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_TAG2 in t) {
-    const defaultTag = t[COMPONENT_DEFAULT_TAG2];
-    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",
@@ -787,6 +617,27 @@ function getImplicitRole(tag) {
   if (tag in IMPLICIT_ROLE_RECORD2) return IMPLICIT_ROLE_RECORD2[tag];
   return void 0;
 }
+var COMPONENT_DEFAULT_TAG2 = /* @__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_TAG2 in t) {
+    const defaultTag = t[COMPONENT_DEFAULT_TAG2];
+    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() {
@@ -1478,8 +1329,201 @@ var invalidProps = ({
     ...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) => {
@@ -1645,7 +1689,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);
 }
@@ -1783,9 +1832,11 @@ function render({
   const known = knownRaw;
   const tag = createMemo(() => resolveTag2(runtime, known.as));
   const mergedProps = createMemo(() => runtime.resolveProps(rest));
-  const normalizedProps = createMemo(
-    () => runtime.options.normalizeFn ? runtime.options.normalizeFn(mergedProps()) : mergedProps()
-  );
+  const normalizedProps = createMemo(() => {
+    const base = runtime.options.normalizeFn ? runtime.options.normalizeFn(mergedProps()) : mergedProps();
+    const htmlNormalizers = runtime.options.htmlPropNormalizersFn?.(tag());
+    return htmlNormalizers?.length ? htmlNormalizers.reduce((acc, fn) => ({ ...acc, ...fn(acc) }), base) : base;
+  });
   const resolvedClass = createMemo(
     () => runtime.resolveClasses(
       tag(),
@@ -1831,7 +1882,5 @@ function defineContractComponent(options) {
 }
 export {
   createContractComponent,
-  defineContractComponent,
-  disabledProps,
-  invalidProps
+  defineContractComponent
 };

package/dist/svelte/index.d.ts

@@ -229,6 +229,7 @@ type StylingOptions<V extends Readonly<VariantMap> = Readonly<EmptyRecord>, TPre
 type NormalizeFn<Props extends AnyRecord = AnyRecord> = {
     normalize(props: Readonly<Props & IntrinsicProps>): Props & IntrinsicProps;
 }['normalize'];
+type AnyFactoryOptions = FactoryOptions<ElementType, AnyRecord, VariantMap, PresetMap<VariantMap>, AnyRecord>;
 type FactoryOptions<TDefault extends ElementType = ElementType, Props extends AnyRecord = EmptyRecord, V extends Readonly<VariantMap> = Readonly<EmptyRecord>, TPreset extends PresetMap<V> = Readonly<EmptyRecord>, TPluginProps extends AnyRecord = EmptyRecord, TAllowed extends ElementType = ElementType> = {
     readonly tag?: TDefault;
     readonly name?: string;
@@ -251,6 +252,7 @@ type ResolvedFactoryOptions<TDefault extends ElementType = ElementType, Props ex
     readonly strict: StrictMode;
     readonly variantKeys: ReadonlySet<string>;
     readonly normalizeFn?: NormalizeFn<Props>;
+    readonly htmlPropNormalizersFn?: (tag: unknown) => readonly PropNormalizer[] | undefined;
     readonly childRules?: readonly ChildRuleInput[];
     readonly ariaRules?: readonly AriaRule[];
     readonly allowedAs?: readonly ElementType[];
@@ -294,10 +296,6 @@ declare class ChildrenEvaluator extends StrictBase {
     evaluate(children: unknown[]): void;
 }
 
-declare const disabledProps: PropNormalizer;
-
-declare const invalidProps: PropNormalizer;
-
 declare function createPolymorphic<TDefault extends ElementType, Props extends AnyRecord, Variants extends Readonly<VariantMap>, TPreset extends PresetMap<Variants> = Readonly<EmptyRecord>>(options?: FactoryOptions<TDefault, Props, Variants, TPreset>): PolymorphicRuntime<TDefault, Props, Variants, Extract<keyof TPreset, string>, TPreset>;
 
 declare class SlotValidator extends StrictBase {
@@ -340,4 +338,4 @@ declare function createContractComponent<TDefault extends ElementType, Props ext
 
 declare function defineContractComponent<O extends FactoryOptions>(options: O): <R>(factory: (options: O) => R) => R;
 
-export { type BuiltRuntime, type ElementType, type EmptyRecord, type FilterPredicate, type PolymorphicGenerics, type SvelteFactoryOptions, type UnknownProps, type WithChildRules, createContractComponent, defineContractComponent, disabledProps, invalidProps };
+export { type AnyFactoryOptions, type BuiltRuntime, type ElementType, type EmptyRecord, type FilterPredicate, type PolymorphicGenerics, type SvelteFactoryOptions, type UnknownProps, type WithChildRules, createContractComponent, defineContractComponent };