@datamoc/mw_games 0.38.0 → 0.39.1

package/tools/compile-resources.mjs

@@ -58,6 +58,9 @@ export async function* walk(dir) {
  * @param options.from folder holding the assets
  * @param options.to folder to write the generated scripts into
  * @param options.mime extension to MIME type, merged over the defaults
+ * @param options.assetFiles exact paths relative to `from` to embed; omit for all, [] for none.
+ *   Unknown paths and explicitly selected unsupported formats fail before replacing output.
+ *   credits.json is converted to CREDITS.txt only when selected (or when no list is given).
  * @param options.groupBy how to name the script an asset lands in; defaults to its top folder
  * @param options.toWebp convert `.png`/`.jpg`/`.jpeg` assets to WebP before embedding
  *   (default false - see `tools/webp-convert.mjs`). The asset's *key* never changes (a game
@@ -81,6 +84,7 @@ export async function compileResources({
 	to,
 	mime = {},
 	groupBy,
+	assetFiles,
 	toWebp: convertToWebp = false,
 	webpLossless = true,
 	webpQuality = 90,
@@ -90,6 +94,22 @@ export async function compileResources({
 	const types = { ...DEFAULT_MIME, ...mime };
 	const group = groupBy ?? ((key) => (key.includes('/') ? key.slice(0, key.indexOf('/')) : 'assets'));
 
+	const files = [];
+	for await (const file of walk(from)) files.push(file);
+	const keyOf = (file) => relative(from, file).split(sep).join('/');
+	const selected =
+		assetFiles === undefined
+			? undefined
+			: new Set(assetFiles.map((key) => key.replaceAll('\\', '/').replace(/^\.\//, '')));
+	if (selected) {
+		const known = new Set(files.map(keyOf));
+		for (const key of selected) {
+			if (!known.has(key)) throw new Error(`unknown asset file ${key}`);
+			if (key !== 'credits.json' && !types[extname(key).toLowerCase()])
+				throw new Error(`unsupported asset file ${key}`);
+		}
+	}
+
 	await rm(to, { recursive: true, force: true });
 	await mkdir(to, { recursive: true });
 
@@ -106,7 +126,8 @@ export async function compileResources({
 	const creditsFile = join(from, 'credits.json');
 	let credits = null;
 
-	for await (const file of walk(from)) {
+	for (const file of files) {
+		if (selected && !selected.has(keyOf(file))) continue;
 		if (file === creditsFile) {
 			credits = creditsText(JSON.parse(await readFile(file, 'utf8')));
 			continue;
@@ -118,7 +139,7 @@ export async function compileResources({
 			continue;
 		}
 
-		const key = relative(from, file).split(sep).join('/');
+		const key = keyOf(file);
 		const data = await readFile(file);
 
 		let mimeType = type;

package/tools/emit-page.d.mts

@@ -9,6 +9,8 @@ export interface EmitPageOptions {
 	assets?: string;
 	/** maps an asset path to its script's name; defaults to one script per top-level folder */
 	groupBy?: (key: string) => string;
+	/** Exact paths relative to the asset folder to embed. Omit to include all; [] includes none. Unknown entries fail by name. */
+	assetFiles?: readonly string[];
 	/** write `.gz`/`.br` siblings for a server to negotiate; default true */
 	compress?: boolean;
 	/** also write `.xz`, where the system `xz` binary exists */

package/tools/emit-page.mjs

@@ -66,6 +66,7 @@ export async function emitPage({
 	dist,
 	assets,
 	groupBy,
+	assetFiles,
 	compress = true,
 	xz = false,
 	singleFile = false,
@@ -75,8 +76,17 @@ export async function emitPage({
 	csp = true,
 }) {
 	if (!dist) throw new Error('emitPage needs the dist folder of a vite build');
+	if (!assets && assetFiles?.length) throw new Error(`unknown asset file ${assetFiles[0]}: no assets folder`);
 	const compiled = assets
-		? await compileResources({ from: assets, to: join(dist, 'assets'), groupBy, toWebp, webpLossless, webpQuality })
+		? await compileResources({
+				from: assets,
+				to: join(dist, 'assets'),
+				groupBy,
+				assetFiles,
+				toWebp,
+				webpLossless,
+				webpQuality,
+			})
 		: { groups: [], rawBytes: 0, embeddedBytes: 0, webpConverted: 0 };
 
 	const html = await readFile(join(dist, 'index.html'), 'utf8');

package/tools/vite.mjs

@@ -11,7 +11,10 @@ import { buildArtifactSbom, serialize, shippedFiles } from './sbom.mjs';
  * It sets the configuration that target needs (a classic IIFE bundle named `game.js`, relative
  * urls through `base: './'`, no inlined or copied assets since they are compiled instead) and
  * serves `assets` (default `'assets'`, `false` for none) as the public folder, so an asset path reads the same in `vite` dev as in the
- * build. At the end of the build it runs `emitPage` over the output folder with the same
+ * build. `assetFiles: ['characters/hero.svg', 'music/theme.ogg']` embeds only those paths;
+ * omit it for all assets, or pass [] for none. An unknown entry fails by name. Filtering
+ * affects the build only, so the dev server still serves the asset folder normally.
+ * At the end of the build it runs `emitPage` over the output folder with the same
  * options. A setting the game's own config gives explicitly still wins, since vite merges a
  * plugin's `config` result under the user's.
  *