solid-tiny-utils 0.2.0 → 0.4.0

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-YJB637I2.js → chunk-HPKVQC7S.js}

@@ -1,9 +1,11 @@
+import {
+  makeEventListener
+} from "./chunk-OUAI75QC.js";
 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);
@@ -20,8 +22,7 @@ function createClickOutside(target, handler, options) {
     }
     handler(e);
   };
-  makeEventListener(document, "click", listener);
-  makeEventListener(document, "touchstart", listener);
+  makeEventListener(document, ["click", "touchstart"], listener);
 }
 
 export {

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-KFWZFQMB.js

@@ -0,0 +1,8 @@
+// src/lodash/async.ts
+var sleep = (milliseconds) => {
+  return new Promise((res) => setTimeout(res, milliseconds));
+};
+
+export {
+  sleep
+};

package/dist/chunk-KLRTXD4R.js

@@ -0,0 +1,53 @@
+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
+import { onCleanup } from "solid-js";
+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));
+    }
+  );
+  onCleanup(cleanup);
+  return cleanup;
+}
+
+export {
+  createEventListener
+};

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/chunk-PNR5G432.js

@@ -0,0 +1,85 @@
+// src/lodash/str.ts
+var capitalize = (str) => {
+  if (!str || str.length === 0) {
+    return "";
+  }
+  const lower = str.toLowerCase();
+  return lower.substring(0, 1).toUpperCase() + lower.substring(1, lower.length);
+};
+var splitRegexp = /(?=[A-Z])|[.\-\s_]/;
+var camel = (str) => {
+  const parts = str?.replace(/([A-Z])+/g, capitalize)?.split(splitRegexp).map((x) => x.toLowerCase()) ?? [];
+  if (parts.length === 0) {
+    return "";
+  }
+  if (parts.length === 1) {
+    return parts[0];
+  }
+  return parts.reduce((acc, part) => {
+    return `${acc}${part.charAt(0).toUpperCase()}${part.slice(1)}`;
+  });
+};
+var splitOnNumberRegexp = /([A-Za-z]{1}[0-9]{1})/;
+var snake = (str, options) => {
+  const parts = str?.replace(/([A-Z])+/g, capitalize).split(splitRegexp).map((x) => x.toLowerCase()) ?? [];
+  if (parts.length === 0) {
+    return "";
+  }
+  if (parts.length === 1) {
+    return parts[0];
+  }
+  const result = parts.reduce((acc, part) => {
+    return `${acc}_${part.toLowerCase()}`;
+  });
+  return options?.splitOnNumber === false ? result : result.replace(splitOnNumberRegexp, (val) => `${val[0]}_${val[1]}`);
+};
+var dash = (str) => {
+  const parts = str?.replace(/([A-Z])+/g, capitalize)?.split(splitRegexp).map((x) => x.toLowerCase()) ?? [];
+  if (parts.length === 0) {
+    return "";
+  }
+  if (parts.length === 1) {
+    return parts[0];
+  }
+  return parts.reduce((acc, part) => {
+    return `${acc}-${part.toLowerCase()}`;
+  });
+};
+var pascalSplitRegexp = /[.\-\s_]/;
+var pascal = (str) => {
+  const parts = str?.split(pascalSplitRegexp).map((x) => x.toLowerCase()) ?? [];
+  if (parts.length === 0) {
+    return "";
+  }
+  return parts.map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join("");
+};
+var title = (str) => {
+  if (!str) {
+    return "";
+  }
+  return str.split(splitRegexp).map((s) => s.trim()).filter((s) => !!s).map((s) => capitalize(s.toLowerCase())).join(" ");
+};
+var template = (str, data, regex = /\{\{(.+?)\}\}/g) => {
+  return Array.from(str.matchAll(regex)).reduce((acc, match) => {
+    return acc.replace(match[0], data[match[1]]);
+  }, str);
+};
+var trim = (str, charsToTrim = " ") => {
+  if (!str) {
+    return "";
+  }
+  const toTrim = charsToTrim.replace(/[\W]{1}/g, "\\$&");
+  const regex = new RegExp(`^[${toTrim}]+|[${toTrim}]+$`, "g");
+  return str.replace(regex, "");
+};
+
+export {
+  capitalize,
+  camel,
+  snake,
+  dash,
+  pascal,
+  title,
+  template,
+  trim
+};

package/dist/dom/css.js

@@ -1,10 +1,12 @@
 import {
   mountStyle
 } from "../chunk-KVG6TCSE.js";
-import "../chunk-33ZRZ4S2.js";
-import "../chunk-RRYFZNKE.js";
-import "../chunk-WLQ64SAO.js";
+import "../chunk-OECLQ3OT.js";
+import "../chunk-PBALVUKK.js";
+import "../chunk-PNR5G432.js";
+import "../chunk-CSAKXWF3.js";
 import "../chunk-ZGYORUAX.js";
+import "../chunk-KFWZFQMB.js";
 export {
   mountStyle
 };

package/dist/dom/index.js

@@ -2,10 +2,12 @@ import "../chunk-FFBJP5FE.js";
 import {
   mountStyle
 } from "../chunk-KVG6TCSE.js";
-import "../chunk-33ZRZ4S2.js";
-import "../chunk-RRYFZNKE.js";
-import "../chunk-WLQ64SAO.js";
+import "../chunk-OECLQ3OT.js";
+import "../chunk-PBALVUKK.js";
+import "../chunk-PNR5G432.js";
+import "../chunk-CSAKXWF3.js";
 import "../chunk-ZGYORUAX.js";
+import "../chunk-KFWZFQMB.js";
 export {
   mountStyle
 };

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

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

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-KLRTXD4R.js";
+import "../chunk-OUAI75QC.js";
+import "../chunk-BGLY6NJK.js";
+import "../chunk-M5A3VVYI.js";
+import "../chunk-4L6FK7MF.js";
+import "../chunk-OECLQ3OT.js";
+import "../chunk-PBALVUKK.js";
+import "../chunk-PNR5G432.js";
+import "../chunk-CSAKXWF3.js";
+import "../chunk-ZGYORUAX.js";
+import "../chunk-KFWZFQMB.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,14 +1,24 @@
-import "../chunk-M53KPXWR.js";
+import "../chunk-B6TZK2S5.js";
 import {
   createClickOutside
-} from "../chunk-YJB637I2.js";
-import "../chunk-ZZNAXGNU.js";
+} from "../chunk-HPKVQC7S.js";
+import {
+  createEventListener
+} from "../chunk-KLRTXD4R.js";
+import {
+  makeEventListener
+} from "../chunk-OUAI75QC.js";
+import "../chunk-BGLY6NJK.js";
 import "../chunk-M5A3VVYI.js";
 import "../chunk-4L6FK7MF.js";
-import "../chunk-33ZRZ4S2.js";
-import "../chunk-RRYFZNKE.js";
-import "../chunk-WLQ64SAO.js";
+import "../chunk-OECLQ3OT.js";
+import "../chunk-PBALVUKK.js";
+import "../chunk-PNR5G432.js";
+import "../chunk-CSAKXWF3.js";
 import "../chunk-ZGYORUAX.js";
+import "../chunk-KFWZFQMB.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-PBALVUKK.js";
+import "../chunk-PNR5G432.js";
+import "../chunk-CSAKXWF3.js";
+import "../chunk-ZGYORUAX.js";
+import "../chunk-KFWZFQMB.js";
+export {
+  makeEventListener
+};

package/dist/fn/create-debounce.js

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