praxis-kit 7.4.0 → 7.8.0

package/dist/contract/index.d.ts

@@ -25,6 +25,19 @@ type SubComponentMap = Readonly<AnyRecord>;
 type IntrinsicTag = keyof HTMLElementTagNameMap;
 
 type ElementType = IntrinsicTag | (string & {});
+/**
+ * Resolves a component's default tag to its real DOM interface — `HTMLDialogElement` for
+ * `'dialog'`, `HTMLDetailsElement` for `'details'`, and so on — falling back to `HTMLElement`
+ * for custom-element tags or anything not in `HTMLElementTagNameMap`. Used to type
+ * `FactoryOptions.onElement`'s `element` param so component authors get direct, correctly-typed
+ * access to tag-specific native members (`dialogEl.showModal()`) without an unsafe cast.
+ *
+ * The fallback is `HTMLElement`, not the more generic `Element` — every tag reachable through
+ * `IntrinsicTag` extends it, and so does every custom element per spec, so members `HTMLElement`
+ * itself declares (`showPopover()`/`hidePopover()`/`togglePopover()`, the `popover` attribute)
+ * stay directly accessible even for tags with no dedicated entry in `HTMLElementTagNameMap`.
+ */
+type ElementForTag<TDefault extends ElementType> = TDefault extends keyof HTMLElementTagNameMap ? HTMLElementTagNameMap[TDefault] : HTMLElement;
 
 declare const KNOWN_ARIA_ROLES: readonly ["alert", "alertdialog", "application", "article", "banner", "blockquote", "button", "caption", "cell", "checkbox", "code", "columnheader", "combobox", "complementary", "contentinfo", "definition", "deletion", "dialog", "document", "emphasis", "feed", "figure", "form", "generic", "grid", "gridcell", "group", "heading", "img", "insertion", "link", "list", "listbox", "listitem", "log", "main", "marquee", "math", "menu", "menubar", "menuitem", "menuitemcheckbox", "menuitemradio", "meter", "navigation", "none", "note", "option", "paragraph", "presentation", "progressbar", "radio", "radiogroup", "region", "row", "rowgroup", "rowheader", "scrollbar", "search", "searchbox", "separator", "slider", "spinbutton", "status", "strong", "subscript", "superscript", "switch", "tab", "table", "tablist", "tabpanel", "term", "textbox", "time", "timer", "toolbar", "tooltip", "tree", "treegrid", "treeitem"];
 type KnownAriaRole = (typeof KNOWN_ARIA_ROLES)[number];
@@ -124,7 +137,7 @@ type DefaultVariants<V extends VariantMap> = {
  * Presets are named bundles of variant props that callers activate by key,
  * avoiding the need to repeat variant combinations at each call site.
  */
-type RecipeMap<V extends VariantMap = VariantMap> = Readonly<Record<string, VariantSelection<V>>>;
+type RecipeMap<V extends VariantMap = VariantMap> = Readonly<StringMap<VariantSelection<V>>>;
 
 type RecipeTarget<TVariants extends VariantMap = VariantMap> = VariantSelection<TVariants>;
 
@@ -158,7 +171,7 @@ interface BaseClassOptions {
 type ClassPipelineFn = (tag: unknown, props: AnyRecord, className?: ClassName, recipe?: string) => string | undefined;
 
 interface RecipeOptions<TVariants extends VariantMap = VariantMap> {
-    recipeMap?: Record<string, RecipeTarget<TVariants>>;
+    recipeMap?: StringMap<RecipeTarget<TVariants>>;
 }
 
 interface TagMapOptions {
@@ -327,7 +340,7 @@ type StylingOptions<V extends Readonly<VariantMap> = Readonly<EmptyRecord>, TPre
      * combination, skipping runtime class computation entirely when a match is found. Normally
      * generated by a build-time class-extraction plugin rather than hand-authored.
      */
-    readonly precomputedClasses?: Readonly<Record<string, string>>;
+    readonly precomputedClasses?: Readonly<StringMap<string>>;
 };
 
 type NormalizeFn<Props extends AnyRecord = AnyRecord> = {
@@ -373,13 +386,23 @@ type FactoryOptions<TDefault extends ElementType = ElementType, Props extends An
      * no prop-based equivalent), not for anything expressible as a plain
      * prop.
      *
+     * `element` is typed to the real DOM interface of every tag the rendered
+     * element could actually be — `TDefault` plus whatever `enforcement.allowed`
+     * permits via `as` (`HTMLDialogElement` for `tag: 'dialog'`,
+     * `HTMLDetailsElement` for `tag: 'details'`, and so on) — no cast needed to
+     * reach tag-specific members. A component that leaves `allowed`
+     * unconstrained (any tag reachable via `as`) falls back to `HTMLElement`,
+     * which still covers members every element shares (`showPopover()` and
+     * friends); restrict `enforcement.allowed` to the tags `onElement`
+     * actually knows how to handle to get real narrowing.
+     *
      * `getProps` returns the instance's *current* resolved props at call
      * time — read it from inside a listener registered once at mount, rather
      * than re-subscribing on every prop change.
      *
      * Return a cleanup function to run when the instance unmounts.
      */
-    readonly onElement?: (element: Element, getProps: () => Readonly<Props>) => void | (() => void);
+    readonly onElement?: (element: ElementForTag<TDefault | TAllowed>, getProps: () => Readonly<Props>) => void | (() => void);
 };
 
 /** Shared input shape for `invalidWithFix`/`invalidWithoutFix`. */

package/dist/eslint/index.js

@@ -28,9 +28,9 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
-// ../../node_modules/.pnpm/@typescript-eslint+utils@8.65.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/deepMerge.js
+// ../../node_modules/.pnpm/@typescript-eslint+utils@8.66.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/deepMerge.js
 var require_deepMerge = __commonJS({
-  "../../node_modules/.pnpm/@typescript-eslint+utils@8.65.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/deepMerge.js"(exports) {
+  "../../node_modules/.pnpm/@typescript-eslint+utils@8.66.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/deepMerge.js"(exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.isObjectNotArray = isObjectNotArray;
@@ -63,9 +63,9 @@ var require_deepMerge = __commonJS({
   }
 });
 
-// ../../node_modules/.pnpm/@typescript-eslint+utils@8.65.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/applyDefault.js
+// ../../node_modules/.pnpm/@typescript-eslint+utils@8.66.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/applyDefault.js
 var require_applyDefault = __commonJS({
-  "../../node_modules/.pnpm/@typescript-eslint+utils@8.65.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/applyDefault.js"(exports) {
+  "../../node_modules/.pnpm/@typescript-eslint+utils@8.66.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/applyDefault.js"(exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.applyDefault = applyDefault;
@@ -90,9 +90,9 @@ var require_applyDefault = __commonJS({
   }
 });
 
-// ../../node_modules/.pnpm/@typescript-eslint+utils@8.65.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/parserSeemsToBeTSESLint.js
+// ../../node_modules/.pnpm/@typescript-eslint+utils@8.66.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/parserSeemsToBeTSESLint.js
 var require_parserSeemsToBeTSESLint = __commonJS({
-  "../../node_modules/.pnpm/@typescript-eslint+utils@8.65.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/parserSeemsToBeTSESLint.js"(exports) {
+  "../../node_modules/.pnpm/@typescript-eslint+utils@8.66.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/parserSeemsToBeTSESLint.js"(exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.parserSeemsToBeTSESLint = parserSeemsToBeTSESLint;
@@ -102,9 +102,9 @@ var require_parserSeemsToBeTSESLint = __commonJS({
   }
 });
 
-// ../../node_modules/.pnpm/@typescript-eslint+utils@8.65.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/getParserServices.js
+// ../../node_modules/.pnpm/@typescript-eslint+utils@8.66.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/getParserServices.js
 var require_getParserServices = __commonJS({
-  "../../node_modules/.pnpm/@typescript-eslint+utils@8.65.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/getParserServices.js"(exports) {
+  "../../node_modules/.pnpm/@typescript-eslint+utils@8.66.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/getParserServices.js"(exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.getParserServices = getParserServices;
@@ -135,17 +135,17 @@ var require_getParserServices = __commonJS({
   }
 });
 
-// ../../node_modules/.pnpm/@typescript-eslint+utils@8.65.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/InferTypesFromRule.js
+// ../../node_modules/.pnpm/@typescript-eslint+utils@8.66.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/InferTypesFromRule.js
 var require_InferTypesFromRule = __commonJS({
-  "../../node_modules/.pnpm/@typescript-eslint+utils@8.65.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/InferTypesFromRule.js"(exports) {
+  "../../node_modules/.pnpm/@typescript-eslint+utils@8.66.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/InferTypesFromRule.js"(exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
   }
 });
 
-// ../../node_modules/.pnpm/@typescript-eslint+utils@8.65.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/nullThrows.js
+// ../../node_modules/.pnpm/@typescript-eslint+utils@8.66.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/nullThrows.js
 var require_nullThrows = __commonJS({
-  "../../node_modules/.pnpm/@typescript-eslint+utils@8.65.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/nullThrows.js"(exports) {
+  "../../node_modules/.pnpm/@typescript-eslint+utils@8.66.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/nullThrows.js"(exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.NullThrowsReasons = void 0;
@@ -163,9 +163,9 @@ var require_nullThrows = __commonJS({
   }
 });
 
-// ../../node_modules/.pnpm/@typescript-eslint+utils@8.65.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/RuleCreator.js
+// ../../node_modules/.pnpm/@typescript-eslint+utils@8.66.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/RuleCreator.js
 var require_RuleCreator = __commonJS({
-  "../../node_modules/.pnpm/@typescript-eslint+utils@8.65.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/RuleCreator.js"(exports) {
+  "../../node_modules/.pnpm/@typescript-eslint+utils@8.66.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/RuleCreator.js"(exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.RuleCreator = RuleCreator8;
@@ -211,9 +211,9 @@ var require_RuleCreator = __commonJS({
   }
 });
 
-// ../../node_modules/.pnpm/@typescript-eslint+utils@8.65.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/index.js
+// ../../node_modules/.pnpm/@typescript-eslint+utils@8.66.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/index.js
 var require_eslint_utils = __commonJS({
-  "../../node_modules/.pnpm/@typescript-eslint+utils@8.65.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/index.js"(exports) {
+  "../../node_modules/.pnpm/@typescript-eslint+utils@8.66.0_eslint@10.7.0_jiti@2.7.0__typescript@6.0.3/node_modules/@typescript-eslint/utils/dist/eslint-utils/index.js"(exports) {
     "use strict";
     var __createBinding = exports && exports.__createBinding || (Object.create ? (function(o, m, k, k2) {
       if (k2 === void 0) k2 = k;
@@ -245,6 +245,10 @@ var require_eslint_utils = __commonJS({
 var import_eslint_utils = __toESM(require_eslint_utils(), 1);
 
 // ../../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;
+}
 function isString(value) {
   return typeof value === "string";
 }
@@ -420,6 +424,9 @@ var iterate = Object.freeze({
 });
 
 // ../../plugins/eslint/src/utils/ast.ts
+function hasStringValue(node) {
+  return isObject(node, true) && isString(node.value);
+}
 function asObjectExpression(node) {
   return node?.type === "ObjectExpression" ? node : void 0;
 }
@@ -442,23 +449,20 @@ function asNumericLiteral(node) {
   return void 0;
 }
 function asStringLiteral(node) {
-  if (node?.type === "Literal" && typeof node.value === "string") return node.value;
+  if (node?.type === "Literal" && hasStringValue(node)) return node.value;
   return void 0;
 }
 function getPropertyKey(prop) {
   const { key } = prop;
   if (prop.computed) return void 0;
   if (key.type === "Identifier") return key.name;
-  if (key.type === "Literal" && typeof key.value === "string") return key.value;
+  if (key.type === "Literal" && hasStringValue(key)) return key.value;
   return void 0;
 }
 function getObjectProperty(obj, key) {
   return obj.properties.find((prop) => {
-    if (prop.type !== "Property" || prop.kind !== "init" || prop.computed) {
-      return false;
-    }
-    const { key: propKey } = prop;
-    return propKey.type === "Identifier" && propKey.name === key || propKey.type === "Literal" && propKey.value === key;
+    if (prop.type !== "Property" || prop.kind !== "init") return false;
+    return getPropertyKey(prop) === key;
   });
 }
 function getFirstObjectArg(node) {
@@ -763,182 +767,218 @@ var noInvalidDefault = createRule3({
 // ../../plugins/eslint/src/rules/no-invalid-html-nesting.ts
 var import_eslint_utils4 = __toESM(require_eslint_utils(), 1);
 
+// ../../plugins/eslint/src/utils/content-model-builders.ts
+function categories(...values2) {
+  return new Set(values2);
+}
+function tags(...values2) {
+  return new Set(values2);
+}
+function category(...allowed) {
+  return { model: { kind: "category", allowed: categories(...allowed) } };
+}
+function specific(...allowed) {
+  return { model: { kind: "specific", allowed: tags(...allowed) } };
+}
+function phrasing() {
+  return category("phrasing");
+}
+function phrasingOrHeading() {
+  return category("phrasing", "heading");
+}
+function categoriesFor(categoryList, tagNames) {
+  return Object.fromEntries(tagNames.map((tagName) => [tagName, categories(...categoryList)]));
+}
+function defineContentModels(definitions) {
+  return definitions;
+}
+
 // ../../plugins/eslint/src/utils/html-nesting.ts
+var FLOW_PHRASING_TAGS = [
+  "abbr",
+  "b",
+  "bdi",
+  "bdo",
+  "br",
+  "cite",
+  "code",
+  "data",
+  "dfn",
+  "em",
+  "i",
+  "kbd",
+  "mark",
+  "output",
+  "q",
+  "ruby",
+  "s",
+  "samp",
+  "small",
+  "span",
+  "strong",
+  "sub",
+  "sup",
+  "time",
+  "u",
+  "var",
+  "wbr"
+];
+var FLOW_PHRASING_EMBEDDED_TAGS = [
+  "audio",
+  "canvas",
+  "img",
+  "math",
+  "object",
+  "picture",
+  "svg",
+  "video"
+];
+var FLOW_PHRASING_INTERACTIVE_TAGS = ["button", "input", "label", "select", "textarea"];
+var FLOW_PHRASING_EMBEDDED_INTERACTIVE_TAGS = ["embed", "iframe"];
+var FLOW_PHRASING_METADATA_TAGS = ["meta", "noscript", "script", "template", "link"];
+var FLOW_ONLY_TAGS = [
+  "address",
+  "blockquote",
+  "dialog",
+  "div",
+  "dl",
+  "fieldset",
+  "figure",
+  "footer",
+  "form",
+  "header",
+  "hr",
+  "li",
+  "main",
+  "menu",
+  "ol",
+  "p",
+  "pre",
+  "summary",
+  "table",
+  "ul"
+];
+var FLOW_SECTIONING_TAGS = ["article", "aside", "nav", "section"];
+var FLOW_INTERACTIVE_TAGS = ["details"];
+var FLOW_METADATA_TAGS = ["style"];
+var FLOW_HEADING_TAGS = ["h1", "h2", "h3", "h4", "h5", "h6", "hgroup"];
+var METADATA_ONLY_TAGS = ["base", "title"];
 var TAG_CATEGORIES = {
-  // Phrasing + flow
-  abbr: /* @__PURE__ */ new Set(["flow", "phrasing"]),
-  audio: /* @__PURE__ */ new Set(["flow", "phrasing", "embedded"]),
-  b: /* @__PURE__ */ new Set(["flow", "phrasing"]),
-  bdi: /* @__PURE__ */ new Set(["flow", "phrasing"]),
-  bdo: /* @__PURE__ */ new Set(["flow", "phrasing"]),
-  br: /* @__PURE__ */ new Set(["flow", "phrasing"]),
-  button: /* @__PURE__ */ new Set(["flow", "phrasing", "interactive"]),
-  canvas: /* @__PURE__ */ new Set(["flow", "phrasing", "embedded"]),
-  cite: /* @__PURE__ */ new Set(["flow", "phrasing"]),
-  code: /* @__PURE__ */ new Set(["flow", "phrasing"]),
-  data: /* @__PURE__ */ new Set(["flow", "phrasing"]),
-  dfn: /* @__PURE__ */ new Set(["flow", "phrasing"]),
-  em: /* @__PURE__ */ new Set(["flow", "phrasing"]),
-  embed: /* @__PURE__ */ new Set(["flow", "phrasing", "embedded", "interactive"]),
-  i: /* @__PURE__ */ new Set(["flow", "phrasing"]),
-  iframe: /* @__PURE__ */ new Set(["flow", "phrasing", "embedded", "interactive"]),
-  img: /* @__PURE__ */ new Set(["flow", "phrasing", "embedded"]),
-  input: /* @__PURE__ */ new Set(["flow", "phrasing", "interactive"]),
-  kbd: /* @__PURE__ */ new Set(["flow", "phrasing"]),
-  label: /* @__PURE__ */ new Set(["flow", "phrasing", "interactive"]),
-  mark: /* @__PURE__ */ new Set(["flow", "phrasing"]),
-  math: /* @__PURE__ */ new Set(["flow", "phrasing", "embedded"]),
-  meta: /* @__PURE__ */ new Set(["metadata", "flow", "phrasing"]),
-  noscript: /* @__PURE__ */ new Set(["metadata", "flow", "phrasing"]),
-  object: /* @__PURE__ */ new Set(["flow", "phrasing", "embedded"]),
-  output: /* @__PURE__ */ new Set(["flow", "phrasing"]),
-  picture: /* @__PURE__ */ new Set(["flow", "phrasing", "embedded"]),
-  q: /* @__PURE__ */ new Set(["flow", "phrasing"]),
-  ruby: /* @__PURE__ */ new Set(["flow", "phrasing"]),
-  s: /* @__PURE__ */ new Set(["flow", "phrasing"]),
-  samp: /* @__PURE__ */ new Set(["flow", "phrasing"]),
-  script: /* @__PURE__ */ new Set(["metadata", "flow", "phrasing"]),
-  select: /* @__PURE__ */ new Set(["flow", "phrasing", "interactive"]),
-  small: /* @__PURE__ */ new Set(["flow", "phrasing"]),
-  span: /* @__PURE__ */ new Set(["flow", "phrasing"]),
-  strong: /* @__PURE__ */ new Set(["flow", "phrasing"]),
-  sub: /* @__PURE__ */ new Set(["flow", "phrasing"]),
-  sup: /* @__PURE__ */ new Set(["flow", "phrasing"]),
-  svg: /* @__PURE__ */ new Set(["flow", "phrasing", "embedded"]),
-  template: /* @__PURE__ */ new Set(["metadata", "flow", "phrasing"]),
-  textarea: /* @__PURE__ */ new Set(["flow", "phrasing", "interactive"]),
-  time: /* @__PURE__ */ new Set(["flow", "phrasing"]),
-  u: /* @__PURE__ */ new Set(["flow", "phrasing"]),
-  var: /* @__PURE__ */ new Set(["flow", "phrasing"]),
-  video: /* @__PURE__ */ new Set(["flow", "phrasing", "embedded"]),
-  wbr: /* @__PURE__ */ new Set(["flow", "phrasing"]),
-  // Flow only (block-level)
-  address: /* @__PURE__ */ new Set(["flow"]),
-  article: /* @__PURE__ */ new Set(["flow", "sectioning"]),
-  aside: /* @__PURE__ */ new Set(["flow", "sectioning"]),
-  blockquote: /* @__PURE__ */ new Set(["flow"]),
-  details: /* @__PURE__ */ new Set(["flow", "interactive"]),
-  dialog: /* @__PURE__ */ new Set(["flow"]),
-  div: /* @__PURE__ */ new Set(["flow"]),
-  dl: /* @__PURE__ */ new Set(["flow"]),
-  fieldset: /* @__PURE__ */ new Set(["flow"]),
-  figure: /* @__PURE__ */ new Set(["flow"]),
-  footer: /* @__PURE__ */ new Set(["flow"]),
-  form: /* @__PURE__ */ new Set(["flow"]),
-  header: /* @__PURE__ */ new Set(["flow"]),
-  hr: /* @__PURE__ */ new Set(["flow"]),
-  li: /* @__PURE__ */ new Set(["flow"]),
-  link: /* @__PURE__ */ new Set(["metadata", "flow", "phrasing"]),
-  main: /* @__PURE__ */ new Set(["flow"]),
-  menu: /* @__PURE__ */ new Set(["flow"]),
-  nav: /* @__PURE__ */ new Set(["flow", "sectioning"]),
-  ol: /* @__PURE__ */ new Set(["flow"]),
-  p: /* @__PURE__ */ new Set(["flow"]),
-  pre: /* @__PURE__ */ new Set(["flow"]),
-  section: /* @__PURE__ */ new Set(["flow", "sectioning"]),
-  style: /* @__PURE__ */ new Set(["metadata", "flow"]),
-  summary: /* @__PURE__ */ new Set(["flow"]),
-  table: /* @__PURE__ */ new Set(["flow"]),
-  ul: /* @__PURE__ */ new Set(["flow"]),
-  // Heading
-  h1: /* @__PURE__ */ new Set(["flow", "heading"]),
-  h2: /* @__PURE__ */ new Set(["flow", "heading"]),
-  h3: /* @__PURE__ */ new Set(["flow", "heading"]),
-  h4: /* @__PURE__ */ new Set(["flow", "heading"]),
-  h5: /* @__PURE__ */ new Set(["flow", "heading"]),
-  h6: /* @__PURE__ */ new Set(["flow", "heading"]),
-  hgroup: /* @__PURE__ */ new Set(["flow", "heading"]),
-  // Metadata only
-  base: /* @__PURE__ */ new Set(["metadata"]),
-  title: /* @__PURE__ */ new Set(["metadata"])
+  ...categoriesFor(["flow", "phrasing"], FLOW_PHRASING_TAGS),
+  ...categoriesFor(["flow", "phrasing", "embedded"], FLOW_PHRASING_EMBEDDED_TAGS),
+  ...categoriesFor(["flow", "phrasing", "interactive"], FLOW_PHRASING_INTERACTIVE_TAGS),
+  ...categoriesFor(
+    ["flow", "phrasing", "embedded", "interactive"],
+    FLOW_PHRASING_EMBEDDED_INTERACTIVE_TAGS
+  ),
+  ...categoriesFor(["metadata", "flow", "phrasing"], FLOW_PHRASING_METADATA_TAGS),
+  ...categoriesFor(["flow"], FLOW_ONLY_TAGS),
+  ...categoriesFor(["flow", "sectioning"], FLOW_SECTIONING_TAGS),
+  ...categoriesFor(["flow", "interactive"], FLOW_INTERACTIVE_TAGS),
+  ...categoriesFor(["flow", "metadata"], FLOW_METADATA_TAGS),
+  ...categoriesFor(["flow", "heading"], FLOW_HEADING_TAGS),
+  ...categoriesFor(["metadata"], METADATA_ONLY_TAGS)
 };
-var HTML_CONTENT_MODELS = {
+var HTML_CONTENT_MODELS = defineContentModels({
   // Specific-tag constraints (structural elements whose content is enumerated, not categorical)
-  colgroup: { kind: "specific", allowed: /* @__PURE__ */ new Set(["col", "template"]) },
-  dl: { kind: "specific", allowed: /* @__PURE__ */ new Set(["dt", "dd", "div", "script", "template"]) },
-  menu: { kind: "specific", allowed: /* @__PURE__ */ new Set(["li", "script", "template"]) },
-  ol: { kind: "specific", allowed: /* @__PURE__ */ new Set(["li", "script", "template"]) },
-  optgroup: { kind: "specific", allowed: /* @__PURE__ */ new Set(["option", "script", "template"]) },
-  picture: { kind: "specific", allowed: /* @__PURE__ */ new Set(["source", "img", "script", "template"]) },
-  select: {
-    kind: "specific",
-    allowed: /* @__PURE__ */ new Set(["option", "optgroup", "hr", "script", "template"])
-  },
-  table: {
-    kind: "specific",
-    allowed: /* @__PURE__ */ new Set([
-      "caption",
-      "colgroup",
-      "thead",
-      "tbody",
-      "tfoot",
-      "tr",
-      "script",
-      "template"
-    ])
-  },
-  tbody: { kind: "specific", allowed: /* @__PURE__ */ new Set(["tr", "script", "template"]) },
-  tfoot: { kind: "specific", allowed: /* @__PURE__ */ new Set(["tr", "script", "template"]) },
-  thead: { kind: "specific", allowed: /* @__PURE__ */ new Set(["tr", "script", "template"]) },
-  tr: { kind: "specific", allowed: /* @__PURE__ */ new Set(["td", "th", "script", "template"]) },
-  ul: { kind: "specific", allowed: /* @__PURE__ */ new Set(["li", "script", "template"]) },
+  colgroup: specific("col", "template"),
+  dl: specific("dt", "dd", "div", "script", "template"),
+  menu: specific("li", "script", "template"),
+  ol: specific("li", "script", "template"),
+  optgroup: specific("option", "script", "template"),
+  picture: specific("source", "img", "script", "template"),
+  select: specific("option", "optgroup", "hr", "script", "template"),
+  table: specific("caption", "colgroup", "thead", "tbody", "tfoot", "tr", "script", "template"),
+  tbody: specific("tr", "script", "template"),
+  tfoot: specific("tr", "script", "template"),
+  thead: specific("tr", "script", "template"),
+  tr: specific("td", "th", "script", "template"),
+  ul: specific("li", "script", "template"),
   // Phrasing-content parents (any element whose content model is phrasing content)
-  abbr: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  b: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  bdi: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  bdo: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  cite: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  code: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  data: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  dfn: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  dt: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  em: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  h1: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  h2: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  h3: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  h4: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  h5: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  h6: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  i: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  kbd: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  label: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  mark: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  output: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  p: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  q: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  ruby: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  s: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  samp: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  small: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  span: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  strong: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  sub: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  sup: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  time: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  u: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
-  var: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing"]) },
+  abbr: phrasing(),
+  b: phrasing(),
+  bdi: phrasing(),
+  bdo: phrasing(),
+  cite: phrasing(),
+  code: phrasing(),
+  data: phrasing(),
+  dfn: phrasing(),
+  dt: phrasing(),
+  em: phrasing(),
+  h1: phrasing(),
+  h2: phrasing(),
+  h3: phrasing(),
+  h4: phrasing(),
+  h5: phrasing(),
+  h6: phrasing(),
+  i: phrasing(),
+  kbd: phrasing(),
+  label: phrasing(),
+  mark: phrasing(),
+  output: phrasing(),
+  p: phrasing(),
+  q: phrasing(),
+  ruby: phrasing(),
+  s: phrasing(),
+  samp: phrasing(),
+  small: phrasing(),
+  span: phrasing(),
+  strong: phrasing(),
+  sub: phrasing(),
+  sup: phrasing(),
+  time: phrasing(),
+  u: phrasing(),
+  var: phrasing(),
   // Phrasing or heading (spec allows either as first child)
-  legend: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing", "heading"]) },
-  summary: { kind: "category", allowed: /* @__PURE__ */ new Set(["phrasing", "heading"]) }
-};
+  legend: phrasingOrHeading(),
+  summary: phrasingOrHeading()
+});
+function getTagCategorySet(tagCategories, tagName) {
+  return tagCategories[tagName];
+}
+function getContentModelDefinition(contentModels, tagName) {
+  return contentModels[tagName];
+}
 
 // ../../plugins/eslint/src/rules/no-invalid-html-nesting.ts
 var createRule4 = (0, import_eslint_utils4.RuleCreator)((name) => `https://praxis-kit.dev/eslint-rules/${name}`);
+function describeAllowed(definition) {
+  const { model } = definition;
+  switch (model.kind) {
+    case "specific":
+      return [...model.allowed].join(", ");
+    case "category":
+      return [...model.allowed].map((c) => `${c} content`).join(", ");
+    // `transparent`/`nothing`/`structured` aren't evaluated yet (see `isAllowed` below) — no
+    // entry in HTML_CONTENT_MODELS currently uses them, so this stays unreachable in practice.
+    case "transparent":
+    case "nothing":
+    case "structured":
+      return "";
+  }
+}
 var ALLOWED_TEXT = Object.fromEntries(
-  Object.entries(HTML_CONTENT_MODELS).map(([tag, model]) => [
-    tag,
-    model.kind === "specific" ? [...model.allowed].join(", ") : [...model.allowed].map((c) => `${c} content`).join(", ")
-  ])
+  Object.entries(HTML_CONTENT_MODELS).filter((entry) => entry[1] !== void 0).map(([tag, definition]) => [tag, describeAllowed(definition)])
 );
 function getIntrinsicTag(name) {
   if (name.type !== "JSXIdentifier") return void 0;
   return /^[a-z]/.test(name.name) ? name.name : void 0;
 }
-function isAllowed(childTag, model) {
-  if (model.kind === "specific") return model.allowed.has(childTag);
-  const cats = TAG_CATEGORIES[childTag];
-  if (!cats) return true;
-  return [...model.allowed].some((c) => cats.has(c));
+function isAllowed(childTag, definition) {
+  const { model } = definition;
+  switch (model.kind) {
+    case "specific":
+      return model.allowed.has(childTag);
+    case "category": {
+      const cats = getTagCategorySet(TAG_CATEGORIES, childTag);
+      if (!cats) return true;
+      return [...model.allowed].some((c) => cats.has(c));
+    }
+    case "transparent":
+    case "nothing":
+    case "structured":
+      return true;
+  }
 }
 var noInvalidHtmlNesting = createRule4({
   name: "no-invalid-html-nesting",
@@ -958,13 +998,13 @@ var noInvalidHtmlNesting = createRule4({
       JSXElement(node) {
         const parentTag = getIntrinsicTag(node.openingElement.name);
         if (!parentTag) return;
-        const model = HTML_CONTENT_MODELS[parentTag];
-        if (!model) return;
+        const definition = getContentModelDefinition(HTML_CONTENT_MODELS, parentTag);
+        if (!definition) return;
         iterate.forEach(node.children, (child) => {
           if (child.type !== "JSXElement") return;
           const childTag = getIntrinsicTag(child.openingElement.name);
           if (childTag === void 0) return;
-          if (isAllowed(childTag, model)) return;
+          if (isAllowed(childTag, definition)) return;
           context.report({
             node: child,
             messageId: "invalidChild",

package/dist/html/index.d.ts

@@ -84,6 +84,11 @@ declare const HTML_ARIA_RULES: readonly AriaRule[];
 
 declare const roleNotPermittedRule: AriaRule;
 
+declare const dangerousHrefRule: AriaRule;
+declare const roleButtonWithHrefRule: AriaRule;
+declare const ariaDisabledInertRule: AriaRule;
+declare const ANCHOR_RULES: readonly AriaRule[];
+
 declare const supportedInputTypeRule: AriaRule;
 declare const checkedRequiresCheckableTypeRule: AriaRule;
 declare const multipleRequiresSupportedTypeRule: AriaRule;
@@ -104,4 +109,4 @@ declare const passwordAutocompleteRule: AriaRule;
 declare const requiredReadOnlyConflictRule: AriaRule;
 declare const INPUT_RULES: readonly AriaRule[];
 
-export { HTML_ARIA_RULES, INPUT_RULES, acceptRequiresFileTypeRule, altRequiresImageTypeRule, captureRequiresFileTypeRule, checkedRequiresCheckableTypeRule, heightRequiresImageTypeRule, inputAccessibleNameRule, landmarkAccessibleNameRule, landmarkRoleRule, maxLengthRequiresTextTypeRule, maxRequiresNumericTypeRule, minLengthRequiresTextTypeRule, minRequiresNumericTypeRule, multipleRequiresSupportedTypeRule, passwordAutocompleteRule, patternRequiresTextTypeRule, requireAccessibleName, requiredReadOnlyConflictRule, roleNotPermittedRule, sizeRequiresTextTypeRule, stepRequiresNumericTypeRule, supportedInputTypeRule, widthRequiresImageTypeRule };
+export { ANCHOR_RULES, HTML_ARIA_RULES, INPUT_RULES, acceptRequiresFileTypeRule, altRequiresImageTypeRule, ariaDisabledInertRule, captureRequiresFileTypeRule, checkedRequiresCheckableTypeRule, dangerousHrefRule, heightRequiresImageTypeRule, inputAccessibleNameRule, landmarkAccessibleNameRule, landmarkRoleRule, maxLengthRequiresTextTypeRule, maxRequiresNumericTypeRule, minLengthRequiresTextTypeRule, minRequiresNumericTypeRule, multipleRequiresSupportedTypeRule, passwordAutocompleteRule, patternRequiresTextTypeRule, requireAccessibleName, requiredReadOnlyConflictRule, roleButtonWithHrefRule, roleNotPermittedRule, sizeRequiresTextTypeRule, stepRequiresNumericTypeRule, supportedInputTypeRule, widthRequiresImageTypeRule };