try {

var map = new LinkedHashMap<String, String>();

for (var line : Files.readAllLines(Path.of(CATEGORIES_FILE))) {

line = line.strip();

if (line.isEmpty() || line.startsWith("#")) continue;

var idx = line.indexOf('=');

if (idx > 0) map.put(line.substring(0, idx).strip(), line.substring(idx + 1).strip());

}

return map;

} catch (IOException e) {

throw new UncheckedIOException(e);

}

try {

var map = new LinkedHashMap<String, String>();

for (var line : Files.readAllLines(Path.of(LOCALES_FILE))) {

line = line.strip();

if (line.isEmpty() || line.startsWith("#")) continue;

var idx = line.indexOf('=');

if (idx > 0) map.put(line.substring(0, idx).strip(), line.substring(idx + 1).strip());

}

return map;

} catch (IOException e) {

throw new UncheckedIOException(e);

}

try {

var map = new LinkedHashMap<String, String>();

for (var line : Files.readAllLines(Path.of(TAGS_FILE))) {

line = line.strip();

if (line.isEmpty() || line.startsWith("#")) continue;

var idx = line.indexOf('=');

if (idx > 0) map.put(line.substring(0, idx).strip(), line.substring(idx + 1).strip());

}

return map;

} catch (IOException e) {

throw new UncheckedIOException(e);

}

var map = new LinkedHashMap<String, String>();

var it = node.fields();

while (it.hasNext()) {

var entry = it.next();

var key = prefix.isEmpty() ? entry.getKey() : prefix + "." + entry.getKey();

if (entry.getValue().isObject()) {

map.putAll(flattenJson(entry.getValue(), key));

} else {

map.put(key, entry.getValue().asText());

}

}

return map;

for (var ext : List.of("json", "yaml", "yml")) {

var p = dir.resolve(baseName + "." + ext);

if (Files.exists(p)) return Optional.of(p);

}

return Optional.empty();

var name = path.getFileName().toString();

var ext = name.substring(name.lastIndexOf('.') + 1);

var content = Files.readString(path);

return MAPPERS.getOrDefault(ext, JSON_MAPPER).readTree(content);

var enFile = findWithExtensions(Path.of(TRANSLATIONS_DIR, "strings"), "en")

.orElseThrow(() -> new IOException("No English strings file found"));

var enStrings = flattenJson(readAuto(enFile), "");

if (locale.equals("en")) return enStrings;

var localeFile = findWithExtensions(Path.of(TRANSLATIONS_DIR, "strings"), locale);

if (localeFile.isEmpty()) {

IO.println("[WARN] strings/%s.{json,yaml,yml} not found — using all English strings".formatted(locale));

return enStrings;

}

var localeStrings = flattenJson(readAuto(localeFile.get()), "");

var merged = new LinkedHashMap<>(enStrings);

for (var entry : localeStrings.entrySet()) {

if (enStrings.containsKey(entry.getKey())) {

merged.put(entry.getKey(), entry.getValue());

}

}

// Warn about missing keys

for (var key : enStrings.keySet()) {

if (!localeStrings.containsKey(key)) {

IO.println("[WARN] %s: missing key \"%s\" — using English fallback".formatted(localeFile.get().getFileName(), key));

}

}

return merged;

var order = node.get("navigationOrder");

if (order == null || !order.isIntegralNumber()

|| !order.canConvertToInt() || order.intValue() < 0) {

throw new IllegalArgumentException(

"Missing or invalid non-negative navigationOrder in " + key());

}

return order.intValue();

var rel = node.get("related");

if (rel == null) return List.of();

var paths = new ArrayList<String>();

rel.forEach(n -> paths.add(n.asText()));

return paths;

var t = node.get("tags");

if (t == null || !t.isArray() || t.isEmpty()) {

throw new IllegalArgumentException("Missing or empty tags array in " + key());

}

var tagList = new ArrayList<String>();

t.forEach(n -> {

var tag = n.asText().strip();

if (!tag.matches("[a-z0-9]+(?:-[a-z0-9]+)*")) {

throw new IllegalArgumentException("Invalid tag slug \"" + tag + "\" in " + key());

}

if (!TAG_DISPLAY.containsKey(tag)) {

throw new IllegalArgumentException("Unknown tag \"" + tag + "\" in " + key() + " (missing from " + TAGS_FILE + ")");

}

tagList.add(tag);

});

return tagList;

return new Templates(

Files.readString(Path.of("templates/slug-template.html")),

Files.readString(Path.of("templates/why-card.html")),

Files.readString(Path.of("templates/related-card.html")),

Files.readString(Path.of("templates/social-share.html")),

Files.readString(Path.of("templates/index.html")),

Files.readString(Path.of("templates/index-card.html")),

Files.readString(Path.of("templates/doc-link.html")),

Files.readString(Path.of("templates/topic-page.html")),

Files.readString(Path.of("templates/agent-plugin.html")));

var templates = Templates.load();

var allSnippets = loadAllSnippets();

IO.println("Loaded %d snippets".formatted(allSnippets.size()));

// Determine which locales to build

List<String> localesToBuild;

if (args.length > 0 && args[0].equals("--all-locales")) {

localesToBuild = new ArrayList<>(LOCALES.sequencedKeySet());

} else if (args.length > 1 && args[0].equals("--locale")) {

localesToBuild = List.of(args[1]);

} else {

localesToBuild = new ArrayList<>(LOCALES.sequencedKeySet());

}

for (var locale : localesToBuild) {

buildLocale(locale, templates, allSnippets);

}

var isEnglish = locale.equals("en");

var strings = loadStrings(locale);

var localeName = LOCALES.getOrDefault(locale, locale);

var sitePrefix = isEnglish ? "" : locale + "/";

// basePrefix is the relative path from a detail page back to site root

var basePrefix = isEnglish ? "../" : "../../";

var homeUrl = isEnglish ? "/" : "/%s/".formatted(locale);

IO.println("Building locale: %s (%s)".formatted(locale, localeName));

// Build locale picker HTML

var localePickerHtml = renderLocalePicker(locale);

// Build hreflang links for index

var indexHreflang = renderHreflangLinks("", "index");

// Build i18n script block

var i18nScript = renderI18nScript(strings, locale);

// Load translated content if available

for (var snippet : allSnippets.values()) {

var resolved = resolveSnippet(snippet, locale);

var detailHreflang = renderHreflangLinks(snippet.category() + "/", snippet.slug());

var extraTokens = new LinkedHashMap<String, String>();

extraTokens.putAll(strings);

extraTokens.put("locale", locale);

extraTokens.put("htmlDir", locale.equals("ar") ? "rtl" : "ltr");

extraTokens.put("ogLocale", locale.replace("-", "_"));

extraTokens.put("basePrefix", basePrefix);

extraTokens.put("homeUrl", homeUrl);

extraTokens.put("localePicker", localePickerHtml);

extraTokens.put("hreflangLinks", detailHreflang);

extraTokens.put("i18nScript", i18nScript);

var html = generateHtml(templates, resolved, allSnippets, extraTokens, locale).strip();

if (isEnglish) {

Files.createDirectories(Path.of(SITE_DIR, snippet.category()));

Files.writeString(Path.of(SITE_DIR, snippet.category(), snippet.slug() + ".html"), html);

} else {

Files.createDirectories(Path.of(SITE_DIR, locale, snippet.category()));

Files.writeString(Path.of(SITE_DIR, locale, snippet.category(), snippet.slug() + ".html"), html);

}

}

IO.println("Generated %d HTML files for %s".formatted(allSnippets.size(), locale));

// Rebuild data/snippets.json

var snippetsList = allSnippets.values().stream()

.map(s -> {

var resolved = resolveSnippet(s, locale);

Map<String, Object> map = JSON_MAPPER.convertValue(resolved.node(), new TypeReference<LinkedHashMap<String, Object>>() {});

EXCLUDED_KEYS.forEach(map::remove);

return map;

})

.toList();

var dataDir = isEnglish ? Path.of(SITE_DIR, "data") : Path.of(SITE_DIR, locale, "data");

Files.createDirectories(dataDir);

var prettyMapper = new ObjectMapper().enable(SerializationFeature.INDENT_OUTPUT);

Files.writeString(dataDir.resolve("snippets.json"), prettyMapper.writeValueAsString(snippetsList) + "\n");

IO.println("Rebuilt data/snippets.json for %s with %d entries".formatted(locale, snippetsList.size()));

// Generate index.html from template

var tipCards = allSnippets.values().stream()

.map(s -> renderIndexCard(templates.indexCard(), resolveSnippet(s, locale), locale, strings, true))

.collect(Collectors.joining("\n"));

var indexTokens = new LinkedHashMap<String, String>();

indexTokens.putAll(strings);

indexTokens.put("tipCards", tipCards);

indexTokens.put("snippetCount", String.valueOf(allSnippets.size()));

indexTokens.put("locale", locale);

indexTokens.put("htmlDir", locale.equals("ar") ? "rtl" : "ltr");

indexTokens.put("ogLocale", locale.replace("-", "_"));

indexTokens.put("canonicalUrl", isEnglish ? BASE_URL : BASE_URL + "/" + locale);

indexTokens.put("homeUrl", homeUrl);

indexTokens.put("indexBasePrefix", isEnglish ? "" : "../");

indexTokens.put("localePicker", localePickerHtml);

indexTokens.put("hreflangLinks", indexHreflang);

indexTokens.put("i18nScript", i18nScript);

var indexHtml = replaceTokens(templates.index(), indexTokens);

var indexPath = isEnglish ? Path.of(SITE_DIR, "index.html") : Path.of(SITE_DIR, locale, "index.html");

if (!isEnglish) Files.createDirectories(indexPath.getParent());

Files.writeString(indexPath, indexHtml);

IO.println("Generated index.html for %s with %d cards".formatted(locale, allSnippets.size()));

// Generate topic pages — only for English (canonical); other locales link back to English topics

if (isEnglish) {

Files.writeString(Path.of(SITE_DIR, "agent-plugin.html"), templates.agentPlugin());

IO.println("Generated agent-plugin.html");

generateTopicPages(templates, allSnippets, strings, locale, homeUrl, i18nScript);

}

var loaded = new ArrayList<Snippet>();

var ids = new HashSet<String>();

for (var cat : CATEGORY_DISPLAY.sequencedKeySet()) {

var catDir = Path.of(CONTENT_DIR, cat);

if (!Files.isDirectory(catDir)) continue;

var sorted = new ArrayList<Path>();

// first collect and sortall files

for (var ext : MAPPERS.keySet()) {

try (var stream = Files.newDirectoryStream(catDir, "*." + ext)) {

stream.forEach(sorted::add);

}

}

sorted.sort(Path::compareTo);

for (var path : sorted) {

var filename = path.getFileName().toString();

var ext = filename.substring(filename.lastIndexOf('.') + 1);

var json = MAPPERS.get(ext).readTree(Files.readString(path));

var id = requireUuidId(json, path);

if (!ids.add(id)) {

throw new IllegalArgumentException("Duplicate UUID id \"" + id + "\" in " + path);

}

var snippet = new Snippet(json);

snippet.navigationOrder();

loaded.add(snippet);

}

}

loaded.sort(Comparator.comparingInt(Snippet::navigationOrder).thenComparing(Snippet::key));

SequencedMap<String, Snippet> snippets = new LinkedHashMap<>();

loaded.forEach(snippet -> snippets.put(snippet.key(), snippet));

return snippets;

var idNode = node.get("id");

if (idNode == null || !idNode.isTextual()) {

throw new IllegalArgumentException("Missing or non-string UUID id in " + path);

}

var id = idNode.asText().strip();

try {

var parsed = UUID.fromString(id);

if (!parsed.toString().equals(id)) {

throw new IllegalArgumentException("UUID id must use canonical lowercase form");

}

return id;

} catch (IllegalArgumentException e) {

throw new IllegalArgumentException("Invalid UUID id \"" + id + "\" in " + path, e);

}

var quoted = JSON_MAPPER.writeValueAsString(text);

var inner = quoted.substring(1, quoted.length() - 1);

var sb = new StringBuilder(inner.length());

for (int i = 0; i < inner.length(); i++) {

char c = inner.charAt(i);

sb.append(c > 127 ? "\\u%04x".formatted((int) c) : String.valueOf(c));

}

return sb.toString();

return switch (state) {

case "preview" -> strings.getOrDefault("support.preview", "Preview");

case "experimental" -> strings.getOrDefault("support.experimental", "Experimental");

default -> strings.getOrDefault("support.available", "Available");

};

return switch (state) {

case "preview" -> "preview";

case "experimental" -> "experimental";

default -> "widely";

};

var prefix = locale.equals("en") ? "" : "/" + locale;

var keys = new ArrayList<>(all.keySet());

var index = keys.indexOf(snippet.key());

if (index < 0) {

throw new IllegalArgumentException("Pattern missing from navigation: " + snippet.key());

}

var prev = index > 0

? "<a href=\"%s/%s.html\" aria-label=\"Previous pattern\">←</a>"

.formatted(prefix, keys.get(index - 1))

: "<span class=\"nav-arrow-disabled\">←</span>";

var next = index + 1 < keys.size()

? "<a href=\"%s/%s.html\" aria-label=\"Next pattern\">→</a>"

.formatted(prefix, keys.get(index + 1))

: "";

return prev + "\n " + next;

boolean initiallyHidden) {

var cardHref = locale.equals("en")

? "/%s/%s.html".formatted(s.category(), s.slug())

: "/%s/%s/%s.html".formatted(locale, s.category(), s.slug());

var tagsValue = escape(String.join(" ", s.tags()));

return replaceTokens(tpl, Map.ofEntries(

Map.entry("category", s.category()), Map.entry("slug", s.slug()),

Map.entry("catDisplay", s.catDisplay()), Map.entry("title", escape(s.title())),

Map.entry("oldCode", escape(s.oldCode())), Map.entry("modernCode", escape(s.modernCode())),

Map.entry("jdkVersion", s.jdkVersion()), Map.entry("cardHref", cardHref),

Map.entry("initialCardState", initiallyHidden ? " filter-hidden" : ""),

Map.entry("tags", tagsValue),

Map.entry("cards.old", strings.getOrDefault("cards.old", "Old")),

Map.entry("cards.modern", strings.getOrDefault("cards.modern", "Modern")),

Map.entry("cards.hoverHint", strings.getOrDefault("cards.hoverHint", "hover to see modern →")),

Map.entry("cards.learnMore", strings.getOrDefault("cards.learnMore", "learn more"))));

var cards = new ArrayList<String>();

for (var w : whyList)

cards.add(replaceTokens(tpl, Map.of(

"icon", w.get("icon").asText(),

"title", escape(w.get("title").asText()),

"desc", escape(w.get("desc").asText()))));

return String.join("\n", cards);

var relatedHref = locale.equals("en")

? "/%s/%s.html".formatted(rel.category(), rel.slug())

: "/%s/%s/%s.html".formatted(locale, rel.category(), rel.slug());

return replaceTokens(tpl, Map.ofEntries(

Map.entry("category", rel.category()), Map.entry("slug", rel.slug()),

Map.entry("catDisplay", rel.catDisplay()), Map.entry("difficulty", rel.difficulty()),

Map.entry("difficultyDisplay", difficultyDisplay(rel.difficulty(), strings)),

Map.entry("title", escape(rel.title())),

Map.entry("oldLabel", escape(rel.oldLabel())), Map.entry("oldCode", escape(rel.oldCode())),

Map.entry("modernLabel", escape(rel.modernLabel())), Map.entry("modernCode", escape(rel.modernCode())),

Map.entry("jdkVersion", rel.jdkVersion()), Map.entry("relatedHref", relatedHref),

Map.entry("cards.hoverHintRelated", strings.getOrDefault("cards.hoverHintRelated", "Hover to see modern ➜"))));

var links = new ArrayList<String>();

for (var d : docs)

links.add(replaceTokens(tpl, Map.of(

"docTitle", escape(d.get("title").asText()),

"docHref", d.get("href").asText())));

return String.join("\n", links);

return Arrays.stream(slug.split("-"))

.filter(w -> !w.isEmpty())

.map(w -> Character.toUpperCase(w.charAt(0)) + w.substring(1))

.collect(Collectors.joining());

var pascal = slugToPascalCase(s.slug());

var proofFile = Path.of("proof", s.category(), pascal + ".java");

if (!Files.exists(proofFile)) return "";

var proofUrl = "https://github.com/javaevolved/javaevolved.github.io/blob/main/proof/%s/%s.java"

.formatted(s.category(), pascal);

var label = strings.getOrDefault("sections.proof", "Proof");

var linkText = strings.getOrDefault("sections.proofLink", "View proof source");

return """

</section>""".formatted(label, proofUrl, linkText);

return snippet.related().stream().filter(all::containsKey)

.map(p -> renderRelatedCard(tpl, all.get(p), locale, strings))

.collect(Collectors.joining("\n"));

var encodedUrl = urlEncode("%s/%s/%s.html".formatted(BASE_URL, category, slug));

var encodedText = urlEncode("%s \u2013 java.evolved".formatted(title));

return replaceTokens(tpl, Map.of("encodedUrl", encodedUrl, "encodedText", encodedText,

"share.label", strings.getOrDefault("share.label", "Share")));

var tags = s.tags();

if (tags.isEmpty()) return "";

var sb = new StringBuilder();

sb.append(" <div class=\"tag-pills\">\n");

for (var tag : tags) {

var display = TAG_DISPLAY.getOrDefault(tag, tag);

// Topic pages are English-only (canonical); use absolute path

sb.append(" <a href=\"/topics/%s.html\" class=\"tag-pill\">%s</a>\n"

.formatted(tag, escape(display)));

}

sb.append(" </div>");

return sb.toString();

Map<String, String> strings, String locale, String homeUrl,

String i18nScript) throws IOException {

// Build map: tag → list of snippets

var tagSnippets = new LinkedHashMap<String, List<Snippet>>();

for (var snippet : allSnippets.values()) {

for (var tag : snippet.tags()) {

tagSnippets.computeIfAbsent(tag, k -> new ArrayList<>()).add(snippet);

}

}

var topicsDir = Path.of(SITE_DIR, "topics");

Files.createDirectories(topicsDir);

for (var entry : tagSnippets.entrySet()) {

var tag = entry.getKey();

var snippetsForTag = entry.getValue();

var tagDisplay = TAG_DISPLAY.getOrDefault(tag, tag);

// Render cards for snippets in this topic

var topicCards = snippetsForTag.stream()

.map(s -> renderIndexCard(templates.indexCard(), s, locale, strings, false))

.collect(Collectors.joining("\n"));

var canonicalUrl = "%s/topics/%s.html".formatted(BASE_URL, tag);

var topicTitle = strings.getOrDefault("topics.title", "{{tagDisplay}} — java.evolved")

.replace("{{tagDisplay}}", tagDisplay);

var topicDescription = strings.getOrDefault("topics.description",

"All Java patterns related to {{tagDisplay}} — java.evolved")

.replace("{{tagDisplay}}", tagDisplay);

var topicHeading = strings.getOrDefault("topics.heading", "Topic: {{tagDisplay}}")

.replace("{{tagDisplay}}", tagDisplay);

var topicSnippetCount = strings.getOrDefault("topics.snippetCount", "{{count}} patterns")

.replace("{{count}}", String.valueOf(snippetsForTag.size()));

var tokens = new LinkedHashMap<String, String>();

tokens.putAll(strings);

tokens.put("locale", locale);

tokens.put("htmlDir", locale.equals("ar") ? "rtl" : "ltr");

tokens.put("ogLocale", locale.replace("-", "_"));

tokens.put("homeUrl", homeUrl);

tokens.put("canonicalUrl", canonicalUrl);

tokens.put("tagDisplay", escape(tagDisplay));

tokens.put("topicTitle", escape(topicTitle));

tokens.put("topicDescription", escape(topicDescription));

tokens.put("topics.heading", topicHeading);

tokens.put("topics.breadcrumb", strings.getOrDefault("topics.breadcrumb", "Topics"));

tokens.put("topics.backToAll", strings.getOrDefault("topics.backToAll", "← All patterns"));

tokens.put("topicSnippetCount", topicSnippetCount);

tokens.put("topicCards", topicCards);

tokens.put("topicBasePrefix", "../");

tokens.put("i18nScript", i18nScript);

var html = replaceTokens(templates.topicPage(), tokens);

Files.writeString(topicsDir.resolve(tag + ".html"), html);

}

IO.println("Generated %d topic pages".formatted(tagSnippets.size()));

var codeUrl = "%s?template=code-issue.yml&title=%s&category=%s&slug=%s".formatted(

GITHUB_ISSUES_URL,

urlEncode("[Code Issue] %s".formatted(s.title())),

urlEncode(s.category()),

urlEncode(s.slug()));

var cleanLocaleName = localeName.replaceFirst("^[^\\p{L}]+", "");

var transUrl = "%s?template=translation-issue.yml&title=%s&locale=%s&pattern=%s&area=%s".formatted(

GITHUB_ISSUES_URL,

urlEncode("[Translation] %s (%s)".formatted(s.title(), cleanLocaleName)),

urlEncode(locale),

urlEncode(s.slug()),

urlEncode("Pattern content"));

var suggestUrl = "%s?template=new-pattern.yml".formatted(GITHUB_ISSUES_URL);

return Map.of(

"contributeCodeIssueUrl", codeUrl,

"contributeTranslationIssueUrl", transUrl,

"contributeSuggestUrl", suggestUrl);

var isEnglish = locale.equals("en");

var canonicalUrl = isEnglish

? "%s/%s/%s.html".formatted(BASE_URL, s.category(), s.slug())

: "%s/%s/%s/%s.html".formatted(BASE_URL, locale, s.category(), s.slug());

var tokens = new LinkedHashMap<>(extraTokens);

tokens.putAll(Map.ofEntries(

Map.entry("title", escape(s.title())), Map.entry("summary", escape(s.summary())),

Map.entry("slug", s.slug()), Map.entry("category", s.category()),

Map.entry("categoryDisplay", s.catDisplay()), Map.entry("difficulty", s.difficulty()),

Map.entry("difficultyDisplay", difficultyDisplay(s.difficulty(), extraTokens)),

Map.entry("jdkVersion", s.jdkVersion()),

Map.entry("oldLabel", escape(s.oldLabel())), Map.entry("modernLabel", escape(s.modernLabel())),

Map.entry("oldCode", escape(s.oldCode())), Map.entry("modernCode", escape(s.modernCode())),

Map.entry("oldApproach", escape(s.oldApproach())), Map.entry("modernApproach", escape(s.modernApproach())),

Map.entry("explanation", escape(s.explanation())),

Map.entry("supportDescription", escape(s.supportDesc())),

Map.entry("supportBadge", supportBadge(s.supportState(), extraTokens)),

Map.entry("supportBadgeClass", supportBadgeClass(s.supportState())),

Map.entry("canonicalUrl", canonicalUrl),

Map.entry("ogImage", "%s/og/%s/%s.png".formatted(BASE_URL, s.category(), s.slug())),

Map.entry("flatUrl", "%s/%s.html".formatted(BASE_URL, s.slug())),

Map.entry("titleJson", jsonEscape(s.title())), Map.entry("summaryJson", jsonEscape(s.summary())),

Map.entry("categoryDisplayJson", jsonEscape(s.catDisplay())),

Map.entry("navArrows", renderNavArrows(s, all, locale)),

Map.entry("whyCards", renderWhyCards(tpl.whyCard(), s.whyModernWins())),

Map.entry("docLinks", renderDocLinks(tpl.docLink(), s.node().withArray("docs"))),

Map.entry("proofSection", renderProofSection(s, extraTokens)),

Map.entry("relatedCards", renderRelatedSection(tpl.relatedCard(), s, all, locale, extraTokens)),

Map.entry("socialShare", renderSocialShare(tpl.socialShare(), s.category(), s.slug(), s.title(), extraTokens)),

Map.entry("tagPills", renderTagPills(s, locale))));

var localeName = LOCALES.getOrDefault(locale, locale);

tokens.putAll(buildContributeUrls(s, locale, localeName));

return replaceTokens(tpl.page(), tokens);

if (locale.equals("en")) return englishSnippet;

var translatedDir = Path.of(TRANSLATIONS_DIR, "content", locale, englishSnippet.category());

var translatedFile = findWithExtensions(translatedDir, englishSnippet.slug());

if (translatedFile.isEmpty()) return englishSnippet;

try {

var translatedNode = (com.fasterxml.jackson.databind.node.ObjectNode) readAuto(translatedFile.get());

// Start from a copy of the English node

var merged = englishSnippet.node().deepCopy();

// Overlay only translatable fields from the translation file

for (var field : TRANSLATABLE_FIELDS) {

if (translatedNode.has(field)) {

if (field.equals("support") && translatedNode.get("support").isObject()) {

// For support, only merge "description" — keep "state" from English

var translatedSupport = translatedNode.get("support");

if (translatedSupport.has("description")) {

((com.fasterxml.jackson.databind.node.ObjectNode) merged.get("support"))

.put("description", translatedSupport.get("description").asText());

}

} else {

((com.fasterxml.jackson.databind.node.ObjectNode) merged).set(field, translatedNode.get(field));

}

}

}

return new Snippet(merged);

} catch (IOException e) {

IO.println("[WARN] Failed to load %s — using English".formatted(translatedFile.get()));

return englishSnippet;

}

var sb = new StringBuilder();

for (var entry : LOCALES.entrySet()) {

var loc = entry.getKey();

String href;

if (slug.equals("index")) {

href = loc.equals("en") ? BASE_URL + "/" : BASE_URL + "/" + loc + "/";

} else {

href = loc.equals("en")

? "%s/%s%s.html".formatted(BASE_URL, pathPart, slug)

: "%s/%s/%s%s.html".formatted(BASE_URL, loc, pathPart, slug);

}

sb.append(" <link rel=\"alternate\" hreflang=\"%s\" href=\"%s\">\n".formatted(loc, href));

}

// x-default points to English

var defaultHref = slug.equals("index")

? BASE_URL + "/"

: "%s/%s%s.html".formatted(BASE_URL, pathPart, slug);

sb.append(" <link rel=\"alternate\" hreflang=\"x-default\" href=\"%s\">".formatted(defaultHref));

return sb.toString();

var sb = new StringBuilder();

sb.append(" <div class=\"locale-picker\" id=\"localePicker\">\n");

sb.append(" <button type=\"button\" class=\"locale-toggle\" aria-haspopup=\"listbox\" aria-expanded=\"false\"\n");

sb.append(" aria-label=\"Select language\">🌐</button>\n");

sb.append(" <ul role=\"listbox\" aria-label=\"Language\">\n");

for (var entry : LOCALES.entrySet()) {

var selected = entry.getKey().equals(currentLocale);

sb.append(" <li role=\"option\" data-locale=\"%s\" aria-selected=\"%s\"%s>%s</li>\n"

.formatted(entry.getKey(), selected, selected ? " class=\"active\"" : "", entry.getValue()));

}

sb.append(" </ul>\n");

sb.append(" </div>");

return sb.toString();

var localeArray = LOCALES.keySet().stream()

.map(l -> "\"" + l + "\"")

.collect(java.util.stream.Collectors.joining(", "));

return """

</script>""".formatted(

locale,

localeArray,

jsEscape(strings.getOrDefault("search.placeholder", "Search snippets…")),

jsEscape(strings.getOrDefault("search.noResults", "No results found.")),

jsEscape(strings.getOrDefault("copy.copied", "Copied!")),

jsEscape(strings.getOrDefault("view.expandAll", "Expand All")),

jsEscape(strings.getOrDefault("view.collapseAll", "Collapse All")),

jsEscape(strings.getOrDefault("cards.hoverHint", "hover to see modern →")),

jsEscape(strings.getOrDefault("cards.touchHint", "👆 tap or swipe →")));

// Loop to handle tokens within replacement values (e.g., {{snippetCount}} inside i18n strings)

var result = template;

for (int pass = 0; pass < 3; pass++) {

var m = TOKEN.matcher(result);

var sb = new StringBuilder();

boolean found = false;

while (m.find()) {

var replacement = replacements.get(m.group(1));

if (replacement != null) {

m.appendReplacement(sb, Matcher.quoteReplacement(replacement));

found = true;

} else {

m.appendReplacement(sb, Matcher.quoteReplacement(m.group(0)));

}

}

m.appendTail(sb);

result = sb.toString();

if (!found) break;

}

return result;