@css-hooks/core 1.4.0 → 1.4.2

package/README.md

@@ -51,6 +51,8 @@ Please visit [css-hooks.com](https://css-hooks.com) to get started.
 
 ## Packages
 
+- [@css-hooks/recommended](packages/recommended): Recommended hook configuration
+  with sensible defaults
 - [@css-hooks/react](packages/react): React framework integration
 - [@css-hooks/solid](packages/solid): Solid framework integration
 - [@css-hooks/preact](packages/preact): Preact framework integration

package/cjs/index.js

@@ -44,6 +44,7 @@ function hash(obj) {
 }
 function buildHooksSystem(stringify = genericStringify) {
     return function createHooks(config, options) {
+        const fallbackKeyword = (options === null || options === void 0 ? void 0 : options.fallback) || "unset";
         const stringifyImpl = (propertyName, value) => {
             return typeof value === "string" && value.startsWith("var(")
                 ? value
@@ -181,7 +182,7 @@ function buildHooksSystem(stringify = genericStringify) {
                         v = fallback(propertyName);
                     }
                     if (v === null) {
-                        v = "unset";
+                        v = fallbackKeyword;
                     }
                     return v;
                 });
@@ -190,7 +191,7 @@ function buildHooksSystem(stringify = genericStringify) {
                     if (v1 !== null) {
                         let v0 = fallback(propertyName);
                         if (v0 === null) {
-                            v0 = "unset";
+                            v0 = fallbackKeyword;
                         }
                         /* eslint-disable @typescript-eslint/no-unsafe-assignment,@typescript-eslint/no-explicit-any */
                         properties[propertyName] =

package/esm/index.js

@@ -40,6 +40,7 @@ function hash(obj) {
 }
 export function buildHooksSystem(stringify = genericStringify) {
     return function createHooks(config, options) {
+        const fallbackKeyword = (options === null || options === void 0 ? void 0 : options.fallback) || "unset";
         const stringifyImpl = (propertyName, value) => {
             return typeof value === "string" && value.startsWith("var(")
                 ? value
@@ -177,7 +178,7 @@ export function buildHooksSystem(stringify = genericStringify) {
                         v = fallback(propertyName);
                     }
                     if (v === null) {
-                        v = "unset";
+                        v = fallbackKeyword;
                     }
                     return v;
                 });
@@ -186,7 +187,7 @@ export function buildHooksSystem(stringify = genericStringify) {
                     if (v1 !== null) {
                         let v0 = fallback(propertyName);
                         if (v0 === null) {
-                            v0 = "unset";
+                            v0 = fallbackKeyword;
                         }
                         /* eslint-disable @typescript-eslint/no-unsafe-assignment,@typescript-eslint/no-explicit-any */
                         properties[propertyName] =

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@css-hooks/core",
   "description": "CSS Hooks core library",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "author": "Nick Saunders",
   "devDependencies": {
     "@tsconfig/strictest": "^2.0.1",

package/types/index.d.ts

@@ -10,13 +10,15 @@ type WithHooksImpl<Properties, HookProperties, HookPropertiesSub extends HookPro
 } : never>>;
 /** @internal */
 export declare function genericStringify(_: unknown, value: unknown): string | null;
-export declare function buildHooksSystem<Properties = Record<string, unknown>>(stringify?: (propertyName: keyof Properties, value: unknown) => string | null): <HookProperties extends string>(config: Record<HookProperties, HookSpec>, options?: {
+export declare function buildHooksSystem<Properties = Record<string, unknown>>(stringify?: (propertyName: keyof Properties, value: unknown) => string | null): <HookProperties extends string>(config: Record<HookProperties, HookSpec>, options?: (({
     debug?: boolean; /** @internal */
     hookNameToId?: undefined;
 } | {
     debug?: undefined;
     /** @internal */ hookNameToId?: (hookName: string) => string;
-} | undefined) => readonly [`*{${string}}undefined` | `*{${string}}${string}`, (properties: WithHooks<HookProperties, Properties>) => Properties];
+}) & {
+    fallback?: "unset" | "revert-layer";
+}) | undefined) => readonly [`*{${string}}undefined` | `*{${string}}${string}`, (properties: WithHooks<HookProperties, Properties>) => Properties];
 /**
  * A list of hooks offered as a "sensible default" to solve the most common use cases.
  *