praxis-kit 6.6.1 → 7.3.0

package/dist/web/index.js

@@ -1,8 +1,22 @@
+// ../../lib/adapter-utils/src/invariant.ts
+function panic(message) {
+  throw new Error(message);
+}
+function invariant(condition, message) {
+  if (!condition) panic(message);
+}
+
 // ../../lib/adapter-utils/src/runtime/define-component.ts
 function defineContractComponent(options) {
   return (factory) => factory(options);
 }
 
+// ../../lib/adapter-utils/src/runtime/assemble-compound-component.ts
+function assembleCompoundComponent(root, subComponents) {
+  if (!subComponents) return root;
+  return Object.assign(root, subComponents);
+}
+
 // ../../lib/primitive/src/tag/resolve-tag.ts
 function makeResolveTag(defaultTag) {
   return function tag(as) {
@@ -13,6 +27,11 @@ function makeResolveTag(defaultTag) {
 // ../../lib/primitive/src/rule/rule-brand.ts
 var RULE_BRAND = /* @__PURE__ */ Symbol("praxis-kit/dynamic-rule");
 
+// ../../lib/primitive/src/rule/dynamic.ts
+function dynamic(resolve) {
+  return { [RULE_BRAND]: true, resolve };
+}
+
 // ../../lib/primitive/src/guards/foundational/is-defined.ts
 function isUndefined(value) {
   return value === void 0;
@@ -26,7 +45,7 @@ function isNonNull(value) {
   return value != null;
 }
 function isNullish(value) {
-  return isNull(value) || value === void 0;
+  return isNull(value) || isUndefined(value);
 }
 
 // ../../lib/primitive/src/utils/type-guards.ts
@@ -40,10 +59,13 @@ function isString(value) {
 function isNumber(value) {
   return typeof value === "number";
 }
+function isFunction(value) {
+  return typeof value === "function";
+}
 
 // ../../lib/primitive/src/rule/is-dynamic-rule.ts
 function isDynamicRule(rule) {
-  return isObject(rule, true) && rule[RULE_BRAND] === true;
+  return isObject(rule, true) && Reflect.get(rule, RULE_BRAND) === true;
 }
 
 // ../../lib/primitive/src/rule/resolve-rule.ts
@@ -517,6 +539,24 @@ var ROLE_RESTRICTED_ATTRIBUTES = /* @__PURE__ */ new Map([
   ]
 ]);
 
+// ../../lib/primitive/src/constants/html/void-tags.ts
+var VOID_TAGS = [
+  "area",
+  "base",
+  "br",
+  "col",
+  "embed",
+  "hr",
+  "img",
+  "input",
+  "link",
+  "meta",
+  "param",
+  "source",
+  "track",
+  "wbr"
+];
+
 // ../../lib/primitive/src/guards/aria/is-aria-attribute.ts
 function isGlobalAriaAttribute(attr) {
   return GLOBAL_ARIA_ATTRIBUTES.has(attr);
@@ -564,17 +604,17 @@ var COMPONENT_DEFAULT_TAG = /* @__PURE__ */ Symbol.for("praxis.component-default
 // ../../lib/primitive/src/guards/children/is-tag.ts
 function getAsProp(child) {
   if (!isObject(child) || !("props" in child)) return void 0;
-  const props = child.props;
+  const { props } = child;
   if (!isObject(props)) return void 0;
-  const as = props.as;
+  const as = Reflect.get(props, "as");
   return isString(as) && as !== "" ? as : void 0;
 }
 function getTag(child) {
   if (!isObject(child) || !("type" in child)) return void 0;
-  const t = child.type;
+  const { type: t } = child;
   if (isString(t)) return t;
   if (typeof t === "function" || isObject(t)) {
-    const defaultTag = t[COMPONENT_DEFAULT_TAG];
+    const defaultTag = Reflect.get(t, COMPONENT_DEFAULT_TAG);
     if (!isString(defaultTag)) return void 0;
     return getAsProp(child) ?? defaultTag;
   }
@@ -594,6 +634,28 @@ function isTag(...args) {
   return tag !== void 0 && set2.has(tag);
 }
 
+// ../../lib/adapter-utils/src/runtime/is-factory-options-like.ts
+var FACTORY_OPTIONS_FIELD_VALIDATORS = {
+  tag: (v) => v === void 0 || isString(v),
+  name: (v) => v === void 0 || isString(v),
+  defaults: (v) => v === void 0 || isObject(v),
+  normalize: (v) => v === void 0 || isFunction(v),
+  styling: (v) => v === void 0 || isObject(v),
+  enforcement: (v) => v === void 0 || isObject(v),
+  diagnostics: (v) => v === void 0 || isObject(v),
+  subComponents: (v) => v === void 0 || isObject(v),
+  onElement: (v) => v === void 0 || isFunction(v)
+};
+function isFactoryOptionsLike(options, extraFieldValidators) {
+  if (!isObject(options)) return false;
+  const validators = { ...FACTORY_OPTIONS_FIELD_VALIDATORS, ...extraFieldValidators };
+  for (const [key, value] of Object.entries(options)) {
+    const validate = validators[key];
+    if (!validate || !validate(value)) return false;
+  }
+  return true;
+}
+
 // ../../lib/contract/src/aria/aria-role-policy.ts
 function getImplicitRole(tag, props) {
   if (tag in IMPLICIT_ROLE_RECORD) return IMPLICIT_ROLE_RECORD[tag];
@@ -1446,7 +1508,8 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends InvariantBase {
     const cached = _AriaPolicyEngine.#removeAttributeFixCache.get(attr);
     if (cached) return cached;
     const fix = {
-      kind: `removeAttribute:${attr}`,
+      kind: "removeAttribute",
+      attribute: attr,
       apply: ({ props }) => {
         if (!(attr in props)) return { applied: false, next: props };
         return { applied: true, next: omitProp(props, attr), previous: props };
@@ -1717,7 +1780,8 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends InvariantBase {
     if (!impliedLive) return NO_VIOLATIONS2;
     if ("aria-live" in props) return NO_VIOLATIONS2;
     const injectLive = {
-      kind: `injectLive:${effectiveRole}`,
+      kind: "injectLive",
+      attribute: "aria-live",
       apply: (ctx) => ({
         applied: true,
         next: { ...ctx.props, "aria-live": impliedLive },
@@ -1786,6 +1850,23 @@ var AriaPolicyEngine = class _AriaPolicyEngine extends InvariantBase {
   }
 };
 
+// ../../lib/contract/src/aria/factories.ts
+function removeProp(props, key) {
+  const next = { ...props };
+  delete next[key];
+  return next;
+}
+function removeAttributeFix(attribute) {
+  return Object.freeze({
+    kind: "removeAttribute",
+    attribute,
+    apply: ({ props }) => {
+      if (!(attribute in props)) return { applied: false, next: props };
+      return { applied: true, next: removeProp(props, attribute), previous: props };
+    }
+  });
+}
+
 // ../../lib/contract/src/children/get-type-name.ts
 function getTypeName(value) {
   if (value === null) return "null";
@@ -2104,22 +2185,6 @@ import { warnDiagnostics as warnDiagnostics2 } from "../_shared/diagnostics.js";
 
 // ../core/src/html/contracts/categories.ts
 var METADATA_TAGS = ["script", "template"];
-var VOID_TAGS = [
-  "area",
-  "base",
-  "br",
-  "col",
-  "embed",
-  "hr",
-  "img",
-  "input",
-  "link",
-  "meta",
-  "param",
-  "source",
-  "track",
-  "wbr"
-];
 var TEXT_ONLY_TAGS = [
   "option",
   "script",
@@ -2243,20 +2308,6 @@ var INPUT_MUTUALLY_EXCLUSIVE_POLICIES = [
 
 // ../core/src/html/spec/validators/attribute-type-validator.ts
 var DEFAULT_INPUT_TYPE = "text";
-function omit(props, key) {
-  const next = { ...props };
-  delete next[key];
-  return next;
-}
-function removeAttributeFix(attribute) {
-  return {
-    kind: `removeAttribute:${attribute}`,
-    apply: ({ props }) => {
-      if (!(attribute in props)) return { applied: false, next: props };
-      return { applied: true, next: omit(props, attribute), previous: props };
-    }
-  };
-}
 function createInputAttributeTypeRule({
   attribute,
   allowedTypes
@@ -2709,7 +2760,7 @@ function getChildProp(child, key) {
   if (!isVNodeLike(child)) return void 0;
   const { props } = child;
   if (!isObject(props)) return void 0;
-  return props[key];
+  return Reflect.get(props, key);
 }
 
 // ../core/src/html/contracts/aria/landmarks.ts
@@ -2762,6 +2813,13 @@ function isLabelableControl(child) {
   const type = getChildProp(child, "type");
   return !isString(type) || type !== "hidden";
 }
+function hasAccessibleNameProp(props) {
+  return "aria-label" in props || "aria-labelledby" in props;
+}
+function isNonEmptyTextChild(child) {
+  if (isNumber(child)) return true;
+  return isString(child) && child.trim().length > 0;
+}
 var labelContract = contract([
   { name: "control", match: isLabelableControl, cardinality: { max: 1 } },
   { name: "nested-label", match: isTag("label"), cardinality: { max: 0 } },
@@ -2769,6 +2827,13 @@ var labelContract = contract([
     name: "other-interactive-content",
     match: isTag(...OTHER_INTERACTIVE_TAGS),
     cardinality: { max: 0 }
+  },
+  {
+    name: "accessible-name",
+    match: isNonEmptyTextChild,
+    cardinality: dynamic(
+      (ctx) => hasAccessibleNameProp(ctx.props) ? { min: 0 } : { min: 1 }
+    )
   }
 ]);
 
@@ -3500,6 +3565,14 @@ function buildRuntime(options) {
   };
 }
 
+// ../../adapters/web/src/is-web-contract-component.ts
+function isWebContractComponent(value) {
+  if (!isFunction(value)) return false;
+  if (typeof HTMLElement !== "undefined" && !(value.prototype instanceof HTMLElement)) return false;
+  if (!("diagnostics" in value)) return false;
+  return isObject(value.diagnostics);
+}
+
 // ../../adapters/web/src/render-to-string.ts
 var ssrRegistry = /* @__PURE__ */ new WeakMap();
 function registerForSsr(cls, bundle) {
@@ -3516,8 +3589,17 @@ function renderToString(component, props = {}, innerHTML = "") {
   return renderBundleToString(entry.bundle, props, innerHTML);
 }
 
+// ../../adapters/web/src/to-web-factory-options.ts
+var WEB_FIELD_VALIDATORS = {
+  filterProps: (v) => v === void 0 || isFunction(v)
+};
+function isWebFactoryOptions(options) {
+  return isFactoryOptionsLike(options, WEB_FIELD_VALIDATORS);
+}
+
 // ../../adapters/web/src/create-contract-component.ts
 function createContractComponent(options) {
+  invariant(isWebFactoryOptions(options), "options is not a valid WebFactoryOptions object");
   const bundle = buildRuntime(options);
   const looseBundle = toLooseBundle(bundle);
   const variantKeys = options.styling?.variants ? Object.keys(options.styling.variants) : [];
@@ -3531,8 +3613,20 @@ function createContractComponent(options) {
     static get observedAttributes() {
       return observedAttrNames;
     }
+    // Tag registered by the consumer's own customElements.define() call is never literally
+    // `dialog` (custom-element names must be hyphenated), so native `<dialog>`-specific methods
+    // like showModal() won't exist on this class unless the consumer opts into "customized
+    // built-ins" (`{ extends: 'dialog' }`) themselves — not something this adapter special-cases.
+    _onElementCleanup;
     connectedCallback() {
       this._applyPraxis();
+      if (options.onElement) {
+        this._onElementCleanup = options.onElement(this, () => this._buildProps()) ?? void 0;
+      }
+    }
+    disconnectedCallback() {
+      this._onElementCleanup?.();
+      this._onElementCleanup = void 0;
     }
     // Fires synchronously for every observed attribute change — no microtask
     // scheduling needed. The guard is implicit: this only fires for
@@ -3549,12 +3643,11 @@ function createContractComponent(options) {
     get _self() {
       return this;
     }
-    _applyPraxis() {
+    // Shared by _applyPraxis and the onElement getProps accessor — both need the same
+    // attribute-derived prop snapshot, just for different purposes (pipeline input vs.
+    // exposing "current props" to author-supplied element wiring).
+    _buildProps() {
       const self = this._self;
-      const {
-        childrenEvaluator,
-        runtime: { options: options2 }
-      } = bundle;
       const observedSet = new Set(
         this.constructor.observedAttributes ?? []
       );
@@ -3570,6 +3663,14 @@ function createContractComponent(options) {
         const val = self[key] ?? this.getAttribute(key);
         if (val != null) props[key] = val;
       }
+      return props;
+    }
+    _applyPraxis() {
+      const {
+        childrenEvaluator,
+        runtime: { options: options2 }
+      } = bundle;
+      const props = this._buildProps();
       const hostState = resolveHostState(looseBundle, props);
       const children = Array.from(this.childNodes);
       if (childrenEvaluator) {
@@ -3578,7 +3679,7 @@ function createContractComponent(options) {
           props: hostState.normalizedProps
         });
       }
-      options2.htmlChildrenEvaluatorFn?.(hostState.tag)?.evaluate(children);
+      options2.htmlChildrenEvaluatorFn?.(hostState.tag)?.evaluate(children, { tag: hostState.tag, props: hostState.normalizedProps });
       diffAndApplyAttributes(this, hostState, this._pipelineAttrs, props);
     }
   }
@@ -3586,8 +3687,14 @@ function createContractComponent(options) {
     Object.defineProperty(PolymorphicWebElement, "name", { value: options.name });
   }
   Object.defineProperty(PolymorphicWebElement, "diagnostics", { value: bundle.diagnostics });
-  registerForSsr(PolymorphicWebElement, looseBundle);
-  return PolymorphicWebElement;
+  const contractClass = PolymorphicWebElement;
+  invariant(
+    isWebContractComponent(contractClass),
+    "Generated class failed to satisfy the WebContractComponent shape"
+  );
+  registerForSsr(contractClass, looseBundle);
+  const assembled = assembleCompoundComponent(contractClass, options.subComponents);
+  return assembled;
 }
 export {
   createContractComponent,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "praxis-kit",
-  "version": "6.6.1",
+  "version": "7.3.0",
   "type": "module",
   "exports": {
     "./react": {
@@ -187,26 +187,26 @@
     "@sveltejs/vite-plugin-svelte": "^7.0.0",
     "esbuild": "^0.28.1",
     "esbuild-plugin-solid": "^0.6.0",
-    "@types/node": "^26.1.1",
+    "@types/node": "^26.1.2",
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.0.0",
-    "@typescript-eslint/utils": "8.63.0",
+    "@typescript-eslint/utils": "8.65.0",
     "lit": "^3.0.0",
     "preact": "^10.25.0",
-    "react": "^19.2.7",
-    "react-dom": "^19.2.7",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
     "solid-js": "^1.9.0",
     "svelte": "^5.56.3",
     "ts-morph": "^28.0.0",
     "tsup": "^8.5.1",
-    "tsx": "^4.22.5",
+    "tsx": "^4.23.1",
     "typescript": "^6.0.3",
     "vite": "^8.1.5",
-    "vue": "^3.5.38",
+    "vue": "^3.5.40",
     "@praxis-kit/adapter-utils": "0.0.0",
+    "@praxis-kit/core": "0.0.0",
     "@praxis-kit/diagnostics": "0.0.0",
     "@praxis-kit/pipeline": "0.0.0",
-    "@praxis-kit/core": "0.0.0",
     "@praxis-kit/primitive": "0.0.0",
     "@praxis-kit/vite-plugin": "0.0.0"
   },