solid-tiny-utils 0.4.2 → 0.6.0

package/dist/types/maybe.d.ts

@@ -3,5 +3,6 @@ import { Accessor } from 'solid-js';
 type MaybeArray<T> = T | T[];
 type MaybePromise<T> = T | Promise<T>;
 type MaybeAccessor<T> = T | Accessor<T>;
+type MaybeNullableAccessor<T> = T | Accessor<T | null | undefined>;
 
-export type { MaybeAccessor, MaybeArray, MaybePromise };
+export type { MaybeAccessor, MaybeArray, MaybeNullableAccessor, MaybePromise };

package/dist/{lodash → utils}/array.js

@@ -3,8 +3,8 @@ import {
   iterate,
   list,
   range
-} from "../chunk-CSAKXWF3.js";
-import "../chunk-ZGYORUAX.js";
+} from "../chunk-BT47ISVC.js";
+import "../chunk-6G7GFZV2.js";
 export {
   clearArray,
   iterate,

package/dist/{lodash → utils}/async.js

@@ -1,6 +1,6 @@
 import {
   sleep
-} from "../chunk-KFWZFQMB.js";
+} from "../chunk-KKFGUHFR.js";
 export {
   sleep
 };

package/dist/{lodash → utils}/index.d.ts

@@ -1,5 +1,6 @@
 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 { clamp, inRange, max, min, toHex } from './number.js';
 export { draw, random, shuffle, uid } from './random.js';
 export { camel, capitalize, dash, pascal, snake, template, title, trim } from './str.js';

package/dist/{lodash → utils}/index.js

@@ -1,19 +1,29 @@
-import "../chunk-OECLQ3OT.js";
-import {
-  sleep
-} from "../chunk-KFWZFQMB.js";
+import "../chunk-U5LQ2AS5.js";
 import {
   draw,
   random,
   shuffle,
   uid
-} from "../chunk-PBALVUKK.js";
+} from "../chunk-QQVSG76Z.js";
+import {
+  camel,
+  capitalize,
+  dash,
+  pascal,
+  snake,
+  template,
+  title,
+  trim
+} from "../chunk-Y4GYGFIT.js";
 import {
   clearArray,
   iterate,
   list,
   range
-} from "../chunk-CSAKXWF3.js";
+} from "../chunk-BT47ISVC.js";
+import {
+  sleep
+} from "../chunk-KKFGUHFR.js";
 import {
   isArray,
   isClient,
@@ -28,23 +38,22 @@ import {
   isPromise,
   isString,
   isSymbol
-} from "../chunk-ZGYORUAX.js";
+} from "../chunk-6G7GFZV2.js";
 import {
-  camel,
-  capitalize,
-  dash,
-  pascal,
-  snake,
-  template,
-  title,
-  trim
-} from "../chunk-PNR5G432.js";
+  clamp,
+  inRange,
+  max,
+  min,
+  toHex
+} from "../chunk-PD6VHMH6.js";
 export {
   camel,
   capitalize,
+  clamp,
   clearArray,
   dash,
   draw,
+  inRange,
   isArray,
   isClient,
   isDate,
@@ -60,6 +69,8 @@ export {
   isSymbol,
   iterate,
   list,
+  max,
+  min,
   pascal,
   random,
   range,
@@ -68,6 +79,7 @@ export {
   snake,
   template,
   title,
+  toHex,
   trim,
   uid
 };

package/dist/{lodash → utils}/is.js

@@ -12,7 +12,7 @@ import {
   isPromise,
   isString,
   isSymbol
-} from "../chunk-ZGYORUAX.js";
+} from "../chunk-6G7GFZV2.js";
 export {
   isArray,
   isClient,

package/dist/utils/number.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Returns the smallest of the given numbers.
+ *
+ * This is a convenience wrapper around `Math.min` that provides better type safety
+ * and consistency with other utility functions.
+ *
+ * @param numbers - The numbers to compare
+ * @returns The smallest number from the input
+ *
+ * @example
+ * ```typescript
+ * min(1, 2, 3) // => 1
+ * min(-5, 0, 10) // => -5
+ * min(3.14, 2.71, 1.41) // => 1.41
+ * ```
+ */
+declare function min(...numbers: number[]): number;
+/**
+ * Returns the largest of the given numbers.
+ *
+ * This is a convenience wrapper around `Math.max` that provides better type safety
+ * and consistency with other utility functions.
+ *
+ * @param numbers - The numbers to compare
+ * @returns The largest number from the input
+ *
+ * @example
+ * ```typescript
+ * max(1, 2, 3) // => 3
+ * max(-5, 0, 10) // => 10
+ * max(3.14, 2.71, 1.41) // => 3.14
+ * ```
+ */
+declare function max(...numbers: number[]): number;
+/**
+ * Clamps a number to within the specified bounds.
+ *
+ * If the number is less than the minimum, returns the minimum.
+ * If the number is greater than the maximum, returns the maximum.
+ * Otherwise, returns the number unchanged.
+ *
+ * @param x - The number to clamp
+ * @param minimum - The lower bound (inclusive)
+ * @param maximum - The upper bound (inclusive)
+ * @returns The clamped number
+ *
+ * @example
+ * ```typescript
+ * clamp(0.5) // => 0.5 (within default 0-1 range)
+ * clamp(-0.1) // => 0 (clamped to minimum)
+ * clamp(1.5) // => 1 (clamped to maximum)
+ * clamp(15, 10, 20) // => 15 (within range)
+ * clamp(5, 10, 20) // => 10 (clamped to minimum)
+ * clamp(25, 10, 20) // => 20 (clamped to maximum)
+ * ```
+ */
+declare function clamp(x: number, minimum?: number, maximum?: number): number;
+/**
+ * Checks if a number is within a specified range.
+ *
+ * Supports different inclusivity modes:
+ * - `'[]'` - Both bounds inclusive (default): `minimum ≤ x ≤ maximum`
+ * - `'()'` - Both bounds exclusive: `minimum < x < maximum`
+ * - `'[)'` - Lower inclusive, upper exclusive: `minimum ≤ x < maximum`
+ * - `'(]'` - Lower exclusive, upper inclusive: `minimum < x ≤ maximum`
+ *
+ * @param x - The number to check
+ * @param minimum - The lower bound of the range
+ * @param maximum - The upper bound of the range
+ * @param inclusivity - Specifies whether the bounds are inclusive or exclusive
+ * @returns `true` if the number is within the range, `false` otherwise
+ *
+ * @example
+ * ```typescript
+ * // Default inclusive range [0, 1]
+ * inRange(0.5) // => true
+ * inRange(0) // => true (inclusive)
+ * inRange(1) // => true (inclusive)
+ * inRange(-0.1) // => false
+ * inRange(1.1) // => false
+ *
+ * // Custom range [10, 20]
+ * inRange(15, 10, 20) // => true
+ * inRange(10, 10, 20) // => true (inclusive)
+ * inRange(20, 10, 20) // => true (inclusive)
+ *
+ * // Exclusive bounds (10, 20)
+ * inRange(15, 10, 20, '()') // => true
+ * inRange(10, 10, 20, '()') // => false (exclusive)
+ * inRange(20, 10, 20, '()') // => false (exclusive)
+ *
+ * // Mixed inclusivity [10, 20)
+ * inRange(10, 10, 20, '[)') // => true (lower inclusive)
+ * inRange(20, 10, 20, '[)') // => false (upper exclusive)
+ * ```
+ */
+declare function inRange(x: number, minimum?: number, maximum?: number, inclusivity?: '()' | '[]' | '[)' | '(]'): boolean;
+/**
+ * Converts a number to a hexadecimal string.
+ *
+ * @param x - The number to convert
+ * @param pad - The number of digits to pad the output with (default: 2)
+ * @returns The hexadecimal representation of the number
+ *
+ * @example
+ * ```typescript
+ * toHEX(255) // => "ff"
+ * toHEX(255, 4) // => "00ff"
+ * ```
+ */
+declare function toHex(x: number, pad?: number): string;
+
+export { clamp, inRange, max, min, toHex };

package/dist/utils/number.js

@@ -0,0 +1,14 @@
+import {
+  clamp,
+  inRange,
+  max,
+  min,
+  toHex
+} from "../chunk-PD6VHMH6.js";
+export {
+  clamp,
+  inRange,
+  max,
+  min,
+  toHex
+};

package/dist/utils/object.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Get entries of an object
+ */
+declare const entries: <T extends object>(obj: T) => [keyof T, T[keyof T]][];
+/**
+ * Get keys of an object
+ */
+declare const keys: <T extends object>(object: T) => (keyof T)[];
+
+export { entries, keys };

package/dist/utils/object.js

@@ -0,0 +1,7 @@
+// src/utils/object.ts
+var entries = Object.entries;
+var keys = Object.keys;
+export {
+  entries,
+  keys
+};

package/dist/utils/random.js

@@ -0,0 +1,14 @@
+import {
+  draw,
+  random,
+  shuffle,
+  uid
+} from "../chunk-QQVSG76Z.js";
+import "../chunk-BT47ISVC.js";
+import "../chunk-6G7GFZV2.js";
+export {
+  draw,
+  random,
+  shuffle,
+  uid
+};

package/dist/{lodash → utils}/str.js

@@ -7,7 +7,7 @@ import {
   template,
   title,
   trim
-} from "../chunk-PNR5G432.js";
+} from "../chunk-Y4GYGFIT.js";
 export {
   camel,
   capitalize,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "solid-tiny-utils",
-  "version": "0.4.2",
+  "version": "0.6.0",
   "description": "A collection of tiny utilities for SolidJS applications",
   "main": "./dist/index.js",
   "type": "module",
@@ -12,21 +12,25 @@
     "solid-js": "^1.9.7"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.1.2",
+    "@biomejs/biome": "2.2.0",
+    "@solidjs/router": "^0.15.3",
     "@solidjs/testing-library": "^0.8.10",
     "@testing-library/jest-dom": "^6.6.4",
     "@testing-library/user-event": "^14.6.1",
+    "@types/culori": "^4.0.0",
     "@types/node": "^24.2.1",
     "@vitest/ui": "^3.2.4",
     "commit-and-tag-version": "^12.5.1",
+    "culori": "^4.0.2",
     "husky": "^9.1.7",
     "jsdom": "^26.1.0",
     "tsup": "^8.5.0",
     "typescript": "^5.8.3",
-    "ultracite": "5.1.2",
+    "ultracite": "5.2.2",
     "unocss": "^66.3.3",
     "vite": "^6.2.1",
     "vite-plugin-solid": "^2.11.0",
+    "vite-plugin-solid-pages": "^0.3.4",
     "vitest": "^3.2.4"
   },
   "keywords": [
@@ -44,16 +48,14 @@
   },
   "scripts": {
     "build": "tsup",
-    "dev": "vite",
-    "test": "vitest",
+    "dev": "vite -c ./playground/vite.config.ts",
+    "test": "vitest --run",
     "clean": "rimraf dist node_modules pnpm-lock.yaml",
-    "test:run": "vitest --run",
     "test:ui": "vitest --ui",
-    "test:coverage": "vitest --coverage",
     "lint": "npx ultracite lint",
     "lint:fix": "npx ultracite format",
     "type-check": "tsc --noEmit --skipLibCheck",
-    "release": "pnpm type-check && pnpm lint:fix && pnpm test:run && commit-and-tag-version -i CHANGELOG.md --same-file",
+    "release": "pnpm type-check && pnpm lint:fix && pnpm test && commit-and-tag-version -i CHANGELOG.md --same-file",
     "pub": "pnpm build && pnpm publish"
   }
 }

package/dist/lodash/random.js

@@ -1,14 +0,0 @@
-import {
-  draw,
-  random,
-  shuffle,
-  uid
-} from "../chunk-PBALVUKK.js";
-import "../chunk-CSAKXWF3.js";
-import "../chunk-ZGYORUAX.js";
-export {
-  draw,
-  random,
-  shuffle,
-  uid
-};