@datamoc/mw_games 0.4.2 → 0.4.3

package/dist/two-d/ui/SelectionModel.js

@@ -0,0 +1,73 @@
+export class SelectionModel {
+    constructor(hooks) {
+        this.list = [];
+        this.current = 0;
+        this.hooks = hooks;
+    }
+    get items() {
+        return this.list;
+    }
+    get selectedIndex() {
+        return this.current;
+    }
+    get selected() {
+        return this.list[this.current] ?? null;
+    }
+    get length() {
+        return this.list.length;
+    }
+    /** points at the first selectable entry (index 0 when nothing is), without notifying */
+    reset(items) {
+        this.list = items;
+        this.current = items.findIndex((item) => !item.disabled);
+        if (this.current === -1)
+            this.current = 0;
+    }
+    /** swaps two entries in place, the way grid reordering does; the highlight is untouched */
+    swap(a, b) {
+        [this.list[a], this.list[b]] = [this.list[b], this.list[a]];
+    }
+    land(index) {
+        this.current = index;
+        this.hooks.onChange();
+        const item = this.list[index];
+        if (item)
+            this.hooks.onHighlight(item, index);
+    }
+    select(index) {
+        if (index < 0 || index >= this.list.length || this.list[index].disabled)
+            return;
+        this.land(index);
+    }
+    confirm(onSelect) {
+        const item = this.selected;
+        if (!item || item.disabled)
+            return false;
+        onSelect?.(item, this.current);
+        return true;
+    }
+    /**
+     * Steps from the current index with `advance`, skipping disabled and out-of-range
+     * landings. Each attempt starts from the previous candidate (not the selection), so a
+     * blocked neighbour keeps walking rather than retrying the same cell. Tries at most
+     * `maxSteps` candidates, so an all-disabled set terminates. Returns false when there
+     * is nothing selectable to move to.
+     */
+    step(advance, maxSteps) {
+        if (this.list.length === 0)
+            return false;
+        let from = this.current;
+        for (let tried = 0; tried < maxSteps; tried++) {
+            const next = advance(from, this.list.length);
+            from = next;
+            if (next < 0 || next >= this.list.length)
+                continue;
+            if (!this.list[next].disabled) {
+                this.land(next);
+                return true;
+            }
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=SelectionModel.js.map

package/dist/two-d/ui/SelectionModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelectionModel.js","sourceRoot":"","sources":["../../../src/two-d/ui/SelectionModel.ts"],"names":[],"mappings":"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"}

package/dist/two-d/ui/themedText.d.ts

@@ -0,0 +1,20 @@
+import type { Theme } from './theme.ts';
+/**
+ * The text options `Label` and `BitmapLabel` share. Each one extends this with whatever its
+ * own renderer needs (`Label` adds stroke/resolution/roundPixels); the shared fields stay in
+ * one place so the two labels cannot drift apart on what "themed text" accepts.
+ */
+export interface ThemedTextOptions {
+    text?: string;
+    color?: number;
+    size?: number;
+    /** wraps at this width in pixels; omit for a single unwrapped line */
+    wrapWidth?: number;
+    align?: 'left' | 'center' | 'right';
+    bold?: boolean;
+}
+/** accepts the `options | string` shorthand both labels offer in their constructors */
+export declare function normalizeTextOptions<T extends ThemedTextOptions>(options: T | string): T;
+/** the align a label uses when the game gave none: the theme direction, not a fixed left */
+export declare function themedAlign(opts: ThemedTextOptions, t: Theme): 'left' | 'center' | 'right';
+//# sourceMappingURL=themedText.d.ts.map

package/dist/two-d/ui/themedText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"themedText.d.ts","sourceRoot":"","sources":["../../../src/two-d/ui/themedText.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpC,IAAI,CAAC,EAAE,OAAO,CAAC;CACf;AAED,uFAAuF;AACvF,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,iBAAiB,EAAE,OAAO,EAAE,CAAC,GAAG,MAAM,GAAG,CAAC,CAExF;AAED,4FAA4F;AAC5F,wBAAgB,WAAW,CAAC,IAAI,EAAE,iBAAiB,EAAE,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAE1F"}

package/dist/two-d/ui/themedText.js

@@ -0,0 +1,9 @@
+/** accepts the `options | string` shorthand both labels offer in their constructors */
+export function normalizeTextOptions(options) {
+    return typeof options === 'string' ? ({ text: options }) : options;
+}
+/** the align a label uses when the game gave none: the theme direction, not a fixed left */
+export function themedAlign(opts, t) {
+    return opts.align ?? (t.direction === 'rtl' ? 'right' : 'left');
+}
+//# sourceMappingURL=themedText.js.map

package/dist/two-d/ui/themedText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"themedText.js","sourceRoot":"","sources":["../../../src/two-d/ui/themedText.ts"],"names":[],"mappings":"AAiBA,uFAAuF;AACvF,MAAM,UAAU,oBAAoB,CAA8B,OAAmB;IACpF,OAAO,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAM,CAAC,CAAC,CAAC,OAAO,CAAC;AACzE,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,WAAW,CAAC,IAAuB,EAAE,CAAQ;IAC5D,OAAO,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AACjE,CAAC"}

package/dist/version.d.ts

@@ -9,5 +9,5 @@
  * this from `package.json` automatically, chosen because this project's own build already
  * has no step before `tsc`/`vite` that this would need to run ahead of.
  */
-export declare const version = "0.4.2";
+export declare const version = "0.4.3";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -9,5 +9,5 @@
  * this from `package.json` automatically, chosen because this project's own build already
  * has no step before `tsc`/`vite` that this would need to run ahead of.
  */
-export const version = '0.4.2';
+export const version = '0.4.3';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datamoc/mw_games",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "A local-file game framework: renderer-free game logic, drawn through PixiJS in 2D or Babylon.js in 3D, with mobile and desktop packaging.",
   "license": "MPL-2.0",
   "repository": {
@@ -39,6 +39,8 @@
   "files": [
     "dist",
     "tools/compile-resources.mjs",
+    "tools/compress-dist.mjs",
+    "tools/compress-dist.d.mts",
     "LICENSE",
     "README.md"
   ],
@@ -104,6 +106,7 @@
       "import": "./dist/simulation/index.js"
     },
     "./tools/compile-resources": "./tools/compile-resources.mjs",
+    "./tools/compress-dist": "./tools/compress-dist.mjs",
     "./two-d": {
       "types": "./dist/two-d/index.d.ts",
       "import": "./dist/two-d/index.js"

package/tools/compile-resources.mjs

@@ -37,7 +37,7 @@ export const DEFAULT_MIME = {
 	'.txt': 'text/plain',
 };
 
-async function* walk(dir) {
+export async function* walk(dir) {
 	let entries;
 	try {
 		entries = await readdir(dir, { withFileTypes: true });

package/tools/compress-dist.d.mts

@@ -0,0 +1,16 @@
+export interface CompressOptions {
+	gzip?: boolean;
+	brotli?: boolean;
+	xz?: boolean;
+}
+
+export interface CompressRow {
+	file: string;
+	raw: number;
+	gzip: number;
+	brotli: number;
+	xz: number;
+}
+
+export function hasXz(): boolean;
+export function compressDist(dir: string, options?: CompressOptions): Promise<CompressRow[]>;

package/tools/compress-dist.mjs

@@ -0,0 +1,116 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { relative, extname, basename } from 'node:path';
+import { gzipSync, brotliCompressSync, constants } from 'node:zlib';
+import { spawnSync } from 'node:child_process';
+import { walk } from './compile-resources.mjs';
+
+/**
+ * Writes precompressed siblings (`.gz`, `.br`, optionally `.xz`) next to a build's
+ * text files, for servers that can serve them with a `Content-Encoding` header.
+ *
+ * The originals stay exactly where they are, so a page opened from `file://` keeps
+ * working with no server: the compressed files are only ever picked up when a server
+ * negotiates them (nginx `gzip_static`, Apache `mod_rewrite`, a CDN, Capacitor live
+ * reload, and so on). Nothing in the page references them.
+ *
+ * Only Node built-ins are used, so this adds no dependency. Gzip (level 9) is the
+ * universal fallback every server understands; brotli (quality 11) is smaller and served
+ * by preference where the client offers `br`. LZMA2 (`.xz`, via the system `xz` binary
+ * when present, opt-in with `--xz`) compresses a little further, but browsers do not
+ * decode `xz` as a `Content-Encoding`, so it is an offline archive format, not something
+ * a server can negotiate: `gz` stays the fallback.
+ *
+ * usage: node tools/compress-dist.mjs <dist folder> [--xz] [--no-gzip] [--no-brotli]
+ */
+
+const TEXT_EXTENSIONS = new Set(['.js', '.html', '.css', '.svg', '.json', '.txt', '.map']);
+const ALREADY_COMPRESSED = new Set(['.gz', '.br', '.xz', '.png', '.jpg', '.jpeg', '.webp', '.gif', '.wav', '.ogg', '.mp3', '.ttf', '.woff2']);
+const MIN_BYTES = 1024;
+
+/** true when the system `xz` binary (LZMA2) is available for the opt-in archive pass */
+export function hasXz() {
+	try {
+		const found = spawnSync('xz', ['--version'], { stdio: 'ignore' });
+		return found.status === 0;
+	} catch {
+		return false;
+	}
+}
+
+function compressXz(data) {
+	const out = spawnSync('xz', ['-c', '-9'], { input: data });
+	if (out.status !== 0 || !out.stdout) return undefined;
+	return out.stdout;
+}
+
+/**
+ * @param dir folder to compress, normally an example's `dist`
+ * @param options.gzip write `.gz` siblings (default true)
+ * @param options.brotli write `.br` siblings (default true)
+ * @param options.xz also write `.xz` siblings where smaller (default false, needs `xz`)
+ * @returns one row per file considered, with the sizes actually written
+ */
+export async function compressDist(dir, { gzip = true, brotli = true, xz = false } = {}) {
+	const rows = [];
+	const wantXz = xz && hasXz();
+	for await (const file of walk(dir)) {
+		const ext = extname(file).toLowerCase();
+		if (!TEXT_EXTENSIONS.has(ext) || ALREADY_COMPRESSED.has(ext)) continue;
+		const data = await readFile(file);
+		if (data.length < MIN_BYTES) continue;
+		const name = relative(dir, file);
+		const row = { file: name, raw: data.length, gzip: 0, brotli: 0, xz: 0 };
+		if (gzip) {
+			const zipped = gzipSync(data, { level: 9 });
+			if (zipped.length < data.length) {
+				await writeFile(file + '.gz', zipped);
+				row.gzip = zipped.length;
+			}
+		}
+		if (brotli) {
+			const squeezed = brotliCompressSync(data, {
+				params: { [constants.BROTLI_PARAM_QUALITY]: 11 },
+			});
+			if (squeezed.length < data.length) {
+				await writeFile(file + '.br', squeezed);
+				row.brotli = squeezed.length;
+			}
+		}
+		if (wantXz) {
+			const archived = compressXz(data);
+			if (archived && archived.length < data.length) {
+				await writeFile(file + '.xz', archived);
+				row.xz = archived.length;
+			}
+		}
+		rows.push(row);
+	}
+	return rows;
+}
+
+const isMain = process.argv[1] && import.meta.url.endsWith(basename(process.argv[1]));
+
+if (isMain) {
+	const [dir, ...flags] = process.argv.slice(2);
+	if (!dir) {
+		console.error('usage: node tools/compress-dist.mjs <dist folder> [--xz] [--no-gzip] [--no-brotli]');
+		process.exit(1);
+	}
+	const rows = await compressDist(dir, {
+		gzip: !flags.includes('--no-gzip'),
+		brotli: !flags.includes('--no-brotli'),
+		xz: flags.includes('--xz'),
+	});
+	const kb = (n) => (n / 1024).toFixed(1).padStart(8) + ' KB';
+	for (const row of rows) {
+		const parts = [`${row.file.padEnd(36)}${kb(row.raw)}`];
+		if (row.gzip) parts.push(`gz:${kb(row.gzip)}`);
+		if (row.brotli) parts.push(`br:${kb(row.brotli)}`);
+		if (row.xz) parts.push(`xz:${kb(row.xz)}`);
+		console.log('  ' + parts.join('  '));
+	}
+	if (flags.includes('--xz') && !hasXz()) {
+		console.log('  (xz requested but no `xz` binary found - skipping LZMA2, gz stays the fallback)');
+	}
+	console.log(`  ${rows.length} file(s) considered in ${relative(process.cwd(), dir)}`);
+}