wip

src/Plugins/Tia/ContentHash.php

@@ -9,11 +9,6 @@ namespace Pest\Plugins\Tia;
  */
 final class ContentHash
 {
-    /**
-     * xxh128 hex of the file's "behavioural" shape, or `false` when the
-     * file can't be read. Callers should treat `false` the same way they
-     * treated a failed `hash_file()` previously.
-     */
     public static function of(string $absolute): string|false
     {
         $raw = @file_get_contents($absolute);
@@ -25,11 +20,6 @@ final class ContentHash
         return self::ofContent($absolute, $raw);
     }
 
-    /**
-     * Same as `of()` but accepts the file contents in memory. Used when
-     * we already have the bytes (e.g. from `git show <sha>:<path>`) and
-     * want to avoid a disk round-trip.
-     */
     public static function ofContent(string $path, string $raw): string
     {
         $lower = strtolower($path);
@@ -51,13 +41,6 @@ final class ContentHash
         return hash('xxh128', $raw);
     }
 
-    /**
-     * Tokenise the content and hash the concatenated values of every
-     * token except whitespace / comment / docblock. `token_get_all()`
-     * is built-in, fast, and enough to collapse any formatting-only
-     * edit. If tokenisation fails (rare syntax error), fall back to
-     * the raw hash so the caller still gets a deterministic signal.
-     */
     private static function hashPhpContent(string $raw): string
     {
         $tokens = @token_get_all($raw);
@@ -88,14 +71,6 @@ final class ContentHash
         return hash('xxh128', $normalised);
     }
 
-    /**
-     * Blade templates aren't PHP syntactically, so `token_get_all()`
-     * doesn't help. Strip `{{-- … --}}` comments (the only Blade-native
-     * comment form) and collapse whitespace runs. Output differences
-     * that would survive the Blade compiler (markup reordering, new
-     * directives, changed interpolation) still flip the hash; pure
-     * reformatting does not.
-     */
     private static function hashBladeContent(string $raw): string
     {
         $stripped = preg_replace('/\{\{--.*?--\}\}/s', '', $raw) ?? $raw;
@@ -104,17 +79,6 @@ final class ContentHash
         return hash('xxh128', trim($stripped));
     }
 
-    /**
-     * Conservative JS/TS/Vue/Svelte normaliser. Strips `//` line
-     * comments and `/* … *\/` block comments that appear on their own
-     * lines (including leading indentation), then collapses
-     * whitespace. Deliberately leaves trailing comments after code
-     * alone — a string literal like `'http://foo'` would be unsafe to
-     * split on `//` without a full lexer. The direction of error is
-     * over-detection (we may not strip a trailing comment that's
-     * purely cosmetic), never under-detection. Blank lines and
-     * indentation changes are erased regardless.
-     */
     private static function hashJsContent(string $raw): string
     {
         $stripped = preg_replace('/^\s*\/\/[^\n]*$/m', '', $raw) ?? $raw;