tssentials 1.1.0 → 1.3.0

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 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';
+export { DataVersionContextProvider as StoredDataVersionContextProvider } from './use-stored-data/use-version/DataVersionContextProvider.js';

package/dist/index.js

@@ -1,3 +1,3 @@
 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';
+export { DataVersionContextProvider as StoredDataVersionContextProvider } from './use-stored-data/use-version/DataVersionContextProvider.js';

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

@@ -0,0 +1,4 @@
+export type RawWrapper<T> = {
+    obj: T;
+    raw: string;
+};

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,2 @@
+import { SetStateAction } from "react";
+export declare const isUpdater: <T>(value: SetStateAction<T>) => value is (prev: T) => T;

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

@@ -0,0 +1 @@
+export const isUpdater = (value) => typeof value === 'function';

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

@@ -0,0 +1,3 @@
+import z from "zod";
+import { RawWrapper } from "./RawWrapper.js";
+export declare const load: <SCHEMA extends z.ZodType>(key: string, schema: SCHEMA, defaultValue: z.infer<SCHEMA>) => RawWrapper<z.infer<SCHEMA>>;

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

@@ -0,0 +1,7 @@
+export const load = (key, schema, defaultValue) => {
+    const v = localStorage.getItem(key);
+    return {
+        obj: schema.parse(v !== null ? JSON.parse(v) : defaultValue),
+        raw: v !== null && v !== void 0 ? v : ''
+    };
+};

package/dist/use-stored-data/use-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/use-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/use-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/use-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/dist/use-stored-data/use-version/useVersion.d.ts

@@ -0,0 +1,8 @@
+import { RawWrapper } from "../RawWrapper.js";
+type Props<T> = {
+    key: string;
+    value: RawWrapper<T>;
+    load: () => void;
+};
+export declare const useVersion: <T>(props: Props<T>) => void;
+export {};

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

@@ -0,0 +1,27 @@
+import { useEffect, useState } from "react";
+import { useDataVersionContext } from "./DataVersionContext.js";
+export const useVersion = (props) => {
+    var _a;
+    const { value, key } = props;
+    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) {
+            props.load();
+            setVersion(contextVersion);
+        }
+    };
+    useEffect(() => {
+        if (key && value.raw !== localStorage.getItem(key)) {
+            localStorage.setItem(key, JSON.stringify(value.obj));
+            addVersion();
+        }
+    }, [value]);
+    useEffect(loadVersion, [key, contextVersion]);
+};

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

@@ -1,3 +1,9 @@
 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];
+type StoredState<Schema extends z.ZodTypeAny> = [
+    z.infer<Schema>,
+    Dispatch<SetStateAction<z.infer<Schema>>>,
+    () => void
+];
+export declare const useStoredData: (key?: string) => <SCHEMA extends z.ZodType>(schema: SCHEMA, defaultValue: z.infer<SCHEMA>) => StoredState<SCHEMA>;
+export {};

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

@@ -1,42 +1,19 @@
-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 : ''
-}));
+import { useState } from "react";
+import { load } from "./load.js";
+import { isUpdater } from "./isUpdater.js";
+import { useVersion } from "./use-version/useVersion.js";
 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);
+    useVersion({ key, value: state, load: () => setState(load(key, schema, defaultValue)) });
+    const setter = (a) => {
+        return setState(s => {
+            const next = isUpdater(a) ? a(s.obj) : a;
+            const result = schema.safeParse(next);
+            return { obj: result.success ? result.data : s.obj, raw: '' };
+        });
     };
-    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
-    ];
+    const resetter = () => setState({ obj: defaultValue, raw: '' });
+    return [state.obj, setter, resetter];
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tssentials",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "Essential functions and types for typescript projects.",
   "repository": {
     "type": "git",
@@ -23,22 +23,23 @@
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",
     "build": "tsc",
+    "prepare": "npm run build",
     "lint": "eslint ."
   },
   "author": "Timo Bühlmann",
   "license": "MIT",
   "devDependencies": {
     "@eslint/js": "^9.23.0",
-    "@types/react": "^18.3.12",
-    "@types/react-dom": "^18.3.1",
+    "@types/react": "^19.2.7",
+    "@types/react-dom": "^19.2.3",
     "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",
+    "react": "^19.2.3",
+    "react-dom": "^19.2.3",
     "zod": "^4.3.5"
   }
 }