2c397d25ef
Comments in library/ and internal/ that quoted a person, attributed a decision to one, used first person, named fleet agents or carried private host names now state the same technical fact in neutral words: poster-render (including the comments it writes into generated posters), packet-render, the poster and research scripts, PosterWall, DataTable, the legends, the layouts and the gates. The network-policy note states the policy itself. Behaviour is unchanged: a few printed gate messages and reason labels drop an agent name, the poster-render integrity pin follows its comment-only edit, and series.json changes only in its _meta and _why notes. The historical poster design snapshots (library/scripts/posters/snapshots/), which nothing reads, are removed.
108 lines
5.4 KiB
JavaScript
108 lines
5.4 KiB
JavaScript
// export-public.mjs — mirror the rendered posters into doxa-maps' public tree,
|
||
// filed into REGION FOLDERS so they can be browsed in a file manager.
|
||
//
|
||
// It exports every image into a upg-100-posters folder, with a sub-folder per
|
||
// division (India, etc.), so the images can be browsed in a folder rather than
|
||
// downloaded one at a time.
|
||
//
|
||
// node export-public.mjs
|
||
// -> <doxa-maps>/public/upg-100-posters/<Region>/<Title>.png (3000x3000)
|
||
// <doxa-maps>/public/upg-100-posters/index.html (browsable index)
|
||
//
|
||
// WHERE THIS GOES — AND WHY NOT public/ ────────────────────────────────────
|
||
// capacitor.config.json sets `webDir: "public"`, and Capacitor packages that
|
||
// directory WHOLESALE — there is no per-path exclude. So anything in public/
|
||
// ships inside the Android APK.
|
||
//
|
||
// The posters must NOT ship inside the Android application: that much static
|
||
// content does not belong in an app bundle when it can be served from a CDN
|
||
// later, or generated inside the app.
|
||
//
|
||
// Measured: the export is 52 MB of an 88 MB public/ — 59% of the APK would have
|
||
// been print-resolution posters. It also re-duplicated 11x per build (631 MB)
|
||
// because the per-bundle vite build sweeps the served root into every MFE.
|
||
//
|
||
// So the export lives OUTSIDE the repo's build output: nothing packages it,
|
||
// nothing copies it, nothing wipes it. Desktop/web can serve it from here or
|
||
// from a CDN; the phone gets posters from a CDN or generates them on device.
|
||
// Override with DOXA_PUBLIC=/some/path.
|
||
//
|
||
// Filenames use the poster TITLE, not the zone key: a person browsing folders
|
||
// wants "North India + Nepal.png", not "asia-india-uttarakhand.png".
|
||
|
||
import { readFileSync, writeFileSync, mkdirSync, copyFileSync, existsSync, rmSync, readdirSync, statSync } from 'node:fs';
|
||
import { fileURLToPath } from 'node:url';
|
||
import { dirname, join, resolve } from 'node:path';
|
||
import { sectionsOf } from './poster-regions.mjs';
|
||
|
||
const __dirname = dirname(fileURLToPath(import.meta.url));
|
||
const OUT = join(__dirname, 'out');
|
||
const DEST = process.env.DOXA_PUBLIC
|
||
? resolve(process.env.DOXA_PUBLIC)
|
||
// Sibling of the repo, NOT inside public/ — capacitor packages public/ whole,
|
||
// and these are 52 MB of print-resolution posters that must not ship in the APK.
|
||
: resolve(__dirname, '..', '..', '..', '..', 'upg-100-posters');
|
||
|
||
const manifest = JSON.parse(readFileSync(join(OUT, 'manifest.json'), 'utf8'));
|
||
const esc = (s) => String(s).replace(/&/g, '&').replace(/</g, '<').replace(/>/g, '>');
|
||
// Keep the title readable but filesystem-safe on every platform.
|
||
const safe = (s) => String(s).replace(/[\/\\:*?"<>|]/g, '-').replace(/\s+/g, ' ').trim();
|
||
|
||
// Rebuild from scratch so a renamed zone cannot leave a stale duplicate behind.
|
||
if (existsSync(DEST)) rmSync(DEST, { recursive: true, force: true });
|
||
mkdirSync(DEST, { recursive: true });
|
||
|
||
const sections = sectionsOf(manifest.posters);
|
||
let copied = 0, missing = [];
|
||
|
||
for (const { name, list } of sections) {
|
||
const dir = join(DEST, safe(name));
|
||
mkdirSync(dir, { recursive: true });
|
||
for (const p of list) {
|
||
const src = join(OUT, p.png);
|
||
if (!existsSync(src)) { missing.push(p.zoneKey); continue; }
|
||
copyFileSync(src, join(dir, `${safe(p.title)}.png`));
|
||
copied++;
|
||
}
|
||
}
|
||
|
||
// A plain index so the folder is browsable in a browser as well as a file manager.
|
||
const kb = (f) => Math.round(statSync(f).size / 1024);
|
||
const body = sections.map(({ name, list, total }) => `
|
||
<section>
|
||
<h2>${esc(name)} <span class="m">${list.length} maps · ${total} people groups</span></h2>
|
||
<ul>
|
||
${list.map((p) => {
|
||
const rel = `${encodeURIComponent(safe(name))}/${encodeURIComponent(safe(p.title))}.png`;
|
||
const f = join(DEST, safe(name), `${safe(p.title)}.png`);
|
||
// href-escaped-ok: rel is built two lines up entirely from encodeURIComponent(), which
|
||
// percent-encodes a quote, so it cannot break out of the attribute. (check:popup-href-escaped)
|
||
return `<li><a href="${rel}">${esc(p.title)}</a>
|
||
<span class="m">${p.count} UPG · ${existsSync(f) ? kb(f) : 0} KB</span></li>`;
|
||
}).join('')}
|
||
</ul>
|
||
</section>`).join('');
|
||
|
||
writeFileSync(join(DEST, 'index.html'), `<!doctype html><html lang="en"><head>
|
||
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
||
<title>UPG-100 posters — files</title>
|
||
<style>
|
||
body{margin:0;padding:28px 24px 60px;background:#f7f4ec;color:#1c1c17;
|
||
font:15px/1.6 Lato,'Segoe UI',system-ui,sans-serif;max-width:900px}
|
||
h1{font:700 22px/1.2 Georgia,serif;margin:0 0 4px}
|
||
.sub{color:#8a8470;font-size:13px;margin-bottom:22px}
|
||
h2{font:700 17px/1.2 Georgia,serif;margin:26px 0 8px;padding-bottom:6px;border-bottom:1px solid #e2dccc}
|
||
.m{font-weight:400;font-size:12.5px;color:#8a8470;margin-left:8px}
|
||
ul{list-style:none;padding:0;margin:0}
|
||
li{padding:5px 0;border-bottom:1px solid #efeade;display:flex;justify-content:space-between;gap:16px}
|
||
a{color:#6B4A78;font-weight:600;text-decoration:none}
|
||
a:hover{text-decoration:underline}
|
||
</style></head><body>
|
||
<h1>UPG-100 posters</h1>
|
||
<div class="sub">${copied} posters · 3000×3000 PNG · one folder per region</div>
|
||
${body}
|
||
</body></html>`);
|
||
|
||
console.log(`[export-public] ${copied} posters -> ${DEST}`);
|
||
console.log(`[export-public] folders: ${sections.map((s) => safe(s.name)).join(', ')}`);
|
||
if (missing.length) console.warn(`[export-public] MISSING png for: ${missing.join(', ')}`);
|