@bento/use-props 0.2.1 → 0.2.3

package/dist/index.cjs

@@ -1,98 +1,175 @@
-'use strict';
-
-var box = require('@bento/box');
-var internalProps = require('@bento/internal-props');
-var utils = require('@react-aria/utils');
-var react = require('react');
-
-// src/index.ts
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _bento_box = require("@bento/box");
+let _bento_internal_props = require("@bento/internal-props");
+let _react_aria_utils = require("@react-aria/utils");
+let react = require("react");
+//#region src/index.ts
+/**
+* Checks if the given string is an event listener name. An event listener name
+* is defined as a string that starts with "on" followed by an uppercase letter.
+*
+* @param name - The string to check.
+* @returns `true` if the string is an event listener name, otherwise `false`.
+* @private
+*/
 function isEventListener(name) {
-  return /^on[A-Z]/.test(name);
+	return /^on[A-Z]/.test(name);
 }
+/**
+* Determines if a given value is a render prop.
+*
+* A render prop is a function that is used to dynamically generate
+* UI elements. This function checks if the provided value is a function
+* and not an event listener.
+*
+* @param name - The name of the prop.
+* @param value - The value of the prop to check.
+* @returns `true` if the value is a render prop, otherwise `false`.
+*/
 function isRenderProp(name, value) {
-  return typeof value === "function" && !isEventListener(name);
+	return typeof value === "function" && !isEventListener(name);
 }
+/**
+* Executes a function or returns a value from the given data object.
+*
+* @param name - The name of the property to execute or retrieve.
+* @param data - The data object containing the property.
+* @param args - The arguments to pass if the property is a function.
+* @returns The result of the function execution or the value of the property.
+* @private
+*/
 function execute(name, data, args) {
-  const value = data[name];
-  if (isRenderProp(name, value)) return value(args);
-  return value;
+	const value = data[name];
+	if (isRenderProp(name, value)) return value(args);
+	return value;
 }
+/**
+* Retrieves a property value, potentially overridden by a slotted value.
+*
+* @param name - The name of the property to retrieve.
+* @param options.props - The original properties.
+* @param options.slots - The slotted values that can override the original properties.
+* @param options.state - The current state.
+* @param options.original - The original value of the property.
+* @returns The original property value or the overridden value if provided.
+*/
 function renderProp(name, args) {
-  const { props, slots, original } = args;
-  return execute(name, slots, args) || execute(name, props, args) || original;
+	const { props, slots, original } = args;
+	return execute(name, slots, args) || execute(name, props, args) || original;
 }
+/**
+* Merges multiple refs into a single ref callback.
+*
+* @param refs - Array of refs to merge (can include undefined/null).
+* @returns A single merged ref, undefined if no refs provided.
+* @private
+*/
 function mergeRefList(refs) {
-  const filtered = refs.filter((ref) => ref != null);
-  if (!filtered.length) return void 0;
-  if (filtered.length === 1) return filtered[0];
-  return utils.mergeRefs(...filtered);
+	const filtered = refs.filter((ref) => ref != null);
+	if (!filtered.length) return void 0;
+	if (filtered.length === 1) return filtered[0];
+	return (0, _react_aria_utils.mergeRefs)(...filtered);
 }
+/**
+* Hook that merges props with slotted props and provides a proxy for accessing them.
+*
+* @param args - The initial props to use, or array when using rest parameters.
+* @param state - The state object to use.
+* @param forwardedRef - The ref forwarded to the component.
+* @returns An object containing the proxy based props object and the apply function.
+* @throws {BentoError} If the hook is used outside of a @bento/slots component.
+*
+* @example
+* const { props, apply, ref } = useProps({ foo: 'bar' }, {}, forwardedRef);
+* if (props.a) doSomething()
+* return <a {...apply({ className: 'foo' }, ['ref']) } ref={ref}>{ props.children }</a>;
+*
+* @example
+* // With rest parameters
+* function Component(...rest) {
+*   const { props, apply, ref } = useProps(rest);
+*   return <div {...apply()} />;
+* }
+*/
 function useProps(...rest) {
-  let forwardedRef;
-  let args;
-  let state;
-  if (Array.isArray(rest[0])) {
-    [args, forwardedRef] = rest[0];
-    state = rest[1];
-  } else {
-    [args, state, forwardedRef] = rest;
-  }
-  const { slots } = react.useContext(box.Box);
-  const [props, internal] = internalProps.useInternalProps(args);
-  const { namespace, assigned } = slots;
-  const dot = namespace.join(".");
-  const slotted = assigned[dot] || {};
-  const ref = mergeRefList([
-    props?.ref,
-    slotted?.ref,
-    forwardedRef
-  ]);
-  const slotNoRef = { ...slotted };
-  const propsNoRef = { ...props };
-  delete slotNoRef.ref;
-  delete propsNoRef.ref;
-  const propsy = { ...internal, ...propsNoRef, ...slotNoRef };
-  function apply(attributes, except) {
-    const data = attributes || propsy;
-    const returned = {};
-    function reduce(memo, key) {
-      if (except && except.includes(key)) return memo;
-      memo[key] = renderProp(key, {
-        props: { ...props, ...internal },
-        original: data[key],
-        slots: slotted,
-        state
-      });
-      return memo;
-    }
-    let result;
-    if (!attributes) result = Object.keys(propsy).reduce(reduce, returned);
-    else result = Object.keys(propsy).reduce(reduce, Object.keys(attributes).reduce(reduce, returned));
-    if (except && except.includes("ref")) return result;
-    if (ref) result.ref = ref;
-    return result;
-  }
-  return {
-    props: new Proxy(propsy, {
-      get: function getter(_, name) {
-        if (name === "ref") return ref;
-        return renderProp(name, {
-          original: isRenderProp(name, props[name]) ? void 0 : props[name],
-          props: { ...props, ...internal },
-          slots: slotted,
-          state
-        });
-      }
-    }),
-    apply,
-    ref
-  };
+	let forwardedRef;
+	let args;
+	let state;
+	if (Array.isArray(rest[0])) {
+		[args, forwardedRef] = rest[0];
+		state = rest[1];
+	} else [args, state, forwardedRef] = rest;
+	const { slots } = (0, react.useContext)(_bento_box.Box);
+	const [props, internal] = (0, _bento_internal_props.useInternalProps)(args);
+	const { namespace, assigned } = slots;
+	const slotted = assigned[namespace.join(".")] || {};
+	const ref = mergeRefList([
+		props?.ref,
+		slotted?.ref,
+		forwardedRef
+	]);
+	const slotNoRef = { ...slotted };
+	const propsNoRef = { ...props };
+	delete slotNoRef.ref;
+	delete propsNoRef.ref;
+	const propsy = {
+		...internal,
+		...propsNoRef,
+		...slotNoRef
+	};
+	/**
+	* Applies the given attributes to an object.
+	*
+	* @param attributes - The attributes to apply. If not provided, defaults to `propsy`.
+	* @param except - An array of keys to exclude from the resulting object.
+	* @returns The resulting object with applied attributes.
+	* @public
+	*/
+	function apply(attributes, except) {
+		const data = attributes || propsy;
+		const returned = {};
+		function reduce(memo, key) {
+			if (except && except.includes(key)) return memo;
+			memo[key] = renderProp(key, {
+				props: {
+					...props,
+					...internal
+				},
+				original: data[key],
+				slots: slotted,
+				state
+			});
+			return memo;
+		}
+		let result;
+		if (!attributes) result = Object.keys(propsy).reduce(reduce, returned);
+		else result = Object.keys(propsy).reduce(reduce, Object.keys(attributes).reduce(reduce, returned));
+		if (except && except.includes("ref")) return result;
+		if (ref) result.ref = ref;
+		return result;
+	}
+	return {
+		props: new Proxy(propsy, { get: function getter(_, name) {
+			if (name === "ref") return ref;
+			return renderProp(name, {
+				original: isRenderProp(name, props[name]) ? void 0 : props[name],
+				props: {
+					...props,
+					...internal
+				},
+				slots: slotted,
+				state
+			});
+		} }),
+		apply,
+		ref
+	};
 }
-
+//#endregion
 exports.execute = execute;
 exports.isEventListener = isEventListener;
 exports.isRenderProp = isRenderProp;
 exports.renderProp = renderProp;
 exports.useProps = useProps;
-//# sourceMappingURL=index.cjs.map
+
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":["mergeRefs","useContext","Box","useInternalProps"],"mappings":"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","file":"index.cjs","sourcesContent":["import { Box, type BoxContext } from '@bento/box';\nimport { useInternalProps } from '@bento/internal-props';\nimport { AnyObject } from '@bento/types';\nimport { mergeRefs } from '@react-aria/utils';\nimport { useContext } from 'react';\nimport type { ForwardedRef, Ref } from 'react';\n\nexport interface RenderPropData {\n  /**\n   * If the component is assigning a default value to the given prop,\n   * the original value be a reference to the previous assigned value.\n   * @default The original assigned value\n   */\n  original?: unknown;\n\n  /** All the props that were passed to the component. @default {} */\n  props: AnyObject;\n\n  /** If slots are used to modify the component, this will contain a reference to the original slots object. @default {} */\n  slots: AnyObject;\n\n  /** The exposed state of the component. @default {} */\n  state: AnyObject;\n}\n\n/**\n * Checks if the given string is an event listener name. An event listener name\n * is defined as a string that starts with \"on\" followed by an uppercase letter.\n *\n * @param name - The string to check.\n * @returns `true` if the string is an event listener name, otherwise `false`.\n * @private\n */\nexport function isEventListener(name: string): boolean {\n  return /^on[A-Z]/.test(name);\n}\n\n/**\n * Determines if a given value is a render prop.\n *\n * A render prop is a function that is used to dynamically generate\n * UI elements. This function checks if the provided value is a function\n * and not an event listener.\n *\n * @param name - The name of the prop.\n * @param value - The value of the prop to check.\n * @returns `true` if the value is a render prop, otherwise `false`.\n */\nexport function isRenderProp(name: string, value: any): boolean {\n  return typeof value === 'function' && !isEventListener(name);\n}\n\n/**\n * Executes a function or returns a value from the given data object.\n *\n * @param name - The name of the property to execute or retrieve.\n * @param data - The data object containing the property.\n * @param args - The arguments to pass if the property is a function.\n * @returns The result of the function execution or the value of the property.\n * @private\n */\nexport function execute(name: string, data: AnyObject, args: RenderPropData): any {\n  const value = data[name];\n\n  if (isRenderProp(name, value)) return value(args);\n  return value;\n}\n\n/**\n * Retrieves a property value, potentially overridden by a slotted value.\n *\n * @param name - The name of the property to retrieve.\n * @param options.props - The original properties.\n * @param options.slots - The slotted values that can override the original properties.\n * @param options.state - The current state.\n * @param options.original - The original value of the property.\n * @returns The original property value or the overridden value if provided.\n */\nexport function renderProp(name: string, args: RenderPropData): any {\n  const { props, slots, original } = args;\n\n  return execute(name, slots, args) || execute(name, props, args) || original;\n}\n\n/**\n * Merges multiple refs into a single ref callback.\n *\n * @param refs - Array of refs to merge (can include undefined/null).\n * @returns A single merged ref, undefined if no refs provided.\n * @private\n */\nfunction mergeRefList(refs: Array<ForwardedRef<any> | Ref<any> | undefined>): Ref<any> | undefined {\n  const filtered = refs.filter((ref): ref is ForwardedRef<any> | Ref<any> => ref != null);\n\n  if (!filtered.length) return undefined;\n  if (filtered.length === 1) return filtered[0] as Ref<any>;\n\n  return mergeRefs(...(filtered as Array<Ref<any>>)) as Ref<any>;\n}\n\nexport interface Returns {\n  /**\n   * Proxy object that have access to the original props, slotted values, and internal props. When\n   * accessing a property, it will first check the slotted values, then the original props, and finally\n   * the internal props. If the property is a render prop, it will execute the function with the provided\n   * arguments.\n   *\n   * @default { ...props, ...slots }\n   */\n  props: AnyObject;\n  /**\n   * Applies the given attributes as default values to the props. If no attributes are provided, it will\n   * use the props as default values. The resulting object will contain all the properties of the props,\n   * except for the ones specified in the `except` array. The values of the properties will be the result\n   * of executing the render prop function with the provided arguments.\n   *\n   * @default function(attr)\n   */\n  apply: (attributes?: object, except?: string[]) => object;\n  /**\n   * The merged ref combining forwarded refs with any ref supplied via slots.\n   */\n  ref?: Ref<any>;\n}\n\n/**\n * Hook that merges props with slotted props and provides a proxy for accessing them.\n *\n * @param args - The initial props to use, or array when using rest parameters.\n * @param state - The state object to use.\n * @param forwardedRef - The ref forwarded to the component.\n * @returns An object containing the proxy based props object and the apply function.\n * @throws {BentoError} If the hook is used outside of a @bento/slots component.\n *\n * @example\n * const { props, apply, ref } = useProps({ foo: 'bar' }, {}, forwardedRef);\n * if (props.a) doSomething()\n * return <a {...apply({ className: 'foo' }, ['ref']) } ref={ref}>{ props.children }</a>;\n *\n * @example\n * // With rest parameters\n * function Component(...rest) {\n *   const { props, apply, ref } = useProps(rest);\n *   return <div {...apply()} />;\n * }\n */\nexport function useProps(...rest: any[]): Returns {\n  let forwardedRef: ForwardedRef<any> | undefined;\n  let args: AnyObject;\n  let state: object;\n\n  if (Array.isArray(rest[0])) {\n    [args, forwardedRef] = rest[0];\n    state = rest[1];\n  } else {\n    [args, state, forwardedRef] = rest;\n  }\n\n  const { slots } = useContext<BoxContext<AnyObject>>(Box);\n  const [props, internal] = useInternalProps(args);\n  const { namespace, assigned } = slots;\n  const dot = namespace.join('.');\n  const slotted = assigned[dot] || {};\n\n  const ref = mergeRefList([\n    (props as AnyObject)?.ref as ForwardedRef<any> | Ref<any> | undefined,\n    (slotted as AnyObject)?.ref as ForwardedRef<any> | Ref<any> | undefined,\n    forwardedRef\n  ]);\n\n  const slotNoRef = { ...slotted } as AnyObject;\n  const propsNoRef = { ...props } as AnyObject;\n\n  delete slotNoRef.ref;\n  delete propsNoRef.ref;\n\n  const propsy: AnyObject = { ...internal, ...propsNoRef, ...slotNoRef };\n\n  /**\n   * Applies the given attributes to an object.\n   *\n   * @param attributes - The attributes to apply. If not provided, defaults to `propsy`.\n   * @param except - An array of keys to exclude from the resulting object.\n   * @returns The resulting object with applied attributes.\n   * @public\n   */\n  function apply(attributes?: object, except?: string[]): object {\n    const data = (attributes || propsy) as AnyObject;\n    const returned: AnyObject = {};\n\n    function reduce(memo: AnyObject, key: string) {\n      if (except && except.includes(key)) return memo;\n\n      memo[key] = renderProp(key, {\n        props: { ...props, ...internal },\n        original: data[key],\n        slots: slotted,\n        state\n      });\n\n      return memo;\n    }\n\n    let result: AnyObject;\n\n    if (!attributes) result = Object.keys(propsy).reduce(reduce, returned);\n    else result = Object.keys(propsy).reduce(reduce, Object.keys(attributes).reduce(reduce, returned));\n\n    // Always include the merged ref unless specifically excluded\n    if (except && except.includes('ref')) return result;\n    if (ref) result.ref = ref;\n\n    return result;\n  }\n\n  return {\n    props: new Proxy(propsy, {\n      get: function getter(_: object, name: string) {\n        if (name === 'ref') return ref;\n\n        return renderProp(name, {\n          original: isRenderProp(name, props[name]) ? undefined : props[name],\n          props: { ...props, ...internal },\n          slots: slotted,\n          state\n        });\n      }\n    }),\n    apply,\n    ref\n  };\n}\n"]}
+{"version":3,"file":"index.cjs","names":["Box"],"sources":["../src/index.ts"],"sourcesContent":["import { Box, type BoxContext } from '@bento/box';\nimport { useInternalProps } from '@bento/internal-props';\nimport { AnyObject } from '@bento/types';\nimport { mergeRefs } from '@react-aria/utils';\nimport { useContext } from 'react';\nimport type { ForwardedRef, Ref } from 'react';\n\nexport interface RenderPropData {\n  /**\n   * If the component is assigning a default value to the given prop,\n   * the original value be a reference to the previous assigned value.\n   * @default The original assigned value\n   */\n  original?: unknown;\n\n  /** All the props that were passed to the component. @default {} */\n  props: AnyObject;\n\n  /** If slots are used to modify the component, this will contain a reference to the original slots object. @default {} */\n  slots: AnyObject;\n\n  /** The exposed state of the component. @default {} */\n  state: AnyObject;\n}\n\n/**\n * Checks if the given string is an event listener name. An event listener name\n * is defined as a string that starts with \"on\" followed by an uppercase letter.\n *\n * @param name - The string to check.\n * @returns `true` if the string is an event listener name, otherwise `false`.\n * @private\n */\nexport function isEventListener(name: string): boolean {\n  return /^on[A-Z]/.test(name);\n}\n\n/**\n * Determines if a given value is a render prop.\n *\n * A render prop is a function that is used to dynamically generate\n * UI elements. This function checks if the provided value is a function\n * and not an event listener.\n *\n * @param name - The name of the prop.\n * @param value - The value of the prop to check.\n * @returns `true` if the value is a render prop, otherwise `false`.\n */\nexport function isRenderProp(name: string, value: any): boolean {\n  return typeof value === 'function' && !isEventListener(name);\n}\n\n/**\n * Executes a function or returns a value from the given data object.\n *\n * @param name - The name of the property to execute or retrieve.\n * @param data - The data object containing the property.\n * @param args - The arguments to pass if the property is a function.\n * @returns The result of the function execution or the value of the property.\n * @private\n */\nexport function execute(name: string, data: AnyObject, args: RenderPropData): any {\n  const value = data[name];\n\n  if (isRenderProp(name, value)) return value(args);\n  return value;\n}\n\n/**\n * Retrieves a property value, potentially overridden by a slotted value.\n *\n * @param name - The name of the property to retrieve.\n * @param options.props - The original properties.\n * @param options.slots - The slotted values that can override the original properties.\n * @param options.state - The current state.\n * @param options.original - The original value of the property.\n * @returns The original property value or the overridden value if provided.\n */\nexport function renderProp(name: string, args: RenderPropData): any {\n  const { props, slots, original } = args;\n\n  return execute(name, slots, args) || execute(name, props, args) || original;\n}\n\n/**\n * Merges multiple refs into a single ref callback.\n *\n * @param refs - Array of refs to merge (can include undefined/null).\n * @returns A single merged ref, undefined if no refs provided.\n * @private\n */\nfunction mergeRefList(refs: Array<ForwardedRef<any> | Ref<any> | undefined>): Ref<any> | undefined {\n  const filtered = refs.filter((ref): ref is ForwardedRef<any> | Ref<any> => ref != null);\n\n  if (!filtered.length) return undefined;\n  if (filtered.length === 1) return filtered[0] as Ref<any>;\n\n  return mergeRefs(...(filtered as Array<Ref<any>>)) as Ref<any>;\n}\n\nexport interface Returns {\n  /**\n   * Proxy object that have access to the original props, slotted values, and internal props. When\n   * accessing a property, it will first check the slotted values, then the original props, and finally\n   * the internal props. If the property is a render prop, it will execute the function with the provided\n   * arguments.\n   *\n   * @default { ...props, ...slots }\n   */\n  props: AnyObject;\n  /**\n   * Applies the given attributes as default values to the props. If no attributes are provided, it will\n   * use the props as default values. The resulting object will contain all the properties of the props,\n   * except for the ones specified in the `except` array. The values of the properties will be the result\n   * of executing the render prop function with the provided arguments.\n   *\n   * @default function(attr)\n   */\n  apply: (attributes?: object, except?: string[]) => object;\n  /**\n   * The merged ref combining forwarded refs with any ref supplied via slots.\n   */\n  ref?: Ref<any>;\n}\n\n/**\n * Hook that merges props with slotted props and provides a proxy for accessing them.\n *\n * @param args - The initial props to use, or array when using rest parameters.\n * @param state - The state object to use.\n * @param forwardedRef - The ref forwarded to the component.\n * @returns An object containing the proxy based props object and the apply function.\n * @throws {BentoError} If the hook is used outside of a @bento/slots component.\n *\n * @example\n * const { props, apply, ref } = useProps({ foo: 'bar' }, {}, forwardedRef);\n * if (props.a) doSomething()\n * return <a {...apply({ className: 'foo' }, ['ref']) } ref={ref}>{ props.children }</a>;\n *\n * @example\n * // With rest parameters\n * function Component(...rest) {\n *   const { props, apply, ref } = useProps(rest);\n *   return <div {...apply()} />;\n * }\n */\nexport function useProps(...rest: any[]): Returns {\n  let forwardedRef: ForwardedRef<any> | undefined;\n  let args: AnyObject;\n  let state: object;\n\n  if (Array.isArray(rest[0])) {\n    [args, forwardedRef] = rest[0];\n    state = rest[1];\n  } else {\n    [args, state, forwardedRef] = rest;\n  }\n\n  const { slots } = useContext<BoxContext<AnyObject>>(Box);\n  const [props, internal] = useInternalProps(args);\n  const { namespace, assigned } = slots;\n  const dot = namespace.join('.');\n  const slotted = assigned[dot] || {};\n\n  const ref = mergeRefList([\n    (props as AnyObject)?.ref as ForwardedRef<any> | Ref<any> | undefined,\n    (slotted as AnyObject)?.ref as ForwardedRef<any> | Ref<any> | undefined,\n    forwardedRef\n  ]);\n\n  const slotNoRef = { ...slotted } as AnyObject;\n  const propsNoRef = { ...props } as AnyObject;\n\n  delete slotNoRef.ref;\n  delete propsNoRef.ref;\n\n  const propsy: AnyObject = { ...internal, ...propsNoRef, ...slotNoRef };\n\n  /**\n   * Applies the given attributes to an object.\n   *\n   * @param attributes - The attributes to apply. If not provided, defaults to `propsy`.\n   * @param except - An array of keys to exclude from the resulting object.\n   * @returns The resulting object with applied attributes.\n   * @public\n   */\n  function apply(attributes?: object, except?: string[]): object {\n    const data = (attributes || propsy) as AnyObject;\n    const returned: AnyObject = {};\n\n    function reduce(memo: AnyObject, key: string) {\n      if (except && except.includes(key)) return memo;\n\n      memo[key] = renderProp(key, {\n        props: { ...props, ...internal },\n        original: data[key],\n        slots: slotted,\n        state\n      });\n\n      return memo;\n    }\n\n    let result: AnyObject;\n\n    if (!attributes) result = Object.keys(propsy).reduce(reduce, returned);\n    else result = Object.keys(propsy).reduce(reduce, Object.keys(attributes).reduce(reduce, returned));\n\n    // Always include the merged ref unless specifically excluded\n    if (except && except.includes('ref')) return result;\n    if (ref) result.ref = ref;\n\n    return result;\n  }\n\n  return {\n    props: new Proxy(propsy, {\n      get: function getter(_: object, name: string) {\n        if (name === 'ref') return ref;\n\n        return renderProp(name, {\n          original: isRenderProp(name, props[name]) ? undefined : props[name],\n          props: { ...props, ...internal },\n          slots: slotted,\n          state\n        });\n      }\n    }),\n    apply,\n    ref\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;AAiCA,SAAgB,gBAAgB,MAAuB;CACrD,OAAO,WAAW,KAAK,IAAI;AAC7B;;;;;;;;;;;;AAaA,SAAgB,aAAa,MAAc,OAAqB;CAC9D,OAAO,OAAO,UAAU,cAAc,CAAC,gBAAgB,IAAI;AAC7D;;;;;;;;;;AAWA,SAAgB,QAAQ,MAAc,MAAiB,MAA2B;CAChF,MAAM,QAAQ,KAAK;CAEnB,IAAI,aAAa,MAAM,KAAK,GAAG,OAAO,MAAM,IAAI;CAChD,OAAO;AACT;;;;;;;;;;;AAYA,SAAgB,WAAW,MAAc,MAA2B;CAClE,MAAM,EAAE,OAAO,OAAO,aAAa;CAEnC,OAAO,QAAQ,MAAM,OAAO,IAAI,KAAK,QAAQ,MAAM,OAAO,IAAI,KAAK;AACrE;;;;;;;;AASA,SAAS,aAAa,MAA6E;CACjG,MAAM,WAAW,KAAK,QAAQ,QAA6C,OAAO,IAAI;CAEtF,IAAI,CAAC,SAAS,QAAQ,OAAO,KAAA;CAC7B,IAAI,SAAS,WAAW,GAAG,OAAO,SAAS;CAE3C,QAAA,GAAA,kBAAA,WAAiB,GAAI,QAA4B;AACnD;;;;;;;;;;;;;;;;;;;;;;AAgDA,SAAgB,SAAS,GAAG,MAAsB;CAChD,IAAI;CACJ,IAAI;CACJ,IAAI;CAEJ,IAAI,MAAM,QAAQ,KAAK,EAAE,GAAG;EAC1B,CAAC,MAAM,gBAAgB,KAAK;EAC5B,QAAQ,KAAK;CACf,OACE,CAAC,MAAM,OAAO,gBAAgB;CAGhC,MAAM,EAAE,WAAA,GAAA,MAAA,YAA4CA,WAAAA,GAAG;CACvD,MAAM,CAAC,OAAO,aAAA,GAAA,sBAAA,kBAA6B,IAAI;CAC/C,MAAM,EAAE,WAAW,aAAa;CAEhC,MAAM,UAAU,SADJ,UAAU,KAAK,GACA,MAAM,CAAC;CAElC,MAAM,MAAM,aAAa;EACtB,OAAqB;EACrB,SAAuB;EACxB;CACF,CAAC;CAED,MAAM,YAAY,EAAE,GAAG,QAAQ;CAC/B,MAAM,aAAa,EAAE,GAAG,MAAM;CAE9B,OAAO,UAAU;CACjB,OAAO,WAAW;CAElB,MAAM,SAAoB;EAAE,GAAG;EAAU,GAAG;EAAY,GAAG;CAAU;;;;;;;;;CAUrE,SAAS,MAAM,YAAqB,QAA2B;EAC7D,MAAM,OAAQ,cAAc;EAC5B,MAAM,WAAsB,CAAC;EAE7B,SAAS,OAAO,MAAiB,KAAa;GAC5C,IAAI,UAAU,OAAO,SAAS,GAAG,GAAG,OAAO;GAE3C,KAAK,OAAO,WAAW,KAAK;IAC1B,OAAO;KAAE,GAAG;KAAO,GAAG;IAAS;IAC/B,UAAU,KAAK;IACf,OAAO;IACP;GACF,CAAC;GAED,OAAO;EACT;EAEA,IAAI;EAEJ,IAAI,CAAC,YAAY,SAAS,OAAO,KAAK,MAAM,EAAE,OAAO,QAAQ,QAAQ;OAChE,SAAS,OAAO,KAAK,MAAM,EAAE,OAAO,QAAQ,OAAO,KAAK,UAAU,EAAE,OAAO,QAAQ,QAAQ,CAAC;EAGjG,IAAI,UAAU,OAAO,SAAS,KAAK,GAAG,OAAO;EAC7C,IAAI,KAAK,OAAO,MAAM;EAEtB,OAAO;CACT;CAEA,OAAO;EACL,OAAO,IAAI,MAAM,QAAQ,EACvB,KAAK,SAAS,OAAO,GAAW,MAAc;GAC5C,IAAI,SAAS,OAAO,OAAO;GAE3B,OAAO,WAAW,MAAM;IACtB,UAAU,aAAa,MAAM,MAAM,KAAK,IAAI,KAAA,IAAY,MAAM;IAC9D,OAAO;KAAE,GAAG;KAAO,GAAG;IAAS;IAC/B,OAAO;IACP;GACF,CAAC;EACH,EACF,CAAC;EACD;EACA;CACF;AACF"}

package/dist/index.d.cts

@@ -1,19 +1,20 @@
-import { AnyObject } from '@bento/types';
-import { Ref } from 'react';
+import { AnyObject } from "@bento/types";
+import { Ref } from "react";
 
+//#region src/index.d.ts
 interface RenderPropData {
-    /**
-     * If the component is assigning a default value to the given prop,
-     * the original value be a reference to the previous assigned value.
-     * @default The original assigned value
-     */
-    original?: unknown;
-    /** All the props that were passed to the component. @default {} */
-    props: AnyObject;
-    /** If slots are used to modify the component, this will contain a reference to the original slots object. @default {} */
-    slots: AnyObject;
-    /** The exposed state of the component. @default {} */
-    state: AnyObject;
+  /**
+   * If the component is assigning a default value to the given prop,
+   * the original value be a reference to the previous assigned value.
+   * @default The original assigned value
+   */
+  original?: unknown;
+  /** All the props that were passed to the component. @default {} */
+  props: AnyObject;
+  /** If slots are used to modify the component, this will contain a reference to the original slots object. @default {} */
+  slots: AnyObject;
+  /** The exposed state of the component. @default {} */
+  state: AnyObject;
 }
 /**
  * Checks if the given string is an event listener name. An event listener name
@@ -58,28 +59,28 @@ declare function execute(name: string, data: AnyObject, args: RenderPropData): a
  */
 declare function renderProp(name: string, args: RenderPropData): any;
 interface Returns {
-    /**
-     * Proxy object that have access to the original props, slotted values, and internal props. When
-     * accessing a property, it will first check the slotted values, then the original props, and finally
-     * the internal props. If the property is a render prop, it will execute the function with the provided
-     * arguments.
-     *
-     * @default { ...props, ...slots }
-     */
-    props: AnyObject;
-    /**
-     * Applies the given attributes as default values to the props. If no attributes are provided, it will
-     * use the props as default values. The resulting object will contain all the properties of the props,
-     * except for the ones specified in the `except` array. The values of the properties will be the result
-     * of executing the render prop function with the provided arguments.
-     *
-     * @default function(attr)
-     */
-    apply: (attributes?: object, except?: string[]) => object;
-    /**
-     * The merged ref combining forwarded refs with any ref supplied via slots.
-     */
-    ref?: Ref<any>;
+  /**
+   * Proxy object that have access to the original props, slotted values, and internal props. When
+   * accessing a property, it will first check the slotted values, then the original props, and finally
+   * the internal props. If the property is a render prop, it will execute the function with the provided
+   * arguments.
+   *
+   * @default { ...props, ...slots }
+   */
+  props: AnyObject;
+  /**
+   * Applies the given attributes as default values to the props. If no attributes are provided, it will
+   * use the props as default values. The resulting object will contain all the properties of the props,
+   * except for the ones specified in the `except` array. The values of the properties will be the result
+   * of executing the render prop function with the provided arguments.
+   *
+   * @default function(attr)
+   */
+  apply: (attributes?: object, except?: string[]) => object;
+  /**
+   * The merged ref combining forwarded refs with any ref supplied via slots.
+   */
+  ref?: Ref<any>;
 }
 /**
  * Hook that merges props with slotted props and provides a proxy for accessing them.
@@ -103,5 +104,6 @@ interface Returns {
  * }
  */
 declare function useProps(...rest: any[]): Returns;
-
-export { type RenderPropData, type Returns, execute, isEventListener, isRenderProp, renderProp, useProps };
+//#endregion
+export { RenderPropData, Returns, execute, isEventListener, isRenderProp, renderProp, useProps };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":";;;;UAOiB,cAAA;;AAAjB;;;;EAME,QAAA;EASO;EANP,KAAA,EAAO,SAAA;EAMS;EAHhB,KAAA,EAAO,SAAA;EAHP;EAMA,KAAA,EAAO,SAAA;AAAA;;;;;AAAS;AAWlB;;;iBAAgB,eAAA,CAAgB,IAAY;AAAA;AAe5C;;;;AAAqD;AAarD;;;;;AA5B4C,iBAe5B,YAAA,CAAa,IAAA,UAAc,KAAU;;;;;AAasB;AAiB3E;;;;iBAjBgB,OAAA,CAAQ,IAAA,UAAc,IAAA,EAAM,SAAA,EAAW,IAAA,EAAM,cAAc;;;;AAiBd;AAsB7D;;;;;;iBAtBgB,UAAA,CAAW,IAAA,UAAc,IAAA,EAAM,cAAc;AAAA,UAsB5C,OAAA;EAkBc;;;;AAIpB;AAwBX;;;EArCE,KAAA,EAAO,SAAA;EAqCwC;;;;;;;;EA5B/C,KAAA,GAAQ,UAAA,WAAqB,MAAA;;;;EAI7B,GAAA,GAAM,GAAG;AAAA;;;;;;;;;;;;;;;;;;;;;;iBAwBK,QAAA,IAAY,IAAA,UAAc,OAAO"}

package/dist/{index.d.ts → index.d.mts}

@@ -1,19 +1,20 @@
-import { AnyObject } from '@bento/types';
-import { Ref } from 'react';
+import { Ref } from "react";
+import { AnyObject } from "@bento/types";
 
+//#region src/index.d.ts
 interface RenderPropData {
-    /**
-     * If the component is assigning a default value to the given prop,
-     * the original value be a reference to the previous assigned value.
-     * @default The original assigned value
-     */
-    original?: unknown;
-    /** All the props that were passed to the component. @default {} */
-    props: AnyObject;
-    /** If slots are used to modify the component, this will contain a reference to the original slots object. @default {} */
-    slots: AnyObject;
-    /** The exposed state of the component. @default {} */
-    state: AnyObject;
+  /**
+   * If the component is assigning a default value to the given prop,
+   * the original value be a reference to the previous assigned value.
+   * @default The original assigned value
+   */
+  original?: unknown;
+  /** All the props that were passed to the component. @default {} */
+  props: AnyObject;
+  /** If slots are used to modify the component, this will contain a reference to the original slots object. @default {} */
+  slots: AnyObject;
+  /** The exposed state of the component. @default {} */
+  state: AnyObject;
 }
 /**
  * Checks if the given string is an event listener name. An event listener name
@@ -58,28 +59,28 @@ declare function execute(name: string, data: AnyObject, args: RenderPropData): a
  */
 declare function renderProp(name: string, args: RenderPropData): any;
 interface Returns {
-    /**
-     * Proxy object that have access to the original props, slotted values, and internal props. When
-     * accessing a property, it will first check the slotted values, then the original props, and finally
-     * the internal props. If the property is a render prop, it will execute the function with the provided
-     * arguments.
-     *
-     * @default { ...props, ...slots }
-     */
-    props: AnyObject;
-    /**
-     * Applies the given attributes as default values to the props. If no attributes are provided, it will
-     * use the props as default values. The resulting object will contain all the properties of the props,
-     * except for the ones specified in the `except` array. The values of the properties will be the result
-     * of executing the render prop function with the provided arguments.
-     *
-     * @default function(attr)
-     */
-    apply: (attributes?: object, except?: string[]) => object;
-    /**
-     * The merged ref combining forwarded refs with any ref supplied via slots.
-     */
-    ref?: Ref<any>;
+  /**
+   * Proxy object that have access to the original props, slotted values, and internal props. When
+   * accessing a property, it will first check the slotted values, then the original props, and finally
+   * the internal props. If the property is a render prop, it will execute the function with the provided
+   * arguments.
+   *
+   * @default { ...props, ...slots }
+   */
+  props: AnyObject;
+  /**
+   * Applies the given attributes as default values to the props. If no attributes are provided, it will
+   * use the props as default values. The resulting object will contain all the properties of the props,
+   * except for the ones specified in the `except` array. The values of the properties will be the result
+   * of executing the render prop function with the provided arguments.
+   *
+   * @default function(attr)
+   */
+  apply: (attributes?: object, except?: string[]) => object;
+  /**
+   * The merged ref combining forwarded refs with any ref supplied via slots.
+   */
+  ref?: Ref<any>;
 }
 /**
  * Hook that merges props with slotted props and provides a proxy for accessing them.
@@ -103,5 +104,6 @@ interface Returns {
  * }
  */
 declare function useProps(...rest: any[]): Returns;
-
-export { type RenderPropData, type Returns, execute, isEventListener, isRenderProp, renderProp, useProps };
+//#endregion
+export { RenderPropData, Returns, execute, isEventListener, isRenderProp, renderProp, useProps };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;UAOiB,cAAA;;AAAjB;;;;EAME,QAAA;EASO;EANP,KAAA,EAAO,SAAA;EAMS;EAHhB,KAAA,EAAO,SAAA;EAHP;EAMA,KAAA,EAAO,SAAA;AAAA;;;;;AAAS;AAWlB;;;iBAAgB,eAAA,CAAgB,IAAY;AAAA;AAe5C;;;;AAAqD;AAarD;;;;;AA5B4C,iBAe5B,YAAA,CAAa,IAAA,UAAc,KAAU;;;;;AAasB;AAiB3E;;;;iBAjBgB,OAAA,CAAQ,IAAA,UAAc,IAAA,EAAM,SAAA,EAAW,IAAA,EAAM,cAAc;;;;AAiBd;AAsB7D;;;;;;iBAtBgB,UAAA,CAAW,IAAA,UAAc,IAAA,EAAM,cAAc;AAAA,UAsB5C,OAAA;EAkBc;;;;AAIpB;AAwBX;;;EArCE,KAAA,EAAO,SAAA;EAqCwC;;;;;;;;EA5B/C,KAAA,GAAQ,UAAA,WAAqB,MAAA;;;;EAI7B,GAAA,GAAM,GAAG;AAAA;;;;;;;;;;;;;;;;;;;;;;iBAwBK,QAAA,IAAY,IAAA,UAAc,OAAO"}

package/dist/index.mjs

@@ -0,0 +1,170 @@
+import { Box } from "@bento/box";
+import { useInternalProps } from "@bento/internal-props";
+import { mergeRefs } from "@react-aria/utils";
+import { useContext } from "react";
+//#region src/index.ts
+/**
+* Checks if the given string is an event listener name. An event listener name
+* is defined as a string that starts with "on" followed by an uppercase letter.
+*
+* @param name - The string to check.
+* @returns `true` if the string is an event listener name, otherwise `false`.
+* @private
+*/
+function isEventListener(name) {
+	return /^on[A-Z]/.test(name);
+}
+/**
+* Determines if a given value is a render prop.
+*
+* A render prop is a function that is used to dynamically generate
+* UI elements. This function checks if the provided value is a function
+* and not an event listener.
+*
+* @param name - The name of the prop.
+* @param value - The value of the prop to check.
+* @returns `true` if the value is a render prop, otherwise `false`.
+*/
+function isRenderProp(name, value) {
+	return typeof value === "function" && !isEventListener(name);
+}
+/**
+* Executes a function or returns a value from the given data object.
+*
+* @param name - The name of the property to execute or retrieve.
+* @param data - The data object containing the property.
+* @param args - The arguments to pass if the property is a function.
+* @returns The result of the function execution or the value of the property.
+* @private
+*/
+function execute(name, data, args) {
+	const value = data[name];
+	if (isRenderProp(name, value)) return value(args);
+	return value;
+}
+/**
+* Retrieves a property value, potentially overridden by a slotted value.
+*
+* @param name - The name of the property to retrieve.
+* @param options.props - The original properties.
+* @param options.slots - The slotted values that can override the original properties.
+* @param options.state - The current state.
+* @param options.original - The original value of the property.
+* @returns The original property value or the overridden value if provided.
+*/
+function renderProp(name, args) {
+	const { props, slots, original } = args;
+	return execute(name, slots, args) || execute(name, props, args) || original;
+}
+/**
+* Merges multiple refs into a single ref callback.
+*
+* @param refs - Array of refs to merge (can include undefined/null).
+* @returns A single merged ref, undefined if no refs provided.
+* @private
+*/
+function mergeRefList(refs) {
+	const filtered = refs.filter((ref) => ref != null);
+	if (!filtered.length) return void 0;
+	if (filtered.length === 1) return filtered[0];
+	return mergeRefs(...filtered);
+}
+/**
+* Hook that merges props with slotted props and provides a proxy for accessing them.
+*
+* @param args - The initial props to use, or array when using rest parameters.
+* @param state - The state object to use.
+* @param forwardedRef - The ref forwarded to the component.
+* @returns An object containing the proxy based props object and the apply function.
+* @throws {BentoError} If the hook is used outside of a @bento/slots component.
+*
+* @example
+* const { props, apply, ref } = useProps({ foo: 'bar' }, {}, forwardedRef);
+* if (props.a) doSomething()
+* return <a {...apply({ className: 'foo' }, ['ref']) } ref={ref}>{ props.children }</a>;
+*
+* @example
+* // With rest parameters
+* function Component(...rest) {
+*   const { props, apply, ref } = useProps(rest);
+*   return <div {...apply()} />;
+* }
+*/
+function useProps(...rest) {
+	let forwardedRef;
+	let args;
+	let state;
+	if (Array.isArray(rest[0])) {
+		[args, forwardedRef] = rest[0];
+		state = rest[1];
+	} else [args, state, forwardedRef] = rest;
+	const { slots } = useContext(Box);
+	const [props, internal] = useInternalProps(args);
+	const { namespace, assigned } = slots;
+	const slotted = assigned[namespace.join(".")] || {};
+	const ref = mergeRefList([
+		props?.ref,
+		slotted?.ref,
+		forwardedRef
+	]);
+	const slotNoRef = { ...slotted };
+	const propsNoRef = { ...props };
+	delete slotNoRef.ref;
+	delete propsNoRef.ref;
+	const propsy = {
+		...internal,
+		...propsNoRef,
+		...slotNoRef
+	};
+	/**
+	* Applies the given attributes to an object.
+	*
+	* @param attributes - The attributes to apply. If not provided, defaults to `propsy`.
+	* @param except - An array of keys to exclude from the resulting object.
+	* @returns The resulting object with applied attributes.
+	* @public
+	*/
+	function apply(attributes, except) {
+		const data = attributes || propsy;
+		const returned = {};
+		function reduce(memo, key) {
+			if (except && except.includes(key)) return memo;
+			memo[key] = renderProp(key, {
+				props: {
+					...props,
+					...internal
+				},
+				original: data[key],
+				slots: slotted,
+				state
+			});
+			return memo;
+		}
+		let result;
+		if (!attributes) result = Object.keys(propsy).reduce(reduce, returned);
+		else result = Object.keys(propsy).reduce(reduce, Object.keys(attributes).reduce(reduce, returned));
+		if (except && except.includes("ref")) return result;
+		if (ref) result.ref = ref;
+		return result;
+	}
+	return {
+		props: new Proxy(propsy, { get: function getter(_, name) {
+			if (name === "ref") return ref;
+			return renderProp(name, {
+				original: isRenderProp(name, props[name]) ? void 0 : props[name],
+				props: {
+					...props,
+					...internal
+				},
+				slots: slotted,
+				state
+			});
+		} }),
+		apply,
+		ref
+	};
+}
+//#endregion
+export { execute, isEventListener, isRenderProp, renderProp, useProps };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { Box, type BoxContext } from '@bento/box';\nimport { useInternalProps } from '@bento/internal-props';\nimport { AnyObject } from '@bento/types';\nimport { mergeRefs } from '@react-aria/utils';\nimport { useContext } from 'react';\nimport type { ForwardedRef, Ref } from 'react';\n\nexport interface RenderPropData {\n  /**\n   * If the component is assigning a default value to the given prop,\n   * the original value be a reference to the previous assigned value.\n   * @default The original assigned value\n   */\n  original?: unknown;\n\n  /** All the props that were passed to the component. @default {} */\n  props: AnyObject;\n\n  /** If slots are used to modify the component, this will contain a reference to the original slots object. @default {} */\n  slots: AnyObject;\n\n  /** The exposed state of the component. @default {} */\n  state: AnyObject;\n}\n\n/**\n * Checks if the given string is an event listener name. An event listener name\n * is defined as a string that starts with \"on\" followed by an uppercase letter.\n *\n * @param name - The string to check.\n * @returns `true` if the string is an event listener name, otherwise `false`.\n * @private\n */\nexport function isEventListener(name: string): boolean {\n  return /^on[A-Z]/.test(name);\n}\n\n/**\n * Determines if a given value is a render prop.\n *\n * A render prop is a function that is used to dynamically generate\n * UI elements. This function checks if the provided value is a function\n * and not an event listener.\n *\n * @param name - The name of the prop.\n * @param value - The value of the prop to check.\n * @returns `true` if the value is a render prop, otherwise `false`.\n */\nexport function isRenderProp(name: string, value: any): boolean {\n  return typeof value === 'function' && !isEventListener(name);\n}\n\n/**\n * Executes a function or returns a value from the given data object.\n *\n * @param name - The name of the property to execute or retrieve.\n * @param data - The data object containing the property.\n * @param args - The arguments to pass if the property is a function.\n * @returns The result of the function execution or the value of the property.\n * @private\n */\nexport function execute(name: string, data: AnyObject, args: RenderPropData): any {\n  const value = data[name];\n\n  if (isRenderProp(name, value)) return value(args);\n  return value;\n}\n\n/**\n * Retrieves a property value, potentially overridden by a slotted value.\n *\n * @param name - The name of the property to retrieve.\n * @param options.props - The original properties.\n * @param options.slots - The slotted values that can override the original properties.\n * @param options.state - The current state.\n * @param options.original - The original value of the property.\n * @returns The original property value or the overridden value if provided.\n */\nexport function renderProp(name: string, args: RenderPropData): any {\n  const { props, slots, original } = args;\n\n  return execute(name, slots, args) || execute(name, props, args) || original;\n}\n\n/**\n * Merges multiple refs into a single ref callback.\n *\n * @param refs - Array of refs to merge (can include undefined/null).\n * @returns A single merged ref, undefined if no refs provided.\n * @private\n */\nfunction mergeRefList(refs: Array<ForwardedRef<any> | Ref<any> | undefined>): Ref<any> | undefined {\n  const filtered = refs.filter((ref): ref is ForwardedRef<any> | Ref<any> => ref != null);\n\n  if (!filtered.length) return undefined;\n  if (filtered.length === 1) return filtered[0] as Ref<any>;\n\n  return mergeRefs(...(filtered as Array<Ref<any>>)) as Ref<any>;\n}\n\nexport interface Returns {\n  /**\n   * Proxy object that have access to the original props, slotted values, and internal props. When\n   * accessing a property, it will first check the slotted values, then the original props, and finally\n   * the internal props. If the property is a render prop, it will execute the function with the provided\n   * arguments.\n   *\n   * @default { ...props, ...slots }\n   */\n  props: AnyObject;\n  /**\n   * Applies the given attributes as default values to the props. If no attributes are provided, it will\n   * use the props as default values. The resulting object will contain all the properties of the props,\n   * except for the ones specified in the `except` array. The values of the properties will be the result\n   * of executing the render prop function with the provided arguments.\n   *\n   * @default function(attr)\n   */\n  apply: (attributes?: object, except?: string[]) => object;\n  /**\n   * The merged ref combining forwarded refs with any ref supplied via slots.\n   */\n  ref?: Ref<any>;\n}\n\n/**\n * Hook that merges props with slotted props and provides a proxy for accessing them.\n *\n * @param args - The initial props to use, or array when using rest parameters.\n * @param state - The state object to use.\n * @param forwardedRef - The ref forwarded to the component.\n * @returns An object containing the proxy based props object and the apply function.\n * @throws {BentoError} If the hook is used outside of a @bento/slots component.\n *\n * @example\n * const { props, apply, ref } = useProps({ foo: 'bar' }, {}, forwardedRef);\n * if (props.a) doSomething()\n * return <a {...apply({ className: 'foo' }, ['ref']) } ref={ref}>{ props.children }</a>;\n *\n * @example\n * // With rest parameters\n * function Component(...rest) {\n *   const { props, apply, ref } = useProps(rest);\n *   return <div {...apply()} />;\n * }\n */\nexport function useProps(...rest: any[]): Returns {\n  let forwardedRef: ForwardedRef<any> | undefined;\n  let args: AnyObject;\n  let state: object;\n\n  if (Array.isArray(rest[0])) {\n    [args, forwardedRef] = rest[0];\n    state = rest[1];\n  } else {\n    [args, state, forwardedRef] = rest;\n  }\n\n  const { slots } = useContext<BoxContext<AnyObject>>(Box);\n  const [props, internal] = useInternalProps(args);\n  const { namespace, assigned } = slots;\n  const dot = namespace.join('.');\n  const slotted = assigned[dot] || {};\n\n  const ref = mergeRefList([\n    (props as AnyObject)?.ref as ForwardedRef<any> | Ref<any> | undefined,\n    (slotted as AnyObject)?.ref as ForwardedRef<any> | Ref<any> | undefined,\n    forwardedRef\n  ]);\n\n  const slotNoRef = { ...slotted } as AnyObject;\n  const propsNoRef = { ...props } as AnyObject;\n\n  delete slotNoRef.ref;\n  delete propsNoRef.ref;\n\n  const propsy: AnyObject = { ...internal, ...propsNoRef, ...slotNoRef };\n\n  /**\n   * Applies the given attributes to an object.\n   *\n   * @param attributes - The attributes to apply. If not provided, defaults to `propsy`.\n   * @param except - An array of keys to exclude from the resulting object.\n   * @returns The resulting object with applied attributes.\n   * @public\n   */\n  function apply(attributes?: object, except?: string[]): object {\n    const data = (attributes || propsy) as AnyObject;\n    const returned: AnyObject = {};\n\n    function reduce(memo: AnyObject, key: string) {\n      if (except && except.includes(key)) return memo;\n\n      memo[key] = renderProp(key, {\n        props: { ...props, ...internal },\n        original: data[key],\n        slots: slotted,\n        state\n      });\n\n      return memo;\n    }\n\n    let result: AnyObject;\n\n    if (!attributes) result = Object.keys(propsy).reduce(reduce, returned);\n    else result = Object.keys(propsy).reduce(reduce, Object.keys(attributes).reduce(reduce, returned));\n\n    // Always include the merged ref unless specifically excluded\n    if (except && except.includes('ref')) return result;\n    if (ref) result.ref = ref;\n\n    return result;\n  }\n\n  return {\n    props: new Proxy(propsy, {\n      get: function getter(_: object, name: string) {\n        if (name === 'ref') return ref;\n\n        return renderProp(name, {\n          original: isRenderProp(name, props[name]) ? undefined : props[name],\n          props: { ...props, ...internal },\n          slots: slotted,\n          state\n        });\n      }\n    }),\n    apply,\n    ref\n  };\n}\n"],"mappings":";;;;;;;;;;;;;AAiCA,SAAgB,gBAAgB,MAAuB;CACrD,OAAO,WAAW,KAAK,IAAI;AAC7B;;;;;;;;;;;;AAaA,SAAgB,aAAa,MAAc,OAAqB;CAC9D,OAAO,OAAO,UAAU,cAAc,CAAC,gBAAgB,IAAI;AAC7D;;;;;;;;;;AAWA,SAAgB,QAAQ,MAAc,MAAiB,MAA2B;CAChF,MAAM,QAAQ,KAAK;CAEnB,IAAI,aAAa,MAAM,KAAK,GAAG,OAAO,MAAM,IAAI;CAChD,OAAO;AACT;;;;;;;;;;;AAYA,SAAgB,WAAW,MAAc,MAA2B;CAClE,MAAM,EAAE,OAAO,OAAO,aAAa;CAEnC,OAAO,QAAQ,MAAM,OAAO,IAAI,KAAK,QAAQ,MAAM,OAAO,IAAI,KAAK;AACrE;;;;;;;;AASA,SAAS,aAAa,MAA6E;CACjG,MAAM,WAAW,KAAK,QAAQ,QAA6C,OAAO,IAAI;CAEtF,IAAI,CAAC,SAAS,QAAQ,OAAO,KAAA;CAC7B,IAAI,SAAS,WAAW,GAAG,OAAO,SAAS;CAE3C,OAAO,UAAU,GAAI,QAA4B;AACnD;;;;;;;;;;;;;;;;;;;;;;AAgDA,SAAgB,SAAS,GAAG,MAAsB;CAChD,IAAI;CACJ,IAAI;CACJ,IAAI;CAEJ,IAAI,MAAM,QAAQ,KAAK,EAAE,GAAG;EAC1B,CAAC,MAAM,gBAAgB,KAAK;EAC5B,QAAQ,KAAK;CACf,OACE,CAAC,MAAM,OAAO,gBAAgB;CAGhC,MAAM,EAAE,UAAU,WAAkC,GAAG;CACvD,MAAM,CAAC,OAAO,YAAY,iBAAiB,IAAI;CAC/C,MAAM,EAAE,WAAW,aAAa;CAEhC,MAAM,UAAU,SADJ,UAAU,KAAK,GACA,MAAM,CAAC;CAElC,MAAM,MAAM,aAAa;EACtB,OAAqB;EACrB,SAAuB;EACxB;CACF,CAAC;CAED,MAAM,YAAY,EAAE,GAAG,QAAQ;CAC/B,MAAM,aAAa,EAAE,GAAG,MAAM;CAE9B,OAAO,UAAU;CACjB,OAAO,WAAW;CAElB,MAAM,SAAoB;EAAE,GAAG;EAAU,GAAG;EAAY,GAAG;CAAU;;;;;;;;;CAUrE,SAAS,MAAM,YAAqB,QAA2B;EAC7D,MAAM,OAAQ,cAAc;EAC5B,MAAM,WAAsB,CAAC;EAE7B,SAAS,OAAO,MAAiB,KAAa;GAC5C,IAAI,UAAU,OAAO,SAAS,GAAG,GAAG,OAAO;GAE3C,KAAK,OAAO,WAAW,KAAK;IAC1B,OAAO;KAAE,GAAG;KAAO,GAAG;IAAS;IAC/B,UAAU,KAAK;IACf,OAAO;IACP;GACF,CAAC;GAED,OAAO;EACT;EAEA,IAAI;EAEJ,IAAI,CAAC,YAAY,SAAS,OAAO,KAAK,MAAM,EAAE,OAAO,QAAQ,QAAQ;OAChE,SAAS,OAAO,KAAK,MAAM,EAAE,OAAO,QAAQ,OAAO,KAAK,UAAU,EAAE,OAAO,QAAQ,QAAQ,CAAC;EAGjG,IAAI,UAAU,OAAO,SAAS,KAAK,GAAG,OAAO;EAC7C,IAAI,KAAK,OAAO,MAAM;EAEtB,OAAO;CACT;CAEA,OAAO;EACL,OAAO,IAAI,MAAM,QAAQ,EACvB,KAAK,SAAS,OAAO,GAAW,MAAc;GAC5C,IAAI,SAAS,OAAO,OAAO;GAE3B,OAAO,WAAW,MAAM;IACtB,UAAU,aAAa,MAAM,MAAM,KAAK,IAAI,KAAA,IAAY,MAAM;IAC9D,OAAO;KAAE,GAAG;KAAO,GAAG;IAAS;IAC/B,OAAO;IACP;GACF,CAAC;EACH,EACF,CAAC;EACD;EACA;CACF;AACF"}

package/package.json

@@ -1,23 +1,22 @@
 {
   "name": "@bento/use-props",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Context aware props transformation for Bento",
   "type": "module",
   "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
+  "module": "./dist/index.mjs",
   "scripts": {
-    "build": "tsup-node",
-    "dev": "tsup-node --watch",
-    "lint": "biome lint && tsc --noEmit",
-    "posttest": "npm run lint",
-    "prepublishOnly": "node ../../scripts/compile-readme.ts",
-    "pretest": "npm run build",
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "lint": "biome lint && tsgo --noEmit",
+    "prepublishOnly": "node ../../../scripts/compile-readme.ts",
     "test": "vitest --run",
-    "test:watch": "vitest"
+    "test:watch": "vitest",
+    "typecheck": "tsgo --noEmit -p tsconfig.json"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/godaddy/bento.git"
+    "url": "git+https://github.com/godaddy/antares.git"
   },
   "keywords": [
     "bento",
@@ -32,9 +31,9 @@
   "author": "GoDaddy Operating Company, LLC",
   "license": "MIT",
   "bugs": {
-    "url": "https://github.com/godaddy/bento/issues"
+    "url": "https://github.com/godaddy/antares/issues"
   },
-  "homepage": "https://github.com/godaddy/bento#readme",
+  "homepage": "https://github.com/godaddy/antares#readme",
   "files": [
     "dist",
     "src",
@@ -43,10 +42,16 @@
   "dependencies": {
     "@bento/box": "^0.2.0",
     "@bento/internal-props": "^0.1.1",
-    "@react-aria/utils": "^3.30.0"
+    "@bento/types": "^0.1.1",
+    "@react-aria/utils": "^3.34.0"
   },
   "devDependencies": {
-    "@bento/types": "^0.1.0"
+    "@types/react": "^19.2.15",
+    "@types/react-dom": "^19.2.3",
+    "tsdown": "^0.22.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.7",
+    "vitest-browser-react": "^2.2.0"
   },
   "peerDependencies": {
     "react": "18.x || 19.x",
@@ -55,8 +60,8 @@
   "exports": {
     ".": {
       "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
       },
       "require": {
         "types": "./dist/index.d.cts",

package/dist/index.js

@@ -1,92 +0,0 @@
-import { Box } from '@bento/box';
-import { useInternalProps } from '@bento/internal-props';
-import { mergeRefs } from '@react-aria/utils';
-import { useContext } from 'react';
-
-// src/index.ts
-function isEventListener(name) {
-  return /^on[A-Z]/.test(name);
-}
-function isRenderProp(name, value) {
-  return typeof value === "function" && !isEventListener(name);
-}
-function execute(name, data, args) {
-  const value = data[name];
-  if (isRenderProp(name, value)) return value(args);
-  return value;
-}
-function renderProp(name, args) {
-  const { props, slots, original } = args;
-  return execute(name, slots, args) || execute(name, props, args) || original;
-}
-function mergeRefList(refs) {
-  const filtered = refs.filter((ref) => ref != null);
-  if (!filtered.length) return void 0;
-  if (filtered.length === 1) return filtered[0];
-  return mergeRefs(...filtered);
-}
-function useProps(...rest) {
-  let forwardedRef;
-  let args;
-  let state;
-  if (Array.isArray(rest[0])) {
-    [args, forwardedRef] = rest[0];
-    state = rest[1];
-  } else {
-    [args, state, forwardedRef] = rest;
-  }
-  const { slots } = useContext(Box);
-  const [props, internal] = useInternalProps(args);
-  const { namespace, assigned } = slots;
-  const dot = namespace.join(".");
-  const slotted = assigned[dot] || {};
-  const ref = mergeRefList([
-    props?.ref,
-    slotted?.ref,
-    forwardedRef
-  ]);
-  const slotNoRef = { ...slotted };
-  const propsNoRef = { ...props };
-  delete slotNoRef.ref;
-  delete propsNoRef.ref;
-  const propsy = { ...internal, ...propsNoRef, ...slotNoRef };
-  function apply(attributes, except) {
-    const data = attributes || propsy;
-    const returned = {};
-    function reduce(memo, key) {
-      if (except && except.includes(key)) return memo;
-      memo[key] = renderProp(key, {
-        props: { ...props, ...internal },
-        original: data[key],
-        slots: slotted,
-        state
-      });
-      return memo;
-    }
-    let result;
-    if (!attributes) result = Object.keys(propsy).reduce(reduce, returned);
-    else result = Object.keys(propsy).reduce(reduce, Object.keys(attributes).reduce(reduce, returned));
-    if (except && except.includes("ref")) return result;
-    if (ref) result.ref = ref;
-    return result;
-  }
-  return {
-    props: new Proxy(propsy, {
-      get: function getter(_, name) {
-        if (name === "ref") return ref;
-        return renderProp(name, {
-          original: isRenderProp(name, props[name]) ? void 0 : props[name],
-          props: { ...props, ...internal },
-          slots: slotted,
-          state
-        });
-      }
-    }),
-    apply,
-    ref
-  };
-}
-
-export { execute, isEventListener, isRenderProp, renderProp, useProps };
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { Box, type BoxContext } from '@bento/box';\nimport { useInternalProps } from '@bento/internal-props';\nimport { AnyObject } from '@bento/types';\nimport { mergeRefs } from '@react-aria/utils';\nimport { useContext } from 'react';\nimport type { ForwardedRef, Ref } from 'react';\n\nexport interface RenderPropData {\n  /**\n   * If the component is assigning a default value to the given prop,\n   * the original value be a reference to the previous assigned value.\n   * @default The original assigned value\n   */\n  original?: unknown;\n\n  /** All the props that were passed to the component. @default {} */\n  props: AnyObject;\n\n  /** If slots are used to modify the component, this will contain a reference to the original slots object. @default {} */\n  slots: AnyObject;\n\n  /** The exposed state of the component. @default {} */\n  state: AnyObject;\n}\n\n/**\n * Checks if the given string is an event listener name. An event listener name\n * is defined as a string that starts with \"on\" followed by an uppercase letter.\n *\n * @param name - The string to check.\n * @returns `true` if the string is an event listener name, otherwise `false`.\n * @private\n */\nexport function isEventListener(name: string): boolean {\n  return /^on[A-Z]/.test(name);\n}\n\n/**\n * Determines if a given value is a render prop.\n *\n * A render prop is a function that is used to dynamically generate\n * UI elements. This function checks if the provided value is a function\n * and not an event listener.\n *\n * @param name - The name of the prop.\n * @param value - The value of the prop to check.\n * @returns `true` if the value is a render prop, otherwise `false`.\n */\nexport function isRenderProp(name: string, value: any): boolean {\n  return typeof value === 'function' && !isEventListener(name);\n}\n\n/**\n * Executes a function or returns a value from the given data object.\n *\n * @param name - The name of the property to execute or retrieve.\n * @param data - The data object containing the property.\n * @param args - The arguments to pass if the property is a function.\n * @returns The result of the function execution or the value of the property.\n * @private\n */\nexport function execute(name: string, data: AnyObject, args: RenderPropData): any {\n  const value = data[name];\n\n  if (isRenderProp(name, value)) return value(args);\n  return value;\n}\n\n/**\n * Retrieves a property value, potentially overridden by a slotted value.\n *\n * @param name - The name of the property to retrieve.\n * @param options.props - The original properties.\n * @param options.slots - The slotted values that can override the original properties.\n * @param options.state - The current state.\n * @param options.original - The original value of the property.\n * @returns The original property value or the overridden value if provided.\n */\nexport function renderProp(name: string, args: RenderPropData): any {\n  const { props, slots, original } = args;\n\n  return execute(name, slots, args) || execute(name, props, args) || original;\n}\n\n/**\n * Merges multiple refs into a single ref callback.\n *\n * @param refs - Array of refs to merge (can include undefined/null).\n * @returns A single merged ref, undefined if no refs provided.\n * @private\n */\nfunction mergeRefList(refs: Array<ForwardedRef<any> | Ref<any> | undefined>): Ref<any> | undefined {\n  const filtered = refs.filter((ref): ref is ForwardedRef<any> | Ref<any> => ref != null);\n\n  if (!filtered.length) return undefined;\n  if (filtered.length === 1) return filtered[0] as Ref<any>;\n\n  return mergeRefs(...(filtered as Array<Ref<any>>)) as Ref<any>;\n}\n\nexport interface Returns {\n  /**\n   * Proxy object that have access to the original props, slotted values, and internal props. When\n   * accessing a property, it will first check the slotted values, then the original props, and finally\n   * the internal props. If the property is a render prop, it will execute the function with the provided\n   * arguments.\n   *\n   * @default { ...props, ...slots }\n   */\n  props: AnyObject;\n  /**\n   * Applies the given attributes as default values to the props. If no attributes are provided, it will\n   * use the props as default values. The resulting object will contain all the properties of the props,\n   * except for the ones specified in the `except` array. The values of the properties will be the result\n   * of executing the render prop function with the provided arguments.\n   *\n   * @default function(attr)\n   */\n  apply: (attributes?: object, except?: string[]) => object;\n  /**\n   * The merged ref combining forwarded refs with any ref supplied via slots.\n   */\n  ref?: Ref<any>;\n}\n\n/**\n * Hook that merges props with slotted props and provides a proxy for accessing them.\n *\n * @param args - The initial props to use, or array when using rest parameters.\n * @param state - The state object to use.\n * @param forwardedRef - The ref forwarded to the component.\n * @returns An object containing the proxy based props object and the apply function.\n * @throws {BentoError} If the hook is used outside of a @bento/slots component.\n *\n * @example\n * const { props, apply, ref } = useProps({ foo: 'bar' }, {}, forwardedRef);\n * if (props.a) doSomething()\n * return <a {...apply({ className: 'foo' }, ['ref']) } ref={ref}>{ props.children }</a>;\n *\n * @example\n * // With rest parameters\n * function Component(...rest) {\n *   const { props, apply, ref } = useProps(rest);\n *   return <div {...apply()} />;\n * }\n */\nexport function useProps(...rest: any[]): Returns {\n  let forwardedRef: ForwardedRef<any> | undefined;\n  let args: AnyObject;\n  let state: object;\n\n  if (Array.isArray(rest[0])) {\n    [args, forwardedRef] = rest[0];\n    state = rest[1];\n  } else {\n    [args, state, forwardedRef] = rest;\n  }\n\n  const { slots } = useContext<BoxContext<AnyObject>>(Box);\n  const [props, internal] = useInternalProps(args);\n  const { namespace, assigned } = slots;\n  const dot = namespace.join('.');\n  const slotted = assigned[dot] || {};\n\n  const ref = mergeRefList([\n    (props as AnyObject)?.ref as ForwardedRef<any> | Ref<any> | undefined,\n    (slotted as AnyObject)?.ref as ForwardedRef<any> | Ref<any> | undefined,\n    forwardedRef\n  ]);\n\n  const slotNoRef = { ...slotted } as AnyObject;\n  const propsNoRef = { ...props } as AnyObject;\n\n  delete slotNoRef.ref;\n  delete propsNoRef.ref;\n\n  const propsy: AnyObject = { ...internal, ...propsNoRef, ...slotNoRef };\n\n  /**\n   * Applies the given attributes to an object.\n   *\n   * @param attributes - The attributes to apply. If not provided, defaults to `propsy`.\n   * @param except - An array of keys to exclude from the resulting object.\n   * @returns The resulting object with applied attributes.\n   * @public\n   */\n  function apply(attributes?: object, except?: string[]): object {\n    const data = (attributes || propsy) as AnyObject;\n    const returned: AnyObject = {};\n\n    function reduce(memo: AnyObject, key: string) {\n      if (except && except.includes(key)) return memo;\n\n      memo[key] = renderProp(key, {\n        props: { ...props, ...internal },\n        original: data[key],\n        slots: slotted,\n        state\n      });\n\n      return memo;\n    }\n\n    let result: AnyObject;\n\n    if (!attributes) result = Object.keys(propsy).reduce(reduce, returned);\n    else result = Object.keys(propsy).reduce(reduce, Object.keys(attributes).reduce(reduce, returned));\n\n    // Always include the merged ref unless specifically excluded\n    if (except && except.includes('ref')) return result;\n    if (ref) result.ref = ref;\n\n    return result;\n  }\n\n  return {\n    props: new Proxy(propsy, {\n      get: function getter(_: object, name: string) {\n        if (name === 'ref') return ref;\n\n        return renderProp(name, {\n          original: isRenderProp(name, props[name]) ? undefined : props[name],\n          props: { ...props, ...internal },\n          slots: slotted,\n          state\n        });\n      }\n    }),\n    apply,\n    ref\n  };\n}\n"]}