solid-tiny-utils 0.13.0 → 0.15.0

package/dist/index.d.mts

@@ -4,12 +4,14 @@ import { isValidHex, isValidOKLCH, isValidRGB } from "./color/validation.mjs";
 import { hasAnimation } from "./dom/animation.mjs";
 import { dataIf } from "./dom/attrs.mjs";
 import { combineClass, combineStyle, mountStyle, stringStyleToObject } from "./dom/css.mjs";
+import { assignAccessors } from "./solidjs/assign-accessors.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";
+import { EasyContext, createEasyContext } from "./solidjs/create-easy-context.mjs";
 import { DocumentEventName, GeneralEventListener, WindowEventName, makeEventListener } from "./solidjs/make-event-listener.mjs";
 import { createEventListener } from "./solidjs/create-event-listener.mjs";
 import { createIntersectionObserver } from "./solidjs/create-intersection-observer.mjs";
@@ -29,4 +31,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, 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 };
+export { AnyFn, CreateVisibilityObserverOption, DocumentEventName, EasyContext, EntryCallback, Fn, GeneralEventListener, MakePresenceOptions, MaybeAccessor, MaybeArray, MaybeCallableChild, MaybeNullableAccessor, MaybePromise, OKLCH, PersistedStorage, PersistedStoreOption, PresencePhase, RGB, SetterParam, StaticStoreSetter, UseVisibilityObserverFn, WindowEventName, access, accessWith, assignAccessors, callMaybeCallableChild, camel, capitalize, clamp, clearArray, combineClass, combineStyle, createClickOutside, createDebounce, createDebouncedWatch, createEasyContext, 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

@@ -10,12 +10,14 @@ import { oklchToRgb, rgbToOklch } from "./color/oklch-rgb.mjs";
 import { isValidHex, isValidOKLCH, isValidRGB } from "./color/validation.mjs";
 import { hasAnimation } from "./dom/animation.mjs";
 import { dataIf } from "./dom/attrs.mjs";
+import { assignAccessors } from "./solidjs/assign-accessors.mjs";
 import { makeEventListener } from "./solidjs/make-event-listener.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";
 import { createDebouncedWatch } from "./solidjs/create-debounce-watch.mjs";
+import { createEasyContext } from "./solidjs/create-easy-context.mjs";
 import { createEventListener } from "./solidjs/create-event-listener.mjs";
 import { createIntersectionObserver } from "./solidjs/create-intersection-observer.mjs";
 import { createList } from "./solidjs/create-list.mjs";
@@ -26,4 +28,4 @@ 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, 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 };
+export { access, accessWith, assignAccessors, callMaybeCallableChild, camel, capitalize, clamp, clearArray, combineClass, combineStyle, createClickOutside, createDebounce, createDebouncedWatch, createEasyContext, 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/assign-accessors.d.mts

@@ -0,0 +1,13 @@
+import { Accessor } from "solid-js";
+
+//#region src/solidjs/assign-accessors.d.ts
+type AccessorRecord = Record<PropertyKey, Accessor<unknown>>;
+type AccessorValues<T extends AccessorRecord> = { readonly [K in keyof T]: ReturnType<T[K]> };
+/**
+ * Assigns accessor-backed getters to an object.
+ *
+ * `append` keys must not already exist on `base`.
+ */
+declare function assignAccessors<Base extends object, Append extends AccessorRecord>(base: Base, append: Append & { [K in keyof Base]?: never }): Readonly<Base & AccessorValues<Append>>;
+//#endregion
+export { assignAccessors };

package/dist/solidjs/assign-accessors.mjs

@@ -0,0 +1,15 @@
+//#region src/solidjs/assign-accessors.ts
+/**
+* Assigns accessor-backed getters to an object.
+*
+* `append` keys must not already exist on `base`.
+*/
+function assignAccessors(base, append) {
+	for (const key in append) if (Object.hasOwn(append, key) && !Object.hasOwn(base, key)) Object.defineProperty(base, key, {
+		enumerable: true,
+		get: append[key]
+	});
+	return base;
+}
+//#endregion
+export { assignAccessors };

package/dist/solidjs/create-easy-context.d.mts

@@ -0,0 +1,13 @@
+import { ParentComponent } from "solid-js";
+
+//#region src/solidjs/create-easy-context.d.ts
+interface EasyContext<V, P extends object> {
+  initial: (params: P) => {
+    value: V;
+    Provider: ParentComponent;
+  };
+  useContext: () => V;
+}
+declare function createEasyContext<V, P extends object>(factory: (params: P) => V): EasyContext<V, P>;
+//#endregion
+export { EasyContext, createEasyContext };

package/dist/solidjs/create-easy-context.mjs

@@ -0,0 +1,30 @@
+import { isUndefined } from "../utils/is.mjs";
+import { createComponent, createContext, useContext } from "solid-js";
+//#region src/solidjs/create-easy-context.ts
+function createEasyContext(factory) {
+	const ctx = createContext();
+	const initial = (params) => {
+		const value = factory(params);
+		const Provider = (props) => createComponent(ctx.Provider, {
+			value,
+			get children() {
+				return props.children;
+			}
+		});
+		return {
+			value,
+			Provider
+		};
+	};
+	const useThisContext = () => {
+		const value = useContext(ctx);
+		if (isUndefined(value)) throw new Error("createEasyContext: missing context provider");
+		return value;
+	};
+	return {
+		initial,
+		useContext: useThisContext
+	};
+}
+//#endregion
+export { createEasyContext };

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

@@ -37,6 +37,6 @@ interface PersistedStoreOption {
  * setSettings({ sidebarOpen: false });
  * ```
  */
-declare function createPersistedStore<T extends Record<string, unknown>>(init: T, opts?: PersistedStoreOption): readonly [T, StaticStoreSetter<T>];
+declare function createPersistedStore<T extends object>(init: T, opts?: PersistedStoreOption): readonly [T, StaticStoreSetter<T>];
 //#endregion
 export { PersistedStorage, PersistedStoreOption, createPersistedStore };

package/dist/solidjs/index.d.mts

@@ -1,6 +1,8 @@
+import { assignAccessors } from "./assign-accessors.mjs";
 import { createClickOutside } from "./create-click-outside.mjs";
 import { createDebounce } from "./create-debounce.mjs";
 import { createDebouncedWatch } from "./create-debounce-watch.mjs";
+import { EasyContext, createEasyContext } from "./create-easy-context.mjs";
 import { DocumentEventName, GeneralEventListener, WindowEventName, makeEventListener } from "./make-event-listener.mjs";
 import { createEventListener } from "./create-event-listener.mjs";
 import { createIntersectionObserver } from "./create-intersection-observer.mjs";

package/dist/solidjs/utils.d.mts

@@ -7,7 +7,7 @@ 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;
+type MaybeCallableChild<T extends readonly unknown[] = []> = JSX.Element | ((...args: T) => JSX.Element);
+declare function callMaybeCallableChild<T extends readonly unknown[] = []>(children: MaybeCallableChild<T>, ...args: T): JSX.Element;
 //#endregion
 export { MaybeCallableChild, access, accessWith, callMaybeCallableChild, runSolidEventHandler };

package/package.json

@@ -26,7 +26,7 @@
     "solid-js": "^1.9.7"
   },
   "type": "module",
-  "version": "0.13.0",
+  "version": "0.15.0",
   "description": "A collection of tiny utilities for SolidJS applications",
   "author": "solid tiny",
   "license": "MIT",