Add the interface, then rebuild the economy around the first playtest
The MVP is playable: a turn screen, a career retrospective, an optional feedback widget, local-storage autosave with file export/import, and a build that flattens everything into one self-contained HTML file. A turn has two phases — the scenario and its options, then what the choice did and, separately, what the day cost regardless. Numbers that move without the player seeing why are most of what makes them meaningless. Locked options are shown greyed with the requirement spelled out rather than hidden, so a player can see the door they cannot open yet. The interface is named entirely by the pack. `pack.display` maps a state path to a label, a format and an order, which is why the header reads "Standing" for a path called `reputation` and why debt disappears while it is zero. The first playtest then found three things, all of them fair. *"Wasn't clear what daily drain was for."* The ledger was labelling changes by the path that moved — "Money −$18" — when the upkeep entry that caused them had a perfectly good name. It now says "Coffee, transit, lunch". The labels were in the data the whole time and never reached the screen. *"Should probably pay rent weekly / get paid every other week… would be good to have day of week and week # shown."* Packs can now declare a calendar, and the engine derives the day name, cycle and index from the turn number before the event is drawn — so content can require a Friday and the header can say "Thursday · Week 2 · Day 12". Upkeep entries take `every` and `offset`, making wages fall on alternate Fridays and rent every Monday. The turn screen carries a diary line — "Wages tomorrow · Rent in 4 days" — computed generically from whatever a pack schedules. *"Always in debt — could never get ahead."* The old economy bled $25 a day regardless of play. It is now roughly break-even at baseline, with a `spare_shift` event that appears *because* you are broke: the way out of a hole should be visible from inside it. Across archetypes a careful player ends around $1,400, an unplanned one treads water, and a careless one sinks into real debt. That retune broke the coverage test, usefully. Random play stopped reaching hard times at all, which made the entire debt branch look dead — it was not, since random play is not a plausible player. Coverage is now the union across five archetypes, including one that is broke *and* well-liked, because the "ask a friend for money" options sit in a state no single-axis strategy reaches. Not covered by any of this: styling and dark mode, which only a human with a browser can check. This machine has none that can render a page. 109 tests. Reasoning in docs/DECISIONS.md §14-21. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VMSFHyVPitUoosW5wyEADj
This commit is contained in:
JesseMarkowitz
co-authored by
Claude Opus 5
Claude Opus 5
parent
1d4ac0fdbd
commit
e482f07157
+147
@@ -0,0 +1,147 @@
|
||||
// Build a single self-contained HTML file.
|
||||
//
|
||||
// Chrome and Firefox refuse ES module imports over file://, so the modular
|
||||
// source that is pleasant to develop cannot be the thing you hand someone.
|
||||
// This inlines the stylesheet and flattens the module graph into one script,
|
||||
// producing a file that plays by double-clicking it.
|
||||
//
|
||||
// It is a deliberately small bundler that understands only the module syntax
|
||||
// this project actually uses, and throws on anything it does not recognise —
|
||||
// a silent mis-bundle would be far worse than a failed build.
|
||||
|
||||
import { readFile, writeFile, mkdir } from 'node:fs/promises';
|
||||
import { dirname, resolve, relative } from 'node:path';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
|
||||
const root = resolve(dirname(fileURLToPath(import.meta.url)), '..');
|
||||
const entryHtml = resolve(root, 'index.html');
|
||||
const outDir = resolve(root, 'dist');
|
||||
const outFile = resolve(outDir, 'theladder.html');
|
||||
|
||||
const id = (path) => relative(root, path).replaceAll('\\', '/');
|
||||
|
||||
/** Rewrite one module's source into a registry factory. */
|
||||
function transform(source, path) {
|
||||
const exports = [];
|
||||
let body = source;
|
||||
|
||||
// import { a, b as c } from './x.js'
|
||||
body = body.replace(
|
||||
/^[ \t]*import\s*\{([^}]*)\}\s*from\s*['"]([^'"]+)['"];?[ \t]*$/gm,
|
||||
(_m, names, from) => `const {${names.replaceAll(' as ', ': ')}} = __require(${JSON.stringify(id(resolve(dirname(path), from)))});`,
|
||||
);
|
||||
// import * as ns from './x.js'
|
||||
body = body.replace(
|
||||
/^[ \t]*import\s*\*\s*as\s+(\w+)\s+from\s*['"]([^'"]+)['"];?[ \t]*$/gm,
|
||||
(_m, name, from) => `const ${name} = __require(${JSON.stringify(id(resolve(dirname(path), from)))});`,
|
||||
);
|
||||
// import name from './x.js'
|
||||
body = body.replace(
|
||||
/^[ \t]*import\s+(\w+)\s+from\s*['"]([^'"]+)['"];?[ \t]*$/gm,
|
||||
(_m, name, from) => `const ${name} = __require(${JSON.stringify(id(resolve(dirname(path), from)))}).default;`,
|
||||
);
|
||||
|
||||
// export { a, b } (no `from` — re-exports are not used in this project)
|
||||
body = body.replace(/^[ \t]*export\s*\{([^}]*)\};?[ \t]*$/gm, (_m, names) => {
|
||||
for (const entry of names.split(',').map((n) => n.trim()).filter(Boolean)) {
|
||||
const [local, exported = local] = entry.split(/\s+as\s+/).map((n) => n.trim());
|
||||
exports.push([exported, local]);
|
||||
}
|
||||
return '';
|
||||
});
|
||||
|
||||
// export function / const / let / class
|
||||
body = body.replace(/^[ \t]*export\s+(async\s+)?(function|const|let|class)\s+(\w+)/gm, (_m, async_, kind, name) => {
|
||||
exports.push([name, name]);
|
||||
return `${async_ ?? ''}${kind} ${name}`;
|
||||
});
|
||||
|
||||
// export default <expression>
|
||||
body = body.replace(/^[ \t]*export\s+default\s+/gm, () => {
|
||||
exports.push(['default', '__default']);
|
||||
return 'const __default = ';
|
||||
});
|
||||
|
||||
const leftover = body.match(/^\s*(import|export)\s/m);
|
||||
if (leftover) {
|
||||
throw new Error(`${id(path)}: unsupported module syntax near "${leftover[0].trim()}"`);
|
||||
}
|
||||
|
||||
const assignments = exports.map(([exported, local]) =>
|
||||
` __exports[${JSON.stringify(exported)}] = ${local};`).join('\n');
|
||||
|
||||
return `__define(${JSON.stringify(id(path))}, (__exports, __require) => {\n${body}\n${assignments}\n});`;
|
||||
}
|
||||
|
||||
async function collect(entryPath, seen = new Map()) {
|
||||
if (seen.has(entryPath)) return seen;
|
||||
const source = await readFile(entryPath, 'utf8');
|
||||
seen.set(entryPath, null); // reserve the slot before recursing
|
||||
|
||||
const specifiers = [...source.matchAll(/^[ \t]*import\s.*?from\s*['"]([^'"]+)['"];?[ \t]*$/gm)]
|
||||
.map((match) => match[1])
|
||||
.filter((specifier) => specifier.startsWith('.'));
|
||||
|
||||
for (const specifier of specifiers) {
|
||||
await collect(resolve(dirname(entryPath), specifier), seen);
|
||||
}
|
||||
seen.set(entryPath, transform(source, entryPath));
|
||||
return seen;
|
||||
}
|
||||
|
||||
async function build() {
|
||||
const html = await readFile(entryHtml, 'utf8');
|
||||
|
||||
const styleMatch = html.match(/<link\s+rel="stylesheet"\s+href="([^"]+)"\s*\/?>/);
|
||||
if (!styleMatch) throw new Error('index.html has no stylesheet link to inline');
|
||||
const css = await readFile(resolve(root, styleMatch[1]), 'utf8');
|
||||
|
||||
const scriptMatch = html.match(/<script type="module">([\s\S]*?)<\/script>/);
|
||||
if (!scriptMatch) throw new Error('index.html has no module script');
|
||||
const bootstrapSource = scriptMatch[1];
|
||||
|
||||
const entrySpecifier = bootstrapSource.match(/from\s*['"]([^'"]+)['"]/)?.[1];
|
||||
if (!entrySpecifier) throw new Error('could not find the entry module in index.html');
|
||||
const entryPath = resolve(root, entrySpecifier);
|
||||
|
||||
const modules = await collect(entryPath);
|
||||
const bootstrap = transform(bootstrapSource, entryHtml).replace(
|
||||
/__define\("index\.html"/, '__define("__bootstrap__"',
|
||||
);
|
||||
|
||||
const script = [
|
||||
'(() => {',
|
||||
' "use strict";',
|
||||
' const __factories = new Map();',
|
||||
' const __cache = new Map();',
|
||||
' const __define = (id, factory) => __factories.set(id, factory);',
|
||||
' const __require = (id) => {',
|
||||
' if (__cache.has(id)) return __cache.get(id);',
|
||||
' const factory = __factories.get(id);',
|
||||
' if (!factory) throw new Error(`module not bundled: ${id}`);',
|
||||
' const exports = {};',
|
||||
' __cache.set(id, exports);',
|
||||
' factory(exports, __require);',
|
||||
' return exports;',
|
||||
' };',
|
||||
...[...modules.values()].map((code) => code.replace(/^/gm, ' ')),
|
||||
bootstrap.replace(/^/gm, ' '),
|
||||
' __require("__bootstrap__");',
|
||||
'})();',
|
||||
].join('\n');
|
||||
|
||||
const output = html
|
||||
.replace(styleMatch[0], `<style>\n${css}\n </style>`)
|
||||
.replace(scriptMatch[0], `<script>\n${script}\n </script>`);
|
||||
|
||||
await mkdir(outDir, { recursive: true });
|
||||
await writeFile(outFile, output, 'utf8');
|
||||
|
||||
const kb = (Buffer.byteLength(output) / 1024).toFixed(1);
|
||||
console.log(`built ${id(outFile)} — ${modules.size} modules, ${kb} kB`);
|
||||
}
|
||||
|
||||
build().catch((error) => {
|
||||
console.error(`build failed: ${error.message}`);
|
||||
process.exitCode = 1;
|
||||
});
|
||||
Reference in New Issue
Block a user