mirror of
https://github.com/tiennm99/noitu.git
synced 2026-10-11 03:13:45 +00:00
tiennm99
90cd679639
A /rules page says, in one place, what nothing in the app said before: the chain rule, the clock, what a dead end costs, elimination and the last player standing, how a word is scored and the reconnect window. Linked from the landing page and from the board and lobby headers. The chat control moves above the chain as a pill with the unread count, where it can be reached on a phone mid-game, and the lobby's folded chat now carries an unread badge too. ESLint with the Svelte and JSDoc plugins, run in CI; the real findings it turned up (missing each keys, untyped timer handles) are fixed.
93 lines
3.0 KiB
JavaScript
93 lines
3.0 KiB
JavaScript
import { t } from '$lib/i18n/vi.js';
|
|
|
|
/**
|
|
* Turns a finished game into a plain-text transcript the player can keep.
|
|
*
|
|
* The formatting lives here rather than in the panel so it can be tested
|
|
* without a DOM, and so the only thing the component owns is the click.
|
|
*/
|
|
|
|
/** @param {number} n */
|
|
function pad(n) {
|
|
return String(n).padStart(2, '0');
|
|
}
|
|
|
|
/**
|
|
* Local time, because the file is for the person who played the game and not
|
|
* for a machine in another timezone.
|
|
* @param {Date} at
|
|
* @returns {string}
|
|
*/
|
|
function stamp(at) {
|
|
return `${at.getFullYear()}-${pad(at.getMonth() + 1)}-${pad(at.getDate())} ${pad(at.getHours())}:${pad(at.getMinutes())}`;
|
|
}
|
|
|
|
/**
|
|
* @param {Date} at
|
|
* @returns {string} a filename safe on every platform, with no colons
|
|
*/
|
|
export function historyFilename(at = new Date()) {
|
|
const d = `${at.getFullYear()}-${pad(at.getMonth() + 1)}-${pad(at.getDate())}`;
|
|
return `noi-tu-${d}-${pad(at.getHours())}${pad(at.getMinutes())}.txt`;
|
|
}
|
|
|
|
/**
|
|
* The chain stays in playing order here. It is a sequence of links, and read
|
|
* on its own a transcript only makes sense from the opening word forward —
|
|
* the newest-first ordering is a reading aid for the live board, not the
|
|
* shape of the game.
|
|
*
|
|
* `nameOf` resolves a seat id to the name that seat was playing under. It is
|
|
* passed in rather than read from the store so the transcript can be built and
|
|
* tested without one.
|
|
* @param {object} args
|
|
* @param {import('$lib/stores/game.svelte.js').ChainEntry[]} args.chain
|
|
* @param {{ iWon: boolean, myScore: number, chainLength: number } | null} [args.result]
|
|
* @param {(playerId: string) => string} [args.nameOf]
|
|
* @param {Date} [args.at]
|
|
* @returns {string}
|
|
*/
|
|
export function chainToText({ chain, result = null, nameOf = () => '', at = new Date() }) {
|
|
const lines = [`${t.appName} — ${stamp(at)}`];
|
|
|
|
if (result) {
|
|
lines.push(result.iWon ? t.won : t.lost);
|
|
lines.push(
|
|
`${t.finalScore}: ${result.myScore} · ${t.chainLength}: ${result.chainLength}`
|
|
);
|
|
}
|
|
|
|
lines.push('');
|
|
|
|
chain.forEach((entry, index) => {
|
|
const number = `${index + 1}. ${entry.word}`;
|
|
if (entry.opening) {
|
|
lines.push(`${number} (${t.exportOpening})`);
|
|
return;
|
|
}
|
|
// A four-way chain has to say which of the others played a word, not
|
|
// merely that it was not this player's.
|
|
const who = entry.byMe ? t.you : nameOf(entry.playerId) || t.opponent;
|
|
const points = entry.points > 0 ? ` +${entry.points}` : '';
|
|
lines.push(`${number} — ${who}${points}`);
|
|
});
|
|
|
|
return `${lines.join('\n')}\n`;
|
|
}
|
|
|
|
/**
|
|
* Hands the text to the browser as a download.
|
|
* @param {string} filename
|
|
* @param {string} text
|
|
*/
|
|
export function downloadText(filename, text) {
|
|
const url = URL.createObjectURL(new Blob([text], { type: 'text/plain;charset=utf-8' }));
|
|
const link = document.createElement('a');
|
|
link.href = url;
|
|
link.download = filename;
|
|
link.click();
|
|
// Revoked on the next tick: some browsers read the blob after the click
|
|
// returns, and freeing it synchronously cancels the download.
|
|
setTimeout(() => URL.revokeObjectURL(url), 0);
|
|
}
|