koota 0.4.3 → 0.5.0

package/README.md

@@ -217,6 +217,35 @@ const containsAnything = world.query(Contains('*')) // Returns [inventory, chest
 const relatesToGold = world.query(Wildcard(gold)) // Returns [inventory, chest, dwarf]
 ```
 
+#### Removing relationships
+
+A relationship targets a specific entity, so we need to likewise remove relationships with specific entities.
+
+```js
+// Add a specific relation
+player.add(Likes(apple))
+player.add(Likes(banana))
+
+// Remove that same relation
+player.remove(Likes(apple))
+
+player.has(apple) // false
+player.has(banana) // true
+```
+
+However, a wildcard can be used to remove all relationships of a kind — for all targets — from an entity.
+
+```js
+player.add(Likes(apple))
+player.add(Likes(banana))
+
+// Remove all Likes relations
+player.remove(Likes('*'))
+
+player.has(apple) // false
+player.has(banana) // false
+```
+
 ### Query modifiers
 
 Modifiers are used to filter query results enabling powerful patterns. All modifiers can be mixed together.
@@ -550,7 +579,7 @@ const { entityId, generation, worldId } = unpackEntity(entity)
 
 ### Trait
 
-A trait is a specific block of data. They are added to entities to build up its overall data signature. If you are familiar with ECS, it is our version of a component. It is called a trait instead to not get confused with React or web components.
+Traits are self-contained slices of data you attach to an entity to define its state. They serve the same purpose as components in a traditional ECS. We call them traits to avoid confusion with React or web components.
 
 A trait can be created with a schema that describes the kind of data it will hold.
 
@@ -558,22 +587,27 @@ A trait can be created with a schema that describes the kind of data it will hol
 const Position = trait({ x: 0, y: 0, z: 0 })
 ```
 
-In cases where the data needs to be initialized for each instance of the trait created, a callback can be passed in to be used a as a lazy initializer.
+A schema supports primitive values with **no** nested objects or arrays. In cases where the data needs to initialized for each instance of the trait, or complex structures are required, a callback initializer can be used.
 
 ```js
-// ❌ The items array will be shared between every instance of this trait
+// ❌ Arrays and objects are not allowed in trait schemas
 const Inventory = trait({
   items: [],
+  vec3: { x: 0, y: 0, z: 0}
   max: 10,
 })
 
-// ✅ With a lazy initializer, each instance will now get its own array
+// ✅ Use a callback initializer for arrays and objects
 const Inventory = trait({
   items: () => [],
+  vec3: () => ({ x: 0, y: 0, z: 0})
   max: 10,
 })
 ```
 
+> ℹ️ **Why not support nested schemas?**<br>
+> It looks obvious to support nested stores, but doing so makes algorithms that work with the data exponentially more complex. If all data can be assumed scalar then any operation is guaranteed to be the simplest and fastest algorithm possible. This is called the First Normal Form in relational database theory. [You can read more here](https://www.dataorienteddesign.com/dodbook/node3.html#SECTION00340000000000000000).
+
 Sometimes a trait only has one field that points to an object instance. In cases like this, it is useful to skip the schema and use a callback directly in the trait.
 
 ```js

package/dist/{chunk-6HKEF2RH.js → chunk-KLYFWWYD.js}

@@ -298,11 +298,23 @@ function createStore(schema) {
   }
 }
 
+// ../core/src/trait/utils/validate-schema.ts
+function validateSchema(schema) {
+  for (const key in schema) {
+    const value = schema[key];
+    if (value !== null && typeof value === "object") {
+      const kind = Array.isArray(value) ? "array" : "object";
+      throw new Error(`Koota: ${key} is an ${kind}, which is not supported in traits.`);
+    }
+  }
+}
+
 // ../core/src/trait/trait.ts
 var traitId = 0;
 function defineTrait(schema = {}) {
   const isAoS = typeof schema === "function";
   const traitType = isAoS ? "aos" : "soa";
+  validateSchema(schema);
   const Trait = Object.assign((params) => [Trait, params], {
     schema,
     [$internal]: {
@@ -468,6 +480,13 @@ function removeTrait(world, entity, ...traits) {
       if (otherTargets.length === 0) {
         removeTrait(world, entity, Pair(relation2, Wildcard));
       }
+      if (traitCtx.isPairTrait && traitCtx.pairTarget === Wildcard && traitCtx.relation !== Wildcard) {
+        const relation3 = traitCtx.relation;
+        const targets = getRelationTargets(world, relation3, entity);
+        for (const target2 of targets) {
+          removeTrait(world, entity, relation3(target2));
+        }
+      }
     }
   }
 }

package/dist/index.cjs

@@ -343,11 +343,23 @@ function createStore(schema) {
   }
 }
 
+// ../core/src/trait/utils/validate-schema.ts
+function validateSchema(schema) {
+  for (const key in schema) {
+    const value = schema[key];
+    if (value !== null && typeof value === "object") {
+      const kind = Array.isArray(value) ? "array" : "object";
+      throw new Error(`Koota: ${key} is an ${kind}, which is not supported in traits.`);
+    }
+  }
+}
+
 // ../core/src/trait/trait.ts
 var traitId = 0;
 function defineTrait(schema = {}) {
   const isAoS = typeof schema === "function";
   const traitType = isAoS ? "aos" : "soa";
+  validateSchema(schema);
   const Trait = Object.assign((params) => [Trait, params], {
     schema,
     [$internal]: {
@@ -513,6 +525,13 @@ function removeTrait(world, entity, ...traits) {
       if (otherTargets.length === 0) {
         removeTrait(world, entity, Pair(relation2, Wildcard));
       }
+      if (traitCtx.isPairTrait && traitCtx.pairTarget === Wildcard && traitCtx.relation !== Wildcard) {
+        const relation3 = traitCtx.relation;
+        const targets = getRelationTargets(world, relation3, entity);
+        for (const target2 of targets) {
+          removeTrait(world, entity, relation3(target2));
+        }
+      }
     }
   }
 }

package/dist/index.d.cts

@@ -1,6 +1,5 @@
-import { W as World, E as Entity, T as Trait, M as ModifierData, Q as QueryParameter, a as QueryHash, R as Relation, b as RelationTarget, S as Schema, c as WildcardRelation, d as ExtractStore, N as Norm } from './world-CbC1N0VY.cjs';
-export { $ as $internal, A as AoSFactory, C as ConfigurableTrait, t as ExtractIsTag, s as ExtractSchema, l as InstancesFromParameters, I as IsExcluded, m as IsNotModifier, u as IsTag, f as QueryModifier, j as QueryResult, i as QueryResultOptions, g as QuerySubscriber, h as QueryUnsubscriber, r as Store, k as StoresFromParameters, q as TraitInstance, p as TraitTuple, n as TraitType, o as TraitValue, e as createWorld } from './world-CbC1N0VY.cjs';
-import 'src';
+import { W as World, E as Entity, T as Trait, M as ModifierData, Q as QueryParameter, a as QueryHash, R as Relation, b as RelationTarget, S as Schema, c as WildcardRelation, d as ExtractStore, N as Norm } from './world-DzIKt3Qf.cjs';
+export { $ as $internal, A as AoSFactory, C as ConfigurableTrait, u as ExtractIsTag, t as ExtractSchema, l as InstancesFromParameters, I as IsExcluded, m as IsNotModifier, v as IsTag, f as QueryModifier, j as QueryResult, i as QueryResultOptions, g as QuerySubscriber, h as QueryUnsubscriber, q as SetTraitCallback, s as Store, k as StoresFromParameters, r as TraitInstance, p as TraitTuple, n as TraitType, o as TraitValue, e as createWorld } from './world-DzIKt3Qf.cjs';
 
 type Actions = Record<string, (...args: any[]) => void>;
 type ActionInitializer<T extends Actions> = (world: World) => T;
@@ -35,8 +34,7 @@ declare const relation: typeof defineRelation;
 declare const Pair: <T extends Trait>(relation: Relation<T>, target: RelationTarget) => T;
 declare const Wildcard: WildcardRelation;
 
-declare function defineTrait(): Trait<Schema>;
-declare function defineTrait<S extends Schema>(schema: S): Trait<Norm<S>>;
+declare function defineTrait<S extends Schema>(schema?: S): Trait<Norm<S>>;
 declare const trait: typeof defineTrait;
 declare function getStore<C extends Trait = Trait>(world: World, trait: C): ExtractStore<C>;
 

package/dist/index.d.ts

@@ -1,6 +1,5 @@
-import { W as World, E as Entity, T as Trait, M as ModifierData, Q as QueryParameter, a as QueryHash, R as Relation, b as RelationTarget, S as Schema, c as WildcardRelation, d as ExtractStore, N as Norm } from './world-CbC1N0VY.js';
-export { $ as $internal, A as AoSFactory, C as ConfigurableTrait, t as ExtractIsTag, s as ExtractSchema, l as InstancesFromParameters, I as IsExcluded, m as IsNotModifier, u as IsTag, f as QueryModifier, j as QueryResult, i as QueryResultOptions, g as QuerySubscriber, h as QueryUnsubscriber, r as Store, k as StoresFromParameters, q as TraitInstance, p as TraitTuple, n as TraitType, o as TraitValue, e as createWorld } from './world-CbC1N0VY.js';
-import 'src';
+import { W as World, E as Entity, T as Trait, M as ModifierData, Q as QueryParameter, a as QueryHash, R as Relation, b as RelationTarget, S as Schema, c as WildcardRelation, d as ExtractStore, N as Norm } from './world-DzIKt3Qf.js';
+export { $ as $internal, A as AoSFactory, C as ConfigurableTrait, u as ExtractIsTag, t as ExtractSchema, l as InstancesFromParameters, I as IsExcluded, m as IsNotModifier, v as IsTag, f as QueryModifier, j as QueryResult, i as QueryResultOptions, g as QuerySubscriber, h as QueryUnsubscriber, q as SetTraitCallback, s as Store, k as StoresFromParameters, r as TraitInstance, p as TraitTuple, n as TraitType, o as TraitValue, e as createWorld } from './world-DzIKt3Qf.js';
 
 type Actions = Record<string, (...args: any[]) => void>;
 type ActionInitializer<T extends Actions> = (world: World) => T;
@@ -35,8 +34,7 @@ declare const relation: typeof defineRelation;
 declare const Pair: <T extends Trait>(relation: Relation<T>, target: RelationTarget) => T;
 declare const Wildcard: WildcardRelation;
 
-declare function defineTrait(): Trait<Schema>;
-declare function defineTrait<S extends Schema>(schema: S): Trait<Norm<S>>;
+declare function defineTrait<S extends Schema>(schema?: S): Trait<Norm<S>>;
 declare const trait: typeof defineTrait;
 declare function getStore<C extends Trait = Trait>(world: World, trait: C): ExtractStore<C>;
 

package/dist/index.js

@@ -17,7 +17,7 @@ import {
   trait,
   universe,
   unpackEntity
-} from "./chunk-6HKEF2RH.js";
+} from "./chunk-KLYFWWYD.js";
 export {
   $internal,
   IsExcluded,

package/dist/react.cjs

@@ -316,11 +316,23 @@ function createStore(schema) {
   }
 }
 
+// ../core/src/trait/utils/validate-schema.ts
+function validateSchema(schema) {
+  for (const key in schema) {
+    const value = schema[key];
+    if (value !== null && typeof value === "object") {
+      const kind = Array.isArray(value) ? "array" : "object";
+      throw new Error(`Koota: ${key} is an ${kind}, which is not supported in traits.`);
+    }
+  }
+}
+
 // ../core/src/trait/trait.ts
 var traitId = 0;
 function defineTrait(schema = {}) {
   const isAoS = typeof schema === "function";
   const traitType = isAoS ? "aos" : "soa";
+  validateSchema(schema);
   const Trait = Object.assign((params) => [Trait, params], {
     schema,
     [$internal]: {
@@ -486,6 +498,13 @@ function removeTrait(world, entity, ...traits) {
       if (otherTargets.length === 0) {
         removeTrait(world, entity, Pair(relation2, Wildcard));
       }
+      if (traitCtx.isPairTrait && traitCtx.pairTarget === Wildcard && traitCtx.relation !== Wildcard) {
+        const relation3 = traitCtx.relation;
+        const targets = getRelationTargets(world, relation3, entity);
+        for (const target2 of targets) {
+          removeTrait(world, entity, relation3(target2));
+        }
+      }
     }
   }
 }

package/dist/react.d.cts

@@ -1,6 +1,5 @@
-import { W as World, Q as QueryParameter, j as QueryResult, E as Entity, T as Trait, q as TraitInstance } from './world-CbC1N0VY.cjs';
+import { W as World, Q as QueryParameter, j as QueryResult, E as Entity, T as Trait, r as TraitInstance } from './world-DzIKt3Qf.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import 'src';
 
 declare function useActions<T extends Record<string, (...args: any[]) => any>>(actions: (world: World) => T): T;
 

package/dist/react.d.ts

@@ -1,6 +1,5 @@
-import { W as World, Q as QueryParameter, j as QueryResult, E as Entity, T as Trait, q as TraitInstance } from './world-CbC1N0VY.js';
+import { W as World, Q as QueryParameter, j as QueryResult, E as Entity, T as Trait, r as TraitInstance } from './world-DzIKt3Qf.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import 'src';
 
 declare function useActions<T extends Record<string, (...args: any[]) => any>>(actions: (world: World) => T): T;
 

package/dist/react.js

@@ -2,7 +2,7 @@
 import {
   $internal,
   cacheQuery
-} from "./chunk-6HKEF2RH.js";
+} from "./chunk-KLYFWWYD.js";
 
 // ../react/src/world/use-world.ts
 import { useContext } from "react";

package/dist/{world-CbC1N0VY.d.cts → world-DzIKt3Qf.d.cts}

@@ -1,5 +1,3 @@
-import * as src from 'src';
-
 declare const $internal: unique symbol;
 
 type IsEmpty<T> = T extends Record<string, never> ? true : false;
@@ -31,18 +29,21 @@ type ConfigurableTrait<T extends Trait = Trait> = T | TraitTuple<T>;
 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 SetTraitCallback<T extends Trait> = (prev: TraitInstance<ExtractSchema<T>>) => TraitValue<ExtractSchema<T>>;
 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;
+    [key: string]: number | bigint | string | boolean | null | undefined | (() => unknown);
 } | AoSFactory;
-type AoSFactory = () => Record<string, any>;
+type AoSFactory = () => unknown;
 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> = 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 object ? T[K] extends (...args: any[]) => any ? T[K] : never : T[K] extends boolean ? boolean : T[K];
+}[keyof T] extends never ? never : {
     [K in keyof T]: T[K] extends boolean ? boolean : T[K];
 };
 type ExtractSchema<T extends Trait | Relation<Trait>> = T extends Relation<infer R> ? ExtractSchema<R> : T extends Trait<infer S> ? S : never;
@@ -77,7 +78,7 @@ type Entity = number & {
     has: (trait: Trait) => boolean;
     destroy: () => void;
     changed: (trait: Trait) => void;
-    set: <T extends Trait>(trait: T, value: TraitValue<ExtractSchema<T>> | ((prev: TraitInstance<ExtractSchema<T>>) => TraitValue<ExtractSchema<T>>), flagChanged?: boolean) => void;
+    set: <T extends Trait>(trait: T, value: TraitValue<ExtractSchema<T>> | SetTraitCallback<T>, flagChanged?: boolean) => void;
     get: <T extends Trait | Relation<Trait>>(trait: T) => TraitInstance<ExtractSchema<T>> | undefined;
     targetFor: <T extends Trait>(relation: Relation<T>) => Entity | undefined;
     targetsFor: <T extends Trait>(relation: Relation<T>) => Entity[];
@@ -164,7 +165,9 @@ type QueryHash<T extends QueryParameter[]> = string & {
     readonly [$parameters]: T;
 };
 
-declare const IsExcluded: Trait<src.Schema>;
+declare const IsExcluded: Trait<{
+    [x: string]: string | number | bigint | boolean | (() => unknown) | null | undefined;
+} | (() => unknown)>;
 declare class Query {
     version: number;
     world: World;
@@ -243,7 +246,7 @@ declare class World {
     add(...traits: ConfigurableTrait[]): void;
     remove(...traits: Trait[]): void;
     get<T extends Trait>(trait: T): TraitInstance<ExtractSchema<T>> | undefined;
-    set<T extends Trait>(trait: T, value: TraitValue<ExtractSchema<T>>): void;
+    set<T extends Trait>(trait: T, value: TraitValue<ExtractSchema<T>> | SetTraitCallback<T>): void;
     destroy(): void;
     reset(): void;
     query<T extends QueryParameter[]>(key: QueryHash<T>): QueryResult<T>;
@@ -260,4 +263,4 @@ declare class World {
 }
 declare function createWorld(...traits: ConfigurableTrait[]): World;
 
-export { $internal as $, type AoSFactory as A, type ConfigurableTrait as C, type Entity as E, IsExcluded 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 QueryHash as a, type RelationTarget as b, type WildcardRelation as c, type ExtractStore as d, createWorld as e, type QueryModifier as f, type QuerySubscriber as g, type QueryUnsubscriber as h, type QueryResultOptions as i, type QueryResult as j, type StoresFromParameters as k, type InstancesFromParameters as l, type IsNotModifier as m, type TraitType as n, type TraitValue as o, type TraitTuple as p, type TraitInstance as q, type Store as r, type ExtractSchema as s, type ExtractIsTag as t, type IsTag as u };
+export { $internal as $, type AoSFactory as A, type ConfigurableTrait as C, type Entity as E, IsExcluded 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 QueryHash as a, type RelationTarget as b, type WildcardRelation as c, type ExtractStore as d, createWorld as e, type QueryModifier as f, type QuerySubscriber as g, type QueryUnsubscriber as h, type QueryResultOptions as i, type QueryResult as j, type StoresFromParameters as k, type InstancesFromParameters as l, type IsNotModifier as m, type TraitType as n, type TraitValue as o, type TraitTuple as p, type SetTraitCallback as q, type TraitInstance as r, type Store as s, type ExtractSchema as t, type ExtractIsTag as u, type IsTag as v };

package/dist/{world-CbC1N0VY.d.ts → world-DzIKt3Qf.d.ts}

@@ -1,5 +1,3 @@
-import * as src from 'src';
-
 declare const $internal: unique symbol;
 
 type IsEmpty<T> = T extends Record<string, never> ? true : false;
@@ -31,18 +29,21 @@ type ConfigurableTrait<T extends Trait = Trait> = T | TraitTuple<T>;
 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 SetTraitCallback<T extends Trait> = (prev: TraitInstance<ExtractSchema<T>>) => TraitValue<ExtractSchema<T>>;
 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;
+    [key: string]: number | bigint | string | boolean | null | undefined | (() => unknown);
 } | AoSFactory;
-type AoSFactory = () => Record<string, any>;
+type AoSFactory = () => unknown;
 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> = 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 object ? T[K] extends (...args: any[]) => any ? T[K] : never : T[K] extends boolean ? boolean : T[K];
+}[keyof T] extends never ? never : {
     [K in keyof T]: T[K] extends boolean ? boolean : T[K];
 };
 type ExtractSchema<T extends Trait | Relation<Trait>> = T extends Relation<infer R> ? ExtractSchema<R> : T extends Trait<infer S> ? S : never;
@@ -77,7 +78,7 @@ type Entity = number & {
     has: (trait: Trait) => boolean;
     destroy: () => void;
     changed: (trait: Trait) => void;
-    set: <T extends Trait>(trait: T, value: TraitValue<ExtractSchema<T>> | ((prev: TraitInstance<ExtractSchema<T>>) => TraitValue<ExtractSchema<T>>), flagChanged?: boolean) => void;
+    set: <T extends Trait>(trait: T, value: TraitValue<ExtractSchema<T>> | SetTraitCallback<T>, flagChanged?: boolean) => void;
     get: <T extends Trait | Relation<Trait>>(trait: T) => TraitInstance<ExtractSchema<T>> | undefined;
     targetFor: <T extends Trait>(relation: Relation<T>) => Entity | undefined;
     targetsFor: <T extends Trait>(relation: Relation<T>) => Entity[];
@@ -164,7 +165,9 @@ type QueryHash<T extends QueryParameter[]> = string & {
     readonly [$parameters]: T;
 };
 
-declare const IsExcluded: Trait<src.Schema>;
+declare const IsExcluded: Trait<{
+    [x: string]: string | number | bigint | boolean | (() => unknown) | null | undefined;
+} | (() => unknown)>;
 declare class Query {
     version: number;
     world: World;
@@ -243,7 +246,7 @@ declare class World {
     add(...traits: ConfigurableTrait[]): void;
     remove(...traits: Trait[]): void;
     get<T extends Trait>(trait: T): TraitInstance<ExtractSchema<T>> | undefined;
-    set<T extends Trait>(trait: T, value: TraitValue<ExtractSchema<T>>): void;
+    set<T extends Trait>(trait: T, value: TraitValue<ExtractSchema<T>> | SetTraitCallback<T>): void;
     destroy(): void;
     reset(): void;
     query<T extends QueryParameter[]>(key: QueryHash<T>): QueryResult<T>;
@@ -260,4 +263,4 @@ declare class World {
 }
 declare function createWorld(...traits: ConfigurableTrait[]): World;
 
-export { $internal as $, type AoSFactory as A, type ConfigurableTrait as C, type Entity as E, IsExcluded 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 QueryHash as a, type RelationTarget as b, type WildcardRelation as c, type ExtractStore as d, createWorld as e, type QueryModifier as f, type QuerySubscriber as g, type QueryUnsubscriber as h, type QueryResultOptions as i, type QueryResult as j, type StoresFromParameters as k, type InstancesFromParameters as l, type IsNotModifier as m, type TraitType as n, type TraitValue as o, type TraitTuple as p, type TraitInstance as q, type Store as r, type ExtractSchema as s, type ExtractIsTag as t, type IsTag as u };
+export { $internal as $, type AoSFactory as A, type ConfigurableTrait as C, type Entity as E, IsExcluded 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 QueryHash as a, type RelationTarget as b, type WildcardRelation as c, type ExtractStore as d, createWorld as e, type QueryModifier as f, type QuerySubscriber as g, type QueryUnsubscriber as h, type QueryResultOptions as i, type QueryResult as j, type StoresFromParameters as k, type InstancesFromParameters as l, type IsNotModifier as m, type TraitType as n, type TraitValue as o, type TraitTuple as p, type SetTraitCallback as q, type TraitInstance as r, type Store as s, type ExtractSchema as t, type ExtractIsTag as u, type IsTag as v };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koota",
-  "version": "0.4.3",
+  "version": "0.5.0",
   "description": "🌎 Performant real-time state management for React and TypeScript",
   "license": "ISC",
   "type": "module",
@@ -32,7 +32,7 @@
   ],
   "devDependencies": {
     "@testing-library/react": "^16.2.0",
-    "esbuild-plugin-inline-functions": "^0.1.0",
+    "esbuild-plugin-inline-functions": "^0.2.0",
     "react": ">=18.0.0",
     "react-dom": ">=18.0.0",
     "tsup": "^8.3.0",
@@ -54,9 +54,9 @@
     }
   },
   "scripts": {
-    "build": "tsup && tsx scripts/copy-readme.ts && tsx scripts/copy-react-files.ts",
+    "build": "tsup && node --no-warnings scripts/copy-readme.ts && node --no-warnings scripts/copy-react-files.ts",
     "test": "vitest --environment=jsdom",
-    "generate-tests": "tsx scripts/generate-tests.ts"
+    "generate-tests": "node scripts/generate-tests.ts"
   },
   "module": "./dist/index.js"
 }

package/react/index.cjs

@@ -316,11 +316,23 @@ function createStore(schema) {
   }
 }
 
+// ../core/src/trait/utils/validate-schema.ts
+function validateSchema(schema) {
+  for (const key in schema) {
+    const value = schema[key];
+    if (value !== null && typeof value === "object") {
+      const kind = Array.isArray(value) ? "array" : "object";
+      throw new Error(`Koota: ${key} is an ${kind}, which is not supported in traits.`);
+    }
+  }
+}
+
 // ../core/src/trait/trait.ts
 var traitId = 0;
 function defineTrait(schema = {}) {
   const isAoS = typeof schema === "function";
   const traitType = isAoS ? "aos" : "soa";
+  validateSchema(schema);
   const Trait = Object.assign((params) => [Trait, params], {
     schema,
     [$internal]: {
@@ -486,6 +498,13 @@ function removeTrait(world, entity, ...traits) {
       if (otherTargets.length === 0) {
         removeTrait(world, entity, Pair(relation2, Wildcard));
       }
+      if (traitCtx.isPairTrait && traitCtx.pairTarget === Wildcard && traitCtx.relation !== Wildcard) {
+        const relation3 = traitCtx.relation;
+        const targets = getRelationTargets(world, relation3, entity);
+        for (const target2 of targets) {
+          removeTrait(world, entity, relation3(target2));
+        }
+      }
     }
   }
 }

package/react/index.d.cts

@@ -1,6 +1,5 @@
-import { W as World, Q as QueryParameter, j as QueryResult, E as Entity, T as Trait, q as TraitInstance } from '../dist/world-CbC1N0VY.cjs';
+import { W as World, Q as QueryParameter, j as QueryResult, E as Entity, T as Trait, r as TraitInstance } from '../dist/world-DzIKt3Qf.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import 'src';
 
 declare function useActions<T extends Record<string, (...args: any[]) => any>>(actions: (world: World) => T): T;
 

package/react/index.d.ts

@@ -1,6 +1,5 @@
-import { W as World, Q as QueryParameter, j as QueryResult, E as Entity, T as Trait, q as TraitInstance } from '../dist/world-CbC1N0VY.js';
+import { W as World, Q as QueryParameter, j as QueryResult, E as Entity, T as Trait, r as TraitInstance } from '../dist/world-DzIKt3Qf.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import 'src';
 
 declare function useActions<T extends Record<string, (...args: any[]) => any>>(actions: (world: World) => T): T;
 

package/react/index.js

@@ -2,7 +2,7 @@
 import {
   $internal,
   cacheQuery
-} from "../dist/chunk-6HKEF2RH.js";
+} from "../dist/chunk-KLYFWWYD.js";
 
 // ../react/src/world/use-world.ts
 import { useContext } from "react";