mirror of
https://github.com/diegosouzapw/OmniRoute.git
synced 2026-09-14 02:42:24 +03:00
The desktop runtime reads exactly one slice of docs/i18n: the translated docs/** tree, through the in-app docs route (src/lib/docsI18nPath.ts pins the path). Each locale's root-level mirrors — README.md, llm.txt, CLAUDE.md, GEMINI.md, CONTRIBUTING.md, SECURITY.md, CODE_OF_CONDUCT.md — exist for GitHub readers and are never opened by the packaged app, so they leave the bundle together with the translated CHANGELOG that was already pruned. Measured on release/v3.8.51 with 51 locales: docs/i18n is 139 MB, of which 25.7 MB is the served docs/** tree (kept), 103.5 MB the CHANGELOG mirrors (already pruned) and 11.4 MB these root files (pruned now). The plan's D4 called for dropping docs/i18n entirely; that would have broken localized docs inside the app, which is why the served subtree stays.
82 lines
2.9 KiB
JavaScript
82 lines
2.9 KiB
JavaScript
import { existsSync, lstatSync, readdirSync, rmSync } from "node:fs";
|
|
import { join, relative, resolve, sep } from "node:path";
|
|
|
|
// The packaged app reads exactly one slice of the translated mirrors:
|
|
// `docs/i18n/<locale>/docs/**`, through the in-app docs route (the path is
|
|
// pinned by src/lib/docsI18nPath.ts). Everything at a locale's root — the
|
|
// README, llm.txt and the agent/contributor guides — is authoring material
|
|
// mirrored for GitHub readers and never opened by the runtime, so it leaves
|
|
// the bundle together with the translated CHANGELOG (~115 MB across 51
|
|
// locales, 103 MB of it CHANGELOG). The translated `docs/**` tree stays.
|
|
export const ELECTRON_RUNTIME_DOC_PRUNE_RULES = Object.freeze({
|
|
localeRootFiles: Object.freeze([
|
|
"CHANGELOG.md",
|
|
"CLAUDE.md",
|
|
"CODE_OF_CONDUCT.md",
|
|
"CONTRIBUTING.md",
|
|
"GEMINI.md",
|
|
"README.md",
|
|
"SECURITY.md",
|
|
"llm.txt",
|
|
]),
|
|
authoringDirectories: Object.freeze(["docs/research", "docs/superpowers"]),
|
|
});
|
|
|
|
function payloadSize(targetPath) {
|
|
const stat = lstatSync(targetPath);
|
|
if (!stat.isDirectory()) {
|
|
return { files: 1, bytes: stat.size };
|
|
}
|
|
|
|
return readdirSync(targetPath).reduce(
|
|
(total, entry) => {
|
|
const payload = payloadSize(join(targetPath, entry));
|
|
total.files += payload.files;
|
|
total.bytes += payload.bytes;
|
|
return total;
|
|
},
|
|
{ files: 0, bytes: 0 }
|
|
);
|
|
}
|
|
|
|
function removePayload(bundleRoot, relativePath, summary) {
|
|
const root = resolve(bundleRoot);
|
|
const targetPath = resolve(root, relativePath);
|
|
if (targetPath !== root && !targetPath.startsWith(`${root}${sep}`)) {
|
|
throw new Error(`[electron-docs] refusing to prune outside bundle root: ${relativePath}`);
|
|
}
|
|
if (!existsSync(targetPath)) return;
|
|
|
|
const payload = payloadSize(targetPath);
|
|
rmSync(targetPath, { recursive: true, force: true });
|
|
summary.removedFiles += payload.files;
|
|
summary.removedBytes += payload.bytes;
|
|
summary.removedPaths.push(relative(root, targetPath).split(sep).join("/"));
|
|
}
|
|
|
|
/**
|
|
* Remove docs that are useful while authoring OmniRoute but are never read by
|
|
* the packaged desktop runtime. Canonical docs remain untouched; bundleRoot is
|
|
* the disposable Electron staging directory.
|
|
*/
|
|
export function pruneElectronRuntimeDocs(bundleRoot) {
|
|
const summary = { removedFiles: 0, removedBytes: 0, removedPaths: [] };
|
|
const localesRoot = join(bundleRoot, "docs", "i18n");
|
|
|
|
if (existsSync(localesRoot)) {
|
|
for (const locale of readdirSync(localesRoot, { withFileTypes: true })) {
|
|
if (!locale.isDirectory()) continue;
|
|
for (const fileName of ELECTRON_RUNTIME_DOC_PRUNE_RULES.localeRootFiles) {
|
|
removePayload(bundleRoot, join("docs", "i18n", locale.name, fileName), summary);
|
|
}
|
|
}
|
|
}
|
|
|
|
for (const relativePath of ELECTRON_RUNTIME_DOC_PRUNE_RULES.authoringDirectories) {
|
|
removePayload(bundleRoot, relativePath, summary);
|
|
}
|
|
|
|
summary.removedPaths.sort();
|
|
return summary;
|
|
}
|