Add File::rewind()

In `File::guessIndentation()`, return the given `Indentation` instance
if the default indentation appears to be used

Author: lkrms

src/Toolkit/Core/Utility/File.php

@@ -163,6 +163,20 @@ public static function write($stream, string $data, ?int $length = null, $uri =
         return $result;
     }
 
+    /**
+     * Rewind to the beginning of a stream
+     *
+     * Equivalent to `File::seek($stream, 0, \SEEK_SET, $uri)`.
+     *
+     * @param resource $stream
+     * @param Stringable|string|null $uri
+     * @throws FilesystemErrorException on failure.
+     */
+    public static function rewind($stream, $uri = null): void
+    {
+        self::seek($stream, 0, \SEEK_SET, $uri);
+    }
+
     /**
      * Set the file position indicator for a stream
      *
@@ -433,6 +447,8 @@ public static function getEol($resource, $uri = null): ?string
      *
      * Derived from VS Code's `indentationGuesser`.
      *
+     * Returns `$default` if `$resource` appears to use the default indentation.
+     *
      * @param Stringable|string|resource $resource
      * @param Stringable|string|null $uri
      *
@@ -579,6 +595,14 @@ public static function guessIndentation(
             self::close($handle, $uri);
         }
 
+        if (
+            $default &&
+            $default->InsertSpaces === $insertSpaces &&
+            $default->TabSize === $tabSize
+        ) {
+            return $default;
+        }
+
         return new Indentation($insertSpaces, $tabSize);
     }