@percuss.io/utils 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Eric L Carraway
+
+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

@@ -0,0 +1 @@
+# https://www.npmjs.com/package/@percuss.io/utils

package/dist/chunk-2J4AIXWB.js

@@ -0,0 +1,8 @@
+'use strict';
+
+// src/isNonEmptyObj/isNonEmptyObj.ts
+function isNonEmptyObj(value) {
+  return value !== null && typeof value === `object` && !Array.isArray(value) && Object.keys(value).length > 0;
+}
+
+exports.isNonEmptyObj = isNonEmptyObj;

package/dist/chunk-55RT75P2.mjs

@@ -0,0 +1,11 @@
+// src/shuffleArray/shuffleArray.ts
+function shuffleArray(array) {
+  const clonedArr = [...array];
+  for (let i = clonedArr.length - 1; i > 0; i -= 1) {
+    const j = Math.floor(Math.random() * (i + 1));
+    [clonedArr[i], clonedArr[j]] = [clonedArr[j], clonedArr[i]];
+  }
+  return clonedArr;
+}
+
+export { shuffleArray };

package/dist/chunk-5XK774RW.mjs

@@ -0,0 +1,6 @@
+// src/isNonEmptyObj/isNonEmptyObj.ts
+function isNonEmptyObj(value) {
+  return value !== null && typeof value === `object` && !Array.isArray(value) && Object.keys(value).length > 0;
+}
+
+export { isNonEmptyObj };

package/dist/chunk-S6VKMDVX.js

@@ -0,0 +1,13 @@
+'use strict';
+
+// src/shuffleArray/shuffleArray.ts
+function shuffleArray(array) {
+  const clonedArr = [...array];
+  for (let i = clonedArr.length - 1; i > 0; i -= 1) {
+    const j = Math.floor(Math.random() * (i + 1));
+    [clonedArr[i], clonedArr[j]] = [clonedArr[j], clonedArr[i]];
+  }
+  return clonedArr;
+}
+
+exports.shuffleArray = shuffleArray;

package/dist/chunk-TZ3Z56CI.js

@@ -0,0 +1,15 @@
+'use strict';
+
+// src/sleep/sleep.ts
+function sleep(millis) {
+  if (typeof millis !== `number` || !Number.isFinite(millis) || millis < 0) {
+    throw new TypeError(
+      `sleep(millis): expected a non-negative finite number, got ${millis}`
+    );
+  }
+  return new Promise((resolve) => {
+    globalThis.setTimeout(resolve, millis);
+  });
+}
+
+exports.sleep = sleep;

package/dist/chunk-WEF2NP5F.mjs

@@ -0,0 +1,13 @@
+// src/sleep/sleep.ts
+function sleep(millis) {
+  if (typeof millis !== `number` || !Number.isFinite(millis) || millis < 0) {
+    throw new TypeError(
+      `sleep(millis): expected a non-negative finite number, got ${millis}`
+    );
+  }
+  return new Promise((resolve) => {
+    globalThis.setTimeout(resolve, millis);
+  });
+}
+
+export { sleep };

package/dist/index.d.mts

@@ -0,0 +1,3 @@
+export { isNonEmptyObj } from './isNonEmptyObj/isNonEmptyObj.mjs';
+export { shuffleArray } from './shuffleArray/shuffleArray.mjs';
+export { sleep } from './sleep/sleep.mjs';

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { isNonEmptyObj } from './isNonEmptyObj/isNonEmptyObj.js';
+export { shuffleArray } from './shuffleArray/shuffleArray.js';
+export { sleep } from './sleep/sleep.js';

package/dist/index.js

@@ -0,0 +1,20 @@
+'use strict';
+
+var chunk2J4AIXWB_js = require('./chunk-2J4AIXWB.js');
+var chunkS6VKMDVX_js = require('./chunk-S6VKMDVX.js');
+var chunkTZ3Z56CI_js = require('./chunk-TZ3Z56CI.js');
+
+
+
+Object.defineProperty(exports, "isNonEmptyObj", {
+  enumerable: true,
+  get: function () { return chunk2J4AIXWB_js.isNonEmptyObj; }
+});
+Object.defineProperty(exports, "shuffleArray", {
+  enumerable: true,
+  get: function () { return chunkS6VKMDVX_js.shuffleArray; }
+});
+Object.defineProperty(exports, "sleep", {
+  enumerable: true,
+  get: function () { return chunkTZ3Z56CI_js.sleep; }
+});

package/dist/index.mjs

@@ -0,0 +1,3 @@
+export { isNonEmptyObj } from './chunk-5XK774RW.mjs';
+export { shuffleArray } from './chunk-55RT75P2.mjs';
+export { sleep } from './chunk-WEF2NP5F.mjs';

package/dist/isNonEmptyObj/isNonEmptyObj.d.mts

@@ -0,0 +1,22 @@
+/**
+ * Validates if a value is a non-empty object (not null, not an array, has at least one property).
+ *
+ * @param value - The value to check
+ * @returns True if the value is a non-null object with at least one property
+ *
+ * @example
+ * // Returns true
+ * isNonEmptyObj({ foo: 'bar' });
+ *
+ * @example
+ * // Returns false
+ * isNonEmptyObj({});
+ * isNonEmptyObj(null);
+ * isNonEmptyObj(undefined);
+ * isNonEmptyObj([]);
+ * isNonEmptyObj('string');
+ * isNonEmptyObj(123);
+ */
+declare function isNonEmptyObj(value: unknown): value is Record<string, unknown>;
+
+export { isNonEmptyObj };

package/dist/isNonEmptyObj/isNonEmptyObj.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Validates if a value is a non-empty object (not null, not an array, has at least one property).
+ *
+ * @param value - The value to check
+ * @returns True if the value is a non-null object with at least one property
+ *
+ * @example
+ * // Returns true
+ * isNonEmptyObj({ foo: 'bar' });
+ *
+ * @example
+ * // Returns false
+ * isNonEmptyObj({});
+ * isNonEmptyObj(null);
+ * isNonEmptyObj(undefined);
+ * isNonEmptyObj([]);
+ * isNonEmptyObj('string');
+ * isNonEmptyObj(123);
+ */
+declare function isNonEmptyObj(value: unknown): value is Record<string, unknown>;
+
+export { isNonEmptyObj };

package/dist/isNonEmptyObj/isNonEmptyObj.js

@@ -0,0 +1,10 @@
+'use strict';
+
+var chunk2J4AIXWB_js = require('../chunk-2J4AIXWB.js');
+
+
+
+Object.defineProperty(exports, "isNonEmptyObj", {
+  enumerable: true,
+  get: function () { return chunk2J4AIXWB_js.isNonEmptyObj; }
+});

package/dist/isNonEmptyObj/isNonEmptyObj.mjs

@@ -0,0 +1 @@
+export { isNonEmptyObj } from '../chunk-5XK774RW.mjs';

package/dist/shuffleArray/shuffleArray.d.mts

@@ -0,0 +1,9 @@
+/**
+ * The Fisher-Yates (also known as Knuth) shuffle algorithm.
+ * Returns a shuffled copy of the input array.
+ * @param array The array to shuffle
+ * @returns A new shuffled array
+ */
+declare function shuffleArray<T>(array: readonly T[]): T[];
+
+export { shuffleArray };

package/dist/shuffleArray/shuffleArray.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The Fisher-Yates (also known as Knuth) shuffle algorithm.
+ * Returns a shuffled copy of the input array.
+ * @param array The array to shuffle
+ * @returns A new shuffled array
+ */
+declare function shuffleArray<T>(array: readonly T[]): T[];
+
+export { shuffleArray };

package/dist/shuffleArray/shuffleArray.js

@@ -0,0 +1,10 @@
+'use strict';
+
+var chunkS6VKMDVX_js = require('../chunk-S6VKMDVX.js');
+
+
+
+Object.defineProperty(exports, "shuffleArray", {
+  enumerable: true,
+  get: function () { return chunkS6VKMDVX_js.shuffleArray; }
+});

package/dist/shuffleArray/shuffleArray.mjs

@@ -0,0 +1 @@
+export { shuffleArray } from '../chunk-55RT75P2.mjs';

package/dist/sleep/sleep.d.mts

@@ -0,0 +1,11 @@
+/**
+ * Sleep for the specified number of milliseconds.
+ *
+ * @example
+ * ```ts
+ * await sleep(1000); // waits for 1 second
+ * ```
+ */
+declare function sleep(millis: number): Promise<void>;
+
+export { sleep };

package/dist/sleep/sleep.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Sleep for the specified number of milliseconds.
+ *
+ * @example
+ * ```ts
+ * await sleep(1000); // waits for 1 second
+ * ```
+ */
+declare function sleep(millis: number): Promise<void>;
+
+export { sleep };

package/dist/sleep/sleep.js

@@ -0,0 +1,10 @@
+'use strict';
+
+var chunkTZ3Z56CI_js = require('../chunk-TZ3Z56CI.js');
+
+
+
+Object.defineProperty(exports, "sleep", {
+  enumerable: true,
+  get: function () { return chunkTZ3Z56CI_js.sleep; }
+});

package/dist/sleep/sleep.mjs

@@ -0,0 +1 @@
+export { sleep } from '../chunk-WEF2NP5F.mjs';

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@percuss.io/utils",
+  "version": "0.0.1",
+  "description": "utils",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./isNonEmptyObj": {
+      "types": "./dist/isNonEmptyObj/isNonEmptyObj.d.ts",
+      "import": "./dist/isNonEmptyObj/isNonEmptyObj.js",
+      "require": "./dist/isNonEmptyObj/isNonEmptyObj.cjs"
+    },
+    "./shuffleArray": {
+      "types": "./dist/shuffleArray/shuffleArray.d.ts",
+      "import": "./dist/shuffleArray/shuffleArray.js",
+      "require": "./dist/shuffleArray/shuffleArray.cjs"
+    },
+    "./sleep": {
+      "types": "./dist/sleep/sleep.d.ts",
+      "import": "./dist/sleep/sleep.js",
+      "require": "./dist/sleep/sleep.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "lint": "eslint src",
+    "prerelease": "./scripts/prerelease.sh",
+    "shipit": "./scripts/publish.sh",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/percuss-io/utils.git"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "type": "commonjs",
+  "bugs": {
+    "url": "https://github.com/percuss-io/utils/issues"
+  },
+  "homepage": "https://github.com/percuss-io/utils#readme",
+  "devDependencies": {
+    "@eslint/js": "^9.25.0",
+    "@percuss.io/eslint-config-ericcarraway": "5.0.1-beta.14",
+    "@stylistic/eslint-plugin": "^4.2.0",
+    "@types/node": "^22.14.1",
+    "eslint-plugin-import": "^2.31.0",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "eslint-plugin-sort-destructure-keys": "^2.0.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.30.1",
+    "vitest": "^3.1.1"
+  }
+}