solid-tiny-utils 0.12.1 → 0.13.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 g-mero
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 g-mero
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,9 +1,9 @@
-# solid-tiny-utils
-
-Tiny utilities for SolidJS applications.
-
-## Installation
-
-```bash
-pnpm add solid-tiny-utils
-```
+# solid-tiny-utils
+
+Tiny utilities for SolidJS applications.
+
+## Installation
+
+```bash
+pnpm add solid-tiny-utils
+```

package/dist/index.d.mts

@@ -6,6 +6,7 @@ import { dataIf } from "./dom/attrs.mjs";
 import { combineClass, combineStyle, mountStyle, stringStyleToObject } from "./dom/css.mjs";
 import { AnyFn, Fn } from "./types/fn.mjs";
 import { MaybeAccessor, MaybeArray, MaybeNullableAccessor, MaybePromise } from "./types/maybe.mjs";
+import { SetterParam } from "./types/solidjs.mjs";
 import { createClickOutside } from "./solidjs/create-click-outside.mjs";
 import { createDebounce } from "./solidjs/create-debounce.mjs";
 import { createDebouncedWatch } from "./solidjs/create-debounce-watch.mjs";
@@ -14,11 +15,13 @@ import { createEventListener } from "./solidjs/create-event-listener.mjs";
 import { createIntersectionObserver } from "./solidjs/create-intersection-observer.mjs";
 import { createList } from "./solidjs/create-list.mjs";
 import { createLoopExec } from "./solidjs/create-loop-exec.mjs";
+import { StaticStoreSetter, createStaticStore } from "./solidjs/create-static-store.mjs";
+import { PersistedStorage, PersistedStoreOption, createPersistedStore } from "./solidjs/create-persisted-store.mjs";
 import { MakePresenceOptions, PresencePhase, createPresence } from "./solidjs/create-presence.mjs";
 import { createThrottle } from "./solidjs/create-throttle.mjs";
 import { CreateVisibilityObserverOption, EntryCallback, UseVisibilityObserverFn, createVisibilityObserver } from "./solidjs/create-visibility-observer.mjs";
 import { createWatch } from "./solidjs/create-watch.mjs";
-import { MaybeCallableChild, access, callMaybeCallableChild, runSolidEventHandler } from "./solidjs/utils.mjs";
+import { MaybeCallableChild, access, accessWith, callMaybeCallableChild, runSolidEventHandler } from "./solidjs/utils.mjs";
 import { clearArray, iterate, list, range } from "./utils/array.mjs";
 import { runAtNextAnimationFrame, sleep } from "./utils/async.mjs";
 import { noop } from "./utils/constant.mjs";
@@ -26,4 +29,4 @@ import { isArray, isClient, isDate, isDefined, isEmpty, isFloat, isFn, isInt, is
 import { clamp, inRange, max, min, toHex } from "./utils/number.mjs";
 import { draw, random, shuffle, uid } from "./utils/random.mjs";
 import { camel, capitalize, dash, pascal, snake, template, title, trim } from "./utils/str.mjs";
-export { AnyFn, CreateVisibilityObserverOption, DocumentEventName, EntryCallback, Fn, GeneralEventListener, MakePresenceOptions, MaybeAccessor, MaybeArray, MaybeCallableChild, MaybeNullableAccessor, MaybePromise, OKLCH, PresencePhase, RGB, UseVisibilityObserverFn, WindowEventName, access, callMaybeCallableChild, camel, capitalize, clamp, clearArray, combineClass, combineStyle, createClickOutside, createDebounce, createDebouncedWatch, createEventListener, createIntersectionObserver, createList, createLoopExec, createPresence, createThrottle, createVisibilityObserver, createWatch, dash, dataIf, draw, hasAnimation, hexToRgb, inRange, isArray, isClient, isDate, isDefined, isEmpty, isFloat, isFn, isInt, isNumber, isObject, isPrimitive, isPromise, isString, isSymbol, isUndefined, isValidHex, isValidOKLCH, isValidRGB, iterate, list, makeEventListener, max, min, mountStyle, noop, oklchToRgb, pascal, random, range, rgbToHex, rgbToOklch, runAtNextAnimationFrame, runSolidEventHandler, shuffle, sleep, snake, stringStyleToObject, template, title, toHex, trim, uid };
+export { AnyFn, CreateVisibilityObserverOption, DocumentEventName, EntryCallback, Fn, GeneralEventListener, MakePresenceOptions, MaybeAccessor, MaybeArray, MaybeCallableChild, MaybeNullableAccessor, MaybePromise, OKLCH, PersistedStorage, PersistedStoreOption, PresencePhase, RGB, SetterParam, StaticStoreSetter, UseVisibilityObserverFn, WindowEventName, access, accessWith, callMaybeCallableChild, camel, capitalize, clamp, clearArray, combineClass, combineStyle, createClickOutside, createDebounce, createDebouncedWatch, createEventListener, createIntersectionObserver, createList, createLoopExec, createPersistedStore, createPresence, createStaticStore, createThrottle, createVisibilityObserver, createWatch, dash, dataIf, draw, hasAnimation, hexToRgb, inRange, isArray, isClient, isDate, isDefined, isEmpty, isFloat, isFn, isInt, isNumber, isObject, isPrimitive, isPromise, isString, isSymbol, isUndefined, isValidHex, isValidOKLCH, isValidRGB, iterate, list, makeEventListener, max, min, mountStyle, noop, oklchToRgb, pascal, random, range, rgbToHex, rgbToOklch, runAtNextAnimationFrame, runSolidEventHandler, shuffle, sleep, snake, stringStyleToObject, template, title, toHex, trim, uid };

package/dist/index.mjs

@@ -11,7 +11,7 @@ import { isValidHex, isValidOKLCH, isValidRGB } from "./color/validation.mjs";
 import { hasAnimation } from "./dom/animation.mjs";
 import { dataIf } from "./dom/attrs.mjs";
 import { makeEventListener } from "./solidjs/make-event-listener.mjs";
-import { access, callMaybeCallableChild, runSolidEventHandler } from "./solidjs/utils.mjs";
+import { access, accessWith, callMaybeCallableChild, runSolidEventHandler } from "./solidjs/utils.mjs";
 import { createClickOutside } from "./solidjs/create-click-outside.mjs";
 import { createDebounce } from "./solidjs/create-debounce.mjs";
 import { createWatch } from "./solidjs/create-watch.mjs";
@@ -20,8 +20,10 @@ import { createEventListener } from "./solidjs/create-event-listener.mjs";
 import { createIntersectionObserver } from "./solidjs/create-intersection-observer.mjs";
 import { createList } from "./solidjs/create-list.mjs";
 import { createLoopExec } from "./solidjs/create-loop-exec.mjs";
+import { createStaticStore } from "./solidjs/create-static-store.mjs";
+import { createPersistedStore } from "./solidjs/create-persisted-store.mjs";
 import { createPresence } from "./solidjs/create-presence.mjs";
 import { createThrottle } from "./solidjs/create-throttle.mjs";
 import { createVisibilityObserver } from "./solidjs/create-visibility-observer.mjs";
 import { combineClass, combineStyle, mountStyle, stringStyleToObject } from "./dom/css.mjs";
-export { access, callMaybeCallableChild, camel, capitalize, clamp, clearArray, combineClass, combineStyle, createClickOutside, createDebounce, createDebouncedWatch, createEventListener, createIntersectionObserver, createList, createLoopExec, createPresence, createThrottle, createVisibilityObserver, createWatch, dash, dataIf, draw, hasAnimation, hexToRgb, inRange, isArray, isClient, isDate, isDefined, isEmpty, isFloat, isFn, isInt, isNumber, isObject, isPrimitive, isPromise, isString, isSymbol, isUndefined, isValidHex, isValidOKLCH, isValidRGB, iterate, list, makeEventListener, max, min, mountStyle, noop, oklchToRgb, pascal, random, range, rgbToHex, rgbToOklch, runAtNextAnimationFrame, runSolidEventHandler, shuffle, sleep, snake, stringStyleToObject, template, title, toHex, trim, uid };
+export { access, accessWith, callMaybeCallableChild, camel, capitalize, clamp, clearArray, combineClass, combineStyle, createClickOutside, createDebounce, createDebouncedWatch, createEventListener, createIntersectionObserver, createList, createLoopExec, createPersistedStore, createPresence, createStaticStore, createThrottle, createVisibilityObserver, createWatch, dash, dataIf, draw, hasAnimation, hexToRgb, inRange, isArray, isClient, isDate, isDefined, isEmpty, isFloat, isFn, isInt, isNumber, isObject, isPrimitive, isPromise, isString, isSymbol, isUndefined, isValidHex, isValidOKLCH, isValidRGB, iterate, list, makeEventListener, max, min, mountStyle, noop, oklchToRgb, pascal, random, range, rgbToHex, rgbToOklch, runAtNextAnimationFrame, runSolidEventHandler, shuffle, sleep, snake, stringStyleToObject, template, title, toHex, trim, uid };

package/dist/solidjs/create-persisted-store.d.mts

@@ -0,0 +1,42 @@
+import { StaticStoreSetter } from "./create-static-store.mjs";
+
+//#region src/solidjs/create-persisted-store.d.ts
+interface PersistedStorage {
+  getItem(key: string): string | null;
+  removeItem(key: string): void;
+  setItem(key: string, value: string): void;
+}
+interface PersistedStoreOption {
+  /**
+   * Storage key used to read and write the store.
+   */
+  name?: string;
+  /**
+   * Storage adapter. Defaults to `localStorage` in the browser.
+   */
+  storage?: PersistedStorage;
+}
+/**
+ * Creates a static store persisted as JSON.
+ *
+ * Only keys from `init` are restored. Invalid JSON and storage errors are
+ * ignored.
+ *
+ * @param init Initial store value.
+ * @param opts Persistence options.
+ * @returns The store object and setter.
+ *
+ * @example
+ * ```ts
+ * const [settings, setSettings] = createPersistedStore(
+ *   { theme: "system", sidebarOpen: true },
+ *   { name: "app-settings" }
+ * );
+ *
+ * setSettings("theme", "dark");
+ * setSettings({ sidebarOpen: false });
+ * ```
+ */
+declare function createPersistedStore<T extends Record<string, unknown>>(init: T, opts?: PersistedStoreOption): readonly [T, StaticStoreSetter<T>];
+//#endregion
+export { PersistedStorage, PersistedStoreOption, createPersistedStore };

package/dist/solidjs/create-persisted-store.mjs

@@ -0,0 +1,64 @@
+import { isObject } from "../utils/is.mjs";
+import { createWatch } from "./create-watch.mjs";
+import { createStaticStore } from "./create-static-store.mjs";
+import { createUniqueId } from "solid-js";
+//#region src/solidjs/create-persisted-store.ts
+const noopStorage = {
+	getItem: () => null,
+	removeItem: () => void 0,
+	setItem: () => void 0
+};
+function getDefaultStorage() {
+	return typeof localStorage === "undefined" ? noopStorage : localStorage;
+}
+function getStore(storage, name) {
+	try {
+		const val = storage.getItem(name);
+		if (!val) return {};
+		return JSON.parse(val);
+	} catch {
+		return {};
+	}
+}
+function strictAssignStore(init, obj) {
+	const store = { ...init };
+	if (!isObject(obj)) return store;
+	for (const key in store) if (Object.hasOwn(obj, key) && Object.hasOwn(store, key)) store[key] = obj[key];
+	return store;
+}
+/**
+* Creates a static store persisted as JSON.
+*
+* Only keys from `init` are restored. Invalid JSON and storage errors are
+* ignored.
+*
+* @param init Initial store value.
+* @param opts Persistence options.
+* @returns The store object and setter.
+*
+* @example
+* ```ts
+* const [settings, setSettings] = createPersistedStore(
+*   { theme: "system", sidebarOpen: true },
+*   { name: "app-settings" }
+* );
+*
+* setSettings("theme", "dark");
+* setSettings({ sidebarOpen: false });
+* ```
+*/
+function createPersistedStore(init, opts) {
+	const name = opts?.name ?? `persisted-${createUniqueId()}`;
+	const storage = opts?.storage ?? getDefaultStorage();
+	const [store, setStore] = createStaticStore(strictAssignStore(init, getStore(storage, name)));
+	createWatch(() => JSON.stringify(store), (jsonData) => {
+		try {
+			storage.setItem(name, jsonData);
+		} catch {
+			return;
+		}
+	}, { defer: true });
+	return [store, setStore];
+}
+//#endregion
+export { createPersistedStore };

package/dist/solidjs/create-presence.d.mts

@@ -7,14 +7,16 @@ interface MakePresenceOptions {
   exitDuration: MaybeAccessor<number>;
   initialEnter?: boolean;
 }
-type PresencePhase = "idle" | "pre-enter" | "entering" | "entered" | "exiting" | "exited";
+type PresencePhase = "idle" | "entering" | "entered" | "exiting";
+/**
+ * Keeps an item mounted while its enter and exit animations run.
+ */
 declare function createPresence<TItem>(item: Accessor<TItem | undefined>, options: MakePresenceOptions): {
   isMounted: () => boolean;
-  mountedItem: Accessor<TItem | undefined>;
-  isVisible: Accessor<boolean>;
   isAnimating: Accessor<boolean>;
   isEntering: Accessor<boolean>;
   isExiting: Accessor<boolean>;
+  mountedItem: Accessor<TItem | undefined>;
   phase: Accessor<PresencePhase>;
 };
 //#endregion

package/dist/solidjs/create-presence.mjs

@@ -1,86 +1,66 @@
 import { isDefined } from "../utils/is.mjs";
-import { runAtNextAnimationFrame } from "../utils/async.mjs";
 import { noop } from "../utils/constant.mjs";
 import { access } from "./utils.mjs";
 import { createWatch } from "./create-watch.mjs";
 import { createEffect, createMemo, createSignal, onCleanup, untrack } from "solid-js";
 //#region src/solidjs/create-presence.ts
 function makeTimeout(ms, fn) {
-	if (ms() <= 0) {
+	if (ms <= 0) {
 		fn();
 		return noop;
 	}
 	const timeoutId = setTimeout(() => {
 		fn();
-	}, ms());
+	}, ms);
 	return () => clearTimeout(timeoutId);
 }
+const itemShouldBeMounted = (item) => item !== false && item != null;
+function getInitialPhase(item, initialEnter) {
+	if (!itemShouldBeMounted(item)) return "idle";
+	if (initialEnter) return "entering";
+	return "entered";
+}
 /**
-* Animates the appearance of its children.
-*
-* @internal - to be combined with `createPresence` in the future
+* Keeps an item mounted while its enter and exit animations run.
 */
-function createPresenceBase(source, options) {
-	const enterDuration = () => access(options.enterDuration);
-	const exitDuration = () => access(options.exitDuration);
-	const initialSource = untrack(source);
-	let initialPhase = "idle";
-	if (initialSource) initialPhase = options.initialEnter ? "pre-enter" : "entered";
-	const [phase, setPhase] = createSignal(initialPhase);
+function createPresence(item, options) {
+	const initial = untrack(item);
+	const [mountedItem, setMountedItem] = createSignal(initial);
+	const [phase, setPhase] = createSignal(getInitialPhase(initial, options.initialEnter));
+	const isMounted = createMemo(() => phase() !== "idle");
+	const isEntering = createMemo(() => phase() === "entering");
+	const isExiting = createMemo(() => phase() === "exiting");
+	const isAnimating = createMemo(() => isEntering() || isExiting());
 	let clear = noop;
 	onCleanup(clear);
-	createWatch(source, (visible) => {
-		setPhase((prev) => {
-			if (visible) {
-				if (prev === "idle" || prev === "exited") return "pre-enter";
-				return prev;
-			}
-			if (prev === "entered" || prev === "entering") return "exiting";
-			return prev;
-		});
-	});
 	createWatch(phase, (currentPhase) => {
 		clear();
-		if (currentPhase === "pre-enter") runAtNextAnimationFrame(() => {
-			setPhase("entering");
-		});
-		if (currentPhase === "entering") clear = makeTimeout(enterDuration, () => setPhase("entered"));
-		if (currentPhase === "exiting") clear = makeTimeout(exitDuration, () => setPhase("exited"));
-		if (currentPhase === "exited") setPhase("idle");
+		if (currentPhase === "entering") clear = makeTimeout(access(options.enterDuration), () => setPhase("entered"));
+		if (currentPhase === "exiting") clear = makeTimeout(access(options.exitDuration), () => setPhase("idle"));
 	});
-	const isVisible = createMemo(() => ["entering", "entered"].includes(phase()));
-	const isMounted = createMemo(() => phase() !== "idle");
-	const isExiting = createMemo(() => phase() === "exiting");
-	const isEntering = createMemo(() => phase() === "entering");
-	return {
-		isMounted,
-		isVisible,
-		isAnimating: createMemo(() => isEntering() || isExiting()),
-		isEntering,
-		isExiting,
-		phase
-	};
-}
-const itemShouldBeMounted = (item) => item !== false && item != null;
-function createPresence(item, options) {
-	const initial = untrack(item);
-	const [mountedItem, setMountedItem] = createSignal(initial);
-	const [shouldBeMounted, setShouldBeMounted] = createSignal(itemShouldBeMounted(initial));
-	const { isMounted, ...rest } = createPresenceBase(shouldBeMounted, options);
 	createEffect(() => {
-		if (mountedItem() !== item()) {
-			if (isMounted()) setShouldBeMounted(false);
-			else if (itemShouldBeMounted(item())) {
-				setMountedItem(() => item());
-				setShouldBeMounted(true);
+		const currentItem = item();
+		if (mountedItem() !== currentItem) {
+			if (isMounted()) setPhase("exiting");
+			else if (itemShouldBeMounted(currentItem)) {
+				setMountedItem(() => currentItem);
+				setPhase("entering");
 			}
-		} else if (!itemShouldBeMounted(item())) setShouldBeMounted(false);
-		else if (itemShouldBeMounted(item())) setShouldBeMounted(true);
+			return;
+		}
+		if (itemShouldBeMounted(currentItem)) {
+			if (!isMounted()) setPhase("entering");
+			return;
+		}
+		if (isMounted()) setPhase("exiting");
 	});
 	return {
-		...rest,
 		isMounted: () => isMounted() && isDefined(mountedItem()),
-		mountedItem
+		isAnimating,
+		isEntering,
+		isExiting,
+		mountedItem,
+		phase
 	};
 }
 //#endregion

package/dist/solidjs/create-static-store.d.mts

@@ -0,0 +1,27 @@
+import { SetterParam } from "../types/solidjs.mjs";
+//#region src/solidjs/create-static-store.d.ts
+interface StaticStoreSetter<T extends object> {
+  (setter: (prev: T) => Partial<T>): T;
+  (state: Partial<T>): T;
+  <K extends keyof T>(key: K, state: SetterParam<T[K]>): T;
+}
+/**
+ * Creates a shallow reactive object with a fixed set of keys.
+ *
+ * Only top-level properties are tracked. Keys are defined by `init` and are not
+ * added or removed later.
+ *
+ * @param init Initial store value.
+ * @returns The store object and setter.
+ *
+ * @example
+ * ```ts
+ * const [state, setState] = createStaticStore({ count: 0 });
+ *
+ * setState("count", (count) => count + 1);
+ * setState({ count: 10 });
+ * ```
+ */
+declare function createStaticStore<T extends object>(init: T): [access: T, write: StaticStoreSetter<T>];
+//#endregion
+export { StaticStoreSetter, createStaticStore };

package/dist/solidjs/create-static-store.mjs

@@ -0,0 +1,54 @@
+import { isFn, isObject } from "../utils/is.mjs";
+import { accessWith } from "./utils.mjs";
+import { batch, createSignal, getListener, untrack } from "solid-js";
+//#region src/solidjs/create-static-store.ts
+/** biome-ignore-all lint/suspicious/noExplicitAny: any */
+/**
+* Creates a shallow reactive object with a fixed set of keys.
+*
+* Only top-level properties are tracked. Keys are defined by `init` and are not
+* added or removed later.
+*
+* @param init Initial store value.
+* @returns The store object and setter.
+*
+* @example
+* ```ts
+* const [state, setState] = createStaticStore({ count: 0 });
+*
+* setState("count", (count) => count + 1);
+* setState({ count: 10 });
+* ```
+*/
+function createStaticStore(init) {
+	const copy = { ...init }, store = { ...init }, cache = {};
+	const getValue = (key) => {
+		let signal = cache[key];
+		if (!signal) {
+			if (!getListener()) return copy[key];
+			cache[key] = signal = createSignal(copy[key], { internal: true });
+			delete copy[key];
+		}
+		return signal[0]();
+	};
+	for (const key in init) if (Object.hasOwn(init, key)) Object.defineProperty(store, key, {
+		get: () => getValue(key),
+		enumerable: true
+	});
+	const setValue = (key, value) => {
+		const signal = cache[key];
+		if (signal) signal[1](value);
+		if (key in copy) copy[key] = accessWith(value, copy[key]);
+	};
+	return [store, (a, b) => {
+		if (isObject(a) || isFn(a)) {
+			const entries = untrack(() => Object.entries(accessWith(a, store)));
+			batch(() => {
+				for (const [key, value] of entries) setValue(key, () => value);
+			});
+		} else setValue(a, b);
+		return store;
+	}];
+}
+//#endregion
+export { createStaticStore };

package/dist/solidjs/index.d.mts

@@ -6,8 +6,10 @@ import { createEventListener } from "./create-event-listener.mjs";
 import { createIntersectionObserver } from "./create-intersection-observer.mjs";
 import { createList } from "./create-list.mjs";
 import { createLoopExec } from "./create-loop-exec.mjs";
+import { StaticStoreSetter, createStaticStore } from "./create-static-store.mjs";
+import { PersistedStorage, PersistedStoreOption, createPersistedStore } from "./create-persisted-store.mjs";
 import { MakePresenceOptions, PresencePhase, createPresence } from "./create-presence.mjs";
 import { createThrottle } from "./create-throttle.mjs";
 import { CreateVisibilityObserverOption, EntryCallback, UseVisibilityObserverFn, createVisibilityObserver } from "./create-visibility-observer.mjs";
 import { createWatch } from "./create-watch.mjs";
-import { MaybeCallableChild, access, callMaybeCallableChild, runSolidEventHandler } from "./utils.mjs";
+import { MaybeCallableChild, access, accessWith, callMaybeCallableChild, runSolidEventHandler } from "./utils.mjs";

package/dist/solidjs/utils.d.mts

@@ -1,10 +1,13 @@
+import { AnyFn } from "../types/fn.mjs";
 import { MaybeAccessor } from "../types/maybe.mjs";
 import { JSX } from "solid-js";
 
 //#region src/solidjs/utils.d.ts
 declare function access<T>(value: MaybeAccessor<T>): T;
+/** If value is a function – call it with a given arguments – otherwise get the value as is */
+declare function accessWith<T>(valueOrFn: T, ...args: T extends AnyFn ? Parameters<T> : never): T extends AnyFn ? ReturnType<T> : T;
 declare function runSolidEventHandler<T, E extends Event, EHandler extends JSX.EventHandler<T, any> = JSX.EventHandler<T, E>>(event: E, handler?: EHandler | JSX.BoundEventHandler<T, E, EHandler>): void;
 type MaybeCallableChild<T extends unknown[] = []> = JSX.Element | ((...args: T) => JSX.Element);
 declare function callMaybeCallableChild<T extends unknown[] = []>(children: MaybeCallableChild<T>, ...args: T): JSX.Element;
 //#endregion
-export { MaybeCallableChild, access, callMaybeCallableChild, runSolidEventHandler };
+export { MaybeCallableChild, access, accessWith, callMaybeCallableChild, runSolidEventHandler };

package/dist/solidjs/utils.mjs

@@ -3,6 +3,10 @@ import { isArray, isFn } from "../utils/is.mjs";
 function access(value) {
 	return isFn(value) ? value() : value;
 }
+/** If value is a function – call it with a given arguments – otherwise get the value as is */
+function accessWith(valueOrFn, ...args) {
+	return isFn(valueOrFn) ? valueOrFn(...args) : valueOrFn;
+}
 function runSolidEventHandler(event, handler) {
 	if (isFn(handler)) {
 		handler(event);
@@ -18,4 +22,4 @@ function callMaybeCallableChild(children, ...args) {
 	return isFn(children) ? children(...args) : children;
 }
 //#endregion
-export { access, callMaybeCallableChild, runSolidEventHandler };
+export { access, accessWith, callMaybeCallableChild, runSolidEventHandler };

package/dist/types/index.d.mts

@@ -1,2 +1,3 @@
 import { AnyFn, Fn } from "./fn.mjs";
-import { MaybeAccessor, MaybeArray, MaybeNullableAccessor, MaybePromise } from "./maybe.mjs";
+import { MaybeAccessor, MaybeArray, MaybeNullableAccessor, MaybePromise } from "./maybe.mjs";
+import { SetterParam } from "./solidjs.mjs";

package/dist/types/solidjs.d.mts

@@ -0,0 +1,6 @@
+import { Setter } from "solid-js";
+
+//#region src/types/solidjs.d.ts
+type SetterParam<T> = Parameters<Setter<T>>[0];
+//#endregion
+export { SetterParam };

package/package.json

@@ -8,13 +8,12 @@
     "@testing-library/user-event": "^14.6.1",
     "@types/culori": "^4.0.0",
     "@types/node": "^25.0.3",
-    "@typescript/native-preview": "7.0.0-dev.20260421.2",
+    "@typescript/native-preview": "7.0.0-dev.20260527.2",
     "@vitest/ui": "^4.0.16",
     "bumpp": "^11.1.0",
     "culori": "^4.0.2",
     "jsdom": "^29.1.1",
-    "solid-tiny-context": "0.3.1",
-    "tsdown": "^0.22.0",
+    "tsdown": "^0.22.1",
     "ultracite": "7.7.0",
     "unocss": "^66.7.0",
     "vite": "^8.0.14",
@@ -27,7 +26,7 @@
     "solid-js": "^1.9.7"
   },
   "type": "module",
-  "version": "0.12.1",
+  "version": "0.13.0",
   "description": "A collection of tiny utilities for SolidJS applications",
   "author": "solid tiny",
   "license": "MIT",