feat: supports the deletion of loader caches

src/Loader/CachedResourceLoader.php

@@ -46,4 +46,10 @@ public function exists(ResourceLocation $location): bool
         }
         return $this->resourceLoader->exists($location);
     }
+
+    public function cleanup(): void
+    {
+        $this->resourceLoader->cleanup();
+        $this->cache = [];
+    }
 }

src/Loader/SiteKitLoader.php

@@ -68,6 +68,11 @@ public function exists(ResourceLocation $location): bool
         );
     }
 
+    public function cleanup(): void
+    {
+        $this->langLocaleMap = null;
+    }
+
     private function locationToFile(ResourceLocation $location): string
     {
         $file = $this->resourceChannel->resourceDir . '/' .

src/Loader/SiteKitResourceHierarchyLoader.php

@@ -33,6 +33,11 @@ public function exists(ResourceLocation $location): bool
         return $this->resourceLoader->exists($location);
     }
 
+    public function cleanup(): void
+    {
+        $this->resourceLoader->cleanup();
+    }
+
     /**
      * @throws InvalidResourceException
      * @throws ResourceNotFoundException

src/ResourceLoader.php

@@ -20,4 +20,10 @@ interface ResourceLoader
     public function load(ResourceLocation $location): Resource;
 
     public function exists(ResourceLocation $location): bool;
+
+    /**
+     * Can be used, for example, to clear the loader's
+     * cache if the loader uses a cache.
+     */
+    public function cleanup(): void;
 }

test/Loader/CachedResourceLoaderTest.php

@@ -74,4 +74,29 @@ public function testExistsCached(): void
             'Resource should be test from cache'
         );
     }
+
+    public function testCleanup(): void
+    {
+
+        $location = ResourceLocation::of('test');
+        $resource = $this->createStub(Resource::class);
+        $loader = $this->createMock(ResourceLoader::class);
+        $loader->expects($this->once())
+            ->method('load')
+            ->with($location)
+            ->willReturn($resource);
+        $loader->expects($this->exactly(1))
+            ->method('exists')
+            ->with($location)
+            ->willReturn(false);
+
+        $cachedLoader = new CachedResourceLoader($loader);
+        $cachedLoader->load($location); // cache warmup
+        $cachedLoader->cleanup();
+
+        $this->assertFalse(
+            $cachedLoader->exists($location),
+            'Resource should be test from cache'
+        );
+    }
 }

test/Loader/SiteKitLoaderTest.php

@@ -81,6 +81,12 @@ public function testLoadValidResourceWithLang(): void
         );
     }
 
+    public function testCleanup(): void
+    {
+        $this->expectNotToPerformAssertions();
+        $this->loader->cleanup();
+    }
+
     public function testLoadMissingLocation(): void
     {
         $this->expectException(ResourceNotFoundException::class);

test/Loader/SiteKitResourceHierarchyLoaderTest.php

@@ -84,6 +84,20 @@ public function testExists(): void
         $hierarchyLoader->exists(ResourceLocation::of('/a.php'));
     }
 
+    public function testCleanUp(): void
+    {
+        $resourceLoader = $this->createMock(ResourceLoader::class);
+        $hierarchyLoader = new SiteKitResourceHierarchyLoader(
+            $resourceLoader,
+            'category'
+        );
+
+        $resourceLoader->expects($this->once())
+            ->method('cleanup');
+
+        $hierarchyLoader->cleanup();
+    }
+
     public function testLoadPrimaryParentResourceWithoutParent(): void
     {