mani-game-engine 1.0.0-pre.34 → 1.0.0-pre.35
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -21
- package/README.md +69 -69
- package/lib/clock.d.ts +55 -55
- package/lib/clock.js +117 -117
- package/lib/ecsInjector.d.ts +28 -27
- package/lib/ecsInjector.js +169 -149
- package/lib/ecsInjector.js.map +1 -1
- package/lib/entity.d.ts +26 -23
- package/lib/entity.js +101 -95
- package/lib/entity.js.map +1 -1
- package/lib/gameEngine.d.ts +83 -83
- package/lib/gameEngine.js +340 -340
- package/lib/gameEngine.js.map +1 -1
- package/lib/index.d.ts +12 -12
- package/lib/index.js +34 -32
- package/lib/index.js.map +1 -1
- package/lib/injector.d.ts +121 -121
- package/lib/injector.js +289 -289
- package/lib/scope/scopeContext.d.ts +57 -57
- package/lib/scope/scopeContext.js +254 -254
- package/lib/scope/scopeContext.js.map +1 -1
- package/lib/systemContext.d.ts +14 -12
- package/lib/systemContext.js +35 -23
- package/lib/systemContext.js.map +1 -1
- package/lib/types.d.ts +73 -73
- package/lib/types.js +17 -17
- package/lib/utils/map2k.d.ts +6 -6
- package/lib/utils/map2k.js +43 -43
- package/package.json +39 -39
- package/src/clock.ts +163 -163
- package/src/ecsInjector.ts +212 -189
- package/src/entity.ts +131 -123
- package/src/gameEngine.ts +433 -433
- package/src/index.ts +32 -32
- package/src/injector.ts +363 -363
- package/src/scope/scopeContext.ts +322 -320
- package/src/systemContext.ts +37 -27
- package/src/types.ts +87 -87
- package/src/utils/map2k.ts +52 -52
package/src/ecsInjector.ts
CHANGED
|
@@ -1,189 +1,212 @@
|
|
|
1
|
-
// TODO: what if systems for entity without components are created?
|
|
2
|
-
import {Signal} from 'mani-signal';
|
|
3
|
-
import {Class, createDependencyAnnotation, Dependency, ID, Injector, putIfAbsent, ResolverContext, ResolverFunction} from './injector';
|
|
4
|
-
import {SystemContext} from './systemContext';
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
type
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
type
|
|
11
|
-
type
|
|
12
|
-
type
|
|
13
|
-
type
|
|
14
|
-
|
|
15
|
-
type
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
export const
|
|
20
|
-
|
|
21
|
-
export const
|
|
22
|
-
export const
|
|
23
|
-
export const
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
};
|
|
51
|
-
|
|
52
|
-
const
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
}
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
return (context: SystemContext) => context.entity;
|
|
86
|
-
};
|
|
87
|
-
|
|
88
|
-
const
|
|
89
|
-
if (kind !== 'system') {
|
|
90
|
-
throw new Error(`Could not resolve
|
|
91
|
-
}
|
|
92
|
-
return (context: SystemContext) => context;
|
|
93
|
-
};
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
}
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
const
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
1
|
+
// TODO: what if systems for entity without components are created?
|
|
2
|
+
import {Signal} from 'mani-signal';
|
|
3
|
+
import {Class, createDependencyAnnotation, Dependency, ID, Injector, putIfAbsent, ResolverContext, ResolverFunction} from './injector';
|
|
4
|
+
import {entitySignalHandlers, SystemContext} from './systemContext';
|
|
5
|
+
import {Entity} from './entity';
|
|
6
|
+
|
|
7
|
+
type ComponentClass = Class;
|
|
8
|
+
type EntityClass = Class;
|
|
9
|
+
|
|
10
|
+
type SystemResolvers<T extends Class> = [T, ResolverFunction[]]
|
|
11
|
+
type ComponentDependency = Dependency & { kind: 'component'; index: number; type: Class; };
|
|
12
|
+
type EntityDependency = Dependency & { kind: 'entity'; index: number; };
|
|
13
|
+
type ContextDependency = Dependency & { kind: 'context'; index: number; };
|
|
14
|
+
type SignalDependency = Dependency & { kind: 'signal'; index: number; id: ID; };
|
|
15
|
+
type EntitySignalDependency = Dependency & { kind: 'entitySignal'; index: number; id: ID; };
|
|
16
|
+
|
|
17
|
+
type EntityResolverContext = ResolverContext & { entityClass: Object; };
|
|
18
|
+
|
|
19
|
+
export const entityComponents = new Map<EntityClass, Map<ComponentClass, string>>();
|
|
20
|
+
|
|
21
|
+
export const GetComponent = createDependencyAnnotation((type, index): ComponentDependency => ({kind: 'component', type, index}));
|
|
22
|
+
export const GetEntity = createDependencyAnnotation((_type, index): EntityDependency => ({kind: 'entity', index}));
|
|
23
|
+
export const GetContext = createDependencyAnnotation((_type, index): ContextDependency => ({kind: 'context', index}));
|
|
24
|
+
export const GetSignal = (id: ID) => createDependencyAnnotation((_type, index): SignalDependency => ({kind: 'signal', index, id}));
|
|
25
|
+
export const GetEntitySignal = (id: ID) => createDependencyAnnotation((_type, index): EntitySignalDependency => ({
|
|
26
|
+
kind: 'entitySignal',
|
|
27
|
+
index,
|
|
28
|
+
id,
|
|
29
|
+
}));
|
|
30
|
+
export const EntityComponent = (target: object, propertyKey: string): any => {
|
|
31
|
+
const entityClass = target.constructor;
|
|
32
|
+
const componentClass = Reflect.getMetadata('design:type', target, propertyKey);
|
|
33
|
+
if (componentClass === Object) {
|
|
34
|
+
throw new Error(`Object component type not allowed. Forgot to specify type of ${entityClass.name}.${propertyKey}?`);
|
|
35
|
+
}
|
|
36
|
+
const componentSet = putIfAbsent(entityComponents, entityClass, () => new Map<ComponentClass, string>());
|
|
37
|
+
componentSet.set(componentClass, propertyKey);
|
|
38
|
+
};
|
|
39
|
+
|
|
40
|
+
export const signalHandlers = new Map<Object, [string, ID][]>();
|
|
41
|
+
export const staticSignalHandlers = new Map<Object, [string, ID][]>();
|
|
42
|
+
export const OnSignal = (id: ID) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => {
|
|
43
|
+
if (target instanceof Function) {
|
|
44
|
+
let mappingList = putIfAbsent(staticSignalHandlers, target, (): [string, ID][] => []);
|
|
45
|
+
mappingList.push([propertyKey, id]);
|
|
46
|
+
} else {
|
|
47
|
+
let mappingList = putIfAbsent(signalHandlers, target.constructor, (): [string, ID][] => []);
|
|
48
|
+
mappingList.push([propertyKey, id]);
|
|
49
|
+
}
|
|
50
|
+
};
|
|
51
|
+
|
|
52
|
+
const getComponentDependencies = (system: Class) => {
|
|
53
|
+
const dependencies = Injector.dependencyMap.get(system);
|
|
54
|
+
return dependencies
|
|
55
|
+
? dependencies.filter((dependency): dependency is ComponentDependency => dependency.kind === 'component')
|
|
56
|
+
: [];
|
|
57
|
+
};
|
|
58
|
+
|
|
59
|
+
const getEntityClassesForComponentDependencies = (componentTypes: Class[]): Class[] => {
|
|
60
|
+
// TODO: refactor class, use map, filter etc...
|
|
61
|
+
const result = [];
|
|
62
|
+
for (const [entityClass, componentMap] of entityComponents) {
|
|
63
|
+
let allDependenciesMet = true;
|
|
64
|
+
for (const componentType of componentTypes) {
|
|
65
|
+
if (!componentMap.has(componentType)) {
|
|
66
|
+
allDependenciesMet = false;
|
|
67
|
+
break;
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
if (allDependenciesMet) {
|
|
71
|
+
result.push(entityClass);
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
return result;
|
|
75
|
+
};
|
|
76
|
+
|
|
77
|
+
const componentResolver = (context: ResolverContext, dependency: Dependency): ResolverFunction => {
|
|
78
|
+
const kind = context.kind;
|
|
79
|
+
const type = context.type;
|
|
80
|
+
if (kind !== 'system') {
|
|
81
|
+
throw new Error(`Could not resolve Component ${type.name}. @GetComponent only allowed in system scope.`);
|
|
82
|
+
}
|
|
83
|
+
const entityClass = (context as EntityResolverContext).entityClass;
|
|
84
|
+
const key = entityComponents.get(<any>entityClass as Class)!.get((dependency as ComponentDependency).type);
|
|
85
|
+
return (context: SystemContext) => (context.entity as any)[key!];
|
|
86
|
+
};
|
|
87
|
+
|
|
88
|
+
const entityResolver = ({type, kind}: ResolverContext, _dependency: Dependency): ResolverFunction => {
|
|
89
|
+
if (kind !== 'system') {
|
|
90
|
+
throw new Error(`Could not resolve Entity in ${type.name}. @GetEntity only allowed in system scope.`);
|
|
91
|
+
}
|
|
92
|
+
return (context: SystemContext) => context.entity;
|
|
93
|
+
};
|
|
94
|
+
|
|
95
|
+
const entitySignalResolver = ({type, kind}: ResolverContext, dependency: Dependency): ResolverFunction => {
|
|
96
|
+
if (kind !== 'system') {
|
|
97
|
+
throw new Error(`Could not resolve Entity in ${type.name}. @GetEntity only allowed in system scope.`);
|
|
98
|
+
}
|
|
99
|
+
return (context: SystemContext) => (<Entity>context.entity).getSignal((<EntitySignalDependency>dependency).id);
|
|
100
|
+
};
|
|
101
|
+
|
|
102
|
+
const contextResolver = ({type, kind}: ResolverContext, _dependency: Dependency): ResolverFunction => {
|
|
103
|
+
if (kind !== 'system') {
|
|
104
|
+
throw new Error(`Could not resolve Context in ${type.name}. @GetContext only allowed in system scope.`);
|
|
105
|
+
}
|
|
106
|
+
return (context: SystemContext) => context;
|
|
107
|
+
};
|
|
108
|
+
|
|
109
|
+
// const isSignalResolver = (dependency: Dependency): dependency is SignalDependency => dependency.kind === 'signal';
|
|
110
|
+
|
|
111
|
+
export class EcsInjector<SystemClass extends Class = Class> extends Injector {
|
|
112
|
+
// protected readonly entitySystemMap = new Map<EntityClass, SystemClass[]>();
|
|
113
|
+
protected entitySystemMap: Map<Class, SystemClass[]>;
|
|
114
|
+
protected entitySystemResolverTuples: Map<Class, SystemResolvers<SystemClass>[]>;
|
|
115
|
+
private signalMap: Map<ID, Signal>;
|
|
116
|
+
|
|
117
|
+
constructor(parent?: EcsInjector<SystemClass>) {
|
|
118
|
+
super(parent);
|
|
119
|
+
this.signalMap = parent ? parent.signalMap : new Map<ID, Signal>();
|
|
120
|
+
this.entitySystemMap = new Map<EntityClass, SystemClass[]>();
|
|
121
|
+
this.entitySystemResolverTuples = new Map<EntityClass, SystemResolvers<SystemClass>[]>();
|
|
122
|
+
this.map(EcsInjector).toValue(this);
|
|
123
|
+
|
|
124
|
+
if (!parent) {
|
|
125
|
+
// only add extension resolvers to the main/parent injector
|
|
126
|
+
this.addExtensionResolver('entity', entityResolver);
|
|
127
|
+
this.addExtensionResolver('component', componentResolver);
|
|
128
|
+
this.addExtensionResolver('context', contextResolver);
|
|
129
|
+
|
|
130
|
+
const signalResolver = ({kind}: ResolverContext, dependency: Dependency): ResolverFunction => {
|
|
131
|
+
const signal = putIfAbsent(this.signalMap, (<SignalDependency>dependency).id, () => new Signal());
|
|
132
|
+
return (entity: any) => signal;
|
|
133
|
+
};
|
|
134
|
+
this.addExtensionResolver('signal', signalResolver);
|
|
135
|
+
this.addExtensionResolver('entitySignal', entitySignalResolver);
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
//TODO: this needs some overthinking...
|
|
140
|
+
newSignalScope() {
|
|
141
|
+
this.signalMap = new Map<ID, Signal>();
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
registerSystem<T extends SystemClass>(systemClass: T) {
|
|
145
|
+
// TODO: check if system is already mapped
|
|
146
|
+
const componentDependencies = getComponentDependencies(systemClass).map(dependency => dependency.type);
|
|
147
|
+
if (componentDependencies.length === 0) {
|
|
148
|
+
throw new Error(`${systemClass.name} needs at least one component dependency.`);
|
|
149
|
+
}
|
|
150
|
+
const entityClasses = getEntityClassesForComponentDependencies(componentDependencies);
|
|
151
|
+
if (entityClasses.length === 0) {
|
|
152
|
+
console.warn(`System '${systemClass.name}' has no matching entities.`);
|
|
153
|
+
return;
|
|
154
|
+
}
|
|
155
|
+
for (let entityClass of entityClasses) {
|
|
156
|
+
const systemClasses = putIfAbsent(this.entitySystemMap, entityClass, (): SystemClass[] => []);
|
|
157
|
+
systemClasses.push(systemClass);
|
|
158
|
+
}
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
createSystems(entity: Object): SystemContext[] {
|
|
162
|
+
const systemResolverTuples = putIfAbsent(this.entitySystemResolverTuples, entity.constructor, (): SystemResolvers<SystemClass>[] => {
|
|
163
|
+
const systems = this.entitySystemMap.get(entity.constructor as Class);
|
|
164
|
+
if (!systems) {
|
|
165
|
+
return [];
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
const result: SystemResolvers<SystemClass>[] = [];
|
|
169
|
+
for (const systemClass of systems) {
|
|
170
|
+
result.push([systemClass, this.createResolverArray({type: systemClass, kind: 'system', entityClass: entity.constructor})]);
|
|
171
|
+
}
|
|
172
|
+
return result;
|
|
173
|
+
});
|
|
174
|
+
const systemInstances: SystemContext[] = [];
|
|
175
|
+
for (const [system, resolver] of systemResolverTuples) {
|
|
176
|
+
const args = new Array(resolver.length);
|
|
177
|
+
|
|
178
|
+
const systemContext = new SystemContext<InstanceType<SystemClass>>(entity);
|
|
179
|
+
|
|
180
|
+
for (let i = 0; i < args.length; i++) {
|
|
181
|
+
args[i] = resolver[i](systemContext);
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
const newSystem = new system(...args); // TODO: new class(...args) is very slow in firefox :/
|
|
185
|
+
|
|
186
|
+
// map entity signals
|
|
187
|
+
const entitySignals = entitySignalHandlers.get(system);
|
|
188
|
+
if (entitySignals?.length) {
|
|
189
|
+
for (const [propertyKey, id] of entitySignals) {
|
|
190
|
+
(entity as Entity).getSignal(id).add(newSystem[propertyKey]);
|
|
191
|
+
}
|
|
192
|
+
}
|
|
193
|
+
|
|
194
|
+
// friend class :)
|
|
195
|
+
(systemContext as any).system = newSystem;
|
|
196
|
+
|
|
197
|
+
systemInstances.push(systemContext);
|
|
198
|
+
}
|
|
199
|
+
return systemInstances;
|
|
200
|
+
}
|
|
201
|
+
|
|
202
|
+
getSignal<T>(id: ID): Signal<T> {
|
|
203
|
+
return putIfAbsent(this.signalMap, id, () => new Signal<any>());
|
|
204
|
+
}
|
|
205
|
+
|
|
206
|
+
dispose() {
|
|
207
|
+
// TODO: implement dispose in Injector
|
|
208
|
+
for (const [key, signal] of this.signalMap) {
|
|
209
|
+
signal.detachAll();
|
|
210
|
+
}
|
|
211
|
+
}
|
|
212
|
+
}
|