@reliverse/rempts 1.7.10 → 1.7.11

package/bin/hooks/spinner/spinner-mod.d.ts

@@ -1,20 +1,64 @@
+import { type Color, type Options as OraOptions } from "ora";
 type SpinnerOptions = {
     text: string;
+    color?: Color;
+    spinner?: OraOptions["spinner"];
+    successText?: string;
+    failText?: string;
 };
 type SpinnerControls = {
-    start: () => SpinnerControls;
+    start: (text?: string) => SpinnerControls;
     stop: () => void;
     setText: (text: string) => void;
+    succeed: (text?: string) => void;
+    fail: (text?: string) => void;
+    warn: (text?: string) => void;
+    info: (text?: string) => void;
+    isSpinning: () => boolean;
+    clear: () => void;
 };
 /**
- * Creates a terminal spinner.
+ * Creates a terminal spinner with enhanced controls and styling options.
  *
  * @example
- * \`\`\`typescript
- * const spinner = useSpinner({ text: "preparing something..." }).start();
- * // user's code
+ * ```typescript
+ * // Basic usage
+ * const spinner = useSpinner({ text: "Loading..." }).start();
  * spinner.stop();
- * \`\`\`
+ *
+ * // With custom color and spinner
+ * const spinner = useSpinner({
+ *   text: "Processing...",
+ *   color: "cyan",
+ *   spinner: "dots"
+ * }).start();
+ *
+ * // With success/failure states
+ * const spinner = useSpinner({
+ *   text: "Uploading...",
+ *   successText: "Upload complete!",
+ *   failText: "Upload failed!"
+ * }).start();
+ * try {
+ *   await uploadFile();
+ *   spinner.succeed();
+ * } catch (error) {
+ *   spinner.fail();
+ * }
+ *
+ * // Using the wrapper for async operations
+ * await useSpinner.promise(
+ *   async () => { await longOperation(); },
+ *   {
+ *     text: "Working...",
+ *     successText: "Done!",
+ *     failText: "Failed!"
+ *   }
+ * );
+ * ```
  */
 export declare function useSpinner(options: SpinnerOptions): SpinnerControls;
+export declare namespace useSpinner {
+    var promise: <T>(operation: () => Promise<T>, options: SpinnerOptions) => Promise<T>;
+}
 export {};

package/bin/hooks/spinner/spinner-mod.js

@@ -2,9 +2,18 @@ import ora from "ora";
 export function useSpinner(options) {
   let spinnerInstance = null;
   const controls = {
-    start: () => {
+    start: (text) => {
+      if (text) {
+        options.text = text;
+      }
       if (!spinnerInstance) {
-        spinnerInstance = ora(options.text);
+        spinnerInstance = ora({
+          text: options.text,
+          color: options.color,
+          spinner: options.spinner
+        });
+      } else {
+        spinnerInstance.text = options.text;
       }
       spinnerInstance.start();
       return controls;
@@ -20,7 +29,46 @@ export function useSpinner(options) {
       } else {
         options.text = text;
       }
+    },
+    succeed: (text) => {
+      if (spinnerInstance) {
+        spinnerInstance.succeed(text ?? options.successText);
+      }
+    },
+    fail: (text) => {
+      if (spinnerInstance) {
+        spinnerInstance.fail(text ?? options.failText);
+      }
+    },
+    warn: (text) => {
+      if (spinnerInstance) {
+        spinnerInstance.warn(text);
+      }
+    },
+    info: (text) => {
+      if (spinnerInstance) {
+        spinnerInstance.info(text);
+      }
+    },
+    isSpinning: () => {
+      return spinnerInstance?.isSpinning ?? false;
+    },
+    clear: () => {
+      if (spinnerInstance) {
+        spinnerInstance.clear();
+      }
     }
   };
   return controls;
 }
+useSpinner.promise = async (operation, options) => {
+  const spinner = useSpinner(options).start();
+  try {
+    const result = await operation();
+    spinner.succeed();
+    return result;
+  } catch (error) {
+    spinner.fail();
+    throw error;
+  }
+};

package/package.json

@@ -28,7 +28,7 @@
   "license": "MIT",
   "name": "@reliverse/rempts",
   "type": "module",
-  "version": "1.7.10",
+  "version": "1.7.11",
   "author": "reliverse",
   "bugs": {
     "email": "blefnk@gmail.com",
@@ -44,7 +44,7 @@
   "devDependencies": {
     "@biomejs/biome": "1.9.4",
     "@eslint/js": "^9.26.0",
-    "@reliverse/dler": "^1.2.4",
+    "@reliverse/dler": "^1.2.5",
     "@reliverse/relidler-cfg": "^1.1.3",
     "@stylistic/eslint-plugin": "^4.2.0",
     "@total-typescript/ts-reset": "^0.6.1",