@leancodepl/utils 9.6.5 → 9.6.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leancodepl/utils",
-  "version": "9.6.5",
+  "version": "9.6.6",
   "license": "Apache-2.0",
   "publishConfig": {
     "access": "public",
@@ -10,7 +10,7 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@leancodepl/api-date": "9.6.5",
+    "@leancodepl/api-date": "9.6.6",
     "tiny-invariant": ">=1.3.1"
   },
   "peerDependencies": {

package/src/index.d.ts

@@ -1,17 +1,13 @@
 export * from "./lib/types";
+export * from "./lib/hooks";
 export * from "./lib/addPrefix";
-export * from "./lib/transformFirst";
-export * from "./lib/transformDeep";
 export * from "./lib/assertDefined";
-export * from "./lib/assertNotNull";
 export * from "./lib/assertNotEmpty";
+export * from "./lib/assertNotNull";
+export * from "./lib/downloadFile";
 export * from "./lib/ensureDefined";
-export * from "./lib/ensureNotNull";
 export * from "./lib/ensureNotEmpty";
-export * from "./lib/downloadFile";
-export * from "./lib/hooks/useRunInTask";
-export * from "./lib/hooks/useBoundRunInTask";
-export * from "./lib/hooks/useKeyByRoute";
-export * from "./lib/hooks/useSetUnset";
-export * from "./lib/hooks/useDialog";
-export * from "./lib/hooks/useSyncState";
+export * from "./lib/ensureNotNull";
+export * from "./lib/transformDeep";
+export * from "./lib/transformFirst";
+export * from "./lib/valueContext";

package/src/lib/hooks/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./useBoundRunInTask";
+export * from "./useDialog";
+export * from "./useKeyByRoute";
+export * from "./useRunInTask";
+export * from "./useSetUnset";
+export * from "./useSyncState";

package/src/lib/valueContext.d.ts

@@ -0,0 +1,52 @@
+import { Dispatch, ReactNode, SetStateAction } from "react";
+type ValueContextData<T> = [T | undefined, Dispatch<SetStateAction<T | undefined>>];
+type ProviderProps<T> = {
+    children?: ReactNode;
+    initialValue?: T;
+};
+/**
+ * Creates a React context hook for managing optional state values with Provider and setter utilities.
+ * Returns a hook with attached Provider component and set function for declarative value management.
+ *
+ * @returns Hook function with attached Provider component and set function
+ * @example
+ * ```typescript
+ * import { mkValueContext } from "@leancodepl/utils";
+ *
+ * const useTheme = mkValueContext<string>();
+ *
+ * function App() {
+ *   return (
+ *     <useTheme.Provider initialValue="dark">
+ *       <ThemeConsumer />
+ *     </useTheme.Provider>
+ *   );
+ * }
+ *
+ * function ThemeConsumer() {
+ *   const [theme] = useTheme();
+ *   return <div>Current theme: {theme}</div>;
+ * }
+ * ```
+ * @example
+ * ```typescript
+ * // Using set to declaratively set context value
+ * const useActiveUser = mkValueContext<string>();
+ *
+ * function UserProfile({ userId }: { userId: string }) {
+ *   useActiveUser.set(userId); // Sets value on mount, clears on unmount
+ *   return <div>Profile content</div>;
+ * }
+ *
+ * function UserBadge() {
+ *   const [activeUserId] = useActiveUser();
+ *   return <div>Active user: {activeUserId}</div>;
+ * }
+ * ```
+ */
+export declare function mkValueContext<T>(): {
+    (): ValueContextData<T>;
+    Provider({ children, initialValue }: ProviderProps<T>): import("react/jsx-runtime").JSX.Element;
+    set(value: T | undefined): void;
+};
+export {};