feat: add flush method to Printer interface for console output without EOL

Author: AxiosLeo

index.d.ts

@@ -432,6 +432,12 @@ interface Printer {
    */
   println(str?: string): this;
 
+  /**
+   * Print some string on the console without EOL.
+   * @param str 
+   */
+  flush(str?: string): this;
+
   /**
    * Print some string on the console without EOL.
    * @param str 

src/printer.js

@@ -50,6 +50,15 @@ function println(str = '') {
   return this;
 }
 
+function flush(str = null) {
+  str = is.invalid(str) ? `${buffer}` : `${buffer}${str}`;
+  buffer = '';
+  if (!quiet) {
+    process.stdout.write('\r' + str);
+  }
+  return this;
+}
+
 function themes(options = {}) {
   if (!is.empty(options)) {
     Object.assign(themesConfig, options);
@@ -149,6 +158,7 @@ module.exports = {
   print,
   themes,
   println,
+  flush,
   enable,
   disable,
   input,

tests/printer.tests.js

@@ -51,4 +51,33 @@ describe('print test case', function () {
   it('print with null', function () {
     printer.print(null).println(null);
   });
+
+  it('flush test', function () {
+    // 测试基本的 flush 调用
+    printer.flush('Progress: 0%');
+    printer.flush('Progress: 50%');
+    printer.flush('Progress: 100%');
+    printer.println(); // 换行
+    
+    // 测试链式调用
+    printer.fixed('Loading', 10).flush();
+    printer.fixed('Loading.', 10).flush();
+    printer.fixed('Loading..', 10).flush();
+    printer.fixed('Loading...', 10).flush();
+    printer.println(); // 换行
+    
+    // 测试 flush 与 quiet 模式
+    printer.disable();
+    printer.flush('This should not display');
+    printer.enable();
+    printer.flush('This should display');
+    printer.println();
+    
+    // 测试 flush 参数为空
+    printer.flush();
+    printer.println();
+    
+    // exec here is ok
+    expect(true).to.be.true;
+  });
 });