praxis-kit 4.0.3 → 4.1.1

package/dist/react/index.d.ts

@@ -1,10 +1,28 @@
-import { E as ElementType, U as UnknownProps, a as EmptyRecord, V as VariantMap, R as RecipeMap, C as ClassPluginFactory, A as AnyRecord, b as ReactFactoryOptions, P as PolymorphicComponent, c as PolymorphicGenerics, d as ExtractPluginProps } from '../merge-refs-B0YcfdtP.js';
-export { e as AnyFactoryOptions, f as ElementRef, F as FactoryOptions, g as PolymorphicProps, h as PolymorphicWithAsChild, i as PolymorphicWithRender, j as RenderCallbackProps, S as Slottable, k as SlottableProps, m as composeRefs, l as defineContractComponent, m as mergeRefs } from '../merge-refs-B0YcfdtP.js';
-import { Ref, ReactElement } from 'react';
+import { U as UnknownProps, E as ElementType, a as EmptyRecord, V as VariantMap, R as RecipeMap, A as AnyClassPluginFactory, b as ReactFactoryOptions, P as PolymorphicComponent, c as PolymorphicGenerics, d as ExtractPluginProps } from '../react-options-XrRof248.js';
+export { e as AnyFactoryOptions, f as ElementRef, F as FactoryOptions, g as PolymorphicProps, h as PolymorphicWithAsChild, i as PolymorphicWithRender, j as RenderCallbackProps, S as Slottable, k as SlottableProps, m as composeRefs, l as defineContractComponent, m as mergeRefs } from '../react-options-XrRof248.js';
+import * as react from 'react';
+import { ReactElement, Ref } from 'react';
 import 'type-fest';
 import '../_shared/diagnostics.js';
 
-declare function createContractComponent<TDefault extends ElementType, Props extends UnknownProps = EmptyRecord, Variants extends Readonly<VariantMap> = Readonly<EmptyRecord>, TPreset extends RecipeMap<Variants> = Readonly<EmptyRecord>, TPlugin extends ClassPluginFactory<AnyRecord> | undefined = ClassPluginFactory<AnyRecord> | undefined, TAllowed extends ElementType = ElementType>(options: ReactFactoryOptions<TDefault, Props, Variants, TPreset, TPlugin, TAllowed>): PolymorphicComponent<PolymorphicGenerics<TDefault, Props & ExtractPluginProps<TPlugin>, Variants, TPreset, TAllowed>>;
+/**
+ * Canonical ref representation used internally.
+ *
+ * All helpers normalize missing refs (`undefined`) to `null`, so callers only
+ * need to handle two states: a ref exists, or it does not.
+ */
+type NormalizedRef = Ref<unknown> | null;
+/**
+ * Input accepted by the clone operation before props, refs, and event handlers
+ * are merged into their final form.
+ */
+type CloneInput = {
+    child: ReactElement;
+    slotProps: UnknownProps;
+    ref: NormalizedRef;
+};
+
+declare function createContractComponent<TDefault extends ElementType, Props extends UnknownProps = EmptyRecord, Variants extends Readonly<VariantMap> = Readonly<EmptyRecord>, TPreset extends RecipeMap<Variants> = Readonly<EmptyRecord>, TPlugin extends AnyClassPluginFactory = AnyClassPluginFactory, TAllowed extends ElementType = ElementType>(options: ReactFactoryOptions<TDefault, Props, Variants, TPreset, TPlugin, TAllowed>): PolymorphicComponent<PolymorphicGenerics<TDefault, Props & ExtractPluginProps<TPlugin>, Variants, TPreset, TAllowed>>;
 
 type SlotProps = {
     ref?: Ref<unknown> | null;
@@ -12,15 +30,10 @@ type SlotProps = {
 };
 declare function Slot({ ref, children, ...slotProps }: SlotProps): ReactElement;
 declare namespace Slot {
-    var displayName: string;
+    var displayName: "Slot";
 }
 
-type CloneInput = {
-    child: ReactElement;
-    slotProps: UnknownProps;
-    ref: Ref<unknown> | null;
-};
-declare function cloneSlotChild({ child, slotProps, ref }: CloneInput): ReactElement;
+declare const cloneSlotChild: ({ child, slotProps, ref }: CloneInput) => react.ReactElement;
 
 /**
  * Cross-version ref extraction for React 19 elements.

package/dist/react/index.js

@@ -1,67 +1,32 @@
 import {
-  AriaPolicyEngine,
   COMPONENT_DEFAULT_TAG,
   SLOT_NAME,
-  SlotValidator,
   Slottable,
-  applyAria,
-  applyAttributes,
   applyDisplayName,
-  applyFilterProps,
-  applyPropNormalizers,
-  applyRef,
   applySlot,
-  buildDefinition,
-  buildEngines,
-  buildStylePipeline,
-  cloneWithProps,
+  buildRuntime,
   defineContractComponent,
-  enforceAllowedAs,
-  extractDecoration,
-  flattenClassName,
-  getHtmlChildrenEvaluator,
-  isFunction,
-  isPlainObject,
-  joinClasses,
-  makeRenderAsChild,
+  getElementRef,
+  getPropsRef,
+  hasWarningGetter,
+  makeCloneSlotChild,
   mergeRefs,
-  mergeSlotProps,
-  renderNormally,
-  renderWithCallback,
-  resolveAdapterCommonOptions
-} from "../chunk-DRGZ4ZI2.js";
-
-// ../../adapters/react/src/current/slot/cloneSlotChild.ts
-import { Fragment } from "react";
+  render
+} from "../chunk-R2RKHZNX.js";
 
 // ../../adapters/react/src/current/slot/composeRefs.ts
-function isReactWarningGetter(getter) {
-  return isFunction(getter) && "isReactWarning" in getter;
-}
-function hasWarningGetter(obj, key) {
-  return isPlainObject(obj) && isReactWarningGetter(Object.getOwnPropertyDescriptor(obj, key)?.get);
-}
-function getElementRef(element) {
-  const el = element;
-  return isPlainObject(el) ? el.ref ?? null : null;
-}
-function getPropsRef(element) {
-  const props = element.props;
-  return isPlainObject(props) ? props.ref ?? null : null;
-}
 function getChildRef(element) {
   return hasWarningGetter(element.props, "ref") ? getElementRef(element) : getPropsRef(element);
 }
 
 // ../../adapters/react/src/current/slot/cloneSlotChild.ts
-function cloneSlotChild({ child, slotProps, ref }) {
-  const childProps = child.props;
-  const isFragment = child.type === Fragment;
-  const childRef = isFragment ? null : getChildRef(child);
-  const mergedRef = isFragment ? null : mergeRefs(ref, childRef);
-  const merged = mergeSlotProps(slotProps, childProps);
-  return cloneWithProps(child, merged, mergedRef);
+var cloneSlotChild = makeCloneSlotChild(getChildRef);
+
+// ../../adapters/react/src/current/slot/Slot.tsx
+function Slot({ ref = null, children, ...slotProps }) {
+  return applySlot(children, slotProps, ref, cloneSlotChild);
 }
+Slot.displayName = SLOT_NAME;
 
 // ../../adapters/react/src/current/normalize-children.ts
 import { isValidElement } from "react";
@@ -71,111 +36,24 @@ function normalizeChildren(children) {
   return [];
 }
 
+// ../../adapters/react/src/current/build-runtime.ts
+function buildRuntime2(options) {
+  return buildRuntime(options, Slot, normalizeChildren);
+}
+
 // ../../adapters/react/src/current/create-contract-component.ts
-var EMPTY_SET = /* @__PURE__ */ new Set();
 function createContractComponent(options) {
-  const resolved = resolveAdapterCommonOptions(options);
-  const displayName = resolved.name;
-  const defaultTag = options.tag ?? "div";
-  const artifact = options.artifact;
-  const definition = artifact?.definition ?? buildDefinition(displayName, defaultTag);
-  const variantKeys = new Set(Object.keys(options.styling?.variants ?? {}));
-  const domDefaults = options.defaults;
-  const stylePipeline = buildStylePipeline(
-    options.styling?.variants,
-    options.styling?.presets,
-    options.styling?.defaults ?? {},
-    options.styling?.compounds,
-    artifact?.precomputed?.variantLookup
-  );
-  const base = options.styling?.base !== void 0 ? flattenClassName(options.styling.base) : void 0;
-  const filterFn = options.filterProps;
-  const allowedAs = options.enforcement?.allowedAs;
-  const normalizeFn = options.normalize;
-  const enforcementNormalizers = options.enforcement?.props;
-  const classPlugin = options.styling?.plugin !== void 0 ? options.styling.plugin(
-    options.styling,
-    resolved.diagnostics
-  ) : void 0;
-  const pluginKeys = classPlugin?.ownedKeys ?? EMPTY_SET;
-  const { childrenEvaluator: explicitEvaluator } = buildEngines(
-    resolved.diagnostics,
-    options.enforcement?.children,
-    displayName
-  );
-  const ariaEngine = options.enforcement !== void 0 ? new AriaPolicyEngine(resolved.diagnostics) : void 0;
-  const slotValidator = new SlotValidator(displayName, resolved.diagnostics, "React element");
-  const renderAsChild = makeRenderAsChild(cloneSlotChild);
+  const bundle = buildRuntime2(options);
   function Component({ ref, ...props }) {
-    const {
-      as,
-      asChild,
-      render,
-      children,
-      className: callerClassName,
-      recipe,
-      ...ownProps
-    } = props;
-    const tag = typeof as === "string" ? as : defaultTag;
-    if (allowedAs !== void 0) enforceAllowedAs(tag, allowedAs, resolved.diagnostics, displayName);
-    const rawBaseProps = domDefaults !== void 0 ? { ...domDefaults, ...ownProps } : ownProps;
-    const normalizedProps = applyPropNormalizers(tag, rawBaseProps, enforcementNormalizers);
-    const baseProps = normalizeFn !== void 0 ? normalizeFn(normalizedProps) : normalizedProps;
-    const pluginProps = {};
-    const propsForExtraction = pluginKeys.size > 0 ? Object.fromEntries(
-      Object.entries(baseProps).filter(([k]) => {
-        if (pluginKeys.has(k)) {
-          pluginProps[k] = baseProps[k];
-          return false;
-        }
-        return true;
-      })
-    ) : baseProps;
-    const rootDec = extractDecoration(propsForExtraction, variantKeys);
-    const decoration = applyAria(
-      Object.keys(rootDec).length > 0 ? { root: rootDec } : {},
-      tag,
-      ariaEngine
-    );
-    if (process.env.NODE_ENV !== "production") {
-      const childEval = explicitEvaluator ?? getHtmlChildrenEvaluator(tag);
-      childEval?.evaluate(normalizeChildren(children));
-    }
-    const recipeName = typeof recipe === "string" ? recipe : void 0;
-    const { variantClasses, compoundClasses } = stylePipeline ? stylePipeline.execute(decoration, recipeName) : { variantClasses: [], compoundClasses: [] };
-    const rawClassName = joinClasses(base, ...variantClasses, ...compoundClasses, callerClassName);
-    const className = classPlugin !== void 0 ? classPlugin.pipeline(tag, pluginProps, rawClassName, recipeName) : rawClassName;
-    if (asChild === true) {
-      if (typeof as === "string") {
-        slotValidator.assertExclusive();
-      } else {
-        return renderAsChild(children, className, ref);
-      }
-    }
-    let finalDecoration = className ? applyAttributes("root", { className }, decoration, variantKeys) : decoration;
-    finalDecoration = applyFilterProps(finalDecoration, filterFn, variantKeys);
-    finalDecoration = applyRef(finalDecoration, ref);
-    if (typeof render === "function")
-      return renderWithCallback(
-        render,
-        finalDecoration["root"]?.attributes ?? {},
-        className,
-        ref
-      );
-    return renderNormally(definition, tag, finalDecoration, children);
+    return render({ ...bundle, props, ref: ref ?? null });
   }
   applyDisplayName(Component, options.name);
+  const defaultTag = bundle.runtime.options.defaultTag;
   if (typeof defaultTag === "string") {
     Object.assign(Component, { [COMPONENT_DEFAULT_TAG]: defaultTag });
   }
   return Component;
 }
-
-// ../../adapters/react/src/current/slot/Slot.tsx
-function Slot({ ref = null, children, ...slotProps }) {
-  return applySlot(children, slotProps, ref, cloneSlotChild);
-}
-Slot.displayName = SLOT_NAME;
 export {
   Slot,
   Slottable,

package/dist/react/legacy.d.ts

@@ -1,10 +1,10 @@
-import { E as ElementType, U as UnknownProps, a as EmptyRecord, V as VariantMap, R as RecipeMap, C as ClassPluginFactory, A as AnyRecord, b as ReactFactoryOptions, P as PolymorphicComponent, c as PolymorphicGenerics, d as ExtractPluginProps } from '../merge-refs-B0YcfdtP.js';
-export { e as AnyFactoryOptions, f as ElementRef, F as FactoryOptions, g as PolymorphicProps, h as PolymorphicWithAsChild, i as PolymorphicWithRender, j as RenderCallbackProps, S as Slottable, k as SlottableProps, l as defineContractComponent, m as mergeRefs } from '../merge-refs-B0YcfdtP.js';
+import { E as ElementType, U as UnknownProps, a as EmptyRecord, V as VariantMap, R as RecipeMap, A as AnyClassPluginFactory, b as ReactFactoryOptions, P as PolymorphicComponent, c as PolymorphicGenerics, d as ExtractPluginProps } from '../react-options-XrRof248.js';
+export { e as AnyFactoryOptions, f as ElementRef, F as FactoryOptions, g as PolymorphicProps, h as PolymorphicWithAsChild, i as PolymorphicWithRender, j as RenderCallbackProps, S as Slottable, k as SlottableProps, l as defineContractComponent, m as mergeRefs } from '../react-options-XrRof248.js';
 import * as react from 'react';
 import 'type-fest';
 import '../_shared/diagnostics.js';
 
-declare function createContractComponent<TDefault extends ElementType, Props extends UnknownProps = EmptyRecord, Variants extends Readonly<VariantMap> = Readonly<EmptyRecord>, TPreset extends RecipeMap<Variants> = Readonly<EmptyRecord>, TPlugin extends ClassPluginFactory<AnyRecord> | undefined = ClassPluginFactory<AnyRecord> | undefined, TAllowed extends ElementType = ElementType>(options: ReactFactoryOptions<TDefault, Props, Variants, TPreset, TPlugin, TAllowed>): PolymorphicComponent<PolymorphicGenerics<TDefault, Props & ExtractPluginProps<TPlugin>, Variants, TPreset, TAllowed>>;
+declare function createContractComponent<TDefault extends ElementType, Props extends UnknownProps = EmptyRecord, Variants extends Readonly<VariantMap> = Readonly<EmptyRecord>, TPreset extends RecipeMap<Variants> = Readonly<EmptyRecord>, TPlugin extends AnyClassPluginFactory = AnyClassPluginFactory, TAllowed extends ElementType = ElementType>(options: ReactFactoryOptions<TDefault, Props, Variants, TPreset, TPlugin, TAllowed>): PolymorphicComponent<PolymorphicGenerics<TDefault, Props & ExtractPluginProps<TPlugin>, Variants, TPreset, TAllowed>>;
 
 type SlotProps = {
     [key: string]: unknown;

package/dist/react/legacy.js

@@ -1,70 +1,39 @@
 import {
-  AriaPolicyEngine,
   COMPONENT_DEFAULT_TAG,
   SLOT_NAME,
-  SlotValidator,
   Slottable,
-  applyAria,
-  applyAttributes,
   applyDisplayName,
-  applyFilterProps,
-  applyPropNormalizers,
-  applyRef,
   applySlot,
-  buildDefinition,
-  buildEngines,
-  buildStylePipeline,
-  cloneWithProps,
+  buildRuntime,
   defineContractComponent,
-  enforceAllowedAs,
-  extractDecoration,
-  flattenClassName,
-  getHtmlChildrenEvaluator,
-  isFunction,
-  isPlainObject,
-  joinClasses,
-  makeRenderAsChild,
+  getElementRef,
+  getPropsRef,
+  hasWarningGetter,
+  isString,
+  makeCloneSlotChild,
   mergeRefs,
-  mergeSlotProps,
-  renderNormally,
-  renderWithCallback,
-  resolveAdapterCommonOptions
-} from "../chunk-DRGZ4ZI2.js";
+  render
+} from "../chunk-R2RKHZNX.js";
 
 // ../../adapters/react/src/legacy/create-contract-component.ts
-import { forwardRef } from "react";
+import { forwardRef as forwardRef2 } from "react";
 
-// ../../adapters/react/src/legacy/slot/cloneSlotChild.ts
-import { Fragment } from "react";
+// ../../adapters/react/src/legacy/slot/Slot.tsx
+import { forwardRef } from "react";
 
 // ../../adapters/react/src/legacy/slot/composeRefs.ts
-function isReactWarningGetter(getter) {
-  return isFunction(getter) && "isReactWarning" in getter;
-}
-function hasWarningGetter(obj, key) {
-  return isPlainObject(obj) && isReactWarningGetter(Object.getOwnPropertyDescriptor(obj, key)?.get);
-}
-function getElementRef(element) {
-  const el = element;
-  return isPlainObject(el) ? el.ref ?? null : null;
-}
-function getPropsRef(element) {
-  const props = element.props;
-  return isPlainObject(props) ? props.ref ?? null : null;
-}
 function getChildRef(element) {
   return hasWarningGetter(element, "ref") ? getPropsRef(element) : getElementRef(element);
 }
 
 // ../../adapters/react/src/legacy/slot/cloneSlotChild.ts
-function cloneSlotChild({ child, slotProps, ref }) {
-  const childProps = child.props;
-  const isFragment = child.type === Fragment;
-  const childRef = isFragment ? null : getChildRef(child);
-  const mergedRef = isFragment ? null : mergeRefs(ref, childRef);
-  const merged = mergeSlotProps(slotProps, childProps);
-  return cloneWithProps(child, merged, mergedRef);
-}
+var cloneSlotChild = makeCloneSlotChild(getChildRef);
+
+// ../../adapters/react/src/legacy/slot/Slot.tsx
+var Slot = forwardRef(function Slot2({ children, ...slotProps }, ref) {
+  return applySlot(children, slotProps, ref, cloneSlotChild);
+});
+Slot.displayName = SLOT_NAME;
 
 // ../../adapters/react/src/legacy/normalize-children.ts
 import { Children, isValidElement } from "react";
@@ -72,112 +41,24 @@ function normalizeChildren(children) {
   return Children.toArray(children).filter(isValidElement);
 }
 
+// ../../adapters/react/src/legacy/build-runtime.ts
+function buildRuntime2(options) {
+  return buildRuntime(options, Slot, normalizeChildren);
+}
+
 // ../../adapters/react/src/legacy/create-contract-component.ts
-var EMPTY_SET = /* @__PURE__ */ new Set();
 function createContractComponent(options) {
-  const resolved = resolveAdapterCommonOptions(options);
-  const displayName = resolved.name;
-  const defaultTag = options.tag ?? "div";
-  const artifact = options.artifact;
-  const definition = artifact?.definition ?? buildDefinition(displayName, defaultTag);
-  const variantKeys = new Set(Object.keys(options.styling?.variants ?? {}));
-  const domDefaults = options.defaults;
-  const stylePipeline = buildStylePipeline(
-    options.styling?.variants,
-    options.styling?.presets,
-    options.styling?.defaults ?? {},
-    options.styling?.compounds,
-    artifact?.precomputed?.variantLookup
-  );
-  const base = options.styling?.base !== void 0 ? flattenClassName(options.styling.base) : void 0;
-  const filterFn = options.filterProps;
-  const allowedAs = options.enforcement?.allowedAs;
-  const normalizeFn = options.normalize;
-  const enforcementNormalizers = options.enforcement?.props;
-  const classPlugin = options.styling?.plugin !== void 0 ? options.styling.plugin(
-    options.styling,
-    resolved.diagnostics
-  ) : void 0;
-  const pluginKeys = classPlugin?.ownedKeys ?? EMPTY_SET;
-  const { childrenEvaluator: explicitEvaluator } = buildEngines(
-    resolved.diagnostics,
-    options.enforcement?.children,
-    displayName
-  );
-  const ariaEngine = options.enforcement !== void 0 ? new AriaPolicyEngine(resolved.diagnostics) : void 0;
-  const slotValidator = new SlotValidator(displayName, resolved.diagnostics, "React element");
-  const renderAsChild = makeRenderAsChild(cloneSlotChild);
-  const Component = forwardRef(function Component2(props, ref) {
-    const {
-      as,
-      asChild,
-      render,
-      children,
-      className: callerClassName,
-      recipe,
-      ...ownProps
-    } = props;
-    const tag = typeof as === "string" ? as : defaultTag;
-    if (allowedAs !== void 0) enforceAllowedAs(tag, allowedAs, resolved.diagnostics, displayName);
-    const rawBaseProps = domDefaults !== void 0 ? { ...domDefaults, ...ownProps } : ownProps;
-    const normalizedProps = applyPropNormalizers(tag, rawBaseProps, enforcementNormalizers);
-    const baseProps = normalizeFn !== void 0 ? normalizeFn(normalizedProps) : normalizedProps;
-    const pluginProps = {};
-    const propsForExtraction = pluginKeys.size > 0 ? Object.fromEntries(
-      Object.entries(baseProps).filter(([k]) => {
-        if (pluginKeys.has(k)) {
-          pluginProps[k] = baseProps[k];
-          return false;
-        }
-        return true;
-      })
-    ) : baseProps;
-    const rootDec = extractDecoration(propsForExtraction, variantKeys);
-    const decoration = applyAria(
-      Object.keys(rootDec).length > 0 ? { root: rootDec } : {},
-      tag,
-      ariaEngine
-    );
-    if (process.env.NODE_ENV !== "production") {
-      const childEval = explicitEvaluator ?? getHtmlChildrenEvaluator(tag);
-      childEval?.evaluate(normalizeChildren(children));
-    }
-    const recipeName = typeof recipe === "string" ? recipe : void 0;
-    const { variantClasses, compoundClasses } = stylePipeline ? stylePipeline.execute(decoration, recipeName) : { variantClasses: [], compoundClasses: [] };
-    const rawClassName = joinClasses(base, ...variantClasses, ...compoundClasses, callerClassName);
-    const className = classPlugin !== void 0 ? classPlugin.pipeline(tag, pluginProps, rawClassName, recipeName) : rawClassName;
-    if (asChild === true) {
-      if (typeof as === "string") {
-        slotValidator.assertExclusive();
-      } else {
-        return renderAsChild(children, className, ref);
-      }
-    }
-    let finalDecoration = className ? applyAttributes("root", { className }, decoration, variantKeys) : decoration;
-    finalDecoration = applyFilterProps(finalDecoration, filterFn, variantKeys);
-    finalDecoration = applyRef(finalDecoration, ref);
-    if (typeof render === "function")
-      return renderWithCallback(
-        render,
-        finalDecoration["root"]?.attributes ?? {},
-        className,
-        ref
-      );
-    return renderNormally(definition, tag, finalDecoration, children);
+  const bundle = buildRuntime2(options);
+  const Component = forwardRef2(function Component2(props, ref) {
+    return render({ ...bundle, props, ref });
   });
   applyDisplayName(Component, options.name);
-  if (typeof defaultTag === "string") {
+  const defaultTag = bundle.runtime.options.defaultTag;
+  if (isString(defaultTag)) {
     Object.assign(Component, { [COMPONENT_DEFAULT_TAG]: defaultTag });
   }
   return Component;
 }
-
-// ../../adapters/react/src/legacy/slot/Slot.tsx
-import { forwardRef as forwardRef2 } from "react";
-var Slot = forwardRef2(function Slot2({ children, ...slotProps }, ref) {
-  return applySlot(children, slotProps, ref, cloneSlotChild);
-});
-Slot.displayName = SLOT_NAME;
 export {
   Slot,
   Slottable,