feat!: add destroy method to replace current world

eslint.config.ts

@@ -19,6 +19,6 @@ export default style(
 		},
 	},
 	{
-		ignores: ["src/jecs/**", GLOB_MARKDOWN],
+		ignores: [GLOB_MARKDOWN],
 	},
 );

src/index.ts

@@ -8,12 +8,13 @@ export {
 	changed,
 	component,
 	despawn,
+	destroy,
 	get,
+	getRegistry,
 	has,
 	insert,
 	pair,
 	parent,
-	registry,
 	remove,
 	removed,
 	reserve,

src/query.ts

@@ -2,7 +2,7 @@ import type { Modding } from "@flamework/core";
 import * as ecs from "@rbxts/jecs";
 
 import type { Entity, FilterPairs, Id, ResolveKeys } from "./registry";
-import { component, getId, registry } from "./registry";
+import { component, getId, getRegistry } from "./registry";
 
 // Almost full credits to @fireboltofdeath for all of these types.
 export interface Without<T> {
@@ -72,7 +72,7 @@ function queryIter<T extends Array<unknown>>(
 	this: QueryHandle<T>,
 ): IterableFunction<LuaTuple<[Entity, ...T]>> {
 	if (this.terms) {
-		let ecsQuery = registry.query(...this.terms);
+		let ecsQuery = getRegistry().query(...this.terms);
 
 		if (this.filterWithout) {
 			ecsQuery = ecsQuery.without(...this.filterWithout);
@@ -134,5 +134,5 @@ export function query<T extends Array<unknown> = []>(
  *   specified components.
  */
 export function queryRuntimeIds<T extends Array<Id>>(...ids: T): ecs.Query<ecs.InferComponents<T>> {
-	return registry.query(...ids);
+	return getRegistry().query(...ids);
 }

src/registry.ts

@@ -28,7 +28,11 @@ export type FilterPairs<T> = {
 };
 
 const components = new Map<string, Entity>();
-export const registry = new ecs.World();
+
+let registry = new ecs.World();
+export function getRegistry(): ecs.World {
+	return registry;
+}
 
 export const signals = {
 	added: new Map<Entity, Signal<[Entity]>>(),
@@ -469,3 +473,14 @@ export function pair<P>(object: Entity, predicate?: ComponentKey<P>): Pair<P, un
 
 reserve<Wildcard>(ecs.Wildcard as Entity<Wildcard>);
 reserve<ChildOf>(ecs.ChildOf as Entity<ChildOf>);
+
+/**
+ * Destroys the current world and all associated entities, and resets the
+ * registry to a new world.
+ *
+ * @note This function should likely only be used for testing purposes.
+ */
+export function destroy(): void {
+	components.clear();
+	registry = new ecs.World();
+}