praxis-kit 1.1.0

package/dist/react/index.d.ts

@@ -0,0 +1,27 @@
+import { E as ElementType, U as UnknownProps, V as VariantMap, P as PresetMap, a as EmptyRecord, A as AnyRecord, R as ReactFactoryOptions, b as PolymorphicComponent, c as PolymorphicGenerics, F as FactoryOptions } from '../merge-refs-CfBqh1UO.js';
+export { d as ElementRef, e as PolymorphicProps, f as PolymorphicWithAsChild, g as PolymorphicWithRender, h as RenderCallbackProps, S as Slottable, i as SlottableProps, j as disabledProps, k as invalidProps, m as mergeRefs } from '../merge-refs-CfBqh1UO.js';
+import { Ref, ReactElement } from 'react';
+import 'type-fest';
+
+declare function createAriaEnforcedComponent<TDefault extends ElementType, Props extends UnknownProps, Variants extends Readonly<VariantMap>, TPreset extends PresetMap<Variants> = Readonly<EmptyRecord>, TPluginProps extends AnyRecord = EmptyRecord>(options: ReactFactoryOptions<TDefault, Props, Variants, TPreset, TPluginProps>): PolymorphicComponent<PolymorphicGenerics<TDefault, Props & TPluginProps, Variants, TPreset>>;
+
+declare function defineContractComponent<O extends FactoryOptions>(options: O): <R>(factory: (options: O) => R) => R;
+
+declare function createChildrenEnforcedComponent<TDefault extends ElementType, Props extends UnknownProps, Variants extends Readonly<VariantMap>, TPreset extends PresetMap<Variants> = Readonly<EmptyRecord>, TPluginProps extends AnyRecord = EmptyRecord>(options: ReactFactoryOptions<TDefault, Props, Variants, TPreset, TPluginProps>): PolymorphicComponent<PolymorphicGenerics<TDefault, Props & TPluginProps, Variants, TPreset>>;
+
+declare function createContractComponent<TDefault extends ElementType, Props extends UnknownProps = EmptyRecord, Variants extends Readonly<VariantMap> = Readonly<EmptyRecord>, TPreset extends PresetMap<Variants> = Readonly<EmptyRecord>, TPluginProps extends AnyRecord = EmptyRecord, TAllowed extends ElementType = ElementType>(options: ReactFactoryOptions<TDefault, Props, Variants, TPreset, TPluginProps, TAllowed>): PolymorphicComponent<PolymorphicGenerics<TDefault, Props & TPluginProps, Variants, TPreset, TAllowed>>;
+
+declare function createContractedComponent<TDefault extends ElementType, Props extends UnknownProps, Variants extends Readonly<VariantMap>, TPreset extends PresetMap<Variants> = Readonly<EmptyRecord>, TPluginProps extends AnyRecord = EmptyRecord>(options: ReactFactoryOptions<TDefault, Props, Variants, TPreset, TPluginProps>): PolymorphicComponent<PolymorphicGenerics<TDefault, Props & TPluginProps, Variants, TPreset>>;
+
+declare function createPolymorphicComponent<TDefault extends ElementType, Props extends UnknownProps, Variants extends Readonly<VariantMap>, TPreset extends PresetMap<Variants> = Readonly<EmptyRecord>, TPluginProps extends AnyRecord = EmptyRecord>(options: ReactFactoryOptions<TDefault, Props, Variants, TPreset, TPluginProps>): PolymorphicComponent<PolymorphicGenerics<TDefault, Props & TPluginProps, Variants, TPreset>>;
+
+type SlotProps = {
+    ref?: Ref<unknown> | null;
+    [key: string]: unknown;
+};
+declare function Slot({ ref, children, ...slotProps }: SlotProps): ReactElement;
+declare namespace Slot {
+    var displayName: string;
+}
+
+export { PolymorphicComponent, ReactFactoryOptions, Slot, createAriaEnforcedComponent, createChildrenEnforcedComponent, createContractComponent, createContractedComponent, createPolymorphicComponent, defineContractComponent };

package/dist/react/index.js

@@ -0,0 +1,197 @@
+import {
+  COMPONENT_DEFAULT_TAG,
+  SLOT_NAME,
+  SlotValidator,
+  Slottable,
+  applyDisplayName,
+  applySlot,
+  buildEngines,
+  buildRuntime,
+  cloneWithProps,
+  composeFilter,
+  createContractedPolymorphic,
+  createPolymorphic,
+  disabledProps,
+  invalidProps,
+  isFunction,
+  isPlainObject,
+  mergeRefs,
+  mergeSlotProps,
+  render
+} from "../chunk-KDUNVQK2.js";
+
+// ../../adapters/react/src/current/slot/cloneSlotChild.ts
+import { Fragment } from "react";
+
+// ../../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);
+}
+
+// ../../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";
+function normalizeChildren(children) {
+  if (isValidElement(children)) return [children];
+  if (Array.isArray(children)) return children.filter(isValidElement);
+  return [];
+}
+
+// ../../adapters/react/src/current/create-aria-enforced-component.ts
+function createAriaEnforcedComponent(options) {
+  const name = options.name ?? "PolymorphicComponent";
+  const strict = options.enforcement?.strict ?? "throw";
+  const slotComponent = options.slotComponent ?? Slot;
+  const runtime = createContractedPolymorphic(options);
+  const filterProps = composeFilter(/* @__PURE__ */ new Set(), options.filterProps);
+  const slotValidator = new SlotValidator(name, strict);
+  function Component({ ref, ...props }) {
+    return render({
+      runtime,
+      props,
+      ref: ref ?? null,
+      slotComponent,
+      normalizeChildren,
+      filterProps,
+      slotValidator
+    });
+  }
+  applyDisplayName(Component, name);
+  return Component;
+}
+
+// ../../adapters/react/src/current/define-contract-component.ts
+function defineContractComponent(options) {
+  return (factory) => factory(options);
+}
+
+// ../../adapters/react/src/current/create-children-enforced-component.ts
+function createChildrenEnforcedComponent(options) {
+  const name = options.name ?? "PolymorphicComponent";
+  const strict = options.enforcement?.strict ?? "throw";
+  const slotComponent = options.slotComponent ?? Slot;
+  const runtime = createPolymorphic(options);
+  const filterProps = composeFilter(/* @__PURE__ */ new Set(), options.filterProps);
+  const slotValidator = new SlotValidator(name, strict);
+  const { childrenEvaluator } = buildEngines(strict, options.enforcement?.children, name);
+  function Component({ ref, ...props }) {
+    return render({
+      runtime,
+      props,
+      ref: ref ?? null,
+      slotComponent,
+      normalizeChildren,
+      filterProps,
+      slotValidator,
+      ...childrenEvaluator !== void 0 && { childrenEvaluator }
+    });
+  }
+  applyDisplayName(Component, name);
+  return Component;
+}
+
+// ../../adapters/react/src/current/create-contract-component.ts
+function createContractComponent(options) {
+  const bundle = buildRuntime(
+    options,
+    Slot,
+    normalizeChildren
+  );
+  function Component({ ref, ...props }) {
+    return render({ ...bundle, props, ref: ref ?? null });
+  }
+  applyDisplayName(Component, options.name);
+  if (typeof bundle.runtime.options.defaultTag === "string") {
+    Object.assign(Component, { [COMPONENT_DEFAULT_TAG]: bundle.runtime.options.defaultTag });
+  }
+  return Component;
+}
+
+// ../../adapters/react/src/current/create-contracted-component.ts
+function createContractedComponent(options) {
+  const name = options.name ?? "PolymorphicComponent";
+  const strict = options.enforcement?.strict ?? "throw";
+  const slotComponent = options.slotComponent ?? Slot;
+  const runtime = createContractedPolymorphic(options);
+  const filterProps = composeFilter(/* @__PURE__ */ new Set(), options.filterProps);
+  const slotValidator = new SlotValidator(name, strict);
+  const { childrenEvaluator } = buildEngines(strict, options.enforcement?.children, name);
+  function Component({ ref, ...props }) {
+    return render({
+      runtime,
+      props,
+      ref: ref ?? null,
+      slotComponent,
+      normalizeChildren,
+      filterProps,
+      slotValidator,
+      ...childrenEvaluator !== void 0 && { childrenEvaluator }
+    });
+  }
+  applyDisplayName(Component, name);
+  return Component;
+}
+
+// ../../adapters/react/src/current/create-polymorphic-component.ts
+function createPolymorphicComponent(options) {
+  const name = options.name ?? "PolymorphicComponent";
+  const slotComponent = options.slotComponent ?? Slot;
+  const runtime = createPolymorphic(options);
+  const filterProps = composeFilter(/* @__PURE__ */ new Set(), options.filterProps);
+  const slotValidator = new SlotValidator(name, "throw");
+  function Component({ ref, ...props }) {
+    return render({
+      runtime,
+      props,
+      ref: ref ?? null,
+      slotComponent,
+      normalizeChildren,
+      filterProps,
+      slotValidator
+    });
+  }
+  applyDisplayName(Component, name);
+  return Component;
+}
+export {
+  Slot,
+  Slottable,
+  createAriaEnforcedComponent,
+  createChildrenEnforcedComponent,
+  createContractComponent,
+  createContractedComponent,
+  createPolymorphicComponent,
+  defineContractComponent,
+  disabledProps,
+  invalidProps,
+  mergeRefs
+};

package/dist/react/legacy.d.ts

@@ -0,0 +1,21 @@
+import { E as ElementType, U as UnknownProps, V as VariantMap, P as PresetMap, a as EmptyRecord, A as AnyRecord, R as ReactFactoryOptions, b as PolymorphicComponent, c as PolymorphicGenerics } from '../merge-refs-CfBqh1UO.js';
+export { d as ElementRef, e as PolymorphicProps, f as PolymorphicWithAsChild, g as PolymorphicWithRender, h as RenderCallbackProps, S as Slottable, i as SlottableProps, j as disabledProps, k as invalidProps, m as mergeRefs } from '../merge-refs-CfBqh1UO.js';
+import * as react from 'react';
+import 'type-fest';
+
+declare function createAriaEnforcedComponent<TDefault extends ElementType, Props extends UnknownProps, Variants extends Readonly<VariantMap>, TPreset extends PresetMap<Variants> = Readonly<EmptyRecord>, TPluginProps extends AnyRecord = EmptyRecord>(options: ReactFactoryOptions<TDefault, Props, Variants, TPreset, TPluginProps>): PolymorphicComponent<PolymorphicGenerics<TDefault, Props & TPluginProps, Variants, TPreset>>;
+
+declare function createChildrenEnforcedComponent<TDefault extends ElementType, Props extends UnknownProps, Variants extends Readonly<VariantMap>, TPreset extends PresetMap<Variants> = Readonly<EmptyRecord>, TPluginProps extends AnyRecord = EmptyRecord>(options: ReactFactoryOptions<TDefault, Props, Variants, TPreset, TPluginProps>): PolymorphicComponent<PolymorphicGenerics<TDefault, Props & TPluginProps, Variants, TPreset>>;
+
+declare function createContractComponent<TDefault extends ElementType, Props extends UnknownProps = EmptyRecord, Variants extends Readonly<VariantMap> = Readonly<EmptyRecord>, TPreset extends PresetMap<Variants> = Readonly<EmptyRecord>, TPluginProps extends AnyRecord = EmptyRecord, TAllowed extends ElementType = ElementType>(options: ReactFactoryOptions<TDefault, Props, Variants, TPreset, TPluginProps, TAllowed>): PolymorphicComponent<PolymorphicGenerics<TDefault, Props & TPluginProps, Variants, TPreset, TAllowed>>;
+
+declare function createContractedComponent<TDefault extends ElementType, Props extends UnknownProps, Variants extends Readonly<VariantMap>, TPreset extends PresetMap<Variants> = Readonly<EmptyRecord>, TPluginProps extends AnyRecord = EmptyRecord>(options: ReactFactoryOptions<TDefault, Props, Variants, TPreset, TPluginProps>): PolymorphicComponent<PolymorphicGenerics<TDefault, Props & TPluginProps, Variants, TPreset>>;
+
+declare function createPolymorphicComponent<TDefault extends ElementType, Props extends UnknownProps, Variants extends Readonly<VariantMap>, TPreset extends PresetMap<Variants> = Readonly<EmptyRecord>, TPluginProps extends AnyRecord = EmptyRecord>(options: ReactFactoryOptions<TDefault, Props, Variants, TPreset, TPluginProps>): PolymorphicComponent<PolymorphicGenerics<TDefault, Props & TPluginProps, Variants, TPreset>>;
+
+type SlotProps = {
+    [key: string]: unknown;
+};
+declare const Slot: react.ForwardRefExoticComponent<Omit<SlotProps, "ref"> & react.RefAttributes<unknown>>;
+
+export { PolymorphicComponent, ReactFactoryOptions, Slot, createAriaEnforcedComponent, createChildrenEnforcedComponent, createContractComponent, createContractedComponent, createPolymorphicComponent };

package/dist/react/legacy.js

@@ -0,0 +1,209 @@
+import {
+  COMPONENT_DEFAULT_TAG,
+  SLOT_NAME,
+  SlotValidator,
+  Slottable,
+  applyDisplayName,
+  applySlot,
+  buildEngines,
+  buildRuntime,
+  cloneWithProps,
+  composeFilter,
+  createContractedPolymorphic,
+  createPolymorphic,
+  disabledProps,
+  invalidProps,
+  isFunction,
+  isPlainObject,
+  mergeRefs,
+  mergeSlotProps,
+  render
+} from "../chunk-KDUNVQK2.js";
+
+// ../../adapters/react/src/legacy/create-aria-enforced-component.ts
+import { forwardRef as forwardRef2 } from "react";
+
+// ../../adapters/react/src/legacy/slot/Slot.tsx
+import { forwardRef } from "react";
+
+// ../../adapters/react/src/legacy/slot/cloneSlotChild.ts
+import { Fragment } 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);
+}
+
+// ../../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";
+function normalizeChildren(children) {
+  return Children.toArray(children).filter(isValidElement);
+}
+
+// ../../adapters/react/src/legacy/create-aria-enforced-component.ts
+function createAriaEnforcedComponent(options) {
+  const name = options.name ?? "PolymorphicComponent";
+  const strict = options.enforcement?.strict ?? "throw";
+  const slotComponent = options.slotComponent ?? Slot;
+  const runtime = createContractedPolymorphic(options);
+  const filterProps = composeFilter(/* @__PURE__ */ new Set(), options.filterProps);
+  const slotValidator = new SlotValidator(name, strict);
+  const Component = forwardRef2(
+    function PolymorphicComponent(props, ref) {
+      return render({
+        runtime,
+        props,
+        ref,
+        slotComponent,
+        normalizeChildren,
+        filterProps,
+        slotValidator
+      });
+    }
+  );
+  applyDisplayName(Component, name);
+  return Component;
+}
+
+// ../../adapters/react/src/legacy/create-children-enforced-component.ts
+import { forwardRef as forwardRef3 } from "react";
+function createChildrenEnforcedComponent(options) {
+  const name = options.name ?? "PolymorphicComponent";
+  const strict = options.enforcement?.strict ?? "throw";
+  const slotComponent = options.slotComponent ?? Slot;
+  const runtime = createPolymorphic(options);
+  const filterProps = composeFilter(/* @__PURE__ */ new Set(), options.filterProps);
+  const slotValidator = new SlotValidator(name, strict);
+  const { childrenEvaluator } = buildEngines(strict, options.enforcement?.children, name);
+  const Component = forwardRef3(
+    function PolymorphicComponent(props, ref) {
+      return render({
+        runtime,
+        props,
+        ref,
+        slotComponent,
+        normalizeChildren,
+        filterProps,
+        slotValidator,
+        ...childrenEvaluator !== void 0 && { childrenEvaluator }
+      });
+    }
+  );
+  applyDisplayName(Component, name);
+  return Component;
+}
+
+// ../../adapters/react/src/legacy/create-contract-component.ts
+import { forwardRef as forwardRef4 } from "react";
+function createContractComponent(options) {
+  const bundle = buildRuntime(
+    options,
+    Slot,
+    normalizeChildren
+  );
+  const Component = forwardRef4(
+    function PolymorphicComponent(props, ref) {
+      return render({ ...bundle, props, ref });
+    }
+  );
+  applyDisplayName(Component, options.name);
+  if (typeof bundle.runtime.options.defaultTag === "string") {
+    Object.assign(Component, { [COMPONENT_DEFAULT_TAG]: bundle.runtime.options.defaultTag });
+  }
+  return Component;
+}
+
+// ../../adapters/react/src/legacy/create-contracted-component.ts
+import { forwardRef as forwardRef5 } from "react";
+function createContractedComponent(options) {
+  const name = options.name ?? "PolymorphicComponent";
+  const strict = options.enforcement?.strict ?? "throw";
+  const slotComponent = options.slotComponent ?? Slot;
+  const runtime = createContractedPolymorphic(options);
+  const filterProps = composeFilter(/* @__PURE__ */ new Set(), options.filterProps);
+  const slotValidator = new SlotValidator(name, strict);
+  const { childrenEvaluator } = buildEngines(strict, options.enforcement?.children, name);
+  const Component = forwardRef5(
+    function PolymorphicComponent(props, ref) {
+      return render({
+        runtime,
+        props,
+        ref,
+        slotComponent,
+        normalizeChildren,
+        filterProps,
+        slotValidator,
+        ...childrenEvaluator !== void 0 && { childrenEvaluator }
+      });
+    }
+  );
+  applyDisplayName(Component, name);
+  return Component;
+}
+
+// ../../adapters/react/src/legacy/create-polymorphic-component.ts
+import { forwardRef as forwardRef6 } from "react";
+function createPolymorphicComponent(options) {
+  const name = options.name ?? "PolymorphicComponent";
+  const slotComponent = options.slotComponent ?? Slot;
+  const runtime = createPolymorphic(options);
+  const filterProps = composeFilter(/* @__PURE__ */ new Set(), options.filterProps);
+  const slotValidator = new SlotValidator(name, "throw");
+  const Component = forwardRef6(
+    function PolymorphicComponent(props, ref) {
+      return render({
+        runtime,
+        props,
+        ref,
+        slotComponent,
+        normalizeChildren,
+        filterProps,
+        slotValidator
+      });
+    }
+  );
+  applyDisplayName(Component, name);
+  return Component;
+}
+export {
+  Slot,
+  Slottable,
+  createAriaEnforcedComponent,
+  createChildrenEnforcedComponent,
+  createContractComponent,
+  createContractedComponent,
+  createPolymorphicComponent,
+  disabledProps,
+  invalidProps,
+  mergeRefs
+};