@v12-engine/engine 0.1.0 → 0.4.0

package/dist/manaBurn.js

@@ -0,0 +1,75 @@
+import { manaChanged } from "./engineEvents.js";
+import { scaled } from "./abilities/scaled.js";
+import { valueOf } from "./abilities/amounts.js";
+import { defineEffect, effectTargets } from "./abilities/effects.js";
+//#region src/manaBurn.ts
+/**
+* The mana burn pack's id
+*
+* @beta
+*/
+var MANA_BURN = "core.manaBurn";
+/**
+* Takes up to `amount` of a unit's mana and hurts it by as much as it took (times `ratio`), from `source`: what the
+* `manaBurn` effect does, for a game's own rules. Gives back the mana it took: none of a unit that has none, and no
+* damage then
+*
+* @beta
+*/
+function burnMana(world, target, amount, source, options = {}) {
+	const burnt = Math.min(Math.max(amount, 0), target.mana);
+	if (burnt <= 0) return 0;
+	target.mana -= burnt;
+	world.events.emit(manaChanged, {
+		entity: target,
+		amount: -burnt,
+		ability: options.ability,
+		source
+	});
+	const damage = burnt * (options.ratio ?? 1);
+	if (damage > 0) world.damage(target, damage, source, {
+		damageType: options.damageType ?? "magic",
+		ability: options.ability
+	});
+	return burnt;
+}
+var manaBurnEffect = defineEffect({
+	type: "manaBurn",
+	run: (context, effect) => {
+		const { world, caster, level } = context;
+		const amount = scaled(world, caster, valueOf(context, effect.amount), effect.scaling, level);
+		for (const entity of effectTargets(context, effect, "enemies")) burnMana(world, entity, amount, caster, {
+			ratio: effect.ratio,
+			damageType: effect.damageType,
+			ability: context.ability.id
+		});
+	},
+	fields: [
+		"amount",
+		"scaling",
+		"damageType",
+		{
+			path: "ratio",
+			kind: "number",
+			min: 0,
+			hint: "Times the mana taken it hurts by: 1 when left out"
+		}
+	]
+});
+/**
+* Mana burn, as in classic RTS games: the `manaBurn` effect (`EffectTypes.manaBurn`) takes `amount` of what it reaches of its
+* mana and hurts it by as much (times `ratio`). The demon hunter's spell is an ability with it; Feedback is a passive
+* whose `onHit` has it. `burnMana` does it in code
+*
+* @beta
+*/
+function manaBurnPack() {
+	return {
+		id: MANA_BURN,
+		effects: [manaBurnEffect]
+	};
+}
+//#endregion
+export { MANA_BURN, burnMana, manaBurnPack };
+
+//# sourceMappingURL=manaBurn.js.map

package/dist/manaBurn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manaBurn.js","names":[],"sources":["../src/manaBurn.ts"],"sourcesContent":["import { defineEffect, effectTargets } from './abilities/effects'\nimport { valueOf } from './abilities/amounts'\nimport { scaled } from './abilities/scaled'\nimport type { DamageType } from './defs'\nimport { manaChanged } from './engineEvents'\nimport type { Entity } from './entity'\nimport type { GamePack } from './packs/pack'\nimport type { World } from './world'\n\n/*\n * Mana burn, an opt-in pack (review RV95): the `manaBurn` effect takes a unit's mana and hurts it by as much, as the\n * demon hunter's spell does, and on every hit with `onHit` (Feedback)\n */\n\n/**\n * The mana burn pack's id\n *\n * @beta\n */\nexport const MANA_BURN = 'core.manaBurn'\n\n/**\n * How mana is burnt (`burnMana`)\n *\n * @beta\n */\nexport interface BurnOptions {\n\t/** Damage for each point of mana burnt: 1 when left out */\n\tratio?: number\n\t/** Magic when left out */\n\tdamageType?: DamageType\n\t/** The ability that burnt it, by id: for the damage and the mana told */\n\tability?: string\n}\n\n/**\n * Takes up to `amount` of a unit's mana and hurts it by as much as it took (times `ratio`), from `source`: what the\n * `manaBurn` effect does, for a game's own rules. Gives back the mana it took: none of a unit that has none, and no\n * damage then\n *\n * @beta\n */\nexport function burnMana(world: World, target: Entity, amount: number, source?: Entity, options: BurnOptions = {}): number {\n\tconst burnt = Math.min(Math.max(amount, 0), target.mana)\n\tif (burnt <= 0) return 0\n\ttarget.mana -= burnt\n\tworld.events.emit(manaChanged, { entity: target, amount: -burnt, ability: options.ability, source })\n\tconst damage = burnt * (options.ratio ?? 1)\n\tif (damage > 0) world.damage(target, damage, source, { damageType: options.damageType ?? 'magic', ability: options.ability })\n\treturn burnt\n}\n\nconst manaBurnEffect = defineEffect({ type: 'manaBurn', run: (context, effect) => {\n\t\tconst { world, caster, level } = context\n\t\tconst amount = scaled(world, caster, valueOf(context, effect.amount), effect.scaling, level)\n\t\tfor (const entity of effectTargets(context, effect, 'enemies'))\n\t\t\tburnMana(world, entity, amount, caster, { ratio: effect.ratio, damageType: effect.damageType, ability: context.ability.id })\n\t}, fields: ['amount', 'scaling', 'damageType', { path: 'ratio', kind: 'number', min: 0, hint: 'Times the mana taken it hurts by: 1 when left out' }] })\n\n/**\n * Mana burn, as in classic RTS games: the `manaBurn` effect (`EffectTypes.manaBurn`) takes `amount` of what it reaches of its\n * mana and hurts it by as much (times `ratio`). The demon hunter's spell is an ability with it; Feedback is a passive\n * whose `onHit` has it. `burnMana` does it in code\n *\n * @beta\n */\nexport function manaBurnPack(): GamePack {\n\treturn { id: MANA_BURN, effects: [manaBurnEffect] }\n}\n"],"mappings":";;;;;;;;;;AAmBA,IAAa,YAAY;;;;;;;;AAuBzB,SAAgB,SAAS,OAAc,QAAgB,QAAgB,QAAiB,UAAuB,CAAC,GAAW;CAC1H,MAAM,QAAQ,KAAK,IAAI,KAAK,IAAI,QAAQ,CAAC,GAAG,OAAO,IAAI;CACvD,IAAI,SAAS,GAAG,OAAO;CACvB,OAAO,QAAQ;CACf,MAAM,OAAO,KAAK,aAAa;EAAE,QAAQ;EAAQ,QAAQ,CAAC;EAAO,SAAS,QAAQ;EAAS;CAAO,CAAC;CACnG,MAAM,SAAS,SAAS,QAAQ,SAAS;CACzC,IAAI,SAAS,GAAG,MAAM,OAAO,QAAQ,QAAQ,QAAQ;EAAE,YAAY,QAAQ,cAAc;EAAS,SAAS,QAAQ;CAAQ,CAAC;CAC5H,OAAO;AACR;AAEA,IAAM,iBAAiB,aAAa;CAAE,MAAM;CAAY,MAAM,SAAS,WAAW;EAChF,MAAM,EAAE,OAAO,QAAQ,UAAU;EACjC,MAAM,SAAS,OAAO,OAAO,QAAQ,QAAQ,SAAS,OAAO,MAAM,GAAG,OAAO,SAAS,KAAK;EAC3F,KAAK,MAAM,UAAU,cAAc,SAAS,QAAQ,SAAS,GAC5D,SAAS,OAAO,QAAQ,QAAQ,QAAQ;GAAE,OAAO,OAAO;GAAO,YAAY,OAAO;GAAY,SAAS,QAAQ,QAAQ;EAAG,CAAC;CAC7H;CAAG,QAAQ;EAAC;EAAU;EAAW;EAAc;GAAE,MAAM;GAAS,MAAM;GAAU,KAAK;GAAG,MAAM;EAAoD;CAAC;AAAE,CAAC;;;;;;;;AASvJ,SAAgB,eAAyB;CACxC,OAAO;EAAE,IAAI;EAAW,SAAS,CAAC,cAAc;CAAE;AACnD"}

package/dist/map/file.d.ts

@@ -8,12 +8,19 @@ import { type CellRect, type GameMap, type MapCamera, type MapCamp, type MapDay,
  * @beta
  */
 export interface MapFile {
+    /** The file format's version (`MAP_FORMAT` when written), which the reader brings older files up from */
     format: number;
+    /** The map's name (`GameMap.name`) */
     name: string;
+    /** The map's description (`GameMap.description`) */
     description: string;
+    /** The game the map was made for, by the id of its module (`GameMap.game`); any game when left out */
     game?: string;
+    /** The map's width in cells */
     width: number;
+    /** The map's depth in cells */
     depth: number;
+    /** How much higher a level stands than the one below (`GameMap.cliffHeight`) */
     cliffHeight: number;
     /**
      * The layers of the ground, a line of text for each row (since format 3: before, one line for the whole layer): two
@@ -21,9 +28,13 @@ export interface MapFile {
      * corners along x for each z; the rest by cell, a row of cells for each z
      */
     ground: string[];
+    /** The cliff levels, a line of text per row of cells (`GameMap.levels`) */
     levels: string[];
+    /** The ramp flags, a line of text per row of cells (`GameMap.ramps`) */
     ramps: string[];
+    /** The water layer, a line of text per row of cells (`GameMap.water`) */
     water: string[];
+    /** The paint layer, a line of text per row of cells (`GameMap.tiles`) */
     tiles: string[];
     /** The game's layers of cells (`GameMap.cells`), by id, a line of text for each row as the layers above. Left out for none */
     cells?: Record<string, string[]>;
@@ -31,31 +42,51 @@ export interface MapFile {
     pathing?: string[];
     /** See `GameMap.tileset`. Since format 2 */
     tileset: string[];
+    /** The players who can take part (`GameMap.players`) */
     players: MapPlayer[];
+    /** What stands on the map when the game begins (`GameMap.objects`) */
     objects: MapObject[];
+    /** The creeps that guard spots (`GameMap.camps`) */
     camps: MapCamp[];
     /** Left out when there are none, as files made before regions were have none */
     regions?: MapRegion[];
     /** Left out when there are none */
     points?: MapPoint[];
+    /** The named lines of the map (`GameMap.paths`); left out when there are none */
     paths?: MapPath[];
+    /** The scenery of the map (`GameMap.doodads`); left out when there are none */
     doodads?: MapDoodad[];
+    /** The saved views of the map (`GameMap.cameras`); left out when there are none */
     cameras?: MapCamera[];
+    /** The groups that placed things can be drawn from (`GameMap.randomGroups`) */
     randomGroups?: MapRandomGroup[];
+    /** The tables of what drops when something dies (`GameMap.itemTables`) */
     itemTables?: MapItemTable[];
     /** The map's own definitions (`GameMap.definitions`) */
     definitions?: GameData;
+    /** The map's teams, named (`GameMap.forces`) */
     forces?: MapForce[];
+    /** The races a lobby offers on the map, by id (`GameMap.races`) */
     races?: string[];
+    /** Who made the map (`GameMap.author`) */
     author?: string;
+    /** The map's checks it does not want, by their rules' ids (`GameMap.silence`) */
     silence?: string[];
+    /** Who the map is for, as lists show it (`GameMap.meantFor`) */
     meantFor?: string;
+    /** Whether the whole map starts explored (`GameMap.explored`) */
     explored?: boolean;
+    /** What the loading screen says (`GameMap.loading`) */
     loading?: string;
+    /** A small picture of the map as a data URL, for lists of maps (`GameMap.preview`) */
     preview?: string;
+    /** What the map looks like beyond its ground: its water, light, sky (`GameMap.environment`) */
     environment?: MapEnvironment;
+    /** The hour the game starts at and whether it moves (`GameMap.day`) */
     day?: MapDay;
+    /** How the map was made when a generator made it: the seed and options (`GameMap.generated`) */
     generated?: GeneratedWith;
+    /** The part of the map play happens in, in cells (`GameMap.bounds`) */
     bounds?: CellRect;
     /** Left out when the game keeps nothing with the map */
     data?: Record<string, unknown>;
@@ -88,16 +119,38 @@ export declare function serializeMap(map: GameMap): MapFile;
  *
  *     export const maps = mapsFrom({ './maps/field.vgmap.json': field, './maps/hills.vgmap.json': hills })
  *
- * Throws for two files of one name, and with the path of a file that cannot be read
+ * Given what loads each file in place of the file (`import.meta.glob('./maps/*.vgmap.json', { import: 'default' })`, not
+ * `eager`; or `() => import('./field.vgmap.json')`), nothing is fetched or read until a map is asked for: the result is
+ * then `LazyMaps`, each a function giving the map (a promise), and the page carries one chunk a map. `appScenes` takes
+ * both
  *
- * @beta
+ *     export const maps = mapsFrom(import.meta.glob('./maps/*.vgmap.json', { import: 'default' }))
+ *     const field = await maps.field()
+ *
+ * Throws for two files of one name, for files some given and some loaded, and with the path of a file that cannot be read
+ *
+ * @public
+ */
+export declare function mapsFrom(files: Readonly<Record<string, () => unknown>>): LazyMaps;
+/**
+ * The maps of map files given whole, read at once (see above for loaders)
+ *
+ * @public
  */
 export declare function mapsFrom(files: Readonly<Record<string, unknown>>): Record<string, GameMap>;
 /**
- * Reads a map file, of this format or an older one. Throws with what is wrong with it
+ * The maps of a game, each read as it is asked for (`mapsFrom` given loaders): a function giving the map, a promise. A
+ * map is read (`parseMap`) once, when first asked; the next ask gets the same map, which a game copies before it changes
+ * anything (`structuredClone`)
  *
  * @beta
  */
+export type LazyMaps = Readonly<Record<string, () => Promise<GameMap>>>;
+/**
+ * Reads a map file, of this format or an older one. Throws with what is wrong with it
+ *
+ * @public
+ */
 export declare function parseMap(file: unknown): GameMap;
 /**
  * A copy that shares nothing with the original

package/dist/map/file.js

@@ -0,0 +1,264 @@
+import { plain } from "../plain.js";
+import "./types.js";
+import { LEGACY_TILESET } from "../tiles.js";
+import { packBytes, unpackBytes } from "../bytes.js";
+import { KNOWN, MAP_FIELD_SPECS } from "./schema.js";
+//#region src/map/file.ts
+var isObject = (value) => typeof value === "object" && value !== null;
+/** The steps from each format to the one after it, by the format they start from */
+var MIGRATIONS = {
+	1: (file) => ({
+		...file,
+		tileset: [...LEGACY_TILESET]
+	}),
+	2: (file) => {
+		const width = Number(file.width);
+		const depth = Number(file.depth);
+		const split = (key, count, bytes) => {
+			const packed = file[key];
+			const whole = typeof packed === "string" ? unpackBytes(packed, count * bytes) : void 0;
+			return whole ? rowsOf(whole, bytes) : packed;
+		};
+		return {
+			...file,
+			ground: split("ground", depth + 1, (width + 1) * 4),
+			levels: split("levels", depth, width),
+			ramps: split("ramps", depth, width),
+			water: split("water", depth, width),
+			tiles: split("tiles", depth, width)
+		};
+	}
+};
+/** The layers of cells of a map with anything in them, as the file has them: none when there are none */
+function mapCells(map) {
+	const layers = Object.entries(map.cells ?? {}).filter(([, cells]) => cells.some((value) => value !== 0));
+	return layers.length ? Object.fromEntries(layers.sort(([a], [b]) => a < b ? -1 : 1).map(([id, cells]) => [id, rowsOf(cells, map.width)])) : void 0;
+}
+/** Bytes as a line of text for each row of `bytes` of them */
+function rowsOf(bytes, row) {
+	const lines = [];
+	for (let at = 0; at < bytes.length; at += row) lines.push(pack(bytes.subarray(at, at + row)));
+	return lines;
+}
+/**
+* A map file brought up to the format this reader knows, step by step. Throws for what is not a map file, and for
+* one of a newer format: what changed in it cannot be known here. `to` and `steps` are the reader's own when left out
+*
+* @beta
+*/
+function migrateMap(data, to = 3, steps = MIGRATIONS) {
+	if (!isObject(data)) throw new Error("Map file: not a map");
+	let file = data;
+	const format = file.format;
+	if (typeof format !== "number" || !Number.isInteger(format) || format < 1) throw new Error(`Map file: format ${String(format)} is not one this game reads`);
+	if (format > to) throw new Error(`Map file: format ${format} is newer than this game reads (${to}): it was saved by a newer version of the editor`);
+	for (let from = format; from < to; from++) {
+		const step = steps[from];
+		if (!step) throw new Error(`Map file: there is no way from format ${from} to ${from + 1}`);
+		file = {
+			...step(file),
+			format: from + 1
+		};
+	}
+	return file;
+}
+var pack = packBytes;
+function unpack(text, length, what) {
+	const bytes = unpackBytes(text, length);
+	if (!bytes) throw new Error(`Map file: ${what} does not match the size of the map`);
+	return bytes;
+}
+/** Whether a value holds anything: text not empty, a list or an object with something in it, a layer with a cell set */
+function filled(value) {
+	if (value === void 0 || value === null || value === "" || value === false) return false;
+	if (value instanceof Uint8Array) return value.some((each) => each !== 0);
+	if (Array.isArray(value)) return value.length > 0;
+	if (typeof value === "object") return Object.keys(value).length > 0;
+	return true;
+}
+/** The bytes of a layer, and how many to a row: the heights by corner (four bytes each), the rest by cell */
+function layerBytes(map, field, layer) {
+	return field.perVertex ? {
+		bytes: new Uint8Array(layer.buffer, layer.byteOffset, layer.byteLength),
+		row: (map.width + 1) * 4
+	} : {
+		bytes: layer,
+		row: map.width
+	};
+}
+/** A field as its file has it, or none where the file leaves it out (`MapFieldSpec.written`) */
+function written(map, field) {
+	const value = map[field.key];
+	if (field.written === "defined" && value === void 0) return void 0;
+	if (field.kind === "layers") return mapCells(map);
+	if (field.written === "filled" && !filled(value)) return void 0;
+	switch (field.kind) {
+		case "layer":
+		case "mask": {
+			const { bytes, row } = layerBytes(map, field, value);
+			return rowsOf(bytes, row);
+		}
+		case "names": return field.written === "filled" ? [...value] : value;
+		case "object": return field.plain ? plain(value, field.key, "Map", "keep numbers, text, lists and plain objects with a map") : value;
+		default: return value;
+	}
+}
+/**
+* A map as its file. Throws when what the game keeps with it (`data`) is not plain data, saying where
+*
+* @beta
+*/
+function serializeMap(map) {
+	const file = {
+		...map.extra,
+		format: 3
+	};
+	for (const field of MAP_FIELD_SPECS) {
+		const value = written(map, field);
+		if (value === void 0 || field.kind === "object" && field.written === "filled" && !filled(value)) continue;
+		file[field.key] = value;
+	}
+	return file;
+}
+function mapsFrom(files) {
+	const entries = Object.entries(files);
+	const lazy = typeof entries[0]?.[1] === "function";
+	const maps = {};
+	for (const [path, file] of entries) {
+		const name = mapFileName(path);
+		if (name in maps) throw new Error(`mapsFrom: two files are named "${name}"`);
+		if (typeof file === "function" !== lazy) throw new Error("mapsFrom: some files are given and some loaded: give them all one way");
+		const read = (loaded) => {
+			try {
+				return parseMap(mapFileOf(loaded));
+			} catch (error) {
+				throw new Error(`${path}: ${error.message}`);
+			}
+		};
+		let loading;
+		maps[name] = lazy ? () => loading ??= (async () => read(await file()))().catch((error) => (loading = void 0, Promise.reject(error))) : read(file);
+	}
+	return maps;
+}
+/** The name of a map file: its path without the folder and `.vgmap.json` */
+function mapFileName(path) {
+	return (path.split("/").pop() ?? path).replace(/\.vgmap\.json$|\.json$/, "");
+}
+/** What a loader gave: the file itself, or a module whose default is the file (a lazy glob without `import: 'default'`) */
+function mapFileOf(loaded) {
+	return isObject(loaded) && !Array.isArray(loaded) && !("format" in loaded) && "default" in loaded ? loaded.default : loaded;
+}
+/**
+* Reads a map file, of this format or an older one. Throws with what is wrong with it
+*
+* @public
+*/
+function parseMap(file) {
+	const data = migrateMap(file);
+	const width = Number(data.width);
+	const depth = Number(data.depth);
+	const inRange = (size) => Number.isInteger(size) && size >= 8 && size <= 512;
+	if (!inRange(width) || !inRange(depth)) throw new Error(`Map file: the size is out of range, between 8 and 512 cells each way`);
+	/** A layer of the ground as its rows have it, back in one piece: `bytes` to a row */
+	const rows = (lines, count, bytes, what) => {
+		if (!Array.isArray(lines) || lines.length !== count || lines.some((line) => typeof line !== "string")) throw new Error(`Map file: ${what} does not match the size of the map`);
+		const whole = new Uint8Array(count * bytes);
+		lines.forEach((line, row) => whole.set(unpack(line, bytes, what), row * bytes));
+		return whole;
+	};
+	const layer = (field, lines, what = field.what ?? field.key) => field.perVertex ? new Float32Array(rows(lines, depth + 1, (width + 1) * 4, what).buffer) : rows(lines, depth, width, what);
+	/** A list's entries, each an object, with an id where the list is of things with ids (`byId`) */
+	const entries = (field, list) => {
+		list.forEach((entry, at) => {
+			if (!isObject(entry) || Array.isArray(entry)) throw new Error(`Map file: ${field.key}[${at}] is not an object`);
+			if (field.byId && !Number.isFinite(entry.id)) throw new Error(`Map file: ${field.key}[${at}] has no id`);
+		});
+		return list;
+	};
+	const map = {};
+	for (const field of MAP_FIELD_SPECS) {
+		const value = data[field.key];
+		let read;
+		switch (field.kind) {
+			case "text":
+				read = typeof value === "string" ? value : void 0;
+				break;
+			case "number":
+				read = field.key === "width" ? width : field.key === "depth" ? depth : Number(value) || void 0;
+				break;
+			case "boolean":
+				read = typeof value === "boolean" ? value : void 0;
+				break;
+			case "layer":
+				read = layer(field, value);
+				break;
+			case "mask":
+				read = value === void 0 ? void 0 : layer(field, value);
+				break;
+			case "layers":
+				read = isObject(value) ? Object.fromEntries(Object.keys(value).map((id) => [id, layer(field, value[id], `the cells of ${id}`)])) : void 0;
+				break;
+			case "names":
+				if (field.required) {
+					if (!Array.isArray(value)) throw new Error(`Map file: ${field.key} is missing`);
+					if (value.length > 255 || value.some((id) => typeof id !== "string")) throw new Error("Map file: the tileset is not a list of tile names");
+					read = value;
+				} else read = Array.isArray(value) ? value.filter((name) => typeof name === "string") : void 0;
+				break;
+			case "list":
+				if (field.required && !Array.isArray(value)) throw new Error(`Map file: ${field.key} is missing`);
+				read = Array.isArray(value) ? entries(field, value) : void 0;
+				break;
+			case "object": read = isObject(value) && !(field.plain && Array.isArray(value)) ? value : void 0;
+		}
+		if (read === void 0) read = field.empty?.();
+		if (read !== void 0) map[field.key] = read;
+	}
+	map.objects = map.objects.map((object) => ({
+		...object,
+		scale: object.scale ?? 1
+	}));
+	const extra = Object.fromEntries(Object.entries(data).filter(([key]) => !KNOWN.has(key)));
+	if (Object.keys(extra).length > 0) map.extra = extra;
+	return map;
+}
+/** A copy of a field's value that shares nothing with it */
+function copied(field, value) {
+	switch (field.kind) {
+		case "layer":
+		case "mask": return value.slice();
+		case "layers": return Object.fromEntries(Object.entries(value).map(([id, cells]) => [id, cells.slice()]));
+		case "names": return [...value];
+		case "list":
+		case "object": return structuredClone(value);
+		default: return value;
+	}
+}
+/**
+* A copy that shares nothing with the original
+*
+* @beta
+*/
+function cloneMap(map) {
+	const copy = { ...map };
+	for (const field of MAP_FIELD_SPECS) {
+		const value = map[field.key];
+		if (value !== void 0) copy[field.key] = copied(field, value);
+	}
+	return copy;
+}
+/**
+* The map without what its editor keeps of its own (`GameMap.editor`): what a game is given to play. The very map
+* where it has none
+*
+* @beta
+*/
+function withoutEditor(map) {
+	if (!map.editor) return map;
+	const { editor: _, ...rest } = map;
+	return rest;
+}
+//#endregion
+export { cloneMap, mapsFrom, migrateMap, parseMap, serializeMap, withoutEditor };
+
+//# sourceMappingURL=file.js.map

package/dist/map/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","names":[],"sources":["../../src/map/file.ts"],"sourcesContent":["import type { GameData } from '../gameData'\n/*\n * A map as its file: written, read, brought up from an older format, copied (design review E8a: `map.ts` in parts)\n */\nimport { packBytes, unpackBytes } from '../bytes'\nimport type { GeneratedWith } from '../generate'\nimport { plain } from '../plain'\nimport { LEGACY_TILESET, MAX_TILES } from '../tiles'\nimport type { MapEnvironment } from './look'\nimport { KNOWN, MAP_FIELD_SPECS, type MapFieldSpec } from './schema'\nimport {\n\ttype CellRect,\n\ttype GameMap,\n\tMAP_FORMAT,\n\tMAX_MAP_SIZE,\n\tMIN_MAP_SIZE,\n\ttype MapCamera,\n\ttype MapCamp,\n\ttype MapDay,\n\ttype MapDoodad,\n\ttype MapForce,\n\ttype MapItemTable,\n\ttype MapObject,\n\ttype MapPath,\n\ttype MapPlayer,\n\ttype MapPoint,\n\ttype MapRandomGroup,\n\ttype MapRegion\n} from './types'\n\n// ---- files\n\n/**\n * A map the way it is written to a file: JSON, with the layers packed\n *\n * @beta\n */\nexport interface MapFile {\n\t/** The file format's version (`MAP_FORMAT` when written), which the reader brings older files up from */\n\tformat: number\n\t/** The map's name (`GameMap.name`) */\n\tname: string\n\t/** The map's description (`GameMap.description`) */\n\tdescription: string\n\t/** The game the map was made for, by the id of its module (`GameMap.game`); any game when left out */\n\tgame?: string\n\t/** The map's width in cells */\n\twidth: number\n\t/** The map's depth in cells */\n\tdepth: number\n\t/** How much higher a level stands than the one below (`GameMap.cliffHeight`) */\n\tcliffHeight: number\n\t/**\n\t * The layers of the ground, a line of text for each row (since format 3: before, one line for the whole layer): two\n\t * people who change different rows change different lines, which git merges. The heights by corner, a row of the\n\t * corners along x for each z; the rest by cell, a row of cells for each z\n\t */\n\tground: string[]\n\t/** The cliff levels, a line of text per row of cells (`GameMap.levels`) */\n\tlevels: string[]\n\t/** The ramp flags, a line of text per row of cells (`GameMap.ramps`) */\n\tramps: string[]\n\t/** The water layer, a line of text per row of cells (`GameMap.water`) */\n\twater: string[]\n\t/** The paint layer, a line of text per row of cells (`GameMap.tiles`) */\n\ttiles: string[]\n\t/** The game's layers of cells (`GameMap.cells`), by id, a line of text for each row as the layers above. Left out for none */\n\tcells?: Record<string, string[]>\n\t/** What is kept off cells by hand (`GameMap.pathing`), a line of text for each row as the layers above. Left out for none */\n\tpathing?: string[]\n\t/** See `GameMap.tileset`. Since format 2 */\n\ttileset: string[]\n\t/** The players who can take part (`GameMap.players`) */\n\tplayers: MapPlayer[]\n\t/** What stands on the map when the game begins (`GameMap.objects`) */\n\tobjects: MapObject[]\n\t/** The creeps that guard spots (`GameMap.camps`) */\n\tcamps: MapCamp[]\n\t/** Left out when there are none, as files made before regions were have none */\n\tregions?: MapRegion[]\n\t/** Left out when there are none */\n\tpoints?: MapPoint[]\n\t/** The named lines of the map (`GameMap.paths`); left out when there are none */\n\tpaths?: MapPath[]\n\t/** The scenery of the map (`GameMap.doodads`); left out when there are none */\n\tdoodads?: MapDoodad[]\n\t/** The saved views of the map (`GameMap.cameras`); left out when there are none */\n\tcameras?: MapCamera[]\n\t/** The groups that placed things can be drawn from (`GameMap.randomGroups`) */\n\trandomGroups?: MapRandomGroup[]\n\t/** The tables of what drops when something dies (`GameMap.itemTables`) */\n\titemTables?: MapItemTable[]\n\t/** The map's own definitions (`GameMap.definitions`) */\n\tdefinitions?: GameData\n\t/** The map's teams, named (`GameMap.forces`) */\n\tforces?: MapForce[]\n\t/** The races a lobby offers on the map, by id (`GameMap.races`) */\n\traces?: string[]\n\t/** Who made the map (`GameMap.author`) */\n\tauthor?: string\n\t/** The map's checks it does not want, by their rules' ids (`GameMap.silence`) */\n\tsilence?: string[]\n\t/** Who the map is for, as lists show it (`GameMap.meantFor`) */\n\tmeantFor?: string\n\t/** Whether the whole map starts explored (`GameMap.explored`) */\n\texplored?: boolean\n\t/** What the loading screen says (`GameMap.loading`) */\n\tloading?: string\n\t/** A small picture of the map as a data URL, for lists of maps (`GameMap.preview`) */\n\tpreview?: string\n\t/** What the map looks like beyond its ground: its water, light, sky (`GameMap.environment`) */\n\tenvironment?: MapEnvironment\n\t/** The hour the game starts at and whether it moves (`GameMap.day`) */\n\tday?: MapDay\n\t/** How the map was made when a generator made it: the seed and options (`GameMap.generated`) */\n\tgenerated?: GeneratedWith\n\t/** The part of the map play happens in, in cells (`GameMap.bounds`) */\n\tbounds?: CellRect\n\t/** Left out when the game keeps nothing with the map */\n\tdata?: Record<string, unknown>\n\t/** Left out when the editor keeps nothing with the map */\n\teditor?: Record<string, unknown>\n}\n\nconst isObject = (value: unknown): value is Record<string, unknown> => typeof value === 'object' && value !== null\n\n/**\n * Brings a file of one format up to the next\n *\n * @beta\n */\nexport type MapMigration = (file: Record<string, unknown>) => Record<string, unknown>\n\n/** The steps from each format to the one after it, by the format they start from */\nconst MIGRATIONS: Record<number, MapMigration> = {\n\t// format 2 says which tile each index of the paint is. Before, the index was into the client's own list\n\t1: (file) => ({ ...file, tileset: [...LEGACY_TILESET] }),\n\t// format 3 writes each layer of the ground a row to a line, for git to merge. Before, a layer was one line\n\t2: (file) => {\n\t\tconst width = Number(file.width)\n\t\tconst depth = Number(file.depth)\n\t\tconst split = (key: string, count: number, bytes: number) => {\n\t\t\tconst packed = file[key]\n\t\t\tconst whole = typeof packed === 'string' ? unpackBytes(packed, count * bytes) : undefined\n\t\t\t// what does not match is left for the reader to say so\n\t\t\treturn whole ? rowsOf(whole, bytes) : packed\n\t\t}\n\t\treturn {\n\t\t\t...file,\n\t\t\tground: split('ground', depth + 1, (width + 1) * 4),\n\t\t\tlevels: split('levels', depth, width),\n\t\t\tramps: split('ramps', depth, width),\n\t\t\twater: split('water', depth, width),\n\t\t\ttiles: split('tiles', depth, width)\n\t\t}\n\t}\n}\n\n/** The layers of cells of a map with anything in them, as the file has them: none when there are none */\nfunction mapCells(map: GameMap): Record<string, string[]> | undefined {\n\tconst layers = Object.entries(map.cells ?? {}).filter(([, cells]) => cells.some((value) => value !== 0))\n\treturn layers.length\n\t\t? Object.fromEntries(layers.sort(([a], [b]) => (a < b ? -1 : 1)).map(([id, cells]) => [id, rowsOf(cells, map.width)]))\n\t\t: undefined\n}\n\n/** Bytes as a line of text for each row of `bytes` of them */\nfunction rowsOf(bytes: Uint8Array, row: number): string[] {\n\tconst lines: string[] = []\n\tfor (let at = 0; at < bytes.length; at += row) lines.push(pack(bytes.subarray(at, at + row)))\n\treturn lines\n}\n\n/**\n * A map file brought up to the format this reader knows, step by step. Throws for what is not a map file, and for\n * one of a newer format: what changed in it cannot be known here. `to` and `steps` are the reader's own when left out\n *\n * @beta\n */\nexport function migrateMap(data: unknown, to: number = MAP_FORMAT, steps: Record<number, MapMigration> = MIGRATIONS): Record<string, unknown> {\n\tif (!isObject(data)) throw new Error('Map file: not a map')\n\tlet file = data\n\tconst format = file.format\n\tif (typeof format !== 'number' || !Number.isInteger(format) || format < 1)\n\t\tthrow new Error(`Map file: format ${String(format)} is not one this game reads`)\n\tif (format > to) throw new Error(`Map file: format ${format} is newer than this game reads (${to}): it was saved by a newer version of the editor`)\n\tfor (let from = format; from < to; from++) {\n\t\tconst step = steps[from]\n\t\tif (!step) throw new Error(`Map file: there is no way from format ${from} to ${from + 1}`)\n\t\tfile = { ...step(file), format: from + 1 }\n\t}\n\treturn file\n}\n\nconst pack = packBytes\n\nfunction unpack(text: string, length: number, what: string): Uint8Array {\n\tconst bytes = unpackBytes(text, length)\n\tif (!bytes) throw new Error(`Map file: ${what} does not match the size of the map`)\n\treturn bytes\n}\n\n/** Whether a value holds anything: text not empty, a list or an object with something in it, a layer with a cell set */\nfunction filled(value: unknown): boolean {\n\tif (value === undefined || value === null || value === '' || value === false) return false\n\tif (value instanceof Uint8Array) return value.some((each) => each !== 0)\n\tif (Array.isArray(value)) return value.length > 0\n\tif (typeof value === 'object') return Object.keys(value).length > 0\n\treturn true\n}\n\n/** The bytes of a layer, and how many to a row: the heights by corner (four bytes each), the rest by cell */\nfunction layerBytes(map: GameMap, field: MapFieldSpec, layer: Float32Array | Uint8Array): { bytes: Uint8Array; row: number } {\n\treturn field.perVertex\n\t\t? { bytes: new Uint8Array(layer.buffer, layer.byteOffset, layer.byteLength), row: (map.width + 1) * 4 }\n\t\t: { bytes: layer as Uint8Array, row: map.width }\n}\n\n/** A field as its file has it, or none where the file leaves it out (`MapFieldSpec.written`) */\nfunction written(map: GameMap, field: MapFieldSpec): unknown {\n\tconst value = map[field.key] as unknown\n\tif (field.written === 'defined' && value === undefined) return undefined\n\tif (field.kind === 'layers') return mapCells(map)\n\tif (field.written === 'filled' && !filled(value)) return undefined\n\tswitch (field.kind) {\n\t\tcase 'layer':\n\t\tcase 'mask': {\n\t\t\tconst { bytes, row } = layerBytes(map, field, value as Float32Array | Uint8Array)\n\t\t\treturn rowsOf(bytes, row)\n\t\t}\n\t\tcase 'names':\n\t\t\t// a list of names asked only where it holds any is a copy; the tileset is the map's own\n\t\t\treturn field.written === 'filled' ? [...(value as string[])] : value\n\t\tcase 'object':\n\t\t\treturn field.plain ? plain(value, field.key, 'Map', 'keep numbers, text, lists and plain objects with a map') : value\n\t\tdefault:\n\t\t\treturn value\n\t}\n}\n\n/**\n * A map as its file. Throws when what the game keeps with it (`data`) is not plain data, saying where\n *\n * @beta\n */\nexport function serializeMap(map: GameMap): MapFile {\n\t// first, so that nothing in it stands in for what this reader does know\n\tconst file: Record<string, unknown> = { ...map.extra, format: MAP_FORMAT }\n\tfor (const field of MAP_FIELD_SPECS) {\n\t\tconst value = written(map, field)\n\t\t// plain data that comes to nothing is left out, as an empty object is\n\t\tif (value === undefined || (field.kind === 'object' && field.written === 'filled' && !filled(value))) continue\n\t\tfile[field.key] = value\n\t}\n\treturn file as unknown as MapFile\n}\n\n/**\n * The maps of map files, by the name of each file without its folder and `.vgmap.json`: `./maps/field.vgmap.json` is\n * `field`. The files by their paths, read (`parseMap`): imported one by one, or Vite's\n * `import.meta.glob('./maps/*.vgmap.json', { eager: true, import: 'default' })` where only a page reads them\n *\n *     export const maps = mapsFrom({ './maps/field.vgmap.json': field, './maps/hills.vgmap.json': hills })\n *\n * Given what loads each file in place of the file (`import.meta.glob('./maps/*.vgmap.json', { import: 'default' })`, not\n * `eager`; or `() => import('./field.vgmap.json')`), nothing is fetched or read until a map is asked for: the result is\n * then `LazyMaps`, each a function giving the map (a promise), and the page carries one chunk a map. `appScenes` takes\n * both\n *\n *     export const maps = mapsFrom(import.meta.glob('./maps/*.vgmap.json', { import: 'default' }))\n *     const field = await maps.field()\n *\n * Throws for two files of one name, for files some given and some loaded, and with the path of a file that cannot be read\n *\n * @public\n */\nexport function mapsFrom(files: Readonly<Record<string, () => unknown>>): LazyMaps\n/**\n * The maps of map files given whole, read at once (see above for loaders)\n *\n * @public\n */\nexport function mapsFrom(files: Readonly<Record<string, unknown>>): Record<string, GameMap>\nexport function mapsFrom(files: Readonly<Record<string, unknown>>): Record<string, GameMap> | LazyMaps {\n\tconst entries = Object.entries(files)\n\tconst lazy = typeof entries[0]?.[1] === 'function'\n\tconst maps: Record<string, GameMap | (() => Promise<GameMap>)> = {}\n\tfor (const [path, file] of entries) {\n\t\tconst name = mapFileName(path)\n\t\tif (name in maps) throw new Error(`mapsFrom: two files are named \"${name}\"`)\n\t\tif ((typeof file === 'function') !== lazy) throw new Error('mapsFrom: some files are given and some loaded: give them all one way')\n\t\tconst read = (loaded: unknown): GameMap => {\n\t\t\ttry {\n\t\t\t\treturn parseMap(mapFileOf(loaded))\n\t\t\t} catch (error) {\n\t\t\t\tthrow new Error(`${path}: ${(error as Error).message}`)\n\t\t\t}\n\t\t}\n\t\tlet loading: Promise<GameMap> | undefined\n\t\t// read when asked, once; a file that failed is tried again the next time\n\t\tmaps[name] = lazy\n\t\t\t? () => (loading ??= (async () => read(await (file as () => unknown)()))().catch((error) => ((loading = undefined), Promise.reject(error))))\n\t\t\t: read(file)\n\t}\n\treturn maps as Record<string, GameMap> | LazyMaps\n}\n\n/**\n * The maps of a game, each read as it is asked for (`mapsFrom` given loaders): a function giving the map, a promise. A\n * map is read (`parseMap`) once, when first asked; the next ask gets the same map, which a game copies before it changes\n * anything (`structuredClone`)\n *\n * @beta\n */\nexport type LazyMaps = Readonly<Record<string, () => Promise<GameMap>>>\n\n/** The name of a map file: its path without the folder and `.vgmap.json` */\nfunction mapFileName(path: string): string {\n\treturn (path.split('/').pop() ?? path).replace(/\\.vgmap\\.json$|\\.json$/, '')\n}\n\n/** What a loader gave: the file itself, or a module whose default is the file (a lazy glob without `import: 'default'`) */\nfunction mapFileOf(loaded: unknown): unknown {\n\treturn isObject(loaded) && !Array.isArray(loaded) && !('format' in loaded) && 'default' in loaded ? loaded.default : loaded\n}\n\n/**\n * Reads a map file, of this format or an older one. Throws with what is wrong with it\n *\n * @public\n */\nexport function parseMap(file: unknown): GameMap {\n\tconst data = migrateMap(file)\n\tconst width = Number(data.width)\n\tconst depth = Number(data.depth)\n\tconst inRange = (size: number) => Number.isInteger(size) && size >= MIN_MAP_SIZE && size <= MAX_MAP_SIZE\n\tif (!inRange(width) || !inRange(depth)) {\n\t\tthrow new Error(`Map file: the size is out of range, between ${MIN_MAP_SIZE} and ${MAX_MAP_SIZE} cells each way`)\n\t}\n\t/** A layer of the ground as its rows have it, back in one piece: `bytes` to a row */\n\tconst rows = (lines: unknown, count: number, bytes: number, what: string) => {\n\t\tif (!Array.isArray(lines) || lines.length !== count || lines.some((line) => typeof line !== 'string'))\n\t\t\tthrow new Error(`Map file: ${what} does not match the size of the map`)\n\t\tconst whole = new Uint8Array(count * bytes)\n\t\tlines.forEach((line: string, row) => whole.set(unpack(line, bytes, what), row * bytes))\n\t\treturn whole\n\t}\n\tconst layer = (field: MapFieldSpec, lines: unknown, what = field.what ?? field.key) =>\n\t\tfield.perVertex ? new Float32Array(rows(lines, depth + 1, (width + 1) * 4, what).buffer) : rows(lines, depth, width, what)\n\t/** A list's entries, each an object, with an id where the list is of things with ids (`byId`) */\n\tconst entries = (field: MapFieldSpec, list: unknown[]) => {\n\t\tlist.forEach((entry, at) => {\n\t\t\tif (!isObject(entry) || Array.isArray(entry)) throw new Error(`Map file: ${field.key}[${at}] is not an object`)\n\t\t\tif (field.byId && !Number.isFinite((entry as { id?: unknown }).id)) throw new Error(`Map file: ${field.key}[${at}] has no id`)\n\t\t})\n\t\treturn list\n\t}\n\tconst map: Record<string, unknown> = {}\n\tfor (const field of MAP_FIELD_SPECS) {\n\t\tconst value = data[field.key]\n\t\tlet read: unknown\n\t\tswitch (field.kind) {\n\t\t\tcase 'text':\n\t\t\t\tread = typeof value === 'string' ? value : undefined\n\t\t\t\tbreak\n\t\t\tcase 'number':\n\t\t\t\tread = field.key === 'width' ? width : field.key === 'depth' ? depth : Number(value) || undefined\n\t\t\t\tbreak\n\t\t\tcase 'boolean':\n\t\t\t\tread = typeof value === 'boolean' ? value : undefined\n\t\t\t\tbreak\n\t\t\tcase 'layer':\n\t\t\t\tread = layer(field, value)\n\t\t\t\tbreak\n\t\t\tcase 'mask':\n\t\t\t\tread = value === undefined ? undefined : layer(field, value)\n\t\t\t\tbreak\n\t\t\tcase 'layers':\n\t\t\t\tread = isObject(value) ? Object.fromEntries(Object.keys(value).map((id) => [id, layer(field, value[id], `the cells of ${id}`)])) : undefined\n\t\t\t\tbreak\n\t\t\tcase 'names':\n\t\t\t\tif (field.required) {\n\t\t\t\t\tif (!Array.isArray(value)) throw new Error(`Map file: ${field.key} is missing`)\n\t\t\t\t\tif (value.length > MAX_TILES || value.some((id) => typeof id !== 'string'))\n\t\t\t\t\t\tthrow new Error('Map file: the tileset is not a list of tile names')\n\t\t\t\t\tread = value\n\t\t\t\t} else read = Array.isArray(value) ? value.filter((name): name is string => typeof name === 'string') : undefined\n\t\t\t\tbreak\n\t\t\tcase 'list':\n\t\t\t\tif (field.required && !Array.isArray(value)) throw new Error(`Map file: ${field.key} is missing`)\n\t\t\t\tread = Array.isArray(value) ? entries(field, value) : undefined\n\t\t\t\tbreak\n\t\t\tcase 'object':\n\t\t\t\tread = isObject(value) && !(field.plain && Array.isArray(value)) ? value : undefined\n\t\t\t\tbreak\n\t\t}\n\t\tif (read === undefined) read = field.empty?.()\n\t\tif (read !== undefined) map[field.key] = read\n\t}\n\t// a thing placed is as big as its type unless the file says otherwise\n\tmap.objects = (map.objects as MapObject[]).map((object) => ({ ...object, scale: object.scale ?? 1 }))\n\tconst extra = Object.fromEntries(Object.entries(data).filter(([key]) => !KNOWN.has(key)))\n\tif (Object.keys(extra).length > 0) map.extra = extra\n\treturn map as unknown as GameMap\n}\n\n/** A copy of a field's value that shares nothing with it */\nfunction copied(field: MapFieldSpec, value: unknown): unknown {\n\tswitch (field.kind) {\n\t\tcase 'layer':\n\t\tcase 'mask':\n\t\t\treturn (value as Uint8Array | Float32Array).slice()\n\t\tcase 'layers':\n\t\t\treturn Object.fromEntries(Object.entries(value as Record<string, Uint8Array>).map(([id, cells]) => [id, cells.slice()]))\n\t\tcase 'names':\n\t\t\treturn [...(value as string[])]\n\t\tcase 'list':\n\t\tcase 'object':\n\t\t\treturn structuredClone(value)\n\t\tdefault:\n\t\t\treturn value\n\t}\n}\n\n/**\n * A copy that shares nothing with the original\n *\n * @beta\n */\nexport function cloneMap(map: GameMap): GameMap {\n\tconst copy: Record<string, unknown> = { ...map }\n\tfor (const field of MAP_FIELD_SPECS) {\n\t\tconst value = map[field.key] as unknown\n\t\tif (value !== undefined) copy[field.key] = copied(field, value)\n\t}\n\treturn copy as unknown as GameMap\n}\n\n/**\n * The map without what its editor keeps of its own (`GameMap.editor`): what a game is given to play. The very map\n * where it has none\n *\n * @beta\n */\nexport function withoutEditor(map: GameMap): GameMap {\n\tif (!map.editor) return map\n\tconst { editor: _, ...rest } = map\n\treturn rest\n}\n"],"mappings":"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"}

package/dist/map/images.js

@@ -0,0 +1,61 @@
+import { clamp } from "../math.js";
+//#region src/map/images.ts
+/**
+* Heights from the pixels of a picture (RGBA, as a canvas gives them): dark is `low`, light is `high`, the picture
+* stretched over the corners of the map's ground. A heightmap made elsewhere, read into a map
+*
+* @beta
+*/
+function heightsFromPixels(pixels, imageWidth, imageHeight, map, low, high) {
+	const row = map.width + 1;
+	const ground = new Float32Array(row * (map.depth + 1));
+	const at = (x, y) => {
+		const i = (clamp(y, 0, imageHeight - 1) * imageWidth + clamp(x, 0, imageWidth - 1)) * 4;
+		return (pixels[i] * .299 + pixels[i + 1] * .587 + pixels[i + 2] * .114) / 255;
+	};
+	for (let iz = 0; iz <= map.depth; iz++) for (let ix = 0; ix <= map.width; ix++) {
+		const fx = ix / map.width * (imageWidth - 1);
+		const fy = iz / map.depth * (imageHeight - 1);
+		const x = Math.floor(fx);
+		const y = Math.floor(fy);
+		const tx = fx - x;
+		const ty = fy - y;
+		const top = at(x, y) * (1 - tx) + at(x + 1, y) * tx;
+		const bottom = at(x, y + 1) * (1 - tx) + at(x + 1, y + 1) * tx;
+		ground[iz * row + ix] = low + (top * (1 - ty) + bottom * ty) * (high - low);
+	}
+	return ground;
+}
+/**
+* The heights of a terrain as the pixels of a picture (RGBA), a pixel a corner: the lowest black, the highest white
+*
+* @beta
+*/
+function heightsToPixels(heights, width, depth) {
+	let low = Infinity;
+	let high = -Infinity;
+	for (const h of heights) {
+		low = Math.min(low, h);
+		high = Math.max(high, h);
+	}
+	const span = high - low || 1;
+	const pixels = new Uint8ClampedArray((width + 1) * (depth + 1) * 4);
+	for (let i = 0; i < heights.length; i++) {
+		const value = Math.round((heights[i] - low) / span * 255);
+		pixels.set([
+			value,
+			value,
+			value,
+			255
+		], i * 4);
+	}
+	return {
+		pixels,
+		low,
+		high
+	};
+}
+//#endregion
+export { heightsFromPixels, heightsToPixels };
+
+//# sourceMappingURL=images.js.map

package/dist/map/images.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.js","names":[],"sources":["../../src/map/images.ts"],"sourcesContent":["/*\n * Heights to and from the pixels of a picture (design review E8a: `map.ts` in parts)\n */\nimport { clamp } from '../math'\nimport type { GameMap } from './types'\n\n/**\n * Heights from the pixels of a picture (RGBA, as a canvas gives them): dark is `low`, light is `high`, the picture\n * stretched over the corners of the map's ground. A heightmap made elsewhere, read into a map\n *\n * @beta\n */\nexport function heightsFromPixels(\n\tpixels: ArrayLike<number>,\n\timageWidth: number,\n\timageHeight: number,\n\tmap: Pick<GameMap, 'width' | 'depth'>,\n\tlow: number,\n\thigh: number\n): Float32Array {\n\tconst row = map.width + 1\n\tconst ground = new Float32Array(row * (map.depth + 1))\n\tconst at = (x: number, y: number) => {\n\t\tconst i = (clamp(y, 0, imageHeight - 1) * imageWidth + clamp(x, 0, imageWidth - 1)) * 4\n\t\t// the brightness of it, as the eye sees it\n\t\treturn (pixels[i] * 0.299 + pixels[i + 1] * 0.587 + pixels[i + 2] * 0.114) / 255\n\t}\n\tfor (let iz = 0; iz <= map.depth; iz++) {\n\t\tfor (let ix = 0; ix <= map.width; ix++) {\n\t\t\t// between the four pixels around where this corner falls\n\t\t\tconst fx = (ix / map.width) * (imageWidth - 1)\n\t\t\tconst fy = (iz / map.depth) * (imageHeight - 1)\n\t\t\tconst x = Math.floor(fx)\n\t\t\tconst y = Math.floor(fy)\n\t\t\tconst tx = fx - x\n\t\t\tconst ty = fy - y\n\t\t\tconst top = at(x, y) * (1 - tx) + at(x + 1, y) * tx\n\t\t\tconst bottom = at(x, y + 1) * (1 - tx) + at(x + 1, y + 1) * tx\n\t\t\tground[iz * row + ix] = low + (top * (1 - ty) + bottom * ty) * (high - low)\n\t\t}\n\t}\n\treturn ground\n}\n\n/**\n * The heights of a terrain as the pixels of a picture (RGBA), a pixel a corner: the lowest black, the highest white\n *\n * @beta\n */\nexport function heightsToPixels(heights: Float32Array, width: number, depth: number): { pixels: Uint8ClampedArray; low: number; high: number } {\n\tlet low = Infinity\n\tlet high = -Infinity\n\tfor (const h of heights) {\n\t\tlow = Math.min(low, h)\n\t\thigh = Math.max(high, h)\n\t}\n\tconst span = high - low || 1\n\tconst pixels = new Uint8ClampedArray((width + 1) * (depth + 1) * 4)\n\tfor (let i = 0; i < heights.length; i++) {\n\t\tconst value = Math.round(((heights[i] - low) / span) * 255)\n\t\tpixels.set([value, value, value, 255], i * 4)\n\t}\n\treturn { pixels, low, high }\n}\n"],"mappings":";;;;;;;;AAYA,SAAgB,kBACf,QACA,YACA,aACA,KACA,KACA,MACe;CACf,MAAM,MAAM,IAAI,QAAQ;CACxB,MAAM,SAAS,IAAI,aAAa,OAAO,IAAI,QAAQ,EAAE;CACrD,MAAM,MAAM,GAAW,MAAc;EACpC,MAAM,KAAK,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,aAAa,MAAM,GAAG,GAAG,aAAa,CAAC,KAAK;EAEtF,QAAQ,OAAO,KAAK,OAAQ,OAAO,IAAI,KAAK,OAAQ,OAAO,IAAI,KAAK,QAAS;CAC9E;CACA,KAAK,IAAI,KAAK,GAAG,MAAM,IAAI,OAAO,MACjC,KAAK,IAAI,KAAK,GAAG,MAAM,IAAI,OAAO,MAAM;EAEvC,MAAM,KAAM,KAAK,IAAI,SAAU,aAAa;EAC5C,MAAM,KAAM,KAAK,IAAI,SAAU,cAAc;EAC7C,MAAM,IAAI,KAAK,MAAM,EAAE;EACvB,MAAM,IAAI,KAAK,MAAM,EAAE;EACvB,MAAM,KAAK,KAAK;EAChB,MAAM,KAAK,KAAK;EAChB,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,IAAI,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI;EACjD,MAAM,SAAS,GAAG,GAAG,IAAI,CAAC,KAAK,IAAI,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC,IAAI;EAC5D,OAAO,KAAK,MAAM,MAAM,OAAO,OAAO,IAAI,MAAM,SAAS,OAAO,OAAO;CACxE;CAED,OAAO;AACR;;;;;;AAOA,SAAgB,gBAAgB,SAAuB,OAAe,OAAyE;CAC9I,IAAI,MAAM;CACV,IAAI,OAAO;CACX,KAAK,MAAM,KAAK,SAAS;EACxB,MAAM,KAAK,IAAI,KAAK,CAAC;EACrB,OAAO,KAAK,IAAI,MAAM,CAAC;CACxB;CACA,MAAM,OAAO,OAAO,OAAO;CAC3B,MAAM,SAAS,IAAI,mBAAmB,QAAQ,MAAM,QAAQ,KAAK,CAAC;CAClE,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;EACxC,MAAM,QAAQ,KAAK,OAAQ,QAAQ,KAAK,OAAO,OAAQ,GAAG;EAC1D,OAAO,IAAI;GAAC;GAAO;GAAO;GAAO;EAAG,GAAG,IAAI,CAAC;CAC7C;CACA,OAAO;EAAE;EAAQ;EAAK;CAAK;AAC5B"}

package/dist/map/look.d.ts

@@ -4,7 +4,7 @@
  * paint like the game's. An open interface: the client adds what it draws by (its water, light, sky, fog, weather,
  * lights and the rest), as a game adds its commands (`Commands`)
  *
- * @beta
+ * @public
  */
 export interface MapEnvironment {
     /** Ground of the map's own to paint with, past the game's tiles (see `MapTile`): the rules' paint, by id */

package/dist/map/look.js

@@ -0,0 +1,30 @@
+import { environmentChanged } from "../engineEvents.js";
+import { replicateEvent } from "../replication.js";
+import "../tiles.js";
+//#region src/map/look.ts
+/**
+* The ids of a map's own tiles (`MapEnvironment.tiles`)
+*
+* @beta
+*/
+var mapTileIds = (environment) => (environment?.tiles ?? []).map((tile) => tile.id);
+/**
+* The tiles a world from a map is painted with: the game's, then the map's own that are none of them, as many as a map
+* can hold. The order a played ground's paint is in, and its looks
+*
+* @beta
+*/
+function playTileset(gameTiles, environment) {
+	const own = mapTileIds(environment).filter((id) => !gameTiles.includes(id));
+	return [...gameTiles, ...own].slice(0, 255);
+}
+/** The map's light, fog and sky changed (`world.setEnvironment`): to everyone */
+var toldEnvironment = replicateEvent(environmentChanged, "environment", ({ environment, over }) => ({
+	type: "environment",
+	environment: structuredClone(environment),
+	...over && { over }
+}));
+//#endregion
+export { mapTileIds, playTileset, toldEnvironment };
+
+//# sourceMappingURL=look.js.map