koota 0.1.1 → 0.1.3

package/README.md

@@ -210,7 +210,7 @@ const dwarf = world.spawn(Desires(gold));
 
 const constainsSilver = world.query(Contains(silver)); // Returns [inventory]
 const containsAnything = world.query(Contains('*')); // Returns [inventory, chest]
-const relatesToGold = world.query(Widlcard(gold)); // Returns [inventory, chest, dwarf]
+const relatesToGold = world.query(Wildcard(gold)); // Returns [inventory, chest, dwarf]
 ```
 
 ### Query modifiers

package/dist/{chunk-XN4M3U5V.js → chunk-5UTSDPRH.js}

@@ -594,7 +594,7 @@ var cachedSet = /* @__PURE__ */ new Set();
 var cachedQueue = [];
 function destroyEntity(world, entity) {
   const ctx = world[$internal];
-  if (!world.has(entity)) return;
+  if (!world.has(entity)) throw new Error("Koota: The entity being destroyed does not exist.");
   const entityQueue = cachedQueue;
   const processedEntities = cachedSet;
   entityQueue.length = 0;

package/dist/index.cjs

@@ -629,7 +629,7 @@ var cachedSet = /* @__PURE__ */ new Set();
 var cachedQueue = [];
 function destroyEntity(world, entity) {
   const ctx = world[$internal];
-  if (!world.has(entity)) return;
+  if (!world.has(entity)) throw new Error("Koota: The entity being destroyed does not exist.");
   const entityQueue = cachedQueue;
   const processedEntities = cachedSet;
   entityQueue.length = 0;

package/dist/index.d.cts

@@ -1,6 +1,5 @@
-import { S as Schema, T as Trait, N as Norm, M as ModifierData, W as World, Q as QueryParameter, R as Relation, a as RelationTarget } from './world-nBQgHwIP.cjs';
-export { $ as $internal, A as AoSFactory, C as ConfigurableTrait, k as Entity, i as ExtractIsTag, E as ExtractSchema, h as ExtractStore, j as ExtractStores, q as InstancesFromParameters, r as IsNotModifier, I as IsTag, l as QueryModifier, o as QueryResult, n as QueryResultOptions, m as QuerySubscriber, g as Store, p as StoresFromParameters, f as TraitInstance, e as TraitTuple, b as TraitType, d as TraitValue, c as createWorld } from './world-nBQgHwIP.cjs';
-import 'src';
+import { S as Schema, T as Trait, N as Norm, M as ModifierData, W as World, Q as QueryParameter, R as Relation, a as RelationTarget } from './world-B-pehncS.cjs';
+export { $ as $internal, A as AoSFactory, C as ConfigurableTrait, k as Entity, i as ExtractIsTag, E as ExtractSchema, h as ExtractStore, j as ExtractStores, q as InstancesFromParameters, r as IsNotModifier, I as IsTag, l as QueryModifier, o as QueryResult, n as QueryResultOptions, m as QuerySubscriber, g as Store, p as StoresFromParameters, f as TraitInstance, e as TraitTuple, b as TraitType, d as TraitValue, c as createWorld } from './world-B-pehncS.cjs';
 
 declare function defineTrait<S extends Schema = {}>(schema?: S): Trait<Norm<S>>;
 declare const trait: typeof defineTrait;

package/dist/index.d.ts

@@ -1,6 +1,5 @@
-import { S as Schema, T as Trait, N as Norm, M as ModifierData, W as World, Q as QueryParameter, R as Relation, a as RelationTarget } from './world-nBQgHwIP.js';
-export { $ as $internal, A as AoSFactory, C as ConfigurableTrait, k as Entity, i as ExtractIsTag, E as ExtractSchema, h as ExtractStore, j as ExtractStores, q as InstancesFromParameters, r as IsNotModifier, I as IsTag, l as QueryModifier, o as QueryResult, n as QueryResultOptions, m as QuerySubscriber, g as Store, p as StoresFromParameters, f as TraitInstance, e as TraitTuple, b as TraitType, d as TraitValue, c as createWorld } from './world-nBQgHwIP.js';
-import 'src';
+import { S as Schema, T as Trait, N as Norm, M as ModifierData, W as World, Q as QueryParameter, R as Relation, a as RelationTarget } from './world-B-pehncS.js';
+export { $ as $internal, A as AoSFactory, C as ConfigurableTrait, k as Entity, i as ExtractIsTag, E as ExtractSchema, h as ExtractStore, j as ExtractStores, q as InstancesFromParameters, r as IsNotModifier, I as IsTag, l as QueryModifier, o as QueryResult, n as QueryResultOptions, m as QuerySubscriber, g as Store, p as StoresFromParameters, f as TraitInstance, e as TraitTuple, b as TraitType, d as TraitValue, c as createWorld } from './world-B-pehncS.js';
 
 declare function defineTrait<S extends Schema = {}>(schema?: S): Trait<Norm<S>>;
 declare const trait: typeof defineTrait;

package/dist/index.js

@@ -11,7 +11,7 @@ import {
   relation,
   trait,
   universe
-} from "./chunk-XN4M3U5V.js";
+} from "./chunk-5UTSDPRH.js";
 export {
   $internal,
   Not,

package/dist/react.cjs

@@ -51,7 +51,7 @@ var WorldContext = (0, import_react.createContext)(null);
 // ../react/src/world/use-world.ts
 function useWorld() {
   const world = (0, import_react2.useContext)(WorldContext);
-  if (!world) throw new Error("Koota ECS: Hooks can only be used within the World component!");
+  if (!world) throw new Error("Koota: Hooks can only be used within the World component!");
   return world;
 }
 
@@ -95,14 +95,23 @@ function WorldProvider({ children, world }) {
 }
 
 // ../react/src/actions/create-actions.ts
+var actionCache = /* @__PURE__ */ new WeakMap();
 function createActions(actionSet) {
+  const getMemoizedActions = (world) => {
+    let actions = actionCache.get(world);
+    if (!actions) {
+      actions = actionSet(world);
+      actionCache.set(world, actions);
+    }
+    return actions;
+  };
   return Object.assign(
     () => {
       const world = useWorld();
-      return actionSet(world);
+      return getMemoizedActions(world);
     },
     {
-      get: (world) => actionSet(world)
+      get: (world) => getMemoizedActions(world)
     }
   );
 }
@@ -680,7 +689,7 @@ var cachedSet = /* @__PURE__ */ new Set();
 var cachedQueue = [];
 function destroyEntity(world, entity) {
   const ctx = world[$internal];
-  if (!world.has(entity)) return;
+  if (!world.has(entity)) throw new Error("Koota: The entity being destroyed does not exist.");
   const entityQueue = cachedQueue;
   const processedEntities = cachedSet;
   entityQueue.length = 0;

package/dist/react.d.cts

@@ -1,6 +1,5 @@
-import { Q as QueryParameter, o as QueryResult, W as World, T as Trait, k as Entity, f as TraitInstance } from './world-nBQgHwIP.cjs';
+import { Q as QueryParameter, o as QueryResult, W as World, T as Trait, k as Entity, f as TraitInstance } from './world-B-pehncS.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import 'src';
 
 declare function useQuery<T extends QueryParameter[]>(...parameters: T): QueryResult<T>;
 

package/dist/react.d.ts

@@ -1,6 +1,5 @@
-import { Q as QueryParameter, o as QueryResult, W as World, T as Trait, k as Entity, f as TraitInstance } from './world-nBQgHwIP.js';
+import { Q as QueryParameter, o as QueryResult, W as World, T as Trait, k as Entity, f as TraitInstance } from './world-B-pehncS.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import 'src';
 
 declare function useQuery<T extends QueryParameter[]>(...parameters: T): QueryResult<T>;
 

package/dist/react.js

@@ -1,6 +1,6 @@
 import {
   $internal
-} from "./chunk-XN4M3U5V.js";
+} from "./chunk-5UTSDPRH.js";
 
 // ../react/src/hooks/use-query.ts
 import { useEffect, useMemo, useReducer } from "react";
@@ -15,7 +15,7 @@ var WorldContext = createContext(null);
 // ../react/src/world/use-world.ts
 function useWorld() {
   const world = useContext(WorldContext);
-  if (!world) throw new Error("Koota ECS: Hooks can only be used within the World component!");
+  if (!world) throw new Error("Koota: Hooks can only be used within the World component!");
   return world;
 }
 
@@ -59,14 +59,23 @@ function WorldProvider({ children, world }) {
 }
 
 // ../react/src/actions/create-actions.ts
+var actionCache = /* @__PURE__ */ new WeakMap();
 function createActions(actionSet) {
+  const getMemoizedActions = (world) => {
+    let actions = actionCache.get(world);
+    if (!actions) {
+      actions = actionSet(world);
+      actionCache.set(world, actions);
+    }
+    return actions;
+  };
   return Object.assign(
     () => {
       const world = useWorld();
-      return actionSet(world);
+      return getMemoizedActions(world);
     },
     {
-      get: (world) => actionSet(world)
+      get: (world) => getMemoizedActions(world)
     }
   );
 }

package/dist/{world-DeXu3Gyw.d.cts → world-B-pehncS.d.cts}

@@ -1,5 +1,3 @@
-import * as src from 'src';
-
 declare const $internal: unique symbol;
 
 type RelationTarget = number | string;
@@ -127,7 +125,7 @@ type QuerySubscriber = (entity: Entity) => void;
 type QueryResultOptions = {
     changeDetection?: boolean;
 };
-type QueryResult<T extends QueryParameter[]> = readonly Entity[] & {
+type QueryResult<T extends QueryParameter[] = QueryParameter[]> = readonly Entity[] & {
     updateEach: (callback: (state: InstancesFromParameters<T>, entity: Entity, index: number) => void, options?: QueryResultOptions) => QueryResult<T>;
     useStores: (callback: (stores: StoresFromParameters<T>, entities: readonly Entity[]) => void) => QueryResult<T>;
     select<U extends QueryParameter[]>(...params: U): QueryResult<U>;
@@ -219,7 +217,7 @@ declare class World {
     has(trait: Trait): boolean;
     add(...traits: ConfigurableTrait[]): void;
     remove(...traits: Trait[]): void;
-    get<T extends Trait>(trait: T): src.TraitInstance<ExtractSchema<T>>;
+    get<T extends Trait>(trait: T): TraitInstance<ExtractSchema<T>>;
     set<T extends Trait>(trait: T, value: TraitValue<ExtractSchema<T>>): void;
     destroy(): void;
     reset(): void;

package/dist/{world-DeXu3Gyw.d.ts → world-B-pehncS.d.ts}

@@ -1,5 +1,3 @@
-import * as src from 'src';
-
 declare const $internal: unique symbol;
 
 type RelationTarget = number | string;
@@ -127,7 +125,7 @@ type QuerySubscriber = (entity: Entity) => void;
 type QueryResultOptions = {
     changeDetection?: boolean;
 };
-type QueryResult<T extends QueryParameter[]> = readonly Entity[] & {
+type QueryResult<T extends QueryParameter[] = QueryParameter[]> = readonly Entity[] & {
     updateEach: (callback: (state: InstancesFromParameters<T>, entity: Entity, index: number) => void, options?: QueryResultOptions) => QueryResult<T>;
     useStores: (callback: (stores: StoresFromParameters<T>, entities: readonly Entity[]) => void) => QueryResult<T>;
     select<U extends QueryParameter[]>(...params: U): QueryResult<U>;
@@ -219,7 +217,7 @@ declare class World {
     has(trait: Trait): boolean;
     add(...traits: ConfigurableTrait[]): void;
     remove(...traits: Trait[]): void;
-    get<T extends Trait>(trait: T): src.TraitInstance<ExtractSchema<T>>;
+    get<T extends Trait>(trait: T): TraitInstance<ExtractSchema<T>>;
     set<T extends Trait>(trait: T, value: TraitValue<ExtractSchema<T>>): void;
     destroy(): void;
     reset(): void;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koota",
-  "version": "0.1.1",
-  "description": "🌎 Performant data-oriented state management for React and TypeScript.",
+  "version": "0.1.3",
+  "description": "🌎 Performant real-time state management for React and TypeScript",
   "license": "ISC",
   "type": "module",
   "main": "./dist/index.cjs",

package/react/index.cjs

@@ -51,7 +51,7 @@ var WorldContext = (0, import_react.createContext)(null);
 // ../react/src/world/use-world.ts
 function useWorld() {
   const world = (0, import_react2.useContext)(WorldContext);
-  if (!world) throw new Error("Koota ECS: Hooks can only be used within the World component!");
+  if (!world) throw new Error("Koota: Hooks can only be used within the World component!");
   return world;
 }
 
@@ -95,14 +95,23 @@ function WorldProvider({ children, world }) {
 }
 
 // ../react/src/actions/create-actions.ts
+var actionCache = /* @__PURE__ */ new WeakMap();
 function createActions(actionSet) {
+  const getMemoizedActions = (world) => {
+    let actions = actionCache.get(world);
+    if (!actions) {
+      actions = actionSet(world);
+      actionCache.set(world, actions);
+    }
+    return actions;
+  };
   return Object.assign(
     () => {
       const world = useWorld();
-      return actionSet(world);
+      return getMemoizedActions(world);
     },
     {
-      get: (world) => actionSet(world)
+      get: (world) => getMemoizedActions(world)
     }
   );
 }
@@ -680,7 +689,7 @@ var cachedSet = /* @__PURE__ */ new Set();
 var cachedQueue = [];
 function destroyEntity(world, entity) {
   const ctx = world[$internal];
-  if (!world.has(entity)) return;
+  if (!world.has(entity)) throw new Error("Koota: The entity being destroyed does not exist.");
   const entityQueue = cachedQueue;
   const processedEntities = cachedSet;
   entityQueue.length = 0;

package/react/index.d.cts

@@ -1,6 +1,5 @@
-import { Q as QueryParameter, o as QueryResult, W as World, T as Trait, k as Entity, f as TraitInstance } from './world-nBQgHwIP.cjs';
+import { Q as QueryParameter, o as QueryResult, W as World, T as Trait, k as Entity, f as TraitInstance } from './world-B-pehncS.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import 'src';
 
 declare function useQuery<T extends QueryParameter[]>(...parameters: T): QueryResult<T>;
 

package/react/index.d.ts

@@ -1,6 +1,5 @@
-import { Q as QueryParameter, o as QueryResult, W as World, T as Trait, k as Entity, f as TraitInstance } from './world-nBQgHwIP.js';
+import { Q as QueryParameter, o as QueryResult, W as World, T as Trait, k as Entity, f as TraitInstance } from './world-B-pehncS.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import 'src';
 
 declare function useQuery<T extends QueryParameter[]>(...parameters: T): QueryResult<T>;
 

package/react/index.js

@@ -1,6 +1,6 @@
 import {
   $internal
-} from "./chunk-XN4M3U5V.js";
+} from "./chunk-5UTSDPRH.js";
 
 // ../react/src/hooks/use-query.ts
 import { useEffect, useMemo, useReducer } from "react";
@@ -15,7 +15,7 @@ var WorldContext = createContext(null);
 // ../react/src/world/use-world.ts
 function useWorld() {
   const world = useContext(WorldContext);
-  if (!world) throw new Error("Koota ECS: Hooks can only be used within the World component!");
+  if (!world) throw new Error("Koota: Hooks can only be used within the World component!");
   return world;
 }
 
@@ -59,14 +59,23 @@ function WorldProvider({ children, world }) {
 }
 
 // ../react/src/actions/create-actions.ts
+var actionCache = /* @__PURE__ */ new WeakMap();
 function createActions(actionSet) {
+  const getMemoizedActions = (world) => {
+    let actions = actionCache.get(world);
+    if (!actions) {
+      actions = actionSet(world);
+      actionCache.set(world, actions);
+    }
+    return actions;
+  };
   return Object.assign(
     () => {
       const world = useWorld();
-      return actionSet(world);
+      return getMemoizedActions(world);
     },
     {
-      get: (world) => actionSet(world)
+      get: (world) => getMemoizedActions(world)
     }
   );
 }

package/{dist/world-BRz2NI5_.d.cts → react/world-B-pehncS.d.cts}

@@ -12,13 +12,15 @@ type Relation<T> = T & {
 
 type IsEmpty<T> = T extends Record<string, never> ? true : false;
 
+type TraitType = 'aos' | 'soa';
+type TraitValue<TSchema extends Schema> = TSchema extends AoSFactory ? ReturnType<TSchema> : Partial<TraitInstance<TSchema>>;
 type Trait<TSchema extends Schema = any, TStore = Store<TSchema>, TTag extends boolean = IsEmpty<TSchema>> = {
     schema: TSchema;
     [$internal]: {
-        set: (index: number, store: TStore, values: Partial<TraitInstanceFromSchema<TSchema>>) => void;
-        fastSet: (index: number, store: TStore, values: Partial<TraitInstanceFromSchema<TSchema>>) => void;
-        fastSetWithChangeDetection: (index: number, store: TStore, values: Partial<TraitInstanceFromSchema<TSchema>>) => boolean;
-        get: (index: number, store: TStore) => TraitInstanceFromSchema<TSchema>;
+        set: (index: number, store: any, value: TraitValue<TSchema>) => void;
+        fastSet: (index: number, store: any, value: TraitValue<TSchema>) => boolean;
+        fastSetWithChangeDetection: (index: number, store: any, value: TraitValue<TSchema>) => boolean;
+        get: (index: number, store: any) => TraitInstance<TSchema>;
         stores: TStore[];
         id: number;
         createStore: () => TStore;
@@ -26,31 +28,34 @@ type Trait<TSchema extends Schema = any, TStore = Store<TSchema>, TTag extends b
         relation: Relation<any> | null;
         pairTarget: RelationTarget | null;
         isTag: TTag;
+        type: TraitType;
     };
-} & ((params: Partial<TraitInstanceFromSchema<TSchema>>) => [Trait<TSchema, TStore>, Partial<TSchema>]);
+} & ((params?: TraitValue<TSchema>) => [Trait<TSchema, TStore, TTag>, TraitValue<TSchema>]);
 type TraitTuple<T extends Trait = Trait> = [
     T,
-    T extends Trait<infer S, any> ? Partial<TraitInstanceFromSchema<S>> : never
+    T extends Trait<infer S, any> ? S extends AoSFactory ? ReturnType<S> : Partial<TraitInstance<S>> : never
 ];
 type ConfigurableTrait<T extends Trait = Trait> = T | TraitTuple<T>;
-type TraitInstanceFromSchema<T extends Schema> = {
-    [P in keyof T]: T[P] extends (...args: any[]) => any ? ReturnType<T[P]> : T[P];
-};
-type TraitInstance<T extends Trait> = {
+type TraitInstanceFromTrait<T extends Trait> = T['schema'] extends AoSFactory ? ReturnType<T['schema']> : {
     [P in keyof T['schema']]: T['schema'][P] extends (...args: any[]) => any ? ReturnType<T['schema'][P]> : T['schema'][P];
 };
+type TraitInstanceFromSchema<T extends Schema> = T extends AoSFactory ? ReturnType<T> : {
+    [P in keyof T]: T[P] extends (...args: any[]) => any ? ReturnType<T[P]> : T[P];
+};
+type TraitInstance<T extends Trait | Schema> = T extends Trait ? TraitInstanceFromTrait<T> : TraitInstanceFromSchema<T>;
 type Schema = {
     [key: string]: number | string | boolean | any[] | object | null | undefined;
-};
-type Store<T extends Schema = any> = {
+} | AoSFactory;
+type AoSFactory = () => Record<string, any>;
+type Store<T extends Schema = any> = T extends AoSFactory ? ReturnType<T>[] : {
     [P in keyof T]: T[P] extends (...args: any[]) => any ? ReturnType<T[P]>[] : T[P][];
 };
-type Norm<T extends Schema> = {
+type Norm<T extends Schema> = T extends AoSFactory ? () => ReturnType<T> extends number ? number : ReturnType<T> extends boolean ? boolean : ReturnType<T> extends string ? string : ReturnType<T> : {
     [K in keyof T]: T[K] extends boolean ? boolean : T[K];
 };
-type TraitSnapshot<T extends Trait> = T extends Trait<infer S, any> ? TraitInstanceFromSchema<S> : never;
 type ExtractSchema<T extends Trait> = T extends Trait<infer S, any> ? S : never;
 type ExtractStore<T extends Trait> = T extends Trait<any, infer S> ? S : never;
+type ExtractIsTag<T extends Trait> = T extends Trait<any, any, infer Tag> ? Tag : false;
 type ExtractStores<T extends [Trait, ...Trait[]]> = T extends [infer C] ? C extends Trait<any, Store<any>> ? ExtractStore<C> : never : {
     [K in keyof T]: ExtractStore<T[K]>;
 };
@@ -62,8 +67,8 @@ type Entity = number & {
     has: (trait: Trait) => boolean;
     destroy: () => void;
     changed: (trait: Trait) => void;
-    set: <T extends Trait>(trait: T, value: Partial<TraitInstanceFromSchema<ExtractSchema<T>>>, flagChanged?: boolean) => void;
-    get: <T extends Trait>(trait: T) => TraitInstanceFromSchema<ExtractSchema<T>>;
+    set: <T extends Trait>(trait: T, value: TraitValue<ExtractSchema<T>>, flagChanged?: boolean) => void;
+    get: <T extends Trait>(trait: T) => TraitInstance<ExtractSchema<T>>;
     targetFor: <T>(relation: Relation<T>) => Entity | undefined;
     targetsFor: <T>(relation: Relation<T>) => Entity[];
     id: () => number;
@@ -82,6 +87,18 @@ type EntityIndex = {
     worldId: number;
 };
 
+declare class TraitData<T extends Trait = Trait, S extends Schema = ExtractSchema<T>> {
+    generationId: number;
+    bitflag: number;
+    trait: Trait;
+    store: Store<S>;
+    queries: Set<Query>;
+    notQueries: Set<Query>;
+    schema: S;
+    changedSubscriptions: Set<(entity: Entity) => void>;
+    constructor(world: World, trait: T);
+}
+
 declare class SparseSet {
     #private;
     has(val: number): boolean;
@@ -106,10 +123,10 @@ type QueryModifier = (...components: Trait[]) => ModifierData;
 type QueryParameter = Trait | ReturnType<QueryModifier>;
 type QuerySubscriber = (entity: Entity) => void;
 type QueryResultOptions = {
-    passive?: boolean;
+    changeDetection?: boolean;
 };
-type QueryResult<T extends QueryParameter[]> = readonly Entity[] & {
-    updateEach: (callback: (state: SnapshotFromParameters<T>, entity: Entity, index: number) => void, options?: QueryResultOptions) => QueryResult<T>;
+type QueryResult<T extends QueryParameter[] = QueryParameter[]> = readonly Entity[] & {
+    updateEach: (callback: (state: InstancesFromParameters<T>, entity: Entity, index: number) => void, options?: QueryResultOptions) => QueryResult<T>;
     useStores: (callback: (stores: StoresFromParameters<T>, entities: readonly Entity[]) => void) => QueryResult<T>;
     select<U extends QueryParameter[]>(...params: U): QueryResult<U>;
 };
@@ -118,12 +135,12 @@ type StoresFromParameters<T extends QueryParameter[]> = T extends [infer First,
     ...(First extends Trait ? [ExtractStore<First>] : First extends ModifierData<any> ? StoresFromParameters<UnwrapModifierData<First>> : []),
     ...(Rest extends QueryParameter[] ? StoresFromParameters<Rest> : [])
 ] : [];
-type SnapshotFromParameters<T extends QueryParameter[]> = T extends [
+type InstancesFromParameters<T extends QueryParameter[]> = T extends [
     infer First,
     ...infer Rest
 ] ? [
-    ...(First extends Trait ? IsTag<First> extends false ? [TraitSnapshot<First>] : [] : First extends ModifierData<any> ? IsNotModifier<First> extends true ? [] : SnapshotFromParameters<UnwrapModifierData<First>> : []),
-    ...(Rest extends QueryParameter[] ? SnapshotFromParameters<Rest> : [])
+    ...(First extends Trait ? IsTag<First> extends false ? ExtractSchema<First> extends AoSFactory ? [ReturnType<ExtractSchema<First>>] : [TraitInstance<First>] : [] : First extends ModifierData<any> ? IsNotModifier<First> extends true ? [] : InstancesFromParameters<UnwrapModifierData<First>> : []),
+    ...(Rest extends QueryParameter[] ? InstancesFromParameters<Rest> : [])
 ] : [];
 type IsNotModifier<T> = T extends ModifierData<any, infer TType> ? TType extends 'not' ? true : false : false;
 
@@ -171,18 +188,6 @@ declare class Query {
     resetTrackingBitmasks(eid: number): void;
 }
 
-declare class TraitData<T extends Trait = Trait, S extends Schema = ExtractSchema<T>> {
-    generationId: number;
-    bitflag: number;
-    trait: Trait;
-    store: Store<S>;
-    queries: Set<Query>;
-    notQueries: Set<Query>;
-    schema: S;
-    changedSubscriptions: Set<(entity: Entity) => void>;
-    constructor(world: World, trait: T);
-}
-
 declare class World {
     #private;
     [$internal]: {
@@ -212,8 +217,8 @@ declare class World {
     has(trait: Trait): boolean;
     add(...traits: ConfigurableTrait[]): void;
     remove(...traits: Trait[]): void;
-    get<T extends Trait>(trait: T): TraitInstanceFromSchema<ExtractSchema<T>>;
-    set<T extends Trait>(trait: T, value: Partial<TraitInstanceFromSchema<ExtractSchema<T>>>): void;
+    get<T extends Trait>(trait: T): TraitInstance<ExtractSchema<T>>;
+    set<T extends Trait>(trait: T, value: TraitValue<ExtractSchema<T>>): void;
     destroy(): void;
     reset(): void;
     query<T extends QueryParameter[]>(key: string): QueryResult<T>;
@@ -226,4 +231,4 @@ declare class World {
 }
 declare function createWorld(...traits: ConfigurableTrait[]): World;
 
-export { $internal as $, type ConfigurableTrait as C, type ExtractSchema as E, type IsTag as I, ModifierData as M, type Norm as N, type QueryParameter as Q, type Relation as R, type Schema as S, type Trait as T, World as W, type RelationTarget as a, type TraitTuple as b, createWorld as c, type TraitInstanceFromSchema as d, type TraitInstance as e, type Store as f, type TraitSnapshot as g, type ExtractStore as h, type ExtractStores as i, type Entity as j, type QueryModifier as k, type QuerySubscriber as l, type QueryResultOptions as m, type QueryResult as n, type StoresFromParameters as o, type SnapshotFromParameters as p, type IsNotModifier as q };
+export { $internal as $, type AoSFactory as A, type ConfigurableTrait as C, type ExtractSchema as E, type IsTag as I, ModifierData as M, type Norm as N, type QueryParameter as Q, type Relation as R, type Schema as S, type Trait as T, World as W, type RelationTarget as a, type TraitType as b, createWorld as c, type TraitValue as d, type TraitTuple as e, type TraitInstance as f, type Store as g, type ExtractStore as h, type ExtractIsTag as i, type ExtractStores as j, type Entity as k, type QueryModifier as l, type QuerySubscriber as m, type QueryResultOptions as n, type QueryResult as o, type StoresFromParameters as p, type InstancesFromParameters as q, type IsNotModifier as r };

package/{dist/world-BRz2NI5_.d.ts → react/world-B-pehncS.d.ts}

@@ -12,13 +12,15 @@ type Relation<T> = T & {
 
 type IsEmpty<T> = T extends Record<string, never> ? true : false;
 
+type TraitType = 'aos' | 'soa';
+type TraitValue<TSchema extends Schema> = TSchema extends AoSFactory ? ReturnType<TSchema> : Partial<TraitInstance<TSchema>>;
 type Trait<TSchema extends Schema = any, TStore = Store<TSchema>, TTag extends boolean = IsEmpty<TSchema>> = {
     schema: TSchema;
     [$internal]: {
-        set: (index: number, store: TStore, values: Partial<TraitInstanceFromSchema<TSchema>>) => void;
-        fastSet: (index: number, store: TStore, values: Partial<TraitInstanceFromSchema<TSchema>>) => void;
-        fastSetWithChangeDetection: (index: number, store: TStore, values: Partial<TraitInstanceFromSchema<TSchema>>) => boolean;
-        get: (index: number, store: TStore) => TraitInstanceFromSchema<TSchema>;
+        set: (index: number, store: any, value: TraitValue<TSchema>) => void;
+        fastSet: (index: number, store: any, value: TraitValue<TSchema>) => boolean;
+        fastSetWithChangeDetection: (index: number, store: any, value: TraitValue<TSchema>) => boolean;
+        get: (index: number, store: any) => TraitInstance<TSchema>;
         stores: TStore[];
         id: number;
         createStore: () => TStore;
@@ -26,31 +28,34 @@ type Trait<TSchema extends Schema = any, TStore = Store<TSchema>, TTag extends b
         relation: Relation<any> | null;
         pairTarget: RelationTarget | null;
         isTag: TTag;
+        type: TraitType;
     };
-} & ((params: Partial<TraitInstanceFromSchema<TSchema>>) => [Trait<TSchema, TStore>, Partial<TSchema>]);
+} & ((params?: TraitValue<TSchema>) => [Trait<TSchema, TStore, TTag>, TraitValue<TSchema>]);
 type TraitTuple<T extends Trait = Trait> = [
     T,
-    T extends Trait<infer S, any> ? Partial<TraitInstanceFromSchema<S>> : never
+    T extends Trait<infer S, any> ? S extends AoSFactory ? ReturnType<S> : Partial<TraitInstance<S>> : never
 ];
 type ConfigurableTrait<T extends Trait = Trait> = T | TraitTuple<T>;
-type TraitInstanceFromSchema<T extends Schema> = {
-    [P in keyof T]: T[P] extends (...args: any[]) => any ? ReturnType<T[P]> : T[P];
-};
-type TraitInstance<T extends Trait> = {
+type TraitInstanceFromTrait<T extends Trait> = T['schema'] extends AoSFactory ? ReturnType<T['schema']> : {
     [P in keyof T['schema']]: T['schema'][P] extends (...args: any[]) => any ? ReturnType<T['schema'][P]> : T['schema'][P];
 };
+type TraitInstanceFromSchema<T extends Schema> = T extends AoSFactory ? ReturnType<T> : {
+    [P in keyof T]: T[P] extends (...args: any[]) => any ? ReturnType<T[P]> : T[P];
+};
+type TraitInstance<T extends Trait | Schema> = T extends Trait ? TraitInstanceFromTrait<T> : TraitInstanceFromSchema<T>;
 type Schema = {
     [key: string]: number | string | boolean | any[] | object | null | undefined;
-};
-type Store<T extends Schema = any> = {
+} | AoSFactory;
+type AoSFactory = () => Record<string, any>;
+type Store<T extends Schema = any> = T extends AoSFactory ? ReturnType<T>[] : {
     [P in keyof T]: T[P] extends (...args: any[]) => any ? ReturnType<T[P]>[] : T[P][];
 };
-type Norm<T extends Schema> = {
+type Norm<T extends Schema> = T extends AoSFactory ? () => ReturnType<T> extends number ? number : ReturnType<T> extends boolean ? boolean : ReturnType<T> extends string ? string : ReturnType<T> : {
     [K in keyof T]: T[K] extends boolean ? boolean : T[K];
 };
-type TraitSnapshot<T extends Trait> = T extends Trait<infer S, any> ? TraitInstanceFromSchema<S> : never;
 type ExtractSchema<T extends Trait> = T extends Trait<infer S, any> ? S : never;
 type ExtractStore<T extends Trait> = T extends Trait<any, infer S> ? S : never;
+type ExtractIsTag<T extends Trait> = T extends Trait<any, any, infer Tag> ? Tag : false;
 type ExtractStores<T extends [Trait, ...Trait[]]> = T extends [infer C] ? C extends Trait<any, Store<any>> ? ExtractStore<C> : never : {
     [K in keyof T]: ExtractStore<T[K]>;
 };
@@ -62,8 +67,8 @@ type Entity = number & {
     has: (trait: Trait) => boolean;
     destroy: () => void;
     changed: (trait: Trait) => void;
-    set: <T extends Trait>(trait: T, value: Partial<TraitInstanceFromSchema<ExtractSchema<T>>>, flagChanged?: boolean) => void;
-    get: <T extends Trait>(trait: T) => TraitInstanceFromSchema<ExtractSchema<T>>;
+    set: <T extends Trait>(trait: T, value: TraitValue<ExtractSchema<T>>, flagChanged?: boolean) => void;
+    get: <T extends Trait>(trait: T) => TraitInstance<ExtractSchema<T>>;
     targetFor: <T>(relation: Relation<T>) => Entity | undefined;
     targetsFor: <T>(relation: Relation<T>) => Entity[];
     id: () => number;
@@ -82,6 +87,18 @@ type EntityIndex = {
     worldId: number;
 };
 
+declare class TraitData<T extends Trait = Trait, S extends Schema = ExtractSchema<T>> {
+    generationId: number;
+    bitflag: number;
+    trait: Trait;
+    store: Store<S>;
+    queries: Set<Query>;
+    notQueries: Set<Query>;
+    schema: S;
+    changedSubscriptions: Set<(entity: Entity) => void>;
+    constructor(world: World, trait: T);
+}
+
 declare class SparseSet {
     #private;
     has(val: number): boolean;
@@ -106,10 +123,10 @@ type QueryModifier = (...components: Trait[]) => ModifierData;
 type QueryParameter = Trait | ReturnType<QueryModifier>;
 type QuerySubscriber = (entity: Entity) => void;
 type QueryResultOptions = {
-    passive?: boolean;
+    changeDetection?: boolean;
 };
-type QueryResult<T extends QueryParameter[]> = readonly Entity[] & {
-    updateEach: (callback: (state: SnapshotFromParameters<T>, entity: Entity, index: number) => void, options?: QueryResultOptions) => QueryResult<T>;
+type QueryResult<T extends QueryParameter[] = QueryParameter[]> = readonly Entity[] & {
+    updateEach: (callback: (state: InstancesFromParameters<T>, entity: Entity, index: number) => void, options?: QueryResultOptions) => QueryResult<T>;
     useStores: (callback: (stores: StoresFromParameters<T>, entities: readonly Entity[]) => void) => QueryResult<T>;
     select<U extends QueryParameter[]>(...params: U): QueryResult<U>;
 };
@@ -118,12 +135,12 @@ type StoresFromParameters<T extends QueryParameter[]> = T extends [infer First,
     ...(First extends Trait ? [ExtractStore<First>] : First extends ModifierData<any> ? StoresFromParameters<UnwrapModifierData<First>> : []),
     ...(Rest extends QueryParameter[] ? StoresFromParameters<Rest> : [])
 ] : [];
-type SnapshotFromParameters<T extends QueryParameter[]> = T extends [
+type InstancesFromParameters<T extends QueryParameter[]> = T extends [
     infer First,
     ...infer Rest
 ] ? [
-    ...(First extends Trait ? IsTag<First> extends false ? [TraitSnapshot<First>] : [] : First extends ModifierData<any> ? IsNotModifier<First> extends true ? [] : SnapshotFromParameters<UnwrapModifierData<First>> : []),
-    ...(Rest extends QueryParameter[] ? SnapshotFromParameters<Rest> : [])
+    ...(First extends Trait ? IsTag<First> extends false ? ExtractSchema<First> extends AoSFactory ? [ReturnType<ExtractSchema<First>>] : [TraitInstance<First>] : [] : First extends ModifierData<any> ? IsNotModifier<First> extends true ? [] : InstancesFromParameters<UnwrapModifierData<First>> : []),
+    ...(Rest extends QueryParameter[] ? InstancesFromParameters<Rest> : [])
 ] : [];
 type IsNotModifier<T> = T extends ModifierData<any, infer TType> ? TType extends 'not' ? true : false : false;
 
@@ -171,18 +188,6 @@ declare class Query {
     resetTrackingBitmasks(eid: number): void;
 }
 
-declare class TraitData<T extends Trait = Trait, S extends Schema = ExtractSchema<T>> {
-    generationId: number;
-    bitflag: number;
-    trait: Trait;
-    store: Store<S>;
-    queries: Set<Query>;
-    notQueries: Set<Query>;
-    schema: S;
-    changedSubscriptions: Set<(entity: Entity) => void>;
-    constructor(world: World, trait: T);
-}
-
 declare class World {
     #private;
     [$internal]: {
@@ -212,8 +217,8 @@ declare class World {
     has(trait: Trait): boolean;
     add(...traits: ConfigurableTrait[]): void;
     remove(...traits: Trait[]): void;
-    get<T extends Trait>(trait: T): TraitInstanceFromSchema<ExtractSchema<T>>;
-    set<T extends Trait>(trait: T, value: Partial<TraitInstanceFromSchema<ExtractSchema<T>>>): void;
+    get<T extends Trait>(trait: T): TraitInstance<ExtractSchema<T>>;
+    set<T extends Trait>(trait: T, value: TraitValue<ExtractSchema<T>>): void;
     destroy(): void;
     reset(): void;
     query<T extends QueryParameter[]>(key: string): QueryResult<T>;
@@ -226,4 +231,4 @@ declare class World {
 }
 declare function createWorld(...traits: ConfigurableTrait[]): World;
 
-export { $internal as $, type ConfigurableTrait as C, type ExtractSchema as E, type IsTag as I, ModifierData as M, type Norm as N, type QueryParameter as Q, type Relation as R, type Schema as S, type Trait as T, World as W, type RelationTarget as a, type TraitTuple as b, createWorld as c, type TraitInstanceFromSchema as d, type TraitInstance as e, type Store as f, type TraitSnapshot as g, type ExtractStore as h, type ExtractStores as i, type Entity as j, type QueryModifier as k, type QuerySubscriber as l, type QueryResultOptions as m, type QueryResult as n, type StoresFromParameters as o, type SnapshotFromParameters as p, type IsNotModifier as q };
+export { $internal as $, type AoSFactory as A, type ConfigurableTrait as C, type ExtractSchema as E, type IsTag as I, ModifierData as M, type Norm as N, type QueryParameter as Q, type Relation as R, type Schema as S, type Trait as T, World as W, type RelationTarget as a, type TraitType as b, createWorld as c, type TraitValue as d, type TraitTuple as e, type TraitInstance as f, type Store as g, type ExtractStore as h, type ExtractIsTag as i, type ExtractStores as j, type Entity as k, type QueryModifier as l, type QuerySubscriber as m, type QueryResultOptions as n, type QueryResult as o, type StoresFromParameters as p, type InstancesFromParameters as q, type IsNotModifier as r };

package/dist/chunk-AQ5VUG5P.js

@@ -1,17 +0,0 @@
-var __defProp = Object.defineProperty;
-var __typeError = (msg) => {
-  throw TypeError(msg);
-};
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
-var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
-var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
-var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
-
-export {
-  __publicField,
-  __privateGet,
-  __privateAdd,
-  __privateSet
-};