@react-hive/honey-style 6.1.0 → 7.0.0

package/dist/index.dev.cjs

@@ -1116,14 +1116,40 @@ const createSpacingTransformer = ({ theme }) => {
 __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
 /* harmony export */   createCssRule: () => (/* binding */ createCssRule),
-/* harmony export */   css: () => (/* binding */ css)
+/* harmony export */   css: () => (/* binding */ css),
+/* harmony export */   isCssColorProperty: () => (/* binding */ isCssColorProperty),
+/* harmony export */   isCssSpacingProperty: () => (/* binding */ isCssSpacingProperty)
 /* harmony export */ });
 /* harmony import */ var _react_hive_honey_utils__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! @react-hive/honey-utils */ "./node_modules/.pnpm/@react-hive+honey-utils@4.0.0/node_modules/@react-hive/honey-utils/dist/index.mjs");
 /* harmony import */ var _constants__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ../constants */ "./src/constants.ts");
 /* harmony import */ var _utils__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ../utils */ "./src/utils.ts");
+/* harmony import */ var _constants__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ./constants */ "./src/css/constants.ts");
 
 
 
+
+/**
+ * Checks whether a CSS property is spacing-related.
+ *
+ * Spacing properties include margins, paddings, positional offsets,
+ * and layout gaps, such as `margin`, `paddingLeft`, `top`, and `gap`.
+ *
+ * @param propertyName - The CSS property name to check.
+ *
+ * @returns Returns true if the property is spacing-related.
+ */
+const isCssSpacingProperty = (propertyName) => _constants__WEBPACK_IMPORTED_MODULE_3__.CSS_SPACING_PROPERTIES.includes(propertyName);
+/**
+ * Checks whether a CSS property is color-related.
+ *
+ * Color properties include properties that directly define text, background,
+ * border, outline, decoration, shadow, or SVG colors.
+ *
+ * @param propertyName - The CSS property name to check.
+ *
+ * @returns Returns true if the property is color-related.
+ */
+const isCssColorProperty = (propertyName) => _constants__WEBPACK_IMPORTED_MODULE_3__.CSS_COLOR_PROPERTIES.includes(propertyName);
 const resolveCssInterpolation = (value, context) => {
     if (value === false || (0,_react_hive_honey_utils__WEBPACK_IMPORTED_MODULE_0__.isNilOrEmptyString)(value)) {
         return '';
@@ -1241,6 +1267,8 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   CSS_SPACING_PROPERTIES: () => (/* reexport safe */ _constants__WEBPACK_IMPORTED_MODULE_1__.CSS_SPACING_PROPERTIES),
 /* harmony export */   createCssRule: () => (/* reexport safe */ _css__WEBPACK_IMPORTED_MODULE_3__.createCssRule),
 /* harmony export */   css: () => (/* reexport safe */ _css__WEBPACK_IMPORTED_MODULE_3__.css),
+/* harmony export */   isCssColorProperty: () => (/* reexport safe */ _css__WEBPACK_IMPORTED_MODULE_3__.isCssColorProperty),
+/* harmony export */   isCssSpacingProperty: () => (/* reexport safe */ _css__WEBPACK_IMPORTED_MODULE_3__.isCssSpacingProperty),
 /* harmony export */   mediaQuery: () => (/* reexport safe */ _at_rules__WEBPACK_IMPORTED_MODULE_4__.mediaQuery),
 /* harmony export */   processCss: () => (/* reexport safe */ _process_css__WEBPACK_IMPORTED_MODULE_2__.processCss)
 /* harmony export */ });
@@ -1893,6 +1921,60 @@ __webpack_require__.r(__webpack_exports__);
 
 
 
+/**
+ * Creates a Honey-styled component from an HTML element or React component.
+ *
+ * The returned function accepts a tagged template literal with static CSS and dynamic
+ * interpolations. Interpolations receive the resolved styled context, including the
+ * current theme, default props, and props passed to the component.
+ *
+ * The generated component supports the polymorphic `as` prop, so the rendered element
+ * can be changed while preserving the native props of the selected element.
+ *
+ * Default props can be provided as either an object or a resolver function. Props passed
+ * directly to the rendered styled component override default props.
+ *
+ * @template TargetProps - The custom props available to style interpolations.
+ * @template Target - The base HTML element or React component used for rendering.
+ * @template OverrideTarget - The default polymorphic element used for public prop inference.
+ *
+ * @param target - The base HTML element or React component to style.
+ * @param defaultProps - Optional default props or a function that resolves default props from context.
+ * @param options - Optional styled component options.
+ *
+ * @returns A tagged template function that creates a styled component.
+ *
+ * @example
+ * ```tsx
+ * const Box = styled('div')`
+ *   color: red;
+ * `;
+ *
+ * <Box data-testid="box">Content</Box>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * const Button = styled<{ variant: 'primary' | 'secondary' }, 'button'>('button')`
+ *   ${({ variant }) => css`
+ *     color: ${variant === 'primary' ? 'white' : 'black'};
+ *   `}
+ * `;
+ *
+ * <Button variant="primary" type="button" />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * const LinkBox = styled('div')`
+ *   color: blue;
+ * `;
+ *
+ * <LinkBox as="a" href="https://example.com">
+ *   Link
+ * </LinkBox>
+ * ```
+ */
 const styled = (target, defaultProps, { omitProps } = {}) => {
     return (strings, ...interpolations) => {
         const componentId = (0,_utils__WEBPACK_IMPORTED_MODULE_4__.generateId)('hsc');
@@ -2438,6 +2520,8 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   css: () => (/* reexport safe */ _css__WEBPACK_IMPORTED_MODULE_5__.css),
 /* harmony export */   filterNonHtmlAttrs: () => (/* reexport safe */ _utils__WEBPACK_IMPORTED_MODULE_8__.filterNonHtmlAttrs),
 /* harmony export */   generateId: () => (/* reexport safe */ _utils__WEBPACK_IMPORTED_MODULE_8__.generateId),
+/* harmony export */   isCssColorProperty: () => (/* reexport safe */ _css__WEBPACK_IMPORTED_MODULE_5__.isCssColorProperty),
+/* harmony export */   isCssSpacingProperty: () => (/* reexport safe */ _css__WEBPACK_IMPORTED_MODULE_5__.isCssSpacingProperty),
 /* harmony export */   isStyledComponent: () => (/* reexport safe */ _utils__WEBPACK_IMPORTED_MODULE_8__.isStyledComponent),
 /* harmony export */   isThemeColorValue: () => (/* reexport safe */ _utils__WEBPACK_IMPORTED_MODULE_8__.isThemeColorValue),
 /* harmony export */   mediaQuery: () => (/* reexport safe */ _css__WEBPACK_IMPORTED_MODULE_5__.mediaQuery),