65 lines
2.5 KiB
JavaScript
65 lines
2.5 KiB
JavaScript
/**
|
|
* Platform-inventory helpers shared by validate-repo.mjs and its tests.
|
|
*
|
|
* Nothing here hardcodes a platform or a translation. The platforms carrying an
|
|
* install-table row are discovered from the docs/<name>-setup.md files on disk,
|
|
* the documents that must show that table are discovered from README*.md, and
|
|
* the installer's own list is parsed out of scripts/install.sh — so a new
|
|
* platform, or a seventh language, is covered on arrival. Keeping a separate
|
|
* hand-maintained list is what let the localized README badges go stale before
|
|
* (see version-refs.mjs).
|
|
*/
|
|
|
|
import { readdirSync } from "node:fs";
|
|
import path from "node:path";
|
|
|
|
/**
|
|
* Every document that carries the per-platform install table: all README
|
|
* translations, plus the getting-started guide, which is the one non-README
|
|
* page with a platform table of its own.
|
|
*/
|
|
export function platformDocs(root) {
|
|
const readmes = readdirSync(root)
|
|
.filter((file) => file.startsWith("README") && file.endsWith(".md"))
|
|
.sort();
|
|
return [...readmes, path.join("docs", "getting-started.md")];
|
|
}
|
|
|
|
/** Every per-platform setup guide, as bare filenames. */
|
|
export function setupGuides(root) {
|
|
return readdirSync(path.join(root, "docs"))
|
|
.filter((file) => file.endsWith("-setup.md"))
|
|
.sort();
|
|
}
|
|
|
|
/**
|
|
* Setup-guide filenames linked from one document, normalized so a README's
|
|
* `docs/kiro-setup.md` and getting-started's sibling `kiro-setup.md` compare
|
|
* equal. Returns a sorted, de-duplicated array.
|
|
*/
|
|
export function linkedSetupGuides(text) {
|
|
const links = text.matchAll(/\((?:docs\/)?([a-z0-9-]+-setup\.md)\)/g);
|
|
return [...new Set([...links].map((match) => match[1]))].sort();
|
|
}
|
|
|
|
/**
|
|
* The installer's platform list plus the platforms each directory-mapping
|
|
* function actually handles. A platform in PLATFORMS with no case arm fails
|
|
* `install.sh <platform>` with "unknown platform"; a case arm missing from
|
|
* PLATFORMS is invisible in --list and the help text.
|
|
*/
|
|
export function parseInstallerPlatforms(text) {
|
|
const declared = text.match(/^PLATFORMS="([^"]*)"/m)?.[1].trim();
|
|
return {
|
|
declared: declared ? declared.split(/\s+/) : [],
|
|
global: caseArms(text, "global_dir"),
|
|
project: caseArms(text, "project_dir"),
|
|
};
|
|
}
|
|
|
|
/** Platform names matched by the `case` arms of one shell function. */
|
|
function caseArms(text, fnName) {
|
|
const body = text.match(new RegExp(`^${fnName}\\(\\) \\{$([\\s\\S]*?)^\\}$`, "m"))?.[1] ?? "";
|
|
return [...body.matchAll(/^\s+([a-z][a-z0-9-]*)\)/gm)].map((match) => match[1]);
|
|
}
|