@css-hooks/core 4.0.0-next.24 → 4.0.0-next.26

package/README.md

@@ -1,16 +1,16 @@
 <div align="center">
-  <a id="logomark" href="https://next.css-hooks.com"><img alt="CSS Hooks" src="https://github.com/css-hooks/css-hooks/raw/v4.0.0-next.24/.github/logomark.svg" height="128" /></a><br/><br/>
+  <a id="logomark" href="https://next.css-hooks.com"><img alt="CSS Hooks" src="https://github.com/css-hooks/css-hooks/raw/v4.0.0-next.26/.github/logomark.svg" height="128" /></a><br/><br/>
   <div id="wordmark">
-    <a href="https://next.css-hooks.com"><img alt="CSS Hooks" src="https://github.com/css-hooks/css-hooks/raw/v4.0.0-next.24/.github/wordmark-dark.svg" width="256"></a>
+    <a href="https://next.css-hooks.com"><img alt="CSS Hooks" src="https://github.com/css-hooks/css-hooks/raw/v4.0.0-next.26/.github/wordmark-dark.svg" width="256"></a>
   </div>
 </div>
 
 <br/>
 
 <div align="center" id="badges">
-  <a href="https://github.com/css-hooks/css-hooks/tree/v4.0.0-next.24"><img src="https://img.shields.io/badge/tag-v4.0.0--next.24-ffd700" alt="tag v4.0.0-next.24"></a>
-  <a href="https://www.npmjs.com/package/@css-hooks/core/v/4.0.0-next.24"><img src="https://img.shields.io/badge/npm-v4.0.0--next.24-ffd700" alt="npm version"></a>
-  <a href="https://github.com/css-hooks/css-hooks/blob/v4.0.0-next.24/LICENSE"><img src="https://img.shields.io/badge/license-MIT-ffd700" alt="license"></a>
+  <a href="https://github.com/css-hooks/css-hooks/tree/v4.0.0-next.26"><img src="https://img.shields.io/badge/tag-v4.0.0--next.26-ffd700" alt="tag v4.0.0-next.26"></a>
+  <a href="https://www.npmjs.com/package/@css-hooks/core/v/4.0.0-next.26"><img src="https://img.shields.io/badge/npm-v4.0.0--next.26-ffd700" alt="npm version"></a>
+  <a href="https://github.com/css-hooks/css-hooks/blob/v4.0.0-next.26/LICENSE"><img src="https://img.shields.io/badge/license-MIT-ffd700" alt="license"></a>
 </div>
 
 ---

package/cjs/index.js

@@ -5,7 +5,37 @@
  * @packageDocumentation
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeStyles = mergeStyles;
 exports.buildHooksSystem = buildHooksSystem;
+/**
+ * Merges an override style prop into a base style.
+ *
+ * @remarks
+ * Override properties are moved to the end of the resulting object so their
+ * declaration order takes precedence over properties in the base style.
+ *
+ * @typeParam OverrideStyle - The type of the override style prop
+ *
+ * @param overrideStyle - The style whose properties should take precedence
+ *
+ * @returns A curried function that merges `overrideStyle` with a base style
+ *
+ * @public
+ */
+function mergeStyles(overrideStyle) {
+    return (style) => {
+        if (!overrideStyle) {
+            return style;
+        }
+        const result = { ...style };
+        for (const property of Reflect.ownKeys(overrideStyle)) {
+            if (Object.prototype.propertyIsEnumerable.call(overrideStyle, property)) {
+                Reflect.deleteProperty(result, property);
+            }
+        }
+        return Object.assign(result, overrideStyle);
+    };
+}
 /**
  * Creates a flavor of CSS Hooks tailored to a specific app framework.
  *

package/esm/index.js

@@ -3,6 +3,35 @@
  *
  * @packageDocumentation
  */
+/**
+ * Merges an override style prop into a base style.
+ *
+ * @remarks
+ * Override properties are moved to the end of the resulting object so their
+ * declaration order takes precedence over properties in the base style.
+ *
+ * @typeParam OverrideStyle - The type of the override style prop
+ *
+ * @param overrideStyle - The style whose properties should take precedence
+ *
+ * @returns A curried function that merges `overrideStyle` with a base style
+ *
+ * @public
+ */
+export function mergeStyles(overrideStyle) {
+    return (style) => {
+        if (!overrideStyle) {
+            return style;
+        }
+        const result = { ...style };
+        for (const property of Reflect.ownKeys(overrideStyle)) {
+            if (Object.prototype.propertyIsEnumerable.call(overrideStyle, property)) {
+                Reflect.deleteProperty(result, property);
+            }
+        }
+        return Object.assign(result, overrideStyle);
+    };
+}
 /**
  * Creates a flavor of CSS Hooks tailored to a specific app framework.
  *

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@css-hooks/core",
   "description": "CSS Hooks core library",
-  "version": "4.0.0-next.24",
+  "version": "4.0.0-next.26",
   "author": "Nick Saunders",
   "devDependencies": {
     "color": "^5.0.3",

package/types/index.d.ts

@@ -144,6 +144,22 @@ export interface CreateHooksResult<S, CSSProperties, CSSPropertyConflicts extend
  * @public
  */
 export type CreateHooksFn<CSSProperties, CSSPropertyConflicts extends object = object> = <S extends Selector>(...selectors: S[]) => CreateHooksResult<S, CSSProperties, CSSPropertyConflicts>;
+/**
+ * Merges an override style prop into a base style.
+ *
+ * @remarks
+ * Override properties are moved to the end of the resulting object so their
+ * declaration order takes precedence over properties in the base style.
+ *
+ * @typeParam OverrideStyle - The type of the override style prop
+ *
+ * @param overrideStyle - The style whose properties should take precedence
+ *
+ * @returns A curried function that merges `overrideStyle` with a base style
+ *
+ * @public
+ */
+export declare function mergeStyles<const OverrideStyle extends object>(overrideStyle: OverrideStyle | null | undefined): <Style extends object>(style: Style) => Omit<Style, keyof OverrideStyle> & OverrideStyle;
 /**
  * Creates a flavor of CSS Hooks tailored to a specific app framework.
  *