tssentials 1.0.9 → 1.1.0

package/dist/index.d.ts

@@ -1 +1,3 @@
-export { processIfPresent, ifPresent, apply, notEmpty, ifTruthy } from './util.js';
+export { processIfPresent, ifPresent, apply, notEmpty, ifTruthy, } from './util.js';
+export { useStoredData } from './use-stored-data/useStoredData.js';
+export { DataVersionContextProvider as StoredDataVersionContextProvider } from './use-stored-data/version/DataVersionContextProvider.js';

package/dist/index.js

@@ -1 +1,3 @@
-export { processIfPresent, ifPresent, apply, notEmpty, ifTruthy } from './util.js';
+export { processIfPresent, ifPresent, apply, notEmpty, ifTruthy, } from './util.js';
+export { useStoredData } from './use-stored-data/useStoredData.js';
+export { DataVersionContextProvider as StoredDataVersionContextProvider } from './use-stored-data/version/DataVersionContextProvider.js';

package/dist/use-stored-data/useStoredData.d.ts

@@ -0,0 +1,3 @@
+import { z } from "zod";
+import { Dispatch, SetStateAction } from "react";
+export declare const useStoredData: (key?: string) => <SCHEMA extends z.ZodType>(schema: SCHEMA, defaultValue: z.infer<SCHEMA>) => [z.infer<SCHEMA>, Dispatch<SetStateAction<z.infer<SCHEMA>>>, () => void];

package/dist/use-stored-data/useStoredData.js

@@ -0,0 +1,42 @@
+import { useEffect, useState } from "react";
+import { apply } from "../util.js";
+import { useDataVersionContext } from "./version/DataVersionContext.js";
+const isUpdater = (value) => typeof value === 'function';
+const load = (key, schema, defaultValue) => apply(localStorage.getItem(key), v => ({
+    obj: schema.parse(v !== null ? JSON.parse(v) : defaultValue),
+    raw: v !== null && v !== void 0 ? v : ''
+}));
+export const useStoredData = (key) => (schema, defaultValue) => {
+    var _a;
+    const [state, setState] = useState(key
+        ? load(key, schema, defaultValue)
+        : { obj: defaultValue, raw: '' });
+    const { state: versionContext, addVersion: addContextVersion } = useDataVersionContext();
+    const contextVersion = key ? (_a = versionContext[key]) !== null && _a !== void 0 ? _a : 0 : 0;
+    const [version, setVersion] = useState(contextVersion);
+    const addVersion = () => {
+        setVersion(v => v + 1);
+        if (key)
+            addContextVersion(key);
+    };
+    const loadVersion = () => {
+        if (key && contextVersion > version) {
+            setState(load(key, schema, defaultValue));
+            setVersion(contextVersion);
+        }
+    };
+    useEffect(() => {
+        if (key && state.raw !== localStorage.getItem(key)) {
+            localStorage.setItem(key, JSON.stringify(state.obj));
+            addVersion();
+        }
+    }, [state]);
+    useEffect(loadVersion, [key, contextVersion]);
+    return [
+        state.obj, // state
+        (a) => isUpdater(a) // setState
+            ? setState(s => ({ obj: a(s.obj), raw: '' }))
+            : setState(() => ({ obj: a, raw: '' })),
+        () => setState({ obj: defaultValue, raw: '' }), // reset
+    ];
+};

package/dist/use-stored-data/version/DataVersionContext.d.ts

@@ -0,0 +1,9 @@
+export type DataVersionContextType = Record<string, number>;
+export declare const DataVersionContext: import("react").Context<{
+    state: DataVersionContextType;
+    addVersion: (key: string) => void;
+}>;
+export declare const useDataVersionContext: () => {
+    state: DataVersionContextType;
+    addVersion: (key: string) => void;
+};

package/dist/use-stored-data/version/DataVersionContext.js

@@ -0,0 +1,11 @@
+import { createContext, useContext } from "react";
+export const DataVersionContext = createContext(undefined);
+export const useDataVersionContext = () => {
+    const context = useContext(DataVersionContext);
+    if (context) {
+        return context;
+    }
+    else {
+        throw new Error('DataVersionContext is missing');
+    }
+};

package/dist/use-stored-data/version/DataVersionContextProvider.d.ts

@@ -0,0 +1,4 @@
+import { ReactNode } from "react";
+export declare const DataVersionContextProvider: (props: {
+    children: ReactNode;
+}) => import("react/jsx-runtime").JSX.Element;

package/dist/use-stored-data/version/DataVersionContextProvider.js

@@ -0,0 +1,8 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useState } from "react";
+import { apply } from "tssentials";
+import { DataVersionContext } from "./DataVersionContext.js";
+export const DataVersionContextProvider = (props) => {
+    const [state, setState] = useState({});
+    return (_jsx(DataVersionContext.Provider, { value: { state, addVersion: (k) => setState(s => (Object.assign(Object.assign({}, s), { [k]: apply(s[k], v => v ? v + 1 : 1) }))) }, children: props.children }));
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tssentials",
-  "version": "1.0.9",
+  "version": "1.1.0",
   "description": "Essential functions and types for typescript projects.",
   "repository": {
     "type": "git",
@@ -15,7 +15,8 @@
   "exports": {
     ".": {
       "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
     },
     "./dist/style.css": "./dist/style.css"
   },
@@ -28,8 +29,16 @@
   "license": "MIT",
   "devDependencies": {
     "@eslint/js": "^9.23.0",
+    "@types/react": "^18.3.12",
+    "@types/react-dom": "^18.3.1",
     "eslint": "^9.23.0",
+    "eslint-plugin-react-hooks": "^7.0.1",
     "typescript": "^5.8.2",
     "typescript-eslint": "^8.28.0"
+  },
+  "peerDependencies": {
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "zod": "^4.3.5"
   }
 }