fixed bugs

Author: indianmodassir

.github/workflows/npm-publish.yml

@@ -30,6 +30,6 @@ jobs:
         run: npm run build
 
       - name: Publish to npm
-        run: npm publish
+        run: npm publish --provenance --access public
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_ACCESS_TOKEN }}

CHANGELOG.md

@@ -1,8 +1,13 @@
 # Release Notes
 
+## [v2.0.2](https://github.com/jsvibe/printfy/compare/v2.0.1...v2.0.2) - 01 August 2025
+
+Update `README.md` to Enhance more documentatio. [@indianmodassir](https://github.com/indianmodassir)
+Fix bugs, `vprintf` and `vsprintf` was not proper working throwing argument error. we fixed it, [@indianmodassir](https://github.com/indianmodassir) 
+
 ## [v2.0.0](https://github.com/jsvibe/printfy/compare/v1.0.0...v2.0.0) - 01 August 2025
 
 * Rename `sprint` method to `sprintf` in `printfy` module to better reflect its functionality. [@indianmodassir](https://github.com/indianmodassir)
 * Rename `vsprint` method to `vsprintf` in `printfy` module to better reflect its functionality. [@indianmodassir](https://github.com/indianmodassir)
 * Add `vprintf` in `printfy` for formatted output using variable arguments. [@indianmodassir](https://github.com/indianmodassir)
-* Fix bugs specifier `%%` was not proper working. [@indianmodassir](https://github.com/indianmodassir)
+* Fix bugs, specifier `%%` was not proper working. [@indianmodassir](https://github.com/indianmodassir)

README.md

@@ -11,7 +11,7 @@ A lightweight JavaScript library implements C-style `printf` functionality.
 
 ## 🌟 Features
 
-- Fully functional `printf`, `sprint`, and `vsprint` methods.
+- Fully functional `printf`, `sprintf`, and `vsprintf` methods.
 - C-style format specifiers support:
   - `%d`, `%f`, `%s`, `%x`, `%b`, `%o`, `%u`, `%c`, `%e`, `%g`, `%G`, etc.
 -  Padding, alignment, width, and precision controls
@@ -51,7 +51,7 @@ Below are some of the most common ways to include printfy.
 **CDN Link**
 
 ```html
-<script src="https://cdn.jsdelivr.net/npm/printfy@2.0.1/dist/printfy.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/printfy@2.0.2/dist/printfy.min.js"></script>
 ```
 
 You can add the script manually to your project:
@@ -64,15 +64,15 @@ You can add the script manually to your project:
 There are several ways to use [Webpack](https://webpack.js.org/), [Browserify](http://browserify.org/) or [Babel](https://babeljs.io/). For more information on using these tools, please refer to the corresponding project's documentation. In the script, including printfy will usually look like this:
 
 ```js
-import {sprint, printf, vsprint} from "printfy";
+import {sprintf, printf, vprintf, vsprintf} from "printfy";
 ```
 
 ### Node.js
 
 Fully compatible with [Node.js](https://nodejs.org/), this library lets you use familiar C-style printf formatting in server-side code—ideal for CLI tools, logging, and backend output formatting.
 
 ```js
-const {sprint, printf, vsprint} = require("printfy");
+const {sprintf, printf, vprintf, vsprintf} = require("printfy");
 ```
 
 ---
@@ -87,19 +87,27 @@ printf("Hello %s, you have %d new messages", "Alice", 5);
 // Output: Hello Alice, you have 5 new messages
 ```
 
-### `sprint(format, ...args)`
+### `vprintf(format, args[])`
+Logs the formatted output to the console.
+
+```js
+printf("Hello %s, you have %d new messages", [ "Alice", 5]);
+// Output: Hello Alice, you have 5 new messages
+```
+
+### `sprintf(format, ...args)`
 Returns a formatted string (like `sprintf` in C).
 
 ```js
-let result = sprint("Value: %08.2f", 3.14);
+let result = sprintf("Value: %08.2f", 3.14);
 console.log(result); // Output: Value: 00003.14
 ```
 
-### `vsprint(format, args[])`
-Same as `sprint`, but accepts arguments as an array.
+### `vsprintf(format, args[])`
+Same as `sprintf`, but accepts arguments as an array.
 
 ```js
-vsprint("User: %s, Score: %d", ["Bob", 100]);
+vsprintf("User: %s, Score: %d", ["Bob", 100]);
 // Output: User: Bob, Score: 100
 ```
 
@@ -109,7 +117,7 @@ vsprint("User: %s, Score: %d", ["Bob", 100]);
 
 | Specifier | Meaning                               | Example                         |
 |-----------|---------------------------------------|---------------------------------|
-| `%s`      | String                                | `sprint("%s", "abc")` → `"abc"` |
+| `%s`      | String                                | `sprintf("%s", "abc")` → `"abc"` |
 | `%S`      | Uppercase string                      | `"abc"` → `"ABC"`               |
 | `%d`      | Integer (decimal)                     | `42`                            |
 | `%u`      | Unsigned integer (64-bit)             | `-1` → `"18446744073709551615"` |
@@ -137,15 +145,81 @@ vsprint("User: %s, Score: %d", ["Bob", 100]);
 ## 🧪 Examples
 
 ```js
-sprint("Binary: %08b", 5);            // Binary: 00000101
-sprint("Hex: %#x", 255);             // Hex: ff
-sprint("Char: %c", 65);             // Char: A
-sprint("Padded: %10s", "text");     // Padded:      text
-sprint("Left: %-10s!", "text");     // Left: text     !
-sprint("Float: %.2f", 3.14159);     // Float: 3.14
-sprint("Scientific: %.2e", 1200);   // Scientific: 1.20e+3
+sprintf("Binary: %08b", 5);          // Binary: 00000101
+sprintf("Hex: %#x", 255);            // Hex: ff
+sprintf("Char: %c", 65);             // Char: A
+sprintf("Padded: %10s", "text");     // Padded:      text
+sprintf("Left: %-10s!", "text");     // Left: text     !
+sprintf("Float: %.2f", 3.14159);     // Float: 3.14
+sprintf("Scientific: %.2e", 1200);   // Scientific: 1.20e+3
+```
+
+**[index$] – Argument Indexing**
+```js
+sprintf('%2$s is %1$d years old.', 22, 'Modassir');
+// Output: Modassir is 22 years old.
 ```
 
+**[padding] – Custom Padding Character**
+```js
+sprintf("%'~5d", 42);
+// Output: ~~~42
+
+sprintf("%'~-5d", 42);
+// Output: 42~~~
+```
+
+**[flag] – Format Flags**
+
+Support flags `+` and `-` only.
+
+```js
+sprintf("%+d", 42);
+// Output: +45
+
+sprintf("%-d", 42);
+// Output: -45
+```
+
+**[width] – Custom Width**
+```js
+sprintf("%6s", "JS");
+// Output: "    JS"
+
+sprintf("lang%6s", "JS");
+// Output: "lang    JS"
+
+sprintf("%-6s", "JS");
+// Output: "JS    "
+
+sprintf("%-6slib", "JS");
+// Output: "JS    lib"
+```
+
+**[.precision] – Precision (floating-point or string truncation)**
+```js
+sprintf("%.2f", 3.14159);
+// Output: 3.14
+
+sprintf("%.4s", "OpenAI");
+// Output: Open
+```
+
+**Full Format**
+```js
+sprintf('%2$\'#-+10.2f and %1$\'*_10s', "JS", 3.14159);
+// Output: +3.14#####JS*******
+```
+
+🔹 Explanation:
+- `%2$`: Second argument (`3.14159`)
+- `'#`: padding character `#`
+- `-`: left align
+- `+`: show sign
+- `10`: total width 10
+- `.2f`: 2 decimal places
+- `%1$'*_10s`: First argument (`JS`), padded with `*` to width 10
+
 ---
 
 ## ⚠️ Errors & Warnings
@@ -160,13 +234,13 @@ sprint("Scientific: %.2e", 1200);   // Scientific: 1.20e+3
 ## 🔄 Comparison with Other Libraries
 
 | Feature / Library      | printfy ✅         | sprintf-js 🟡 | fast-printf 🟢 | printf (npm) 🔵    |
-| ---------------------- | ------------------ | ------------- | -------------- | -------------------- |
+| ---------------------- | ------------------ | --------------- | --------------- | ----------------- |
 | C-style specifiers     | ✅ Full            | ✅ Full        | ✅ Partial      | ✅ Partial       |
 | %2\$ style arg index   | ✅ Yes             | ✅ Yes         | ❌ No           | ❌ No            |
 | BigInt support         | ✅ Yes             | ❌ No          | ❌ No           | ❌ No            |
 | %f vs %F (locale)      | ✅ Separate        | ❌ Combined    | ❌ Combined     | ❌ No            |
 | Custom padding ('x)    | ✅ `'x`, `0`, etc. | ❌ No          | ❌ No           | ❌ No            |
-| String return (sprint) | ✅ Yes             | ✅ Yes         | ✅ Yes          | ❌ No            |
+| String return (sprintf)| ✅ Yes             | ✅ Yes         | ✅ Yes          | ❌ No            |
 | Lightweight / No deps  | ✅ Yes             | ✅ Yes         | ✅ Yes          | ✅ Yes           |
 | Unicode emoji safe     | Partial            | Partial         | ❌ No           | ❌ No            |
 | Performance            | Good               | Good            | Best             | Good             |

lib/printfy.js

@@ -1,5 +1,5 @@
 /**
- * printfy pure JavaScript Libaray v2.0.1
+ * printfy pure JavaScript Libaray v2.0.2
  * A lightweight JavaScript library implements C-style `printf` functionality.
  * https://github.com/jsvibe/printfy
  * 
@@ -346,7 +346,8 @@ function printf(format, values) {
  * @returns {string} Return a formatted string
  */
 function vprintf(format, values) {
-  printf.apply(this, arguments);
+  values.unshift(format)
+  printf.apply(this, values);
 }
 
 /**
@@ -372,7 +373,8 @@ function sprintf(format, values) {
  * @returns {string} Return a formatted string
  */
 function vsprintf(format, values) {
-  return sprintf.apply(this, concat.apply([], format, values));
+  values.unshift(format);
+  return sprintf.apply(this, values);
 }
 
 

lib/printfy.min.js

@@ -1,6 +1,6 @@
 {
   "name": "printfy",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "description": "C-style printf formatting for JavaScript with padding and precision.",
   "main": "lib/printfy.js",
   "scripts": {

package-lock.json

@@ -0,0 +1,87 @@
+// test.js for printfy v2.0.2
+// Run using: node test.js
+
+const { printf, sprintf, vprintf, vsprintf } = require("../lib/printfy");
+
+// Utility for clean output comparison
+function test(label, actual, expected) {
+  const passed = actual === expected;
+  console.log(`${passed ? '✔' : '✘'} ${label}`);
+  if (!passed) {
+    console.log(`   Expected: "${expected}"`);
+    console.log(`   Received: "${actual}"\n`);
+  }
+}
+
+// Capture console output for printf/vprintf tests
+function captureConsoleOutput(callback) {
+  const originalLog = console.log;
+  let output = "";
+  console.log = (msg) => { output += msg + "\n"; };
+  callback();
+  console.log = originalLog;
+  return output.trim();
+}
+
+// --- Basic String Tests ---
+test('String: simple', sprintf("Hello %s", "World"), "Hello World");
+test('String: padded', sprintf("Name: %10s", "Alice"), "Name:      Alice");
+test('String: left-aligned', sprintf("Name: %-10s!", "Bob"), "Name: Bob       !");
+test('String: precision', sprintf("%.4s", "Elephant"), "Elep");
+
+// --- Integer Tests ---
+test('Decimal: positive', sprintf("Age: %d", 25), "Age: 25");
+test('Decimal: negative', sprintf("Debt: %d", -350), "Debt: -350");
+test('Zero-padded', sprintf("ID: %05d", 42), "ID: 00042");
+test('Left-align', sprintf("Left: %-5d!", 9), "Left: 9    !");
+test('Unsigned: large number', sprintf("Big: %u", -123), "Big: 18446744073709551493");
+
+// --- Binary, Octal, Hex Tests ---
+test('Binary', sprintf("Bin: %08b", 10), "Bin: 00001010");
+test('Octal', sprintf("Oct: %o", 123), "Oct: 173");
+test('Hex lowercase', sprintf("Hex: %x", 255), "Hex: ff");
+test('Hex uppercase', sprintf("Hex: %X", 255), "Hex: FF");
+
+// --- Character ---
+test('Character: %c', sprintf("Char: %c", 65), "Char: A");
+
+// --- Float Tests ---
+test('Float: default precision', sprintf("Pi: %f", 3.14159), "Pi: 3.141590");
+test('Float: .2f', sprintf("Pi: %.2f", 3.14159), "Pi: 3.14");
+test('Float: fixed-point %F', sprintf("Fixed: %.3F", 12.3456), "Fixed: 12.346");
+test('Float: scientific %e', sprintf("Sci: %.2e", 123456), "Sci: 1.23e+5");
+test('Float: uppercase %E', sprintf("Sci: %.2E", 123456), "Sci: 1.23E+5");
+test('Float: auto %g', sprintf("Auto: %.4g", 123.456), "Auto: 123.5");
+test('Float: uppercase auto %G', sprintf("Auto: %.3G", 0.0001234), "Auto: 0.000123");
+
+// --- Positional Arguments ---
+test('Positional args', sprintf("%2$s %1$s!", "World", "Hello"), "Hello World!");
+
+// --- vsprintf and vprintf ---
+test('vsprintf basic', vsprintf("Total: %d, Name: %s", [99, "Item"]), "Total: 99, Name: Item");
+
+// --- sprintf and vsprintf ---
+test('sprintf basic', sprintf("Hello %s!", "World"), "Hello World!");
+test('vsprintf array', vsprintf("Total: %d, Name: %s", [99, "Item"]), "Total: 99, Name: Item");
+
+// --- printf Tests ---
+let result = captureConsoleOutput(() => printf("User: %s, ID: %04d", "Alice", 7));
+test('printf output', result, "User: Alice, ID: 0007");
+
+result = captureConsoleOutput(() => printf("Hex: %X", 255));
+test('printf hex upper', result, "Hex: FF");
+
+result = captureConsoleOutput(() => printf("Float: %.2f", 3.14159));
+test('printf float 2dp', result, "Float: 3.14");
+
+// --- vprintf Tests ---
+result = captureConsoleOutput(() => vprintf("User: %s, Age: %d", ["Bob", 32]));
+test('vprintf array', result, "User: Bob, Age: 32");
+
+result = captureConsoleOutput(() => vprintf("Hex: %02x", [15]));
+test('vprintf padded hex', result, "Hex: 0f");
+
+result = captureConsoleOutput(() => vprintf("Char: %c", [65]));
+test('vprintf char', result, "Char: A");
+
+console.log("\nAll tests completed.");