@datamoc/mw_games 0.44.2 → 0.46.0

package/physics/xpbd.d.ts

@@ -0,0 +1 @@
+export * from '@datamoc/mwg/physics/xpbd';

package/physics/xpbd.js

@@ -0,0 +1 @@
+export * from '@datamoc/mwg/physics/xpbd';

package/physics.d.ts

@@ -0,0 +1 @@
+export * from '@datamoc/mwg/physics';

package/physics.js

@@ -0,0 +1 @@
+export * from '@datamoc/mwg/physics';

package/roguelike.d.ts

@@ -0,0 +1 @@
+export * from '@datamoc/mwg/roguelike';

package/roguelike.js

@@ -0,0 +1 @@
+export * from '@datamoc/mwg/roguelike';

package/rpg.d.ts

@@ -0,0 +1 @@
+export * from '@datamoc/mwg/rpg';

package/rpg.js

@@ -0,0 +1 @@
+export * from '@datamoc/mwg/rpg';

package/simulation.d.ts

@@ -0,0 +1 @@
+export * from '@datamoc/mwg/simulation';

package/simulation.js

@@ -0,0 +1 @@
+export * from '@datamoc/mwg/simulation';

package/skeleton.d.ts

@@ -0,0 +1 @@
+export * from '@datamoc/mwg/skeleton';

package/skeleton.js

@@ -0,0 +1 @@
+export * from '@datamoc/mwg/skeleton';

package/testing.d.ts

@@ -0,0 +1 @@
+export * from '@datamoc/mwg/testing';

package/testing.js

@@ -0,0 +1 @@
+export * from '@datamoc/mwg/testing';

package/threads.d.ts

@@ -0,0 +1 @@
+export * from '@datamoc/mwg/threads';

package/threads.js

@@ -0,0 +1 @@
+export * from '@datamoc/mwg/threads';

package/tools/asset-report.d.mts

@@ -1,37 +1 @@
-export interface AssetReportFile {
-	path: string;
-	raw: number;
-	gzip: number;
-	brotli: number;
-	sha256: string;
-	/** This file's gzip bytes over the page's total gzip bytes, 0 when the page is empty. */
-	share: number;
-}
-export interface AssetReportSource {
-	path: string;
-	raw: number;
-	sha256: string;
-}
-export interface AssetReportTotals {
-	files: number;
-	raw: number;
-	gzip: number;
-	brotli: number;
-	assetFiles: number;
-	assetRaw: number;
-}
-export interface AssetReport {
-	dist: string;
-	files: AssetReportFile[];
-	assets: AssetReportSource[];
-	/** Groups of source paths with byte-identical content, sorted; empty when none exist. */
-	duplicates: string[][];
-	totals: AssetReportTotals;
-}
-export function fingerprint(data: Uint8Array): string;
-export function compressedSizes(data: Uint8Array): { gzip: number; brotli: number };
-export function assetReport(options: {
-	dist: string;
-	assets?: string;
-	mime?: Record<string, string>;
-}): Promise<AssetReport>;
+export * from '@datamoc/mwg/tools/asset-report';

package/tools/asset-report.mjs

@@ -1,157 +1 @@
-#!/usr/bin/env node
-import { createHash } from 'node:crypto';
-import { gzipSync, brotliCompressSync, constants } from 'node:zlib';
-import { realpathSync, statSync } from 'node:fs';
-import { readFile, writeFile } from 'node:fs/promises';
-import { join, relative, sep, extname } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { walk, DEFAULT_MIME } from './compile-resources.mjs';
-
-/**
- * Reports what a built page actually ships, so a game can see where its bytes go.
- *
- * Two halves, both deterministic (sorted paths, fixed compression settings, hashes):
- *
- *   - `files`: every file under `dist` (precompressed `.gz`/`.br`/`.xz` siblings
- *     excluded - they are derived artifacts, and the gzip/brotli columns already count
- *     them) with raw, gzip (level 9) and brotli (quality 11) weights plus its share of
- *     the compressed page, the same settings `tools/compress-dist.mjs` writes with;
- *   - `assets`: every source file the asset folder embeds (the root `credits.json`
- *     and unknown extensions excluded, exactly the files `compileResources` skips),
- *     with duplicates grouped by SHA-256 so an asset embedded twice is visible.
- *
- * Shipped as `@datamoc/mw_games/tools/asset-report` (`assetReport(options)`, what the
- * flags below map onto) and as the `mwg-assets` command.
- *
- * usage: mwg-assets <dist folder> [--assets=<dir>] [--json=<report file>]
- */
-
-const DERIVED_SIBLINGS = new Set(['.gz', '.br', '.xz']);
-
-export function fingerprint(data) {
-	return createHash('sha256').update(data).digest('hex');
-}
-
-export function compressedSizes(data) {
-	return {
-		gzip: gzipSync(data, { level: 9 }).length,
-		brotli: brotliCompressSync(data, { params: { [constants.BROTLI_PARAM_QUALITY]: 11 } }).length,
-	};
-}
-
-function isDirectory(path) {
-	try {
-		return statSync(path).isDirectory();
-	} catch {
-		return false;
-	}
-}
-
-/**
- * @param options.dist the built page folder to measure
- * @param options.assets the asset source folder to inventory (skipped when absent)
- * @param options.mime extension to MIME type, merged over the compile defaults, so a
- *   game embedding extra types reports the same set the build embeds
- * @returns the sorted files, sources, duplicate groups and totals described above
- */
-export async function assetReport({ dist, assets, mime = {} } = {}) {
-	if (!dist || !isDirectory(dist))
-		throw new Error(`assetReport needs the dist folder of a built page, got "${dist}"`);
-	if (assets !== undefined && !isDirectory(assets))
-		throw new Error(`assetReport needs a readable assets folder, got "${assets}"`);
-
-	const files = [];
-	for await (const file of walk(dist)) {
-		if (DERIVED_SIBLINGS.has(extname(file).toLowerCase())) continue;
-		const data = await readFile(file);
-		const { gzip, brotli } = compressedSizes(data);
-		files.push({
-			path: relative(dist, file).split(sep).join('/'),
-			raw: data.length,
-			gzip,
-			brotli,
-			sha256: fingerprint(data),
-			share: 0,
-		});
-	}
-	files.sort((a, b) => (a.path < b.path ? -1 : 1));
-	const totalGzip = files.reduce((sum, file) => sum + file.gzip, 0);
-	for (const file of files) file.share = totalGzip ? file.gzip / totalGzip : 0;
-
-	const sources = [];
-	const duplicates = [];
-	if (assets !== undefined) {
-		const types = { ...DEFAULT_MIME, ...mime };
-		const creditsFile = join(assets, 'credits.json');
-		const byHash = new Map();
-		for await (const file of walk(assets)) {
-			if (file === creditsFile) continue;
-			if (!types[extname(file).toLowerCase()]) continue;
-			const data = await readFile(file);
-			const sha256 = fingerprint(data);
-			const key = relative(assets, file).split(sep).join('/');
-			sources.push({ path: key, raw: data.length, sha256 });
-			const group = byHash.get(sha256) ?? [];
-			group.push(key);
-			byHash.set(sha256, group);
-		}
-		sources.sort((a, b) => (a.path < b.path ? -1 : 1));
-		for (const group of byHash.values()) if (group.length > 1) duplicates.push([...group].sort());
-		duplicates.sort((a, b) => (a[0] < b[0] ? -1 : 1));
-	}
-
-	return {
-		dist,
-		files,
-		assets: sources,
-		duplicates,
-		totals: {
-			files: files.length,
-			raw: files.reduce((sum, file) => sum + file.raw, 0),
-			gzip: totalGzip,
-			brotli: files.reduce((sum, file) => sum + file.brotli, 0),
-			assetFiles: sources.length,
-			assetRaw: sources.reduce((sum, source) => sum + source.raw, 0),
-		},
-	};
-}
-
-const kb = (n) => (n / 1024).toFixed(1) + ' KB';
-const percent = (share) => (share * 100).toFixed(1) + '%';
-
-async function main(argv) {
-	const folder = argv.find((arg) => !arg.startsWith('--'));
-	if (!folder) {
-		console.error('usage: mwg-assets <dist folder> [--assets=<dir>] [--json=<report file>]');
-		process.exit(1);
-	}
-	const value = (name) => argv.find((a) => a.startsWith(`--${name}=`))?.slice(name.length + 3);
-	const report = await assetReport({ dist: folder, assets: value('assets') });
-
-	console.log(`\n  ${report.dist}`);
-	for (const file of report.files) {
-		console.log(
-			`  ${file.path.padEnd(40)}${kb(file.raw).padStart(10)}  gz ${kb(file.gzip).padStart(10)}  br ${kb(file.brotli).padStart(10)}  ${percent(file.share).padStart(6)}`,
-		);
-	}
-	console.log(
-		`  ${report.totals.files} file(s), ${kb(report.totals.raw)} raw -> ${kb(report.totals.gzip)} gz / ${kb(report.totals.brotli)} br`,
-	);
-	if (report.assets.length) {
-		console.log(`  ${report.totals.assetFiles} embedded asset(s), ${kb(report.totals.assetRaw)} raw`);
-		for (const group of report.duplicates) console.log(`  duplicate: ${group.join(' == ')}`);
-	}
-	const json = value('json');
-	if (json) {
-		await writeFile(json, JSON.stringify(report, null, 2) + '\n', 'utf8');
-		console.log(`  report written to ${json}`);
-	}
-}
-
-//realpath, since an npm `bin` shim reaches this file through a symlink
-//no top-level await: a vite config loaded as CommonJS has to be able to require() this module
-if (process.argv[1] && realpathSync(process.argv[1]) === fileURLToPath(import.meta.url))
-	main(process.argv.slice(2)).catch((error) => {
-		console.error(error);
-		process.exitCode = 1;
-	});
+export * from '@datamoc/mwg/tools/asset-report';

package/tools/audio.d.mts

@@ -1,75 +1 @@
-/** what `detectAudioFormat` makes of a file */
-export interface AudioFormat {
-	/** the format by name: `'MIDI'`, `'WAV'`, `'Ogg Vorbis'`, `'MWA'`, `'unknown'`... */
-	format: string;
-	kind: 'midi' | 'wav' | 'soundfont' | 'compressed' | 'chip' | 'tracker' | 'sysex' | 'unknown';
-}
-
-/** the report `inspectAudio` returns: the format, the size, and the numbers that matter for that format */
-export interface AudioInspection extends AudioFormat {
-	name: string;
-	bytes: number;
-	[detail: string]: unknown;
-}
-
-export interface RenderToWavOptions {
-	/** an engine name, or several separated by commas and tried in order */
-	synth?: string;
-	/** module paths imported first, to register the engines `synth` names */
-	modules?: string[];
-	/** the bytes of a SoundFont for the General MIDI voicing */
-	soundfont?: Uint8Array;
-	rate?: number;
-	gain?: number;
-	/** render only these MIDI channels, 0 to 15 */
-	channels?: number[];
-	/** 32-bit float samples instead of 16-bit PCM */
-	float?: boolean;
-}
-
-export interface AudioBudgetOptions {
-	/** render rate assumed for MIDI files; 22050 */
-	rate?: number;
-	/** a MIDI render is capped here, as the library's own cap is; 480 */
-	maxSeconds?: number;
-	/** fail when the decoded audio would hold more than this many megabytes */
-	maxMegabytes?: number;
-	/** fail for any track longer than this many seconds */
-	maxTrackSeconds?: number;
-}
-
-export interface AudioBudgetFile {
-	path: string;
-	format: string;
-	diskBytes: number;
-	/** bytes it adds to a page, base64 included */
-	pageBytes: number;
-	seconds: number | null;
-	/** bytes of stereo float samples it holds decoded, or null when that cannot be known without decoding */
-	decodedBytes: number | null;
-}
-
-export interface AudioBudgetReport {
-	files: AudioBudgetFile[];
-	totals: { diskBytes: number; pageBytes: number; decodedBytes: number };
-	problems: string[];
-}
-
-/** names a file by its content, falling back on the extension for formats with no signature */
-export function detectAudioFormat(bytes: Uint8Array, name?: string): AudioFormat;
-/** describes one file: its format and the numbers that matter for that format */
-export function inspectAudio(bytes: Uint8Array, name?: string): Promise<AudioInspection>;
-/** `"0,9"` as `[0, 9]` */
-export function parseChannelList(text: string): number[];
-/** renders MIDI bytes to WAV bytes through a registered engine, a SoundFont or the built-in synth */
-export function renderToWav(midi: Uint8Array, options?: RenderToWavOptions): Promise<Uint8Array>;
-/** resamples WAV bytes to another rate */
-export function resampleWav(wav: Uint8Array, rate: number, float?: boolean): Promise<Uint8Array>;
-/** how far apart two WAV files sound, in dB of log-spectrum difference */
-export function compareWavs(
-	a: Uint8Array,
-	b: Uint8Array,
-	options?: { windowSize?: number; hop?: number; floorDb?: number },
-): Promise<{ decibels: number; windows: number }>;
-/** what the audio files under these paths cost a page and a bus */
-export function audioBudget(paths: string[], options?: AudioBudgetOptions): Promise<AudioBudgetReport>;
+export * from '@datamoc/mwg/tools/audio';