solid-tiny-utils 0.3.0 → 0.4.2

package/README.md

@@ -7,71 +7,3 @@ Tiny utilities for SolidJS applications.
 ```bash
 pnpm add solid-tiny-utils
 ```
-
-## Usage
-
-```typescript
-import { access, createWatch, CreateLoopExec, isFn, isArray } from 'solid-tiny-utils';
-```
-
-## API
-
-### Reactive
-
-#### `access(value)`
-Safely access a value that might be an accessor function.
-
-```typescript
-const value = access(maybeAccessor); // Returns the value directly or calls the accessor
-```
-
-#### `createWatch(targets, fn, options?)`
-Create a watcher that runs when dependencies change.
-
-```typescript
-createWatch(() => signal(), (value) => {
-  console.log('Value changed:', value);
-});
-```
-
-### Functions
-
-#### `CreateLoopExec(fn, delay)`
-Execute a function in a loop with cleanup support.
-
-```typescript
-CreateLoopExec(
-  async () => {
-    // Your async work here
-  },
-  1000 // Delay in milliseconds
-);
-```
-
-### Type Guards
-
-#### `isFn(value)`
-Check if a value is a function.
-
-```typescript
-if (isFn(value)) {
-  value(); // TypeScript knows it's a function
-}
-```
-
-#### `isArray(value)`
-Check if a value is an array.
-
-```typescript
-if (isArray(value)) {
-  value.forEach(...); // TypeScript knows it's an array
-}
-```
-
-### Types
-
-```typescript
-type MaybeArray<T> = T | T[];
-type MaybePromise<T> = T | Promise<T>;
-type MaybeAccessor<T> = T | Accessor<T>;
-```

package/dist/chunk-BGLY6NJK.js

@@ -0,0 +1,111 @@
+import {
+  access
+} from "./chunk-M5A3VVYI.js";
+import {
+  createWatch
+} from "./chunk-4L6FK7MF.js";
+import {
+  isNumber
+} from "./chunk-ZGYORUAX.js";
+
+// src/fn/create-debounce.ts
+import { onCleanup as onCleanup3 } from "solid-js";
+
+// src/fn/create-loop-exec.ts
+import { onCleanup } from "solid-js";
+function createLoopExec(fn, delay) {
+  let shouldStop = false;
+  let isCleanedUp = false;
+  let timer;
+  const execFn = async () => {
+    clearTimeout(timer);
+    const d = access(delay);
+    if (shouldStop || !isNumber(d) || d < 0) {
+      return;
+    }
+    try {
+      await fn();
+    } finally {
+      timer = setTimeout(() => {
+        execFn();
+      }, d);
+    }
+  };
+  createWatch(
+    () => access(delay),
+    () => {
+      execFn();
+    }
+  );
+  const stop = () => {
+    shouldStop = true;
+    clearTimeout(timer);
+  };
+  const start = () => {
+    if (isCleanedUp) {
+      return;
+    }
+    shouldStop = false;
+    execFn();
+  };
+  onCleanup(() => {
+    isCleanedUp = true;
+    stop();
+  });
+  return {
+    stop,
+    start
+  };
+}
+
+// src/fn/create-throttle.ts
+import { onCleanup as onCleanup2 } from "solid-js";
+function createThrottle(callback, delay) {
+  let timeoutId;
+  onCleanup2(() => {
+    clearTimeout(timeoutId);
+  });
+  const run = (...args) => {
+    if (timeoutId) {
+      return;
+    }
+    timeoutId = setTimeout(() => {
+      callback(...args);
+      timeoutId = void 0;
+    }, access(delay));
+  };
+  return run;
+}
+
+// src/fn/index.ts
+var noop = () => {
+};
+
+// src/reactive/create-debounce-watch.ts
+function createDebouncedWatch(targets, fn, opt) {
+  const debounceFn = createDebounce(fn, opt?.delay ?? 10);
+  createWatch(targets, debounceFn, opt);
+}
+
+// src/fn/create-debounce.ts
+function createDebounce(callback, delay) {
+  let timeoutId;
+  onCleanup3(() => {
+    clearTimeout(timeoutId);
+  });
+  const run = (...args) => {
+    clearTimeout(timeoutId);
+    timeoutId = setTimeout(() => {
+      callback(...args);
+    }, access(delay));
+  };
+  return run;
+}
+
+export {
+  createDebounce,
+  createLoopExec,
+  createThrottle,
+  noop,
+  createDebouncedWatch
+};

package/dist/{chunk-WLQ64SAO.js → chunk-CSAKXWF3.js}

@@ -24,9 +24,13 @@ function* range(startOrLength, end, valueOrMapper = (i) => i, step = 1) {
 var list = (startOrLength, end, valueOrMapper, step) => {
   return Array.from(range(startOrLength, end, valueOrMapper, step));
 };
+function clearArray(arr) {
+  arr.length = 0;
+}
 
 export {
   iterate,
   range,
-  list
+  list,
+  clearArray
 };

package/dist/chunk-II6INKPZ.js

@@ -0,0 +1,8 @@
+// src/jsx/attrs.ts
+function dataIf(show) {
+  return show ? "" : void 0;
+}
+
+export {
+  dataIf
+};

package/dist/chunk-ILGNNUQK.js

@@ -0,0 +1,51 @@
+import {
+  makeEventListener
+} from "./chunk-OUAI75QC.js";
+import {
+  noop
+} from "./chunk-BGLY6NJK.js";
+import {
+  access
+} from "./chunk-M5A3VVYI.js";
+import {
+  createWatch
+} from "./chunk-4L6FK7MF.js";
+import {
+  clearArray
+} from "./chunk-CSAKXWF3.js";
+import {
+  isArray
+} from "./chunk-ZGYORUAX.js";
+
+// src/event/create-event-listener.ts
+function createEventListener(...args) {
+  const target = args[0];
+  const events = args[1];
+  let listeners = args[2];
+  const options = args[3] ?? noop;
+  if (!isArray(listeners)) {
+    listeners = [listeners];
+  }
+  const cleanups = [];
+  const cleanup = () => {
+    for (const c of cleanups) {
+      c();
+    }
+    clearArray(cleanups);
+  };
+  createWatch(
+    () => [access(target), access(events), access(options)],
+    ([tars, evs, opts]) => {
+      cleanup();
+      if (!(tars && evs)) {
+        return;
+      }
+      cleanups.push(makeEventListener(tars, evs, listeners, opts));
+    }
+  );
+  return cleanup;
+}
+
+export {
+  createEventListener
+};

package/dist/chunk-NFDGLC4A.js

@@ -0,0 +1,54 @@
+import {
+  makeEventListener
+} from "./chunk-OUAI75QC.js";
+import {
+  access
+} from "./chunk-M5A3VVYI.js";
+
+// src/event/create-click-outside.ts
+function createClickOutside(target, handler, options) {
+  let shouldListen = false;
+  const shouldIgnore = (event) => {
+    const ignore = (options?.ignore ? options.ignore : []).map(access);
+    return ignore.some((el) => {
+      return el && (event.target === el || event.composedPath().includes(el));
+    });
+  };
+  const listener = (e) => {
+    const el = access(target);
+    if (!el || el === e.target || e.composedPath().includes(el)) {
+      return;
+    }
+    if (e.detail === 0) {
+      shouldListen = !shouldIgnore(e);
+    }
+    if (!shouldListen) {
+      shouldListen = true;
+      return;
+    }
+    handler(e);
+  };
+  const cleanups = [
+    makeEventListener("click", listener, { passive: true }),
+    makeEventListener(
+      "pointerdown",
+      (e) => {
+        const el = access(target);
+        if (el) {
+          shouldListen = !(e.composedPath().includes(el) || shouldIgnore(e));
+        }
+      },
+      { passive: true }
+    )
+  ];
+  const stop = () => {
+    for (const cleanup of cleanups) {
+      cleanup();
+    }
+  };
+  return stop;
+}
+
+export {
+  createClickOutside
+};

package/dist/chunk-OUAI75QC.js

@@ -0,0 +1,55 @@
+import {
+  noop
+} from "./chunk-BGLY6NJK.js";
+import {
+  clearArray
+} from "./chunk-CSAKXWF3.js";
+import {
+  isArray
+} from "./chunk-ZGYORUAX.js";
+
+// src/event/make-event-listener.ts
+import { onCleanup } from "solid-js";
+function makeEventListener(...args) {
+  let target;
+  let events;
+  let listeners;
+  let options;
+  if (typeof args[0] === "string" || isArray(args[0])) {
+    [events, listeners, options] = args;
+    target = window;
+  } else {
+    [target, events, listeners, options] = args;
+  }
+  if (!target) {
+    return noop;
+  }
+  if (!isArray(events)) {
+    events = [events];
+  }
+  if (!isArray(listeners)) {
+    listeners = [listeners];
+  }
+  const cleanups = [];
+  const cleanup = () => {
+    for (const c of cleanups) {
+      c();
+    }
+    clearArray(cleanups);
+  };
+  const register = (el, event, listener, opts) => {
+    el.addEventListener(event, listener, opts);
+    return () => el.removeEventListener(event, listener, opts);
+  };
+  cleanups.push(
+    ...events.flatMap(
+      (event) => listeners.map((listener) => register(target, event, listener, options))
+    )
+  );
+  onCleanup(cleanup);
+  return cleanup;
+}
+
+export {
+  makeEventListener
+};

package/dist/{chunk-RRYFZNKE.js → chunk-PBALVUKK.js}

@@ -1,6 +1,6 @@
 import {
   iterate
-} from "./chunk-WLQ64SAO.js";
+} from "./chunk-CSAKXWF3.js";
 
 // src/lodash/random.ts
 var random = (min, max) => {

package/dist/dom/css.js

@@ -3,8 +3,8 @@ import {
 } from "../chunk-KVG6TCSE.js";
 import "../chunk-OECLQ3OT.js";
 import "../chunk-KFWZFQMB.js";
-import "../chunk-RRYFZNKE.js";
-import "../chunk-WLQ64SAO.js";
+import "../chunk-PBALVUKK.js";
+import "../chunk-CSAKXWF3.js";
 import "../chunk-ZGYORUAX.js";
 import "../chunk-PNR5G432.js";
 export {

package/dist/dom/index.js

@@ -4,8 +4,8 @@ import {
 } from "../chunk-KVG6TCSE.js";
 import "../chunk-OECLQ3OT.js";
 import "../chunk-KFWZFQMB.js";
-import "../chunk-RRYFZNKE.js";
-import "../chunk-WLQ64SAO.js";
+import "../chunk-PBALVUKK.js";
+import "../chunk-CSAKXWF3.js";
 import "../chunk-ZGYORUAX.js";
 import "../chunk-PNR5G432.js";
 export {

package/dist/event/create-click-outside.d.ts

@@ -1,8 +1,8 @@
 import { MaybeAccessor } from '../types/maybe.js';
 import 'solid-js';
 
-declare function createClickOutside(target: MaybeAccessor<HTMLElement | null | undefined>, handler: (event: MouseEvent | TouchEvent) => void, options?: {
+declare function createClickOutside(target: MaybeAccessor<HTMLElement | null | undefined>, handler: (event: PointerEvent) => void, options?: {
     ignore?: MaybeAccessor<HTMLElement | null | undefined>[];
-}): void;
+}): () => void;
 
 export { createClickOutside };

package/dist/event/create-click-outside.js

@@ -1,13 +1,14 @@
 import {
   createClickOutside
-} from "../chunk-YJB637I2.js";
-import "../chunk-ZZNAXGNU.js";
+} from "../chunk-NFDGLC4A.js";
+import "../chunk-OUAI75QC.js";
+import "../chunk-BGLY6NJK.js";
 import "../chunk-M5A3VVYI.js";
 import "../chunk-4L6FK7MF.js";
 import "../chunk-OECLQ3OT.js";
 import "../chunk-KFWZFQMB.js";
-import "../chunk-RRYFZNKE.js";
-import "../chunk-WLQ64SAO.js";
+import "../chunk-PBALVUKK.js";
+import "../chunk-CSAKXWF3.js";
 import "../chunk-ZGYORUAX.js";
 import "../chunk-PNR5G432.js";
 export {

package/dist/event/create-event-listener.d.ts

@@ -0,0 +1,23 @@
+import { Fn } from '../types/fn.js';
+import { MaybeAccessor, MaybeArray } from '../types/maybe.js';
+import { WindowEventName, DocumentEventName, GeneralEventListener } from './make-event-listener.js';
+import 'solid-js';
+
+/**
+ * Overload 2: Explicitly Window target
+ */
+declare function createEventListener<E extends WindowEventName>(target: MaybeAccessor<Window | undefined | null>, event: MaybeAccessor<MaybeArray<E>>, listener: MaybeArray<(this: Window, ev: WindowEventMap[E]) => void>, options?: MaybeAccessor<boolean | AddEventListenerOptions | undefined>): Fn;
+/**
+ * Overload 3: Explicitly Document target
+ */
+declare function createEventListener<E extends DocumentEventName>(target: MaybeAccessor<DocumentOrShadowRoot | undefined | null>, event: MaybeAccessor<MaybeArray<E>>, listener: MaybeArray<(this: Document, ev: DocumentEventMap[E]) => void>, options?: MaybeAccessor<boolean | AddEventListenerOptions | undefined>): Fn;
+/**
+ * Overload 4: Explicitly HTMLElement target
+ */
+declare function createEventListener<T extends HTMLElement, E extends keyof HTMLElementEventMap>(target: MaybeAccessor<T | undefined | null>, event: MaybeAccessor<MaybeArray<E>>, listener: MaybeArray<(this: T, ev: HTMLElementEventMap[E]) => void>, options?: MaybeAccessor<boolean | AddEventListenerOptions | undefined>): Fn;
+/**
+ * Overload 6: Custom event target fallback
+ */
+declare function createEventListener<EventType = Event>(target: MaybeAccessor<EventTarget | undefined | null>, event: MaybeAccessor<MaybeArray<string>>, listener: MaybeArray<GeneralEventListener<EventType>>, options?: MaybeAccessor<boolean | AddEventListenerOptions | undefined>): Fn;
+
+export { createEventListener };

package/dist/event/create-event-listener.js

@@ -0,0 +1,16 @@
+import {
+  createEventListener
+} from "../chunk-ILGNNUQK.js";
+import "../chunk-OUAI75QC.js";
+import "../chunk-BGLY6NJK.js";
+import "../chunk-M5A3VVYI.js";
+import "../chunk-4L6FK7MF.js";
+import "../chunk-OECLQ3OT.js";
+import "../chunk-KFWZFQMB.js";
+import "../chunk-PBALVUKK.js";
+import "../chunk-CSAKXWF3.js";
+import "../chunk-ZGYORUAX.js";
+import "../chunk-PNR5G432.js";
+export {
+  createEventListener
+};

package/dist/event/index.d.ts

@@ -1,3 +1,6 @@
 export { createClickOutside } from './create-click-outside.js';
+export { createEventListener } from './create-event-listener.js';
+export { DocumentEventName, GeneralEventListener, WindowEventName, makeEventListener } from './make-event-listener.js';
 import '../types/maybe.js';
 import 'solid-js';
+import '../types/fn.js';

package/dist/event/index.js

@@ -1,16 +1,24 @@
-import "../chunk-M53KPXWR.js";
+import "../chunk-B6TZK2S5.js";
 import {
   createClickOutside
-} from "../chunk-YJB637I2.js";
-import "../chunk-ZZNAXGNU.js";
+} from "../chunk-NFDGLC4A.js";
+import {
+  createEventListener
+} from "../chunk-ILGNNUQK.js";
+import {
+  makeEventListener
+} from "../chunk-OUAI75QC.js";
+import "../chunk-BGLY6NJK.js";
 import "../chunk-M5A3VVYI.js";
 import "../chunk-4L6FK7MF.js";
 import "../chunk-OECLQ3OT.js";
 import "../chunk-KFWZFQMB.js";
-import "../chunk-RRYFZNKE.js";
-import "../chunk-WLQ64SAO.js";
+import "../chunk-PBALVUKK.js";
+import "../chunk-CSAKXWF3.js";
 import "../chunk-ZGYORUAX.js";
 import "../chunk-PNR5G432.js";
 export {
-  createClickOutside
+  createClickOutside,
+  createEventListener,
+  makeEventListener
 };

package/dist/event/make-event-listener.d.ts

@@ -0,0 +1,49 @@
+import { Fn } from '../types/fn.js';
+import { MaybeArray } from '../types/maybe.js';
+import 'solid-js';
+
+interface InferEventTarget<Events> {
+    addEventListener: (event: Events, fn?: any, options?: any) => any;
+    removeEventListener: (event: Events, fn?: any, options?: any) => any;
+}
+type WindowEventName = keyof WindowEventMap;
+type DocumentEventName = keyof DocumentEventMap;
+type GeneralEventListener<E = Event> = (evt: E) => void;
+/**
+ * Overload 1: Omitted Window target
+ */
+declare function makeEventListener<E extends WindowEventName>(event: MaybeArray<E>, listener: MaybeArray<(this: Window, ev: WindowEventMap[E]) => void>, options?: boolean | AddEventListenerOptions): Fn;
+/**
+ * Overload 2: Explicitly Window target
+ */
+declare function makeEventListener<E extends WindowEventName>(target: Window, event: E, listener: MaybeArray<(this: Window, ev: WindowEventMap[E]) => void>, options?: boolean | AddEventListenerOptions): Fn;
+/**
+ * Overload 2.1: Explicitly Window target
+ */
+declare function makeEventListener<EventType = Event>(target: Window, event: WindowEventName[], listener: MaybeArray<(this: Window, ev: EventType) => void>, options?: boolean | AddEventListenerOptions): Fn;
+/**
+ * Overload 3: Explicitly Document target
+ */
+declare function makeEventListener<E extends DocumentEventName>(target: DocumentOrShadowRoot, event: E, listener: MaybeArray<(this: Document, ev: DocumentEventMap[E]) => void>, options?: boolean | AddEventListenerOptions): Fn;
+/**
+ * Overload 3.1: Explicitly Document target
+ */
+declare function makeEventListener<EventType = Event>(target: DocumentOrShadowRoot, event: DocumentEventName[], listener: MaybeArray<(this: Document, ev: EventType) => void>, options?: boolean | AddEventListenerOptions): Fn;
+/**
+ * Overload 4: Explicitly HTMLElement target
+ */
+declare function makeEventListener<T extends HTMLElement, E extends keyof HTMLElementEventMap>(target: T, event: E | (keyof HTMLElementEventMap)[], listener: MaybeArray<(this: T, ev: HTMLElementEventMap[E]) => void>, options?: boolean | AddEventListenerOptions): Fn;
+/**
+ * Overload 4.1: Explicitly HTMLElement target
+ */
+declare function makeEventListener<T extends HTMLElement, EventType = Event>(target: T, event: (keyof HTMLElementEventMap)[], listener: MaybeArray<(this: T, ev: EventType) => void>, options?: boolean | AddEventListenerOptions): Fn;
+/**
+ * Overload 5: Custom event target with event type infer
+ */
+declare function makeEventListener<Names extends string, EventType = Event>(target: InferEventTarget<Names>, event: MaybeArray<Names>, listener: MaybeArray<GeneralEventListener<EventType>>, options?: boolean | AddEventListenerOptions): Fn;
+/**
+ * Overload 6: Custom event target fallback
+ */
+declare function makeEventListener<EventType = Event>(target: EventTarget, event: MaybeArray<string>, listener: MaybeArray<GeneralEventListener<EventType>>, options?: boolean | AddEventListenerOptions): Fn;
+
+export { type DocumentEventName, type GeneralEventListener, type WindowEventName, makeEventListener };

package/dist/event/make-event-listener.js

@@ -0,0 +1,15 @@
+import {
+  makeEventListener
+} from "../chunk-OUAI75QC.js";
+import "../chunk-BGLY6NJK.js";
+import "../chunk-M5A3VVYI.js";
+import "../chunk-4L6FK7MF.js";
+import "../chunk-OECLQ3OT.js";
+import "../chunk-KFWZFQMB.js";
+import "../chunk-PBALVUKK.js";
+import "../chunk-CSAKXWF3.js";
+import "../chunk-ZGYORUAX.js";
+import "../chunk-PNR5G432.js";
+export {
+  makeEventListener
+};

package/dist/fn/create-debounce.js

@@ -1,13 +1,12 @@
 import {
   createDebounce
-} from "../chunk-H6VUVMSF.js";
-import "../chunk-ZZNAXGNU.js";
+} from "../chunk-BGLY6NJK.js";
 import "../chunk-M5A3VVYI.js";
 import "../chunk-4L6FK7MF.js";
 import "../chunk-OECLQ3OT.js";
 import "../chunk-KFWZFQMB.js";
-import "../chunk-RRYFZNKE.js";
-import "../chunk-WLQ64SAO.js";
+import "../chunk-PBALVUKK.js";
+import "../chunk-CSAKXWF3.js";
 import "../chunk-ZGYORUAX.js";
 import "../chunk-PNR5G432.js";
 export {

package/dist/fn/create-loop-exec.js

@@ -1,13 +1,12 @@
 import {
   createLoopExec
-} from "../chunk-WY5G2PJM.js";
-import "../chunk-ZZNAXGNU.js";
+} from "../chunk-BGLY6NJK.js";
 import "../chunk-M5A3VVYI.js";
 import "../chunk-4L6FK7MF.js";
 import "../chunk-OECLQ3OT.js";
 import "../chunk-KFWZFQMB.js";
-import "../chunk-RRYFZNKE.js";
-import "../chunk-WLQ64SAO.js";
+import "../chunk-PBALVUKK.js";
+import "../chunk-CSAKXWF3.js";
 import "../chunk-ZGYORUAX.js";
 import "../chunk-PNR5G432.js";
 export {

package/dist/fn/create-throttle.d.ts

@@ -0,0 +1,6 @@
+import { MaybeAccessor } from '../types/maybe.js';
+import 'solid-js';
+
+declare function createThrottle<Args extends unknown[]>(callback: (...args: Args) => void, delay: MaybeAccessor<number>): (...args: Args) => void;
+
+export { createThrottle };

package/dist/fn/create-throttle.js

@@ -0,0 +1,14 @@
+import {
+  createThrottle
+} from "../chunk-BGLY6NJK.js";
+import "../chunk-M5A3VVYI.js";
+import "../chunk-4L6FK7MF.js";
+import "../chunk-OECLQ3OT.js";
+import "../chunk-KFWZFQMB.js";
+import "../chunk-PBALVUKK.js";
+import "../chunk-CSAKXWF3.js";
+import "../chunk-ZGYORUAX.js";
+import "../chunk-PNR5G432.js";
+export {
+  createThrottle
+};

package/dist/fn/index.d.ts

@@ -1,5 +1,6 @@
 export { createDebounce } from './create-debounce.js';
 export { createLoopExec } from './create-loop-exec.js';
+export { createThrottle } from './create-throttle.js';
 import '../types/maybe.js';
 import 'solid-js';
 

package/dist/fn/index.js

@@ -1,23 +1,20 @@
 import {
+  createDebounce,
+  createLoopExec,
+  createThrottle,
   noop
-} from "../chunk-2BGAGVTR.js";
-import {
-  createDebounce
-} from "../chunk-H6VUVMSF.js";
-import {
-  createLoopExec
-} from "../chunk-WY5G2PJM.js";
-import "../chunk-ZZNAXGNU.js";
+} from "../chunk-BGLY6NJK.js";
 import "../chunk-M5A3VVYI.js";
 import "../chunk-4L6FK7MF.js";
 import "../chunk-OECLQ3OT.js";
 import "../chunk-KFWZFQMB.js";
-import "../chunk-RRYFZNKE.js";
-import "../chunk-WLQ64SAO.js";
+import "../chunk-PBALVUKK.js";
+import "../chunk-CSAKXWF3.js";
 import "../chunk-ZGYORUAX.js";
 import "../chunk-PNR5G432.js";
 export {
   createDebounce,
   createLoopExec,
+  createThrottle,
   noop
 };

package/dist/index.d.ts

@@ -1,14 +1,20 @@
 export { mountStyle } from './dom/css.js';
 export { createClickOutside } from './event/create-click-outside.js';
+export { createEventListener } from './event/create-event-listener.js';
+export { DocumentEventName, GeneralEventListener, WindowEventName, makeEventListener } from './event/make-event-listener.js';
 export { noop } from './fn/index.js';
-export { iterate, list, range } from './lodash/array.js';
+export { dataIf } from './jsx/attrs.js';
+export { clearArray, iterate, list, range } from './lodash/array.js';
 export { sleep } from './lodash/async.js';
 export { isArray, isClient, isDate, isEmpty, isFloat, isFn, isInt, isNumber, isObject, isPrimitive, isPromise, isString, isSymbol } from './lodash/is.js';
 export { draw, random, shuffle, uid } from './lodash/random.js';
 export { camel, capitalize, dash, pascal, snake, template, title, trim } from './lodash/str.js';
 export { access } from './reactive/access.js';
+export { createDebouncedWatch } from './reactive/create-debounce-watch.js';
 export { createWatch } from './reactive/create-watch.js';
+export { AnyFn, Fn } from './types/fn.js';
 export { MaybeAccessor, MaybeArray, MaybePromise } from './types/maybe.js';
 export { createDebounce } from './fn/create-debounce.js';
 export { createLoopExec } from './fn/create-loop-exec.js';
+export { createThrottle } from './fn/create-throttle.js';
 import 'solid-js';

package/dist/index.js

@@ -1,23 +1,31 @@
-import "./chunk-2BUPSB7O.js";
+import "./chunk-SK6Y2YH6.js";
 import "./chunk-EZML2DEC.js";
+import "./chunk-AZAXMGEB.js";
+import "./chunk-YXRZ2KMJ.js";
+import {
+  dataIf
+} from "./chunk-II6INKPZ.js";
 import "./chunk-FFBJP5FE.js";
 import {
   mountStyle
 } from "./chunk-KVG6TCSE.js";
-import "./chunk-M53KPXWR.js";
+import "./chunk-B6TZK2S5.js";
 import {
   createClickOutside
-} from "./chunk-YJB637I2.js";
+} from "./chunk-NFDGLC4A.js";
 import {
-  noop
-} from "./chunk-2BGAGVTR.js";
+  createEventListener
+} from "./chunk-ILGNNUQK.js";
 import {
-  createDebounce
-} from "./chunk-H6VUVMSF.js";
+  makeEventListener
+} from "./chunk-OUAI75QC.js";
 import {
-  createLoopExec
-} from "./chunk-WY5G2PJM.js";
-import "./chunk-ZZNAXGNU.js";
+  createDebounce,
+  createDebouncedWatch,
+  createLoopExec,
+  createThrottle,
+  noop
+} from "./chunk-BGLY6NJK.js";
 import {
   access
 } from "./chunk-M5A3VVYI.js";
@@ -33,12 +41,13 @@ import {
   random,
   shuffle,
   uid
-} from "./chunk-RRYFZNKE.js";
+} from "./chunk-PBALVUKK.js";
 import {
+  clearArray,
   iterate,
   list,
   range
-} from "./chunk-WLQ64SAO.js";
+} from "./chunk-CSAKXWF3.js";
 import {
   isArray,
   isClient,
@@ -68,11 +77,16 @@ export {
   access,
   camel,
   capitalize,
+  clearArray,
   createClickOutside,
   createDebounce,
+  createDebouncedWatch,
+  createEventListener,
   createLoopExec,
+  createThrottle,
   createWatch,
   dash,
+  dataIf,
   draw,
   isArray,
   isClient,
@@ -89,6 +103,7 @@ export {
   isSymbol,
   iterate,
   list,
+  makeEventListener,
   mountStyle,
   noop,
   pascal,

package/dist/jsx/attrs.d.ts

@@ -0,0 +1,22 @@
+/**
+ * return '' if show is true
+ *
+ * suitable when you want to conditionally apply data attributes
+ *
+ * @example
+ *
+ * ```tsx
+ *
+ * function MyComponent(props:{size:'small'|'medium'|'large'}) {
+ *   return <div
+ *            data-size-small={dataIf(props.size === 'small')}
+ *            data-size-medium={dataIf(props.size === 'medium')}
+ *            data-size-large={dataIf(props.size === 'large')}
+ *            >Hello</div>;
+ * }
+ *
+ * ```
+ */
+declare function dataIf(show: boolean): "" | undefined;
+
+export { dataIf };

package/dist/jsx/attrs.js

@@ -0,0 +1,6 @@
+import {
+  dataIf
+} from "../chunk-II6INKPZ.js";
+export {
+  dataIf
+};

package/dist/jsx/index.d.ts

@@ -0,0 +1 @@
+export { dataIf } from './attrs.js';

package/dist/jsx/index.js

@@ -0,0 +1,7 @@
+import "../chunk-YXRZ2KMJ.js";
+import {
+  dataIf
+} from "../chunk-II6INKPZ.js";
+export {
+  dataIf
+};

package/dist/lodash/array.d.ts

@@ -38,5 +38,9 @@ declare function range<T = number>(startOrLength: number, end?: number, valueOrM
  * list(0, 6, i => i, 2)    // 0, 2, 4, 6
  */
 declare const list: <T = number>(startOrLength: number, end?: number, valueOrMapper?: T | ((i: number) => T), step?: number) => T[];
+/**
+ * set arr.length to 0
+ */
+declare function clearArray<T>(arr: T[]): void;
 
-export { iterate, list, range };
+export { clearArray, iterate, list, range };

package/dist/lodash/array.js

@@ -1,10 +1,12 @@
 import {
+  clearArray,
   iterate,
   list,
   range
-} from "../chunk-WLQ64SAO.js";
+} from "../chunk-CSAKXWF3.js";
 import "../chunk-ZGYORUAX.js";
 export {
+  clearArray,
   iterate,
   list,
   range

package/dist/lodash/index.d.ts

@@ -1,4 +1,4 @@
-export { iterate, list, range } from './array.js';
+export { clearArray, iterate, list, range } from './array.js';
 export { sleep } from './async.js';
 export { isArray, isClient, isDate, isEmpty, isFloat, isFn, isInt, isNumber, isObject, isPrimitive, isPromise, isString, isSymbol } from './is.js';
 export { draw, random, shuffle, uid } from './random.js';

package/dist/lodash/index.js

@@ -7,12 +7,13 @@ import {
   random,
   shuffle,
   uid
-} from "../chunk-RRYFZNKE.js";
+} from "../chunk-PBALVUKK.js";
 import {
+  clearArray,
   iterate,
   list,
   range
-} from "../chunk-WLQ64SAO.js";
+} from "../chunk-CSAKXWF3.js";
 import {
   isArray,
   isClient,
@@ -41,6 +42,7 @@ import {
 export {
   camel,
   capitalize,
+  clearArray,
   dash,
   draw,
   isArray,

package/dist/lodash/random.js

@@ -3,8 +3,8 @@ import {
   random,
   shuffle,
   uid
-} from "../chunk-RRYFZNKE.js";
-import "../chunk-WLQ64SAO.js";
+} from "../chunk-PBALVUKK.js";
+import "../chunk-CSAKXWF3.js";
 import "../chunk-ZGYORUAX.js";
 export {
   draw,

package/dist/reactive/access.js

@@ -3,8 +3,8 @@ import {
 } from "../chunk-M5A3VVYI.js";
 import "../chunk-OECLQ3OT.js";
 import "../chunk-KFWZFQMB.js";
-import "../chunk-RRYFZNKE.js";
-import "../chunk-WLQ64SAO.js";
+import "../chunk-PBALVUKK.js";
+import "../chunk-CSAKXWF3.js";
 import "../chunk-ZGYORUAX.js";
 import "../chunk-PNR5G432.js";
 export {

package/dist/reactive/create-debounce-watch.d.ts

@@ -0,0 +1,12 @@
+import { AccessorArray, Accessor, OnOptions } from 'solid-js';
+
+/**
+ * Creates a debounced watch effect.
+ *
+ * opt.delay - The debounce delay in milliseconds. Default is 10ms.
+ */
+declare function createDebouncedWatch<S, Next extends Prev, Prev = Next>(targets: AccessorArray<S> | Accessor<S>, fn: (input: S, prevInput?: S) => void, opt?: OnOptions & {
+    delay?: number;
+}): void;
+
+export { createDebouncedWatch };

package/dist/reactive/create-debounce-watch.js

@@ -0,0 +1,14 @@
+import {
+  createDebouncedWatch
+} from "../chunk-BGLY6NJK.js";
+import "../chunk-M5A3VVYI.js";
+import "../chunk-4L6FK7MF.js";
+import "../chunk-OECLQ3OT.js";
+import "../chunk-KFWZFQMB.js";
+import "../chunk-PBALVUKK.js";
+import "../chunk-CSAKXWF3.js";
+import "../chunk-ZGYORUAX.js";
+import "../chunk-PNR5G432.js";
+export {
+  createDebouncedWatch
+};

package/dist/reactive/index.d.ts

@@ -1,4 +1,5 @@
 export { access } from './access.js';
+export { createDebouncedWatch } from './create-debounce-watch.js';
 export { createWatch } from './create-watch.js';
 import '../types/maybe.js';
 import 'solid-js';

package/dist/reactive/index.js

@@ -1,4 +1,6 @@
-import "../chunk-ZZNAXGNU.js";
+import {
+  createDebouncedWatch
+} from "../chunk-BGLY6NJK.js";
 import {
   access
 } from "../chunk-M5A3VVYI.js";
@@ -7,11 +9,12 @@ import {
 } from "../chunk-4L6FK7MF.js";
 import "../chunk-OECLQ3OT.js";
 import "../chunk-KFWZFQMB.js";
-import "../chunk-RRYFZNKE.js";
-import "../chunk-WLQ64SAO.js";
+import "../chunk-PBALVUKK.js";
+import "../chunk-CSAKXWF3.js";
 import "../chunk-ZGYORUAX.js";
 import "../chunk-PNR5G432.js";
 export {
   access,
+  createDebouncedWatch,
   createWatch
 };

package/dist/types/fn.d.ts

@@ -1,3 +1,4 @@
 type AnyFn<R = any> = (...args: any[]) => R;
+type Fn = () => void;
 
-export type { AnyFn };
+export type { AnyFn, Fn };

package/dist/types/fn.js

@@ -0,0 +1 @@
+import "../chunk-AZAXMGEB.js";

package/dist/types/index.d.ts

@@ -1,2 +1,3 @@
+export { AnyFn, Fn } from './fn.js';
 export { MaybeAccessor, MaybeArray, MaybePromise } from './maybe.js';
 import 'solid-js';

package/dist/types/index.js

@@ -1,2 +1,3 @@
-import "../chunk-2BUPSB7O.js";
+import "../chunk-SK6Y2YH6.js";
 import "../chunk-EZML2DEC.js";
+import "../chunk-AZAXMGEB.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "solid-tiny-utils",
-  "version": "0.3.0",
+  "version": "0.4.2",
   "description": "A collection of tiny utilities for SolidJS applications",
   "main": "./dist/index.js",
   "type": "module",
@@ -40,7 +40,6 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@solid-primitives/event-listener": "^2.4.3",
     "solid-tiny-context": "0.1.2"
   },
   "scripts": {

package/dist/chunk-2BGAGVTR.js

@@ -1,7 +0,0 @@
-// src/fn/index.ts
-var noop = () => {
-};
-
-export {
-  noop
-};

package/dist/chunk-H6VUVMSF.js

@@ -1,23 +0,0 @@
-import {
-  access
-} from "./chunk-M5A3VVYI.js";
-
-// src/fn/create-debounce.ts
-import { onCleanup } from "solid-js";
-function createDebounce(callback, delay) {
-  let timeoutId;
-  onCleanup(() => {
-    clearTimeout(timeoutId);
-  });
-  const run = (...args) => {
-    clearTimeout(timeoutId);
-    timeoutId = setTimeout(() => {
-      callback(...args);
-    }, access(delay));
-  };
-  return run;
-}
-
-export {
-  createDebounce
-};

package/dist/chunk-WY5G2PJM.js

@@ -1,60 +0,0 @@
-import {
-  access
-} from "./chunk-M5A3VVYI.js";
-import {
-  createWatch
-} from "./chunk-4L6FK7MF.js";
-import {
-  isNumber
-} from "./chunk-ZGYORUAX.js";
-
-// src/fn/create-loop-exec.ts
-import { onCleanup } from "solid-js";
-function createLoopExec(fn, delay) {
-  let shouldStop = false;
-  let isCleanedUp = false;
-  let timer;
-  const execFn = async () => {
-    clearTimeout(timer);
-    const d = access(delay);
-    if (shouldStop || !isNumber(d) || d < 0) {
-      return;
-    }
-    try {
-      await fn();
-    } finally {
-      timer = setTimeout(() => {
-        execFn();
-      }, d);
-    }
-  };
-  createWatch(
-    () => access(delay),
-    () => {
-      execFn();
-    }
-  );
-  const stop = () => {
-    shouldStop = true;
-    clearTimeout(timer);
-  };
-  const start = () => {
-    if (isCleanedUp) {
-      return;
-    }
-    shouldStop = false;
-    execFn();
-  };
-  onCleanup(() => {
-    isCleanedUp = true;
-    stop();
-  });
-  return {
-    stop,
-    start
-  };
-}
-
-export {
-  createLoopExec
-};

package/dist/chunk-YJB637I2.js

@@ -1,29 +0,0 @@
-import {
-  access
-} from "./chunk-M5A3VVYI.js";
-
-// src/event/create-click-outside.ts
-import { makeEventListener } from "@solid-primitives/event-listener";
-function createClickOutside(target, handler, options) {
-  const listener = (e) => {
-    const el = access(target);
-    if (!el || el.contains(e.target)) {
-      return;
-    }
-    if (options?.ignore) {
-      for (const item of options.ignore) {
-        const ignoreEl = access(item);
-        if (ignoreEl && (ignoreEl === e.target || ignoreEl.contains(e.target))) {
-          return;
-        }
-      }
-    }
-    handler(e);
-  };
-  makeEventListener(document, "click", listener);
-  makeEventListener(document, "touchstart", listener);
-}
-
-export {
-  createClickOutside
-};