@ecsframework/core 0.0.1

package/out/framework/base-system.d.ts

@@ -0,0 +1,279 @@
+import { Modding } from "@flamework/core";
+import { Constructor } from "@flamework/core/out/utility";
+import jecs, { Entity, Id } from "@rbxts/jecs";
+import { Calculate, ExtractQueryTypes, QueryHandle, ToIds } from "./flamecs";
+import { ComponentKey, ExtractPredicate, Pair, ResolveKey, ResolveKeys, ResolveValue, ResolveValues, Tag, Unwrap } from "./flamecs/registry";
+import { Signal } from "./flamecs/signal";
+import { WritableDraft } from "@rbxts/immut/src/types-external";
+type TrailingUndefined<T extends Array<unknown>> = T extends [...infer Rest, undefined] ? [...TrailingUndefined<Rest>, undefined?] : T;
+/** @metadata reflect identifier */
+export declare abstract class BaseSystem {
+    protected readonly world: jecs.World;
+    private framework;
+    /** @hidden */
+    __hookStates: {};
+    constructor();
+    /**
+     * Adds a pair relationship with a specific target entity.
+     *
+     * @template T - The type of the pair.
+     * @param entity - The entity to which the pair relationship is added.
+     * @param object - The target entity of the relationship (object of the pair).
+     * @param key - Flamework autogenerated key.
+     * @metadata macro
+     */
+    AddComponent<T extends Pair<Tag>>(entity: Entity, object: Entity, key?: ComponentKey<ExtractPredicate<T>>): void;
+    /**
+     * Adds a fully defined pair to an entity. This is used when both the predicate
+     * and object of the pair are known at compile-time.
+     *
+     * @template T - The type of the pair.
+     * @param entity - The entity to which the pair component is added.
+     * @param key - Flamework autogenerated key.
+     * @metadata macro
+     */
+    AddComponent<T extends Pair<Tag, defined>>(entity: Entity, key?: ResolveKey<T>): void;
+    /**
+     * Adds a component to an entity.
+     *
+     * @template T - The type of the component.
+     * @param entity - The entity to which the component is added.
+     * @param key - Flamework autogenerated key.
+     * @metadata macro
+     */
+    AddComponent<T extends Tag>(entity: Entity, key?: ComponentKey<T>): void;
+    /**
+     * Sets a value for a pair with a specific runtime target entity.
+     *
+     * @template T - The type of the pair.
+     * @param entity - The entity to which the pair relationship is added.
+     * @param object - The target entity of the relationship (object of the pair).
+     * @param value - The value associated with the pair relationship.
+     * @param key - Flamework autogenerated key.
+     * @metadata macro
+     */
+    SetComponent<T extends Pair<defined>>(entity: Entity, object: Entity, value: ResolveValue<T>, key?: ComponentKey<ExtractPredicate<T>>): void;
+    /**
+     * Sets a value for a fully defined pair on an entity. This is used when both
+     * the predicate and object of the pair are known at compile-time.
+     *
+     * @template T - The type of the pair.
+     * @param entity - The entity to which the pair component is added.
+     * @param value - The value associated with the pair component.
+     * @param key - Flamework autogenerated key.
+     * @metadata macro
+     */
+    SetComponent<T extends Pair<defined, defined>>(entity: Entity, value: ResolveValue<T>, key?: ResolveKey<T>): void;
+    /**
+     * Sets a value for a component on an entity.
+     *
+     * @template T - The type of the component.
+     * @param entity - The entity to which the component is added or updated.
+     * @param value - The value associated with the component.
+     * @param key - Flamework autogenerated key.
+     * @metadata macro
+     */
+    SetComponent<T>(entity: Entity, value: Unwrap<T>, key?: ComponentKey<T>): void;
+    /**
+     * Sets a value for a component on an entity.
+     *
+     * @template T - The type of the component.
+     * @param entity - The entity to which the component is added or updated.
+     * @param value - The value associated with the component.
+     * @param key - Flamework autogenerated key.
+     * @metadata macro
+     */
+    SetComponent<T>(entity: Entity, value: Partial<T>, key?: ComponentKey<T>): void;
+    /** @metadata macro */
+    MutateComponent<T>(entity: Entity, onMutate: (darft: WritableDraft<Unwrap<T>>, original: Unwrap<T>) => void, key?: ComponentKey<T>): void;
+    /**
+     * Adds or updates multiple components for the specified entity.
+     *
+     * @template T - The type of the components.
+     * @param entity - The entity to modify.
+     * @param keys - Flamework autogenerated keys.
+     * @metadata macro
+     */
+    InsertComponents<T extends Array<Tag>>(entity: Entity, keys?: ResolveKeys<T>): void;
+    /**
+     * Adds or updates multiple components for the specified entity.
+     *
+     * @template T - The type of the components.
+     * @param entity - The entity to modify.
+     * @param values - The values to set for the components.
+     * @param keys - Flamework autogenerated keys.
+     * @metadata macro
+     */
+    InsertComponents<T extends Array<unknown>>(entity: Entity, values: TrailingUndefined<ResolveValues<T>>, keys?: ResolveKeys<T>): void;
+    /**
+     * Removes a pair relationship with a specific target entity.
+     *
+     * @template T - The type of the pair.
+     * @param entity - The entity from which the pair relationship is removed.
+     * @param object - The target entity of the relationship (object of the pair).
+     * @param key - Flamework autogenerated key.
+     * @metadata macro
+     */
+    RemoveComponent<T extends Pair<defined>>(entity: Entity, object: Entity, key?: ComponentKey<ExtractPredicate<T>>): void;
+    /**
+     * Removes a fully defined pair from an entity. This is used when both the
+     * predicate and object of the pair are known at compile-time.
+     *
+     * @template T - The type of the pair.
+     * @param entity - The entity from which the pair component is removed.
+     * @param key - Flamework autogenerated key.
+     * @metadata macro
+     */
+    RemoveComponent<T extends Pair<defined, defined>>(entity: Entity, key?: ResolveKey<T>): void;
+    /**
+     * Removes a component from an entity.
+     *
+     * @template T - The type of the component.
+     * @param entity - The entity from which the component is removed.
+     * @param key - Flamework autogenerated key.
+     * @metadata macro
+     */
+    RemoveComponent<T>(entity: Entity, key?: ComponentKey<T>): void;
+    /**
+     * Retrieves the value of a pair relationship for a specific entity and target.
+     *
+     * @template T - The type of the pair.
+     * @param entity - The entity from which to retrieve the pair relationship.
+     * @param object - The target entity of the relationship (object of the pair).
+     * @param key - Flamework autogenerated key.
+     * @returns The value associated with the pair relationship.
+     * @metadata macro
+     */
+    GetComponent<T extends Pair<defined>>(entity: Entity, object: Entity, key?: ComponentKey<ExtractPredicate<T>>): ResolveValue<T> | undefined;
+    /**
+     * Retrieves the value of a component or pair for a specific entity.
+     *
+     * @template T - The type of the component or pair.
+     * @param entity - The entity from which to retrieve the component or pair.
+     * @param key - Flamework autogenerated key.
+     * @returns The value associated with the component or pair.
+     * @metadata macro
+     */
+    GetComponent<T>(entity: Entity, key?: ResolveKey<T>): ResolveValue<T> | undefined;
+    /**
+     * Checks if a pair relationship exists for a specific entity and target.
+     *
+     * @template T - The type of the pair.
+     * @param entity - The entity to check for the pair relationship.
+     * @param object - The target entity of the relationship (object of the pair).
+     * @param key - Flamework autogenerated key.
+     * @returns True if the pair relationship exists, false otherwise.
+     * @metadata macro
+     */
+    HasComponent<T extends Pair<defined>>(entity: Entity, object: Entity, key?: ComponentKey<ExtractPredicate<T>>): boolean;
+    /**
+     * Checks if a component or pair exists for a specific entity.
+     *
+     * @template T - The type of the component or pair.
+     * @param entity - The entity to check for the component or pair.
+     * @param key - Flamework autogenerated key.
+     * @returns True if the component or pair exists, false otherwise.
+     * @metadata macro
+     */
+    HasComponent<T>(entity: Entity, key?: ResolveKey<T>): boolean;
+    /**
+     * Retrieves the target entity of a relationship involving the specified entity
+     * and component.
+     *
+     * @template T - The type of the component.
+     * @param entity - The entity to get the target for.
+     * @param key - Flamework autogenerated key.
+     * @returns The target entity if a relationship exists, or undefined otherwise.
+     * @metadata macro
+     */
+    TargetComponent<T>(entity: Entity, key?: ComponentKey<T>): Entity | undefined;
+    /**
+     * Retrieves the parent entity (target of the ChildOf relationship) for the
+     * given entity.
+     *
+     * @param entity - The entity for which to get the parent.
+     * @returns The parent entity, or undefined if no parent exists.
+     */
+    ParentComponent(entity: Entity): Entity | undefined;
+    GetAllClassComponents(): Constructor[];
+    /** @metadata macro */
+    GetClassComponent<T>(key?: ComponentKey<T>): Constructor;
+    /**
+     * Retrieves the ID of a component or a pair relationship.
+     *
+     * @template T - The type of the component.
+     * @param key - Flamework autogenerated key or pair key.
+     * @returns The component or pair ID.
+     * @metadata macro.
+     */
+    GetComponentId<T>(key?: ResolveKey<T>): Id<ResolveValue<T>>;
+    ClearAllComponents(entity: jecs.Entity): void;
+    /**
+     * Returns a signal that fires when a component is added to an entity.
+     *
+     * @template T - The type of the component.
+     * @param key - Flamework autogenerated key for the component.
+     * @returns A signal that fires when the component is added to any entity.
+     * @metadata macro
+     */
+    Added<T>(key?: ComponentKey<T>): Signal<[entity: Entity<T>, data: T]>;
+    /**
+     * Returns a signal that fires when a component is removed from an entity.
+     *
+     * @template T - The type of the component.
+     * @param key - Flamework autogenerated key for the component.
+     * @returns A signal that fires when the component is removed from any entity.
+     * @metadata macro
+     */
+    Removed<T>(key?: ComponentKey<T>): Signal<[Entity<T>]>;
+    /**
+     * Returns a signal that fires when a component's value changes on an entity.
+     *
+     * @template T - The type of the component.
+     * @param key - Flamework autogenerated key for the component.
+     * @returns A signal that fires when the component's value changes on any
+     *   entity.
+     * @metadata macro
+     */
+    Changed<T>(key?: ComponentKey<T>): Signal<[Entity<T>, T]>;
+    GetComponentKey<T>(runtimeId: Entity): T | undefined;
+    private createComponentData;
+    /**
+     * Creates a new empty entity.
+     *
+     * @returns The created entity.
+     * @metadata macro
+     */
+    SpawnEntity(): jecs.Tag;
+    /**
+     * Creates a new entity with the specified tag components.
+     *
+     * @template T - The type of the components.
+     * @param keys - Flamework autogenerated keys.
+     * @returns The created entity.
+     * @metadata macro
+     */
+    SpawnEntity<T extends Array<Tag>>(keys?: ResolveKeys<T>): jecs.Tag;
+    /**
+     * Creates a new entity with the specified components and their values.
+     *
+     * @template T - The type of the components.
+     * @param values - The values to set for the components.
+     * @param keys - Flamework autogenerated keys.
+     * @returns The created entity.
+     * @metadata macro
+     */
+    SpawnEntity<T extends Array<unknown>>(values: TrailingUndefined<Partial<ResolveValues<T>>>, keys?: ResolveKeys<T>): jecs.Tag;
+    ExistEntity(entity: jecs.Entity): boolean;
+    DespawnEntity(entity: jecs.Entity): void;
+    /** @metadata macro */
+    Query<T extends Array<unknown> = []>(terms?: ToIds<Calculate<T>["query"]>, filterWithout?: ToIds<Calculate<T>["without"]>, filterWith?: ToIds<Calculate<T>["with"]>): QueryHandle<ExtractQueryTypes<T>>;
+    /** @metadata macro */
+    QueryChange<T>(componentTypeId?: ComponentKey<T>, key?: Modding.Caller<"uuid">): IterableFunction<[entity: jecs.Entity, record: import("./hooks/query-change").QueryRecord<T>, isDestroyedEntity: boolean]>;
+    /** @metadata macro */
+    Each<T>(key?: ResolveKey<T>): IterableFunction<jecs.Entity<unknown>>;
+    OnStartup(): void;
+    OnUpdate(): void;
+    OnEffect(): void;
+}
+export {};

package/out/framework/base-system.luau

@@ -0,0 +1,170 @@
+-- Compiled with roblox-ts v3.0.0
+local TS = _G[script]
+local Reflect = TS.import(script, TS.getModule(script, "@flamework", "core").out).Reflect
+local query = TS.import(script, script.Parent, "flamecs").query
+local _registry = TS.import(script, script.Parent, "flamecs", "registry")
+local add = _registry.add
+local added = _registry.added
+local changed = _registry.changed
+local get = _registry.get
+local getId = _registry.getId
+local getKey = _registry.getKey
+local has = _registry.has
+local insert = _registry.insert
+local remove = _registry.remove
+local removed = _registry.removed
+local set = _registry.set
+local target = _registry.target
+local InjectType = TS.import(script, script.Parent, "decorators", "inject-type").InjectType
+local QueryChange = TS.import(script, script.Parent, "hooks", "query-change").QueryChange
+local produce = TS.import(script, TS.getModule(script, "@rbxts", "immut").src).produce
+--* @metadata reflect identifier 
+local BaseSystem
+do
+	BaseSystem = {}
+	function BaseSystem:constructor()
+		self.__hookStates = {}
+	end
+	function BaseSystem:AddComponent(entity, argument1, argument2)
+		return add(self.world, entity, argument1, argument2)
+	end
+	function BaseSystem:SetComponent(entity, argument1, argument2, argument3)
+		local classComponent = self:GetClassComponent(argument2)
+		if argument3 == nil and classComponent ~= nil then
+			-- Case class component
+			local value = self:createComponentData(classComponent, argument1)
+			return set(self.world, entity, value, argument2)
+		end
+		return set(self.world, entity, argument1, argument2, argument3)
+	end
+	function BaseSystem:MutateComponent(entity, onMutate, key)
+		local data = self:GetComponent(entity, key)
+		if not (data ~= 0 and data == data and data ~= "" and data) then
+			error(`Component {key} does not exist on entity {entity}.`)
+		end
+		self:SetComponent(entity, produce(data, function(draft)
+			return onMutate(draft, data)
+		end), key)
+	end
+	function BaseSystem:InsertComponents(entity, argument1, argument2)
+		local _arg0 = argument1 ~= nil
+		assert(_arg0)
+		if argument2 ~= nil then
+			-- Insert components: insert(entity, values, keys)
+			local values = argument1
+			local keys = argument2
+			local newValues = {}
+			for index = 0, #keys - 1 do
+				local componentClass = self:GetClassComponent(keys[index + 1])
+				if componentClass == nil then
+					newValues[index + 1] = values[index + 1]
+					continue
+				end
+				local newData = self:createComponentData(componentClass, values[index + 1])
+				newValues[index + 1] = newData
+			end
+			return insert(self.world, entity, newValues, keys)
+		end
+		return insert(self.world, entity, argument1, argument2)
+	end
+	function BaseSystem:RemoveComponent(entity, argument1, argument2)
+		return remove(self.world, entity, argument1, argument2)
+	end
+	function BaseSystem:GetComponent(entity, argument1, argument2)
+		return get(self.world, entity, argument1, argument2)
+	end
+	function BaseSystem:HasComponent(entity, argument1, argument2)
+		return has(self.world, entity, argument1, argument2)
+	end
+	function BaseSystem:TargetComponent(entity, key)
+		return target(self.world, entity, key)
+	end
+	function BaseSystem:ParentComponent(entity)
+		return target(self.world, entity, "$ecsframework:core:framework/flamecs/registry@ChildOf")
+	end
+	function BaseSystem:GetAllClassComponents()
+		return Reflect.getOwnMetadata(getmetatable(self), "ECSFramework:Components") or ({})
+	end
+	function BaseSystem:GetClassComponent(key)
+		local _componentsMap = self.framework.componentsMap
+		local _key = key
+		local ctor = _componentsMap[_key]
+		if not ctor then
+			error(`Component {key} does not exist.`)
+		end
+		return ctor
+	end
+	function BaseSystem:GetComponentId(key)
+		return getId(self.world, key)
+	end
+	function BaseSystem:ClearAllComponents(entity)
+		self.world:clear(entity)
+	end
+	function BaseSystem:Added(key)
+		return added(self.world, key)
+	end
+	function BaseSystem:Removed(key)
+		return removed(self.world, key)
+	end
+	function BaseSystem:Changed(key)
+		return changed(self.world, key)
+	end
+	function BaseSystem:GetComponentKey(runtimeId)
+		return getKey(runtimeId)
+	end
+	function BaseSystem:createComponentData(ctor, addtitionalData)
+		local finalData = {}
+		ctor.constructor(finalData)
+		if addtitionalData ~= nil then
+			for key, _ in pairs(addtitionalData) do
+				finalData[key] = addtitionalData[key]
+			end
+		end
+		return finalData
+	end
+	function BaseSystem:SpawnEntity(argument1, argument2)
+		local entity = self.world:entity()
+		if argument1 == nil and argument2 == nil then
+			return entity
+		end
+		self:InsertComponents(entity, argument1, argument2)
+		return entity
+	end
+	function BaseSystem:ExistEntity(entity)
+		return self.world:exists(entity)
+	end
+	function BaseSystem:DespawnEntity(entity)
+		self:AddComponent(entity, "$ecsframework:core:framework/components/destroyed-component@DestroyComponent")
+		self.world:delete(entity)
+	end
+	function BaseSystem:Query(terms, filterWithout, filterWith)
+		return query(self.world, terms, filterWithout, filterWith)
+	end
+	function BaseSystem:QueryChange(componentTypeId, key)
+		return QueryChange(componentTypeId, key)
+	end
+	function BaseSystem:Each(key)
+		return self.world:each(getId(self.world, key))
+	end
+	function BaseSystem:OnStartup()
+	end
+	function BaseSystem:OnUpdate()
+	end
+	function BaseSystem:OnEffect()
+	end
+	do
+		-- (Flamework) BaseSystem metadata
+		Reflect.defineMetadata(BaseSystem, "identifier", "$ecsframework:core:framework/base-system@BaseSystem")
+		-- (Flamework) BaseSystem.world metadata
+		Reflect.defineMetadata(BaseSystem, "flamework:type", "@rbxts/jecs:jecs@World", "world")
+		-- (Flamework) BaseSystem.framework metadata
+		Reflect.defineMetadata(BaseSystem, "flamework:type", "$ecsframework:core:framework/init@ECSFramework", "framework")
+	end
+end
+-- (Flamework) BaseSystem.world decorators
+Reflect.decorate(BaseSystem, "$ecsframework:core:framework/decorators/inject-type@InjectType", InjectType, {}, "world", false)
+-- (Flamework) BaseSystem.framework decorators
+Reflect.decorate(BaseSystem, "$ecsframework:core:framework/decorators/inject-type@InjectType", InjectType, {}, "framework", false)
+return {
+	BaseSystem = BaseSystem,
+}

package/out/framework/components/destroyed-component.d.ts

@@ -0,0 +1,3 @@
+import { Tag } from "../flamecs";
+export interface DestroyComponent extends Tag {
+}

package/out/framework/components/destroyed-component.luau

@@ -0,0 +1,2 @@
+-- Compiled with roblox-ts v3.0.0
+return nil

package/out/framework/components/roblox-instance-component.d.ts

@@ -0,0 +1,3 @@
+export declare class RobloxInstanceComponent {
+    Instance: Instance;
+}

package/out/framework/components/roblox-instance-component.luau

@@ -0,0 +1,27 @@
+-- Compiled with roblox-ts v3.0.0
+local TS = _G[script]
+local Reflect = TS.import(script, TS.getModule(script, "@flamework", "core").out).Reflect
+local ECSComponent = TS.import(script, script.Parent.Parent, "decorators", "component").ECSComponent
+local RobloxInstanceComponent
+do
+	RobloxInstanceComponent = setmetatable({}, {
+		__tostring = function()
+			return "RobloxInstanceComponent"
+		end,
+	})
+	RobloxInstanceComponent.__index = RobloxInstanceComponent
+	function RobloxInstanceComponent.new(...)
+		local self = setmetatable({}, RobloxInstanceComponent)
+		return self:constructor(...) or self
+	end
+	function RobloxInstanceComponent:constructor()
+	end
+	do
+		-- (Flamework) RobloxInstanceComponent metadata
+		Reflect.defineMetadata(RobloxInstanceComponent, "identifier", "$ecsframework:core:framework/components/roblox-instance-component@RobloxInstanceComponent")
+	end
+	RobloxInstanceComponent = ECSComponent()(RobloxInstanceComponent) or RobloxInstanceComponent
+end
+return {
+	RobloxInstanceComponent = RobloxInstanceComponent,
+}

package/out/framework/decorators/component.d.ts

@@ -0,0 +1,6 @@
+import { RunContext } from "../utilities";
+export interface ECSComponentOptions {
+    RunContext?: RunContext;
+}
+/** @metadata reflect identifier */
+export declare function ECSComponent(options?: ECSComponentOptions): (target: object) => void;

package/out/framework/decorators/component.luau

@@ -0,0 +1,28 @@
+-- Compiled with roblox-ts v3.0.0
+local TS = _G[script]
+local Reflect = TS.import(script, TS.getModule(script, "@flamework", "core").out).Reflect
+local component = TS.import(script, TS.getModule(script, "@rbxts", "jecs").jecs).component
+local BaseSystem = TS.import(script, script.Parent.Parent, "base-system").BaseSystem
+local GetIdentifier = TS.import(script, script.Parent.Parent, "utilities").GetIdentifier
+--* @metadata reflect identifier 
+local function ECSComponent(options)
+	if options == nil then
+		options = {}
+	end
+	return function(target)
+		local components = Reflect.getMetadata(BaseSystem, "ECSFramework:Components") or {}
+		local componentId = component()
+		local _target = target
+		table.insert(components, _target)
+		Reflect.defineMetadata(target, "ECSFramework:Id", componentId)
+		Reflect.defineMetadata(target, "ECSFramework:ComponentOptions", options)
+		Reflect.defineMetadata(BaseSystem, "ECSFramework:Components", components)
+		local componentsId = Reflect.getOwnMetadata(BaseSystem, "ECSFramework:ComponentsId") or {}
+		local _arg1 = GetIdentifier(target)
+		componentsId[componentId] = _arg1
+		Reflect.defineMetadata(BaseSystem, "ECSFramework:ComponentsId", componentsId)
+	end
+end
+return {
+	ECSComponent = ECSComponent,
+}

package/out/framework/decorators/inject-type.d.ts

@@ -0,0 +1,15 @@
+export declare const INJECT_TYPE_KEY = "Inject-type";
+export declare const ObjectWithInjectTypes: Map<string, object[]>;
+/**
+ * Inject dependency.
+ *
+ * @metadata flamework:type
+ */
+export declare const InjectType: (() => ((target: defined, propertyKey: string) => never) & {
+    _flamework_Decorator: never;
+}) & ((target: defined, propertyKey: string) => never) & {
+    _flamework_Decorator: never;
+} & {
+    _flamework_Parameters: [];
+};
+export declare const GetInjectTypes: (obj: {}) => Map<string, string>;

package/out/framework/decorators/inject-type.luau

@@ -0,0 +1,48 @@
+-- Compiled with roblox-ts v3.0.0
+local TS = _G[script]
+local _core = TS.import(script, TS.getModule(script, "@flamework", "core").out)
+local Modding = _core.Modding
+local Reflect = _core.Reflect
+local t = TS.import(script, TS.getModule(script, "@rbxts", "t").lib.ts).t
+local INJECT_TYPE_KEY = "Inject-type"
+local ObjectWithInjectTypes = {}
+--[[
+	*
+	 * Inject dependency.
+	 *
+	 * @metadata flamework:type
+	 
+]]
+local InjectType = Modding.createDecorator("Property", function(descriptor)
+	local typeSpecifier = Reflect.getMetadata(descriptor.object, "flamework:type", descriptor.property)
+	if typeSpecifier == nil then
+		error("Injected type not found")
+	end
+	Reflect.defineMetadata(descriptor.object, descriptor.property, typeSpecifier, INJECT_TYPE_KEY)
+end)
+local GetInjectTypes = function(obj)
+	local injectProperties = Reflect.getMetadataKeys(obj, INJECT_TYPE_KEY)
+	local injectTypes = {}
+	-- ▼ ReadonlyArray.forEach ▼
+	local _callback = function(prop)
+		local typeSpec = Reflect.getMetadata(obj, prop, INJECT_TYPE_KEY)
+		local _arg0 = typeSpec ~= nil
+		local _arg1 = `Injected type not found for {prop}`
+		assert(_arg0, _arg1)
+		local _prop = prop
+		injectTypes[_prop] = typeSpec
+	end
+	for _k, _v in injectProperties do
+		_callback(_v, _k - 1, injectProperties)
+	end
+	-- ▲ ReadonlyArray.forEach ▲
+	local _arg0 = t.map(t.string, t.string)(injectTypes)
+	assert(_arg0, "Invalid inject types")
+	return injectTypes
+end
+return {
+	INJECT_TYPE_KEY = INJECT_TYPE_KEY,
+	ObjectWithInjectTypes = ObjectWithInjectTypes,
+	InjectType = InjectType,
+	GetInjectTypes = GetInjectTypes,
+}

package/out/framework/decorators/system.d.ts

@@ -0,0 +1,9 @@
+import { Constructor } from "@flamework/core/out/utility";
+import { BaseSystem } from "../base-system";
+import { RunContext } from "../utilities";
+export interface SystemOptions {
+    Priority?: number;
+    RunContext?: RunContext;
+}
+/** @metadata reflect identifier */
+export declare function ECSSystem(options?: SystemOptions): (target: Constructor<BaseSystem>) => void;

package/out/framework/decorators/system.luau

@@ -0,0 +1,20 @@
+-- Compiled with roblox-ts v3.0.0
+local TS = _G[script]
+local Reflect = TS.import(script, TS.getModule(script, "@flamework", "core").out).Reflect
+local BaseSystem = TS.import(script, script.Parent.Parent, "base-system").BaseSystem
+--* @metadata reflect identifier 
+local function ECSSystem(options)
+	if options == nil then
+		options = {}
+	end
+	return function(target)
+		local systems = Reflect.getOwnMetadata(BaseSystem, "ECSFramework:Systems") or {}
+		local _target = target
+		table.insert(systems, _target)
+		Reflect.defineMetadata(BaseSystem, "ECSFramework:Systems", systems)
+		Reflect.defineMetadata(target, "ECSFramework:Options", options)
+	end
+end
+return {
+	ECSSystem = ECSSystem,
+}

package/out/framework/decorators/tagged.d.ts

@@ -0,0 +1,11 @@
+import { Constructor } from "@flamework/core/out/utility";
+import { World } from "@rbxts/jecs";
+import { DependenciesContainer } from "../dependencies-container";
+import { Tag } from "../flamecs";
+export interface TaggedOptions<T> {
+    Tag: string;
+    OnCreateData: (instance: Instance, world: World, container: DependenciesContainer) => Partial<T>;
+}
+export interface TaggedInstance extends Tag {
+}
+export declare function Tagged<T>(options: TaggedOptions<T>): (target: Constructor<T>) => void;

package/out/framework/decorators/tagged.luau

@@ -0,0 +1,11 @@
+-- Compiled with roblox-ts v3.0.0
+local TS = _G[script]
+local DefineClassComponentMeta = TS.import(script, script.Parent.Parent, "utilities").DefineClassComponentMeta
+local function Tagged(options)
+	return function(target)
+		DefineClassComponentMeta(target, options, "$ecsframework:core:framework/decorators/tagged@TaggedInstance")
+	end
+end
+return {
+	Tagged = Tagged,
+}

package/out/framework/decorators/unaffectable.d.ts

@@ -0,0 +1 @@
+export declare function Unaffectable(): (target: object) => void;

package/out/framework/decorators/unaffectable.luau

@@ -0,0 +1,11 @@
+-- Compiled with roblox-ts v3.0.0
+local TS = _G[script]
+local Reflect = TS.import(script, TS.getModule(script, "@flamework", "core").out).Reflect
+local function Unaffectable()
+	return function(target)
+		Reflect.defineMetadata(target, "ECSFramework:Unaffectable", true)
+	end
+end
+return {
+	Unaffectable = Unaffectable,
+}