@v12-engine/engine 0.1.1 → 0.4.0

package/dist/mods.js

@@ -0,0 +1,271 @@
+import { notePartOwners, partOwners } from "./errors.js";
+import { overSettings, rulesSaid } from "./rules.js";
+//#region src/mods.ts
+/**
+* Throws when a requirement is not met, or two mods change the same thing without one requiring the other
+*
+* @beta
+*/
+var ModError = class extends Error {};
+/**
+* A game with mods on it: a new `Rules`, which `createWorld` takes like any other. Its id names the game and
+* the mods (`melee+goldRush`), and `mods` lists them with their versions. Mods are applied after the ones they
+* require, otherwise in the order given. Neither the game nor the mods are changed
+*
+* @beta
+*/
+function composeGame(base, mods) {
+	const ordered = order(base, mods);
+	const draft = {
+		...base,
+		units: [...base.units],
+		mods: [...base.mods ?? [], ...ordered.map((mod) => ({
+			id: mod.id,
+			version: mod.version,
+			...mod.hash && { hash: mod.hash }
+		}))]
+	};
+	const touched = /* @__PURE__ */ new Map();
+	const conflicts = [];
+	const requires = closure(ordered);
+	for (const mod of ordered) {
+		const touch = (what) => {
+			const before = touched.get(what);
+			if (before && before !== mod.id && !requires.get(mod.id).has(before) && !requires.get(before).has(mod.id)) conflicts.push(`${what}: changed by "${before}" and by "${mod.id}", and neither requires the other`);
+			touched.set(what, mod.id);
+		};
+		mod.apply(builder(draft, touch));
+	}
+	if (conflicts.length) throw new ModError(`Mods that do not go together:\n${conflicts.join("\n")}`);
+	draft.id = [base.id, ...ordered.map((mod) => mod.id)].join("+");
+	notePartOwners(draft, new Map([...partOwners(base), ...touched]));
+	compositions.set(draft, {
+		base,
+		mods
+	});
+	return draft;
+}
+/** What each game made by `composeGame` was made of: its base and its mods, as they were given */
+var compositions = /* @__PURE__ */ new WeakMap();
+/**
+* What a game made by `composeGame` was made of, its base and its mods; nothing for one that was not
+*
+* @internal
+*/
+function compositionOf(game) {
+	return compositions.get(game);
+}
+/**
+* A game made by `composeGame` made again, of its base and its mods as they are now (a base made of mods made again
+* too): what a game played with mods takes as one of them, or its base, is saved while it runs (hot reload). A game not
+* made so is itself. Throws as `composeGame` does: mods that no longer go together
+*
+* @beta
+*/
+function recompose(game) {
+	const made = compositions.get(game);
+	return made ? composeGame(recompose(made.base), [...made.mods]) : game;
+}
+/**
+* Whether a game is made of this game or mod: is it, or has it as its base or one of its mods, at any depth
+*
+* @beta
+*/
+function isMadeOf(game, part) {
+	if (game === part) return true;
+	const made = compositions.get(game);
+	return !!made && (made.mods.includes(part) || isMadeOf(made.base, part));
+}
+function builder(draft, touch) {
+	const list = (field, kind, idOf) => {
+		const items = () => draft[field] ?? [];
+		const write = (next) => draft[field] = next;
+		const find = (id) => items().find((def) => idOf(def) === id);
+		const must = (id) => find(id) ?? fail(`${kind} "${id}" is not in the game`);
+		return {
+			get: find,
+			has: (id) => !!find(id),
+			all: items,
+			add(def) {
+				const id = idOf(def);
+				if (find(id)) fail(`${kind} "${id}" is in the game already: override it instead`);
+				touch(`${kind} "${id}"`);
+				write([...items(), def]);
+			},
+			override(id, change) {
+				const old = must(id);
+				touch(`${kind} "${id}"`);
+				const next = typeof change === "function" ? change(old) : {
+					...old,
+					...change
+				};
+				write(items().map((def) => def === old ? next : def));
+			},
+			remove(id) {
+				const old = must(id);
+				touch(`${kind} "${id}"`);
+				write(items().filter((def) => def !== old));
+			}
+		};
+	};
+	const effects = list("effects", "effect", (def) => def.type);
+	return {
+		get current() {
+			return draft;
+		},
+		units: list("units", "unit type", (def) => def.id),
+		abilities: list("abilities", "ability", (def) => def.id),
+		buffs: list("buffs", "buff", (def) => def.id),
+		items: list("items", "item", (def) => def.id),
+		tags: list("tags", "tag", (def) => def.id),
+		upgrades: list("upgrades", "upgrade", (def) => def.id),
+		races: list("races", "race", (def) => def.id),
+		stats: list("stats", "stat", (def) => def.id),
+		resources: list("resources", "resource", (def) => def.id),
+		effects,
+		orders: list("orders", "order", (def) => def.type),
+		commands: list("commands", "command", (def) => def.type),
+		hooks: list("hooks", "hook handler", (def) => def.id),
+		listeners: list("listeners", "listener", (def) => def.id),
+		components: list("components", "component", (def) => def.id),
+		events: list("events", "event", (def) => def.id),
+		areas: list("areas", "area", (def) => def.id),
+		cellLayers: list("cellLayers", "layer of cells", (def) => def.id),
+		timers: list("timers", "timer", (def) => def.id),
+		sequences: list("sequences", "sequence", (def) => def.id),
+		withoutHook(id) {
+			touch(`hook handler "${id}"`);
+			draft.withoutHooks = [...draft.withoutHooks ?? [], id];
+		},
+		packs: list("packs", "pack", (def) => def.id),
+		withoutCommand(type) {
+			touch(`command "${type}"`);
+			draft.withoutCommands = [...draft.withoutCommands ?? [], type];
+		},
+		withoutOrder(type) {
+			touch(`order "${type}"`);
+			draft.withoutOrders = [...draft.withoutOrders ?? [], type];
+		},
+		addSystem(system) {
+			if (typeof system !== "function") touch(`system "${system.name}"`);
+			draft.systems = [...draft.systems ?? [], system];
+		},
+		withoutSystem(name) {
+			touch(`system "${name}"`);
+			const systems = draft.systems ?? [];
+			const own = systems.filter((system) => typeof system !== "function" && system.name === name);
+			if (own.length) draft.systems = systems.filter((system) => !own.includes(system));
+			else draft.withoutSystems = [...draft.withoutSystems ?? [], name];
+		},
+		settings(changes) {
+			for (const name of rulesSaid(changes)) touch(`rule "${name}"`);
+			draft.settings = overSettings(draft.settings ?? {}, changes);
+		},
+		set(key, value) {
+			touch(`setting "${key}"`);
+			draft[key] = value;
+		}
+	};
+}
+/** The mods in the order they are applied: each after what it requires. Throws for what is missing or out of range */
+function order(base, mods) {
+	const byId = /* @__PURE__ */ new Map();
+	for (const mod of mods) {
+		if (byId.has(mod.id) || mod.id === base.id) fail(`"${mod.id}" is there twice`);
+		version(mod.version, `the version of "${mod.id}"`);
+		byId.set(mod.id, mod);
+	}
+	const versions = new Map([[base.id, base.version ?? "1.0.0"], ...mods.map((mod) => [mod.id, mod.version])]);
+	for (const mod of mods) for (const requirement of mod.requires ?? []) {
+		const [id, range] = requirement.split("@");
+		const have = versions.get(id);
+		if (have === void 0) fail(`"${mod.id}" requires "${id}", which is not there`);
+		if (range && !satisfies(have, range)) fail(`"${mod.id}" requires ${id} ${range}, and it is ${have}`);
+	}
+	const ordered = [];
+	const state = /* @__PURE__ */ new Map();
+	const visit = (mod, path) => {
+		if (state.get(mod.id) === "done") return;
+		if (state.get(mod.id) === "visiting") fail(`Mods require each other in a circle: ${[...path, mod.id].join(" → ")}`);
+		state.set(mod.id, "visiting");
+		for (const requirement of mod.requires ?? []) {
+			const needed = byId.get(requirement.split("@")[0]);
+			if (needed) visit(needed, [...path, mod.id]);
+		}
+		state.set(mod.id, "done");
+		ordered.push(mod);
+	};
+	for (const mod of mods) visit(mod, []);
+	return ordered;
+}
+/** For each mod, every mod it requires, directly or through others */
+function closure(mods) {
+	const all = /* @__PURE__ */ new Map();
+	for (const mod of mods) {
+		const set = /* @__PURE__ */ new Set();
+		for (const requirement of mod.requires ?? []) {
+			const id = requirement.split("@")[0];
+			set.add(id);
+			for (const further of all.get(id) ?? []) set.add(further);
+		}
+		all.set(mod.id, set);
+	}
+	return all;
+}
+function version(text, what) {
+	const parts = text.split(".").map(Number);
+	if (parts.length < 1 || parts.length > 3 || parts.some((part) => !Number.isInteger(part) || part < 0)) fail(`${what} is not a version: "${text}"`);
+	while (parts.length < 3) parts.push(0);
+	return parts;
+}
+/**
+* Whether a version is in a range: `1.2.3` exactly, or `^1.2` for 1.2 and later of major version 1
+*
+* @beta
+*/
+function satisfies(have, range) {
+	const caret = range.startsWith("^");
+	const want = version(caret ? range.slice(1) : range, `the range "${range}"`);
+	const is = version(have, `the version "${have}"`);
+	if (!caret) return is.every((part, i) => part === want[i]);
+	if (is[0] !== want[0]) return false;
+	for (let i = 1; i < 3; i++) if (is[i] !== want[i]) return is[i] > want[i];
+	return true;
+}
+function fail(message) {
+	throw new ModError(message);
+}
+/**
+* What identifies a game exactly: its definitions, the source of its code, and its mods. Two worlds made from games
+* with the same hash play by the same rules: what a lobby, a save and a replay check
+*
+* @internal
+*/
+function gameHash(game, options = {}) {
+	const code = options.code ?? true;
+	const text = JSON.stringify(game, function(key, value) {
+		if (key === "server") return void 0;
+		if (key === "slot" && isComponent(this)) return void 0;
+		if (key === "maps" && value === game.maps) return void 0;
+		if (typeof value === "function") return code ? `fn:${value.toString()}` : "fn";
+		if (typeof value === "number" && !Number.isFinite(value)) return String(value);
+		return value;
+	});
+	let a = 2166136261;
+	let b = 1523705862;
+	for (let i = 0; i < text.length; i++) {
+		const c = text.charCodeAt(i);
+		a = Math.imul(a ^ c, 16777619);
+		b = Math.imul(b ^ c, 1540483477);
+	}
+	return (a >>> 0).toString(16).padStart(8, "0") + (b >>> 0).toString(16).padStart(8, "0");
+}
+/** Whether an object is a component (`defineComponent`): an id, its number, and every field a component has, in its shape */
+var isComponent = (value) => {
+	const part = value;
+	return typeof part?.id === "string" && typeof part.slot === "number" && "replicate" in part && "snapshot" in part && "refs" in part;
+};
+//#endregion
+export { ModError, composeGame, compositionOf, gameHash, isMadeOf, recompose, satisfies };
+
+//# sourceMappingURL=mods.js.map

package/dist/mods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mods.js","names":[],"sources":["../src/mods.ts"],"sourcesContent":["import type { RaceDef } from './races'\nimport { notePartOwners, partOwners } from './errors'\nimport type { Component } from './components'\nimport type { EventKey } from './events'\nimport type { EffectType } from './abilities/effects'\nimport type { CommandDef } from './commands'\nimport type { AbilityDef, BuffDef, ItemDef, ResourceDef, StatDef, TagDef, UnitTypeDef, UpgradeDef } from './defs'\nimport type { Rules } from './game'\nimport type { AreaDef } from './areas'\nimport type { CellLayerDef } from './cellLayers'\nimport type { ListenerDef } from './events'\nimport type { SequenceDef } from './sequences'\nimport type { TimerDef } from './timers'\nimport type { HookDef } from './hooks'\nimport type { OrderBehavior, SystemDef } from './registry'\nimport { overSettings, type RuleSettingsInit, rulesSaid } from './rules'\nimport type { GamePack } from './packs/pack'\n\n/**\n * A mod: changes to a game, made on top of it instead of on a copy of it. A new hero, other numbers, a rule of its\n * own. `composeGame` applies mods to a game in the order they need each other, and tells about two mods that change\n * the same thing without one knowing of the other, before anyone plays.\n *\n * @beta\n */\nexport interface ModDef {\n\t/** The mod's id, shared by every mod: others list it in `requires` */\n\tid: string\n\t/** `major.minor.patch`. Mods that need this one say which versions they work with */\n\tversion: string\n\t/** The mod's name as a list shows it; its id when left out */\n\tname?: string\n\t/**\n\t * The game and the mods it is made for, each `id`, `id@1.2.3` (that version only) or `id@^1.2` (that major version,\n\t * from 1.2 on). The game counts as one of them, by its id and `Rules.version`\n\t */\n\trequires?: string[]\n\t/** Makes the changes, through the builder */\n\tapply(game: GameBuilder): void\n}\n\n/**\n * Typed help for writing a mod\n *\n * @beta\n */\n\n/**\n * Definitions of one kind, by id: what a mod adds, changes or takes out\n *\n * @beta\n */\nexport interface Collection<T> {\n\t/** Finds the definition with this id; undefined when there is none */\n\tget(id: string): T | undefined\n\t/** Whether a definition with this id is there */\n\thas(id: string): boolean\n\t/** Throws when there is one of that id already: that is `override` */\n\tadd(def: T): void\n\t/** Changes one that is there: a new definition, or the fields that are different. Throws when there is none */\n\toverride(id: string, change: Partial<T> | ((def: T) => T)): void\n\t/** Throws when there is none of that id */\n\tremove(id: string): void\n\t/** Every definition in the collection, in order */\n\tall(): readonly T[]\n}\n\n/**\n * The game a mod is applied to, as it stands after the mods before it\n *\n * @beta\n */\nexport interface GameBuilder {\n\t/** What the game is so far: to read, not to change. Changes go through the rest of the builder */\n\treadonly current: Readonly<Rules>\n\t/** The unit types of the game so far */\n\tunits: Collection<UnitTypeDef>\n\t/** The abilities of the game so far */\n\tabilities: Collection<AbilityDef>\n\t/** The buffs of the game so far */\n\tbuffs: Collection<BuffDef>\n\t/** The items of the game so far */\n\titems: Collection<ItemDef>\n\t/** The tags of items the game names (`Rules.tags`, `TagDef`): what a shop shows of a tag and filters by @beta */\n\ttags: Collection<TagDef>\n\t/** The upgrades of the game so far */\n\tupgrades: Collection<UpgradeDef>\n\t/** The sides players can play (`Rules.races`) */\n\traces: Collection<RaceDef>\n\t/** The stats a unit has, by id (`StatDef`) */\n\tstats: Collection<StatDef>\n\t/** The resources players gather and spend (`Rules.resources`) */\n\tresources: Collection<ResourceDef>\n\t/** Kinds of ability effects, by their type (`defineEffect`) */\n\teffects: Collection<EffectType>\n\t/** How unit orders are carried out, by type */\n\torders: Collection<OrderBehavior>\n\t/** The commands a player can give, by type (`CommandDef`) */\n\tcommands: Collection<CommandDef>\n\t/** The game's hook handlers, by id. `withoutHook` takes out one of the engine's */\n\thooks: Collection<HookDef>\n\t/** How the game reacts to events, by id */\n\tlisteners: Collection<ListenerDef>\n\t/** The state of its own the game keeps, by id: a mod's own components are added here */\n\tcomponents: Collection<Component<any>>\n\t/** The events of its own the game emits, by id */\n\tevents: Collection<EventKey<any>>\n\t/** The parts of the map the rules watch, by id */\n\tareas: Collection<AreaDef>\n\t/** The layers of cells painted on its maps, by id (`Rules.cellLayers`): a mod's own grass, with `foliagePack` among its packs @beta */\n\tcellLayers: Collection<CellLayerDef>\n\t/** What the game can set to go off later, by id */\n\ttimers: Collection<TimerDef>\n\t/** The game's scripts of steps, by id */\n\tsequences: Collection<SequenceDef>\n\t/** Takes out one of the engine's hook handlers by id, which `hooks` cannot reach */\n\twithoutHook(id: string): void\n\t/** The parts of the rules the game opts into (`Rules.packs`), by id: `packs.add(heroesPack())` @beta */\n\tpacks: Collection<GamePack>\n\t/** Takes out a command of the engine's or a pack's, by its type (`Rules.withoutCommands`) @beta */\n\twithoutCommand(type: string): void\n\t/** Takes out an order of the engine's or a pack's, by its type (`Rules.withoutOrders`) @beta */\n\twithoutOrder(type: string): void\n\t/** Adds a system of the mod's own, or one in place of the engine's of the same name */\n\taddSystem(system: SystemDef): void\n\t/** Takes out a system: one of the engine's, or one the game gave as an object, by name */\n\twithoutSystem(name: string): void\n\t/** Changes rules of the game (`RuleSettings`): any of them, a group in part (`{ supply: { max: 200 } }`) */\n\tsettings(changes: RuleSettingsInit): void\n\t/** Changes one of the game's settings that are one thing, not a list */\n\tset<K extends Setting>(key: K, value: Rules[K]): void\n}\n\n/** The parts of a game a mod can only put something else in the place of */\ntype Setting = 'name' | 'currency' | 'upkeep' | 'day' | 'victory' | 'startingBase' | 'report' | 'ai'\n\n/**\n * Throws when a requirement is not met, or two mods change the same thing without one requiring the other\n *\n * @beta\n */\nexport class ModError extends Error {}\n\n/**\n * A game with mods on it: a new `Rules`, which `createWorld` takes like any other. Its id names the game and\n * the mods (`melee+goldRush`), and `mods` lists them with their versions. Mods are applied after the ones they\n * require, otherwise in the order given. Neither the game nor the mods are changed\n *\n * @beta\n */\nexport function composeGame(base: Rules, mods: ModDef[]): Rules {\n\tconst ordered = order(base, mods)\n\tconst draft: Rules = {\n\t\t...base,\n\t\tunits: [...base.units],\n\t\t// a pack's with the hash of its bytes (`packFromJson`): the game's hash has it, what a save and a lobby check\n\t\tmods: [...(base.mods ?? []), ...ordered.map((mod) => ({ id: mod.id, version: mod.version, ...((mod as { hash?: string }).hash && { hash: (mod as { hash?: string }).hash }) }))]\n\t}\n\tconst touched = new Map<string, string>()\n\tconst conflicts: string[] = []\n\tconst requires = closure(ordered)\n\n\tfor (const mod of ordered) {\n\t\t// who changed what: a second mod changing it, without knowing of the first, is a conflict\n\t\tconst touch = (what: string) => {\n\t\t\tconst before = touched.get(what)\n\t\t\tif (before && before !== mod.id && !requires.get(mod.id)!.has(before) && !requires.get(before)!.has(mod.id)) {\n\t\t\t\tconflicts.push(`${what}: changed by \"${before}\" and by \"${mod.id}\", and neither requires the other`)\n\t\t\t}\n\t\t\ttouched.set(what, mod.id)\n\t\t}\n\t\tmod.apply(builder(draft, touch))\n\t}\n\tif (conflicts.length) throw new ModError(`Mods that do not go together:\\n${conflicts.join('\\n')}`)\n\tdraft.id = [base.id, ...ordered.map((mod) => mod.id)].join('+')\n\t// whose each part is, for saying which mod a part that throws belongs to (`ErrorSite.mod`). Beside the game, not\n\t// in it: what a game is, and its hash, stay what they were\n\tnotePartOwners(draft, new Map([...partOwners(base), ...touched]))\n\t// what it was made of, to make it again of their new versions (hot reload, `recompose`): beside it, as the owners\n\tcompositions.set(draft, { base, mods })\n\treturn draft\n}\n\n/** What each game made by `composeGame` was made of: its base and its mods, as they were given */\nconst compositions = new WeakMap<Rules, { base: Rules; mods: readonly ModDef[] }>()\n\n/**\n * What a game made by `composeGame` was made of, its base and its mods; nothing for one that was not\n *\n * @internal\n */\nexport function compositionOf(game: Rules): { base: Rules; mods: readonly ModDef[] } | undefined {\n\treturn compositions.get(game)\n}\n\n/**\n * A game made by `composeGame` made again, of its base and its mods as they are now (a base made of mods made again\n * too): what a game played with mods takes as one of them, or its base, is saved while it runs (hot reload). A game not\n * made so is itself. Throws as `composeGame` does: mods that no longer go together\n *\n * @beta\n */\nexport function recompose(game: Rules): Rules {\n\tconst made = compositions.get(game)\n\treturn made ? composeGame(recompose(made.base), [...made.mods]) : game\n}\n\n/**\n * Whether a game is made of this game or mod: is it, or has it as its base or one of its mods, at any depth\n *\n * @beta\n */\nexport function isMadeOf(game: Rules, part: Rules | ModDef): boolean {\n\tif (game === part) return true\n\tconst made = compositions.get(game)\n\treturn !!made && (made.mods.includes(part as ModDef) || isMadeOf(made.base, part))\n}\n\nfunction builder(draft: Rules, touch: (what: string) => void): GameBuilder {\n\tconst list = <T, K extends keyof Rules>(field: K, kind: string, idOf: (def: T) => string): Collection<T> => {\n\t\tconst items = () => ((draft[field] as T[] | undefined) ?? []) as T[]\n\t\tconst write = (next: T[]) => ((draft as unknown as Record<string, unknown>)[field] = next)\n\t\tconst find = (id: string) => items().find((def) => idOf(def) === id)\n\t\tconst must = (id: string) => find(id) ?? fail(`${kind} \"${id}\" is not in the game`)\n\t\treturn {\n\t\t\tget: find,\n\t\t\thas: (id) => !!find(id),\n\t\t\tall: items,\n\t\t\tadd(def) {\n\t\t\t\tconst id = idOf(def)\n\t\t\t\tif (find(id)) fail(`${kind} \"${id}\" is in the game already: override it instead`)\n\t\t\t\ttouch(`${kind} \"${id}\"`)\n\t\t\t\twrite([...items(), def])\n\t\t\t},\n\t\t\toverride(id, change) {\n\t\t\t\tconst old = must(id)\n\t\t\t\ttouch(`${kind} \"${id}\"`)\n\t\t\t\tconst next = typeof change === 'function' ? change(old) : { ...old, ...change }\n\t\t\t\twrite(items().map((def) => (def === old ? next : def)))\n\t\t\t},\n\t\t\tremove(id) {\n\t\t\t\tconst old = must(id)\n\t\t\t\ttouch(`${kind} \"${id}\"`)\n\t\t\t\twrite(items().filter((def) => def !== old))\n\t\t\t}\n\t\t}\n\t}\n\n\tconst effects = list<EffectType, 'effects'>('effects', 'effect', (def) => def.type)\n\n\treturn {\n\t\tget current() {\n\t\t\treturn draft\n\t\t},\n\t\tunits: list<UnitTypeDef, 'units'>('units', 'unit type', (def) => def.id),\n\t\tabilities: list<AbilityDef, 'abilities'>('abilities', 'ability', (def) => def.id),\n\t\tbuffs: list<BuffDef, 'buffs'>('buffs', 'buff', (def) => def.id),\n\t\titems: list<ItemDef, 'items'>('items', 'item', (def) => def.id),\n\t\ttags: list<TagDef, 'tags'>('tags', 'tag', (def) => def.id),\n\t\tupgrades: list<UpgradeDef, 'upgrades'>('upgrades', 'upgrade', (def) => def.id),\n\t\traces: list<RaceDef, 'races'>('races', 'race', (def) => def.id),\n\t\tstats: list<StatDef, 'stats'>('stats', 'stat', (def) => def.id),\n\t\tresources: list<ResourceDef, 'resources'>('resources', 'resource', (def) => def.id),\n\t\teffects,\n\t\torders: list<OrderBehavior, 'orders'>('orders', 'order', (def) => def.type),\n\t\tcommands: list<CommandDef, 'commands'>('commands', 'command', (def) => def.type),\n\t\thooks: list<HookDef, 'hooks'>('hooks', 'hook handler', (def) => def.id),\n\t\tlisteners: list<ListenerDef, 'listeners'>('listeners', 'listener', (def) => def.id),\n\t\tcomponents: list<Component<any>, 'components'>('components', 'component', (def) => def.id),\n\t\tevents: list<EventKey<any>, 'events'>('events', 'event', (def) => def.id),\n\t\tareas: list<AreaDef, 'areas'>('areas', 'area', (def) => def.id),\n\t\tcellLayers: list<CellLayerDef, 'cellLayers'>('cellLayers', 'layer of cells', (def) => def.id),\n\t\ttimers: list<TimerDef, 'timers'>('timers', 'timer', (def) => def.id),\n\t\tsequences: list<SequenceDef, 'sequences'>('sequences', 'sequence', (def) => def.id),\n\t\twithoutHook(id) {\n\t\t\ttouch(`hook handler \"${id}\"`)\n\t\t\tdraft.withoutHooks = [...(draft.withoutHooks ?? []), id]\n\t\t},\n\t\tpacks: list<GamePack, 'packs'>('packs', 'pack', (def) => def.id),\n\t\twithoutCommand(type) {\n\t\t\ttouch(`command \"${type}\"`)\n\t\t\tdraft.withoutCommands = [...(draft.withoutCommands ?? []), type]\n\t\t},\n\t\twithoutOrder(type) {\n\t\t\ttouch(`order \"${type}\"`)\n\t\t\tdraft.withoutOrders = [...(draft.withoutOrders ?? []), type]\n\t\t},\n\t\taddSystem(system) {\n\t\t\tif (typeof system !== 'function') touch(`system \"${system.name}\"`)\n\t\t\tdraft.systems = [...(draft.systems ?? []), system]\n\t\t},\n\t\twithoutSystem(name) {\n\t\t\ttouch(`system \"${name}\"`)\n\t\t\tconst systems = draft.systems ?? []\n\t\t\tconst own = systems.filter((system) => typeof system !== 'function' && system.name === name)\n\t\t\tif (own.length) draft.systems = systems.filter((system) => !own.includes(system))\n\t\t\telse draft.withoutSystems = [...(draft.withoutSystems ?? []), name]\n\t\t},\n\t\tsettings(changes) {\n\t\t\tfor (const name of rulesSaid(changes)) touch(`rule \"${name}\"`)\n\t\t\tdraft.settings = overSettings(draft.settings ?? {}, changes)\n\t\t},\n\t\tset(key, value) {\n\t\t\ttouch(`setting \"${key}\"`)\n\t\t\tdraft[key] = value\n\t\t}\n\t}\n}\n\n/** The mods in the order they are applied: each after what it requires. Throws for what is missing or out of range */\nfunction order(base: Rules, mods: ModDef[]): ModDef[] {\n\tconst byId = new Map<string, ModDef>()\n\tfor (const mod of mods) {\n\t\tif (byId.has(mod.id) || mod.id === base.id) fail(`\"${mod.id}\" is there twice`)\n\t\tversion(mod.version, `the version of \"${mod.id}\"`)\n\t\tbyId.set(mod.id, mod)\n\t}\n\tconst versions = new Map<string, string>([[base.id, base.version ?? '1.0.0'], ...mods.map((mod) => [mod.id, mod.version] as [string, string])])\n\tfor (const mod of mods) {\n\t\tfor (const requirement of mod.requires ?? []) {\n\t\t\tconst [id, range] = requirement.split('@')\n\t\t\tconst have = versions.get(id)\n\t\t\tif (have === undefined) fail(`\"${mod.id}\" requires \"${id}\", which is not there`)\n\t\t\tif (range && !satisfies(have, range)) fail(`\"${mod.id}\" requires ${id} ${range}, and it is ${have}`)\n\t\t}\n\t}\n\tconst ordered: ModDef[] = []\n\tconst state = new Map<string, 'visiting' | 'done'>()\n\tconst visit = (mod: ModDef, path: string[]) => {\n\t\tif (state.get(mod.id) === 'done') return\n\t\tif (state.get(mod.id) === 'visiting') fail(`Mods require each other in a circle: ${[...path, mod.id].join(' → ')}`)\n\t\tstate.set(mod.id, 'visiting')\n\t\tfor (const requirement of mod.requires ?? []) {\n\t\t\tconst needed = byId.get(requirement.split('@')[0])\n\t\t\tif (needed) visit(needed, [...path, mod.id])\n\t\t}\n\t\tstate.set(mod.id, 'done')\n\t\tordered.push(mod)\n\t}\n\tfor (const mod of mods) visit(mod, [])\n\treturn ordered\n}\n\n/** For each mod, every mod it requires, directly or through others */\nfunction closure(mods: ModDef[]): Map<string, Set<string>> {\n\tconst all = new Map<string, Set<string>>()\n\t// in order, so whatever a mod requires has its set already\n\tfor (const mod of mods) {\n\t\tconst set = new Set<string>()\n\t\tfor (const requirement of mod.requires ?? []) {\n\t\t\tconst id = requirement.split('@')[0]\n\t\t\tset.add(id)\n\t\t\tfor (const further of all.get(id) ?? []) set.add(further)\n\t\t}\n\t\tall.set(mod.id, set)\n\t}\n\treturn all\n}\n\nfunction version(text: string, what: string): number[] {\n\tconst parts = text.split('.').map(Number)\n\tif (parts.length < 1 || parts.length > 3 || parts.some((part) => !Number.isInteger(part) || part < 0)) fail(`${what} is not a version: \"${text}\"`)\n\twhile (parts.length < 3) parts.push(0)\n\treturn parts\n}\n\n/**\n * Whether a version is in a range: `1.2.3` exactly, or `^1.2` for 1.2 and later of major version 1\n *\n * @beta\n */\nexport function satisfies(have: string, range: string): boolean {\n\tconst caret = range.startsWith('^')\n\tconst want = version(caret ? range.slice(1) : range, `the range \"${range}\"`)\n\tconst is = version(have, `the version \"${have}\"`)\n\tif (!caret) return is.every((part, i) => part === want[i])\n\tif (is[0] !== want[0]) return false\n\tfor (let i = 1; i < 3; i++) if (is[i] !== want[i]) return is[i] > want[i]\n\treturn true\n}\n\nfunction fail(message: string): never {\n\tthrow new ModError(message)\n}\n\n/**\n * What identifies a game exactly: its definitions, the source of its code, and its mods. Two worlds made from games\n * with the same hash play by the same rules: what a lobby, a save and a replay check\n *\n * @internal\n */\nexport function gameHash(game: Rules, options: { code?: boolean } = {}): string {\n\tconst code = options.code ?? true\n\tconst text = JSON.stringify(game, function (this: unknown, key, value) {\n\t\t// what only a server runs, around the games: not the game itself, and not on a player's side\n\t\tif (key === 'server') return undefined\n\t\t// a component's number is the process's, given in the order its modules defined components (a server's entry\n\t\t// defines more of the engine's before the game's than a player's page does): its id is what the game is (bug 18)\n\t\tif (key === 'slot' && isComponent(this)) return undefined\n\t\t// the maps it ships: what a map is is the map's hash, not the game's (S36)\n\t\tif (key === 'maps' && value === game.maps) return undefined\n\t\t// without the code: that a function is there, not how a build happens to print it\n\t\tif (typeof value === 'function') return code ? `fn:${value.toString()}` : 'fn'\n\t\tif (typeof value === 'number' && !Number.isFinite(value)) return String(value)\n\t\treturn value\n\t})\n\t// FNV-1a, twice over with different starts, for 64 bits: enough to tell versions apart, not a secret\n\tlet a = 0x811c9dc5\n\tlet b = 0x01000193 ^ 0x5bd1e995\n\tfor (let i = 0; i < text.length; i++) {\n\t\tconst c = text.charCodeAt(i)\n\t\ta = Math.imul(a ^ c, 0x01000193)\n\t\tb = Math.imul(b ^ c, 0x5bd1e995)\n\t}\n\treturn (a >>> 0).toString(16).padStart(8, '0') + (b >>> 0).toString(16).padStart(8, '0')\n}\n\n/** Whether an object is a component (`defineComponent`): an id, its number, and every field a component has, in its shape */\nconst isComponent = (value: unknown): boolean => {\n\tconst part = value as { id?: unknown; slot?: unknown } | null\n\treturn typeof part?.id === 'string' && typeof part.slot === 'number' && 'replicate' in part && 'snapshot' in part && 'refs' in part\n}\n"],"mappings":"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"}

package/dist/moves.d.ts

@@ -0,0 +1,87 @@
+import { type EffectDef } from './defs';
+import { type Entity, type EntityId } from './entity';
+import { type Vec2 } from './math';
+import type { GamePack } from './packs/pack';
+import type { World } from './world';
+/**
+ * The moves pack's id
+ *
+ * @beta
+ */
+export declare const MOVES = "core.moves";
+/**
+ * Someone moved by a `dash` or a `knockback` of the moves pack while it rushes (`dashing`): in whose name (`by`), by
+ * which effect, after whom (`chase`), whom it met already (`met`) and the ground it set off from (`floor`), above which
+ * is a wall to it
+ *
+ * @beta
+ */
+export interface Moved {
+    /** In whose name what it meets and the wall happen: who dashed, or who threw it */
+    by: EntityId;
+    /** The ability that moved it */
+    ability: string;
+    /** The level it was cast at */
+    level: number;
+    /** The `dash` or `knockback` that moved it, whose `collide`, `stops` and `onWall` it goes by */
+    effect: EffectDef;
+    /** The unit it rushes after, to its edge (`to: 'target'`) */
+    chase?: EntityId;
+    /** Whom it met already, each once */
+    met?: EntityId[];
+    /** The level of the ground it set off from: higher ground is a wall to it */
+    floor: number;
+}
+/**
+ * One unit riding another (`attach`): its `host`, who cast it (`caster`), the ability and level, the seconds `left` (until
+ * it is let go otherwise when left out), the cooldown put off until it is let go (`held`) and what happens then (`onEnd`)
+ *
+ * @beta
+ */
+export interface Riding {
+    /** Whom it rides */
+    host: EntityId;
+    /** Who cast it: whose casting the ability again lets it go */
+    caster: EntityId;
+    /** The ability it rides by */
+    ability: string;
+    /** The level it was cast at */
+    level: number;
+    /** Seconds until it is let go, when it has a `duration` */
+    left?: number;
+    /** The ability's cooldown, put off until it is let go */
+    held?: number;
+    /** What happens as it is let go, in its name */
+    onEnd?: EffectDef[];
+}
+/**
+ * Who is being moved by the moves pack's `dash` or `knockback`, and how (`Moved`): on while the rush lasts
+ *
+ * @beta
+ */
+export declare const movedBy: import("./components").Component<Moved, Moved>;
+/**
+ * Who rides another (`attach`, `Riding`), out of the world while it does
+ *
+ * @beta
+ */
+export declare const riding: import("./components").Component<Riding, Riding>;
+/**
+ * Lets a rider go (`attach`): it is back in the world where its host is (or where it was), the ability's cooldown starts,
+ * and `onEnd` happens in its name at `point` (where it is when left out), its host the target. False for one that rides
+ * nobody
+ *
+ * @beta
+ */
+export declare function letGo(world: World, rider: Entity, point?: Vec2): boolean;
+/**
+ * Moves, as in a MOBA: what a game with it (`Rules.packs`) gets beside the engine's `blink`, `dash`, `knockback` and
+ * `pull`. A `dash` to the unit it was cast on (`to: 'target'`: after it as it moves, to its edge, or `through` it), a
+ * `knockback` that throws the way it is told (`direction`: `away`, `aim`, `over`, `towards`); for both, what happens to
+ * each the one moved meets on its way (`collide`, `stops`) and where it meets a wall (`onWall`). The `swap` effect (two
+ * units trade places) and `attach` (one rides another, out of the world, until it is let go: its time, its host gone,
+ * the ability cast again; `letGo` in code)
+ *
+ * @beta
+ */
+export declare function movesPack(): GamePack;