feat: Add preview and bulk generation features to running numbers

Author: nasrulhazim

README.md

@@ -18,12 +18,14 @@ Generate sequential running numbers for your Laravel application. Perfect for in
 - 🎯 **Custom Starting Numbers** - Start sequences from any number
 - 📊 **Range Management** - Set maximum limits with exception handling
 - 📅 **Date-Based Formats** - Built-in date presenters for time-organized numbers
+- 👁️ **Preview Mode** - Preview next numbers without incrementing
+- 📦 **Bulk Generation** - Generate multiple numbers at once atomically
 - ⚙️ **Configurable** - Customize padding, formatting, and behavior
 - 🆔 **UUID Support** - Built-in UUID support for running number records
 - 🏷️ **Native PHP Enums** - Modern PHP 8.1+ enum support with Traitify
 - 🔧 **Extensible** - Custom generators and presenters via contracts
 - 🚀 **Developer Friendly** - Helper functions, facades, and excellent IDE support
-- ✅ **Well Tested** - 51 tests with 124 assertions
+- ✅ **Well Tested** - 64 tests with 166 assertions
 - 📦 **Wide Compatibility** - Laravel 9-12 & PHP 8.1-8.4
 
 ## 📦 Installation
@@ -129,6 +131,7 @@ Comprehensive documentation is available in the [docs](docs/) directory:
 - [Multiple Sequences](docs/04-advanced-features/02-multiple-sequences.md)
 - [Custom Starting Numbers](docs/04-advanced-features/03-custom-starting-numbers.md)
 - [Number Range Management](docs/04-advanced-features/04-number-range-management.md)
+- [Preview & Bulk Generation](docs/04-advanced-features/05-preview-and-batch.md)
 - [Upgrade Guide](docs/06-upgrade-guide.md)
 - [API Reference](docs/README.md)
 

config/running-number.php

@@ -2,6 +2,9 @@
 
 use CleaniqueCoders\RunningNumber\Enums\Organization;
 use CleaniqueCoders\RunningNumber\Enums\ResetPeriod;
+use CleaniqueCoders\RunningNumber\Generator;
+use CleaniqueCoders\RunningNumber\Models\RunningNumber;
+use CleaniqueCoders\RunningNumber\Presenter;
 
 return [
     /*
@@ -21,7 +24,7 @@
 
     'types' => Organization::values(),
 
-    'model' => \CleaniqueCoders\RunningNumber\Models\RunningNumber::class,
+    'model' => RunningNumber::class,
 
     /*
     |--------------------------------------------------------------------------
@@ -33,7 +36,7 @@
     |
     */
 
-    'generator' => \CleaniqueCoders\RunningNumber\Generator::class,
+    'generator' => Generator::class,
 
     /*
     |--------------------------------------------------------------------------
@@ -45,7 +48,7 @@
     |
     */
 
-    'presenter' => \CleaniqueCoders\RunningNumber\Presenter::class,
+    'presenter' => Presenter::class,
 
     /*
     |--------------------------------------------------------------------------

docs/03-usage/02-generator-class.md

@@ -103,6 +103,27 @@ Generate the running number:
 $number = $generator->generate();
 ```
 
+### `preview()`
+
+Preview the next number without incrementing:
+
+```php
+$preview = $generator->preview();
+```
+
+See [Preview & Bulk Generation](../04-advanced-features/05-preview-and-batch.md#preview-mode) for details.
+
+### `generateBatch(int $count)`
+
+Generate multiple numbers at once:
+
+```php
+$numbers = $generator->generateBatch(10);
+// Returns array of 10 numbers
+```
+
+See [Preview & Bulk Generation](../04-advanced-features/05-preview-and-batch.md#bulk-generation) for details.
+
 ## Usage Patterns
 
 ### Fluent Interface