group[1]).join(",") !== "2,2,3") pushError(`[${locale}] unexpected homepage group layout`);
+ const prefix = locale === "en" ? "" : `/${locale}`;
+ for (const route of ["/trading/overview", "/prediction/overview"]) {
+ if (!groups[0]?.[2].includes(`href="${prefix}${route}"`)) pushError(`[${locale}] trading products must appear together first`);
+ }
+ if (!home.includes("sixmm-stat-grid") || (home.match(//g) ?? []).length !== 4) pushError(`[${locale}] homepage must include four guidance blocks`);
+}
+
for (const [label, relativePagePath, href] of sitelinkTargets) {
if (
- !sourceHome.includes(`title="${label}"`) ||
+ (label !== "Trading Solutions" && !sourceHome.includes(`title="${label}"`)) ||
!sourceHome.includes(`href="${href}"`)
) {
pushError(`[en] homepage is missing the ${label} sitelink to ${href}`);
@@ -259,13 +279,13 @@ const simplifiedChineseHome = await readFile(
for (const [label, href] of [
["交易解决方案", "/zh-CN/solutions/overview"],
["开发者 API", "/zh-CN/developer-api/overview"],
- ["Trading Widget SDK", "/zh-CN/sdk/trading-widget/overview"],
- ["Agent SDK", "/zh-CN/sdk/agent-sdk/overview"],
+ ["交易组件 SDK", "/zh-CN/sdk/trading-widget/overview"],
+ ["合作方后端 SDK", "/zh-CN/sdk/agent-sdk/overview"],
["安全与合规", "/zh-CN/security-compliance/overview"],
["集成与支持", "/zh-CN/resources/overview"],
]) {
if (
- !simplifiedChineseHome.includes(`title="${label}"`) ||
+ (label !== "交易解决方案" && !simplifiedChineseHome.includes(`title="${label}"`)) ||
!simplifiedChineseHome.includes(`href="${href}"`)
) {
pushError(`[zh-CN] homepage is missing the ${label} core entry`);
@@ -302,7 +322,7 @@ if (!sameArray(manifestLocales, expectedManifestLocales)) {
);
}
-for (const locale of generatedLocales) {
+for (const locale of generatedLocales.filter((locale) => !requestedLocales || requestedLocales.has(locale))) {
const pages = manifest.locales?.[locale]?.pages ?? {};
if (Object.keys(pages).length !== activePages.length) {
pushError(
@@ -461,7 +481,12 @@ for (const locale of translatedLocales) {
const titles = new Map();
const descriptions = new Map();
for (const relativePagePath of activePages) {
- const content = await readFile(path.join(localizedRoot(locale), relativePagePath), "utf8");
+ let content;
+ try {
+ content = await readFile(path.join(localizedRoot(locale), relativePagePath), "utf8");
+ } catch {
+ continue; // The completeness pass above already reports a missing page.
+ }
const meta = frontmatter(content);
for (const [field, value, collection] of [
["title", meta.title, titles],
@@ -673,7 +698,7 @@ const supportScript = await readFile(path.join(fernRoot, "support-widget.js"), "
if (/window\.location\.(?:assign|replace|reload)|window\.location\s*=/.test(
`${languageScript}\n${supportScript}`,
)) {
- pushError("Language switching must not trigger a full-page navigation");
+ pushError("Locale navigation must use links rather than forcing a full-page reload");
}
for (const contract of [
"CSWidget",
@@ -688,6 +713,13 @@ for (const contract of [
}
}
+if (/__reactFiber|memoizedValue|dependencies\.firstContext/.test(languageScript)) {
+ pushError("Locale navigation must not depend on private React router internals");
+}
+if (!styles.includes('.fern-header-tabs > astro-island > div:has(> [role="tablist"])')) {
+ pushError("Header tab centering must support Fern's Astro island wrapper");
+}
+
const seoScript = await readFile(
path.join(fernRoot, "seo-structured-data.js"),
"utf8",
@@ -720,5 +752,5 @@ if (errors.length > 0) {
}
console.log(
- `Translation structure and terminology checks passed: ${expectedLocales.length} locales, ${activePages.length} active pages each, code and SEO preserved.`,
+ `Translation structure and terminology checks passed: ${requestedLocales ? `English source + ${translatedLocales.join(", ")} (scoped preview; full release check still required)` : `${expectedLocales.length} locales`}, ${activePages.length} active pages each, code and SEO preserved.`,
);
diff --git a/scripts/check-widget-sync.mjs b/scripts/check-widget-sync.mjs
index 6c35dc9f..25d29b4e 100644
--- a/scripts/check-widget-sync.mjs
+++ b/scripts/check-widget-sync.mjs
@@ -1,9 +1,10 @@
+import { fileURLToPath } from "node:url";
import assert from "node:assert/strict";
import { readFile } from "node:fs/promises";
import path from "node:path";
import { runInNewContext } from "node:vm";
-const projectRoot = path.resolve(path.dirname(new URL(import.meta.url).pathname), "..");
+const projectRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
const supportScript = await readFile(
path.join(projectRoot, "fern", "support-widget.js"),
"utf8",
@@ -248,13 +249,12 @@ documentElement.dataset.theme = "light";
observers[0].listener();
assert.deepEqual(widgetCalls, [["theme", "light"]]);
-// Fern adapter: use the mounted Next.js router for locales and the native item
-// for themes.
+// Fern adapter: navigate through standard links without a React/Next router.
let activeMenu = null;
let activeThemeIcon = "light";
let languageTriggerClicks = 0;
-const directRouterNavigations = [];
-const directRouterRefreshes = [];
+const nativeLinkNavigations = [];
+const adapterArticle = { textContent: "English page" };
const adapterRootClasses = new Set(["light"]);
const adapterStorage = new Map([["theme", "light"]]);
const adapterStorageEvents = [];
@@ -297,33 +297,6 @@ const adapterWindow = {
setTimeout,
clearTimeout,
};
-const directRouter = {
- push() {},
- prefetch() {},
- replace(url, options) {
- directRouterNavigations.push([url, options]);
- const target = new URL(url, adapterWindow.location.origin);
- adapterWindow.location.pathname = target.pathname;
- adapterWindow.location.search = target.search;
- adapterWindow.location.hash = target.hash;
- },
- refresh() {
- directRouterRefreshes.push(adapterWindow.location.pathname);
- },
-};
-const mountedFernLink = {
- href: "/home",
- __reactFiber$test: {
- dependencies: {
- firstContext: {
- memoizedValue: directRouter,
- next: null,
- },
- },
- return: null,
- },
-};
-
function makeClassList() {
const values = new Set();
return {
@@ -441,8 +414,25 @@ const adapterDocument = {
readyState: "loading",
documentElement: adapterRoot,
addEventListener() {},
- createElement() {
- return { className: "", textContent: "" };
+ body: { appendChild() {} },
+ createElement(tag) {
+ if (tag !== "a") return { className: "", textContent: "" };
+ return {
+ href: "",
+ hidden: false,
+ click() {
+ nativeLinkNavigations.push(this.href);
+ const target = new URL(this.href, adapterWindow.location.origin);
+ adapterWindow.location.pathname = target.pathname;
+ adapterWindow.location.search = target.search;
+ adapterWindow.location.hash = target.hash;
+ adapterArticle.textContent = "Page " + target.pathname;
+ },
+ remove() {},
+ };
+ },
+ querySelector(selector) {
+ return selector === "main article" ? adapterArticle : null;
},
getElementById(id) {
if (id === "language-menu" && activeMenu === languageMenu) return languageMenu;
@@ -450,7 +440,7 @@ const adapterDocument = {
return null;
},
querySelectorAll(selector) {
- if (selector === "a[href]") return [mountedFernLink];
+ if (selector === "a[href]") return [];
if (selector === ".fern-language-selector") return [languageSelector];
if (selector === ".fern-language-selector + button") return [themeTrigger];
if (selector.includes(".fern-language-dropdown-content")) {
@@ -497,9 +487,7 @@ assert.equal(
true,
);
assert.equal(adapterWindow.location.pathname, "/fr/home");
-assert.equal(directRouterNavigations.at(-1)[0], "/fr/home");
-assert.equal(directRouterNavigations.at(-1)[1].scroll, false);
-assert.deepEqual(directRouterRefreshes, []);
+assert.equal(nativeLinkNavigations.at(-1), "/fr/home");
assert.equal(
languageTriggerClicks,
0,
@@ -514,8 +502,7 @@ assert.equal(
assert.equal(adapterWindow.location.pathname, "/de/home");
assert.equal(adapterWindow.location.search, "?from=widget");
assert.equal(adapterWindow.location.hash, "#example");
-assert.equal(directRouterNavigations.at(-1)[0], "/de/home?from=widget#example");
-assert.deepEqual(directRouterRefreshes, []);
+assert.equal(nativeLinkNavigations.at(-1), "/de/home?from=widget#example");
adapterWindow.location.pathname = "/";
adapterWindow.location.search = "";
@@ -525,13 +512,21 @@ assert.equal(
true,
);
assert.equal(adapterWindow.location.pathname, "/ja");
-assert.equal(directRouterNavigations.at(-1)[0], "/ja");
+assert.equal(nativeLinkNavigations.at(-1), "/ja");
assert.equal(
await adapterWindow.__sixmmNavigateDocsLocale(""),
true,
);
assert.equal(adapterWindow.location.pathname, "/");
-assert.equal(directRouterNavigations.at(-1)[0], "/");
+assert.equal(nativeLinkNavigations.at(-1), "/");
+
+const previousNavigationCount = nativeLinkNavigations.length;
+assert.equal(await adapterWindow.__sixmmNavigateDocsLocale(""), true);
+assert.equal(await adapterWindow.__sixmmNavigateDocsLocale("unsupported"), false);
+assert.equal(nativeLinkNavigations.length, previousNavigationCount,
+ "Current and unsupported locales must not start a navigation");
+assert.doesNotMatch(languageScript, /__reactFiber|memoizedValue/,
+ "Locale switching must work without a private Next router");
activeMenu = null;
assert.equal(
diff --git a/scripts/generate-translations.mjs b/scripts/generate-translations.mjs
index 6985f2ca..bc0c65d3 100644
--- a/scripts/generate-translations.mjs
+++ b/scripts/generate-translations.mjs
@@ -1,4 +1,6 @@
-import { execFileSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { readFileSync } from "node:fs";
+import { parse as parseYaml } from "yaml";
import { createHash } from "node:crypto";
import { mkdir, readFile, writeFile } from "node:fs/promises";
import path from "node:path";
@@ -9,7 +11,7 @@ import {
} from "./locale-config.mjs";
import { polishMachineTranslation } from "./polish-core-translations.mjs";
-const projectRoot = path.resolve(path.dirname(new URL(import.meta.url).pathname), "..");
+const projectRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
const fernRoot = path.join(projectRoot, "fern");
const sourceRoot = path.join(fernRoot, "docs");
const translationsRoot = path.join(fernRoot, "translations");
@@ -39,17 +41,7 @@ if (refreshManifestOnly && (force || labelsOnly)) {
}
function loadYamlAsJson(filePath) {
- const ruby = [
- "require 'yaml'",
- "require 'json'",
- "puts JSON.generate(YAML.load_file(ARGV.fetch(0)))",
- ].join("; ");
- return JSON.parse(
- execFileSync("ruby", ["-e", ruby, filePath], {
- encoding: "utf8",
- maxBuffer: 20 * 1024 * 1024,
- }),
- );
+ return parseYaml(readFileSync(filePath, "utf8"));
}
function yamlQuote(value) {
@@ -364,7 +356,8 @@ function extractDocumentRecords(content) {
continue;
}
- const protectedRecord = protectText(lineWithAttributeTokens);
+ const blockPrefix = lineWithAttributeTokens.match(/^(\s*(?:#{1,6}\s+|>\s*|\d+\.\s+|[-*]\s+))/)?.[0] ?? "";
+ const protectedRecord = protectText(lineWithAttributeTokens.slice(blockPrefix.length));
if (
!/[A-Za-z]/.test(
protectedRecord.text.replace(/\[\[\[ph\d+\]\]\]/g, ""),
@@ -372,7 +365,7 @@ function extractDocumentRecords(content) {
) {
continue;
}
- records.push({ kind: "line", index, prefix: "", suffix: "", ...protectedRecord });
+ records.push({ kind: "line", index, prefix: blockPrefix, suffix: "", ...protectedRecord });
}
return { lines, records };
@@ -393,7 +386,7 @@ async function getEdgeToken(forceRefresh = false) {
return edgeToken;
}
-async function requestTranslations(texts, sourceLanguage, targetLanguage, attempt = 1) {
+async function requestEdgeTranslations(texts, sourceLanguage, targetLanguage, attempt = 1) {
const url = new URL("https://api-edge.cognitive.microsofttranslator.com/translate");
url.search = new URLSearchParams({
"api-version": "3.0",
@@ -454,11 +447,47 @@ async function requestTranslations(texts, sourceLanguage, targetLanguage, attemp
console.warn(`Translation service throttled; retrying in ${Math.round(delay / 1000)}s.`);
}
await sleep(delay);
+ return requestEdgeTranslations(texts, sourceLanguage, targetLanguage, attempt + 1);
+ }
+}
+
+// Public Google dictionary translation endpoint; keep Edge available for existing environments.
+// This is a machine-translation aid, not a guarantee of editorial review.
+const translationProvider = process.env.DOCS_TRANSLATION_PROVIDER ?? "google";
+if (!["google", "edge"].includes(translationProvider)) throw new Error("Unknown translation provider");
+async function requestTranslations(texts, sourceLanguage, targetLanguage, attempt = 1) {
+ if (translationProvider === "edge") return requestEdgeTranslations(texts, sourceLanguage, targetLanguage, attempt);
+ const url = new URL("https://clients5.google.com/translate_a/t");
+ const target = { "es-MX": "es", "es-ES": "es", "pt-BR": "pt", "pt-PT": "pt-PT" }[targetLanguage] ?? targetLanguage;
+ url.search = new URLSearchParams({ client: "dict-chrome-ex", sl: sourceLanguage, tl: target });
+ texts.forEach(text => url.searchParams.append("q", text));
+ try {
+ await sleep(Math.max(0, 650 - (Date.now() - lastTranslationRequestAt)));
+ lastTranslationRequestAt = Date.now();
+ const response = await fetch(url, { signal: AbortSignal.timeout(30_000) });
+ if (!response.ok) {
+ const error = new Error(`Translation service returned HTTP ${response.status}`);
+ error.status = response.status;
+ throw error;
+ }
+ const output = await response.json();
+ if (!Array.isArray(output) || output.length !== texts.length || output.some(x => typeof x !== "string")) {
+ throw new Error("Translation response shape mismatch");
+ }
+ return output.map((text, index) => {
+ const normalized = text.replace(/(?:\[\s*)+ph\s*(\d+)(?:\s*\])+/gi, "[[[ph$1]]]");
+ const tokens = texts[index].match(/\[\[\[ph\d+\]\]\]/g) ?? [];
+ if (tokens.some(token => !normalized.includes(token))) throw new Error(`Translation lost a protected token: ${JSON.stringify({ source: texts[index], translated: normalized })}`);
+ return normalized;
+ });
+ } catch (error) {
+ if (attempt >= 4 || (error.status && ![429, 500, 502, 503, 504].includes(error.status))) throw error;
+ await sleep(error.status === 429 ? 30_000 : 2_000 * attempt);
return requestTranslations(texts, sourceLanguage, targetLanguage, attempt + 1);
}
}
-function createBatches(records, maximumCharacters = 40_000, maximumItems = 100) {
+function createBatches(records, maximumCharacters = 1_800, maximumItems = 30) {
const batches = [];
let current = [];
let currentLength = 0;
@@ -547,6 +576,15 @@ async function translateDocument(content, locale, relativePagePath) {
return canonicalForLocale(localizeInternalLinks(content, route), route);
}
const document = extractDocumentRecords(content);
+ if (relativePagePath.startsWith("docs/pages/prediction/")) {
+ for (const record of document.records) {
+ record.text = { Custom: "Custom Prediction", Grid: "Prediction Grid", "Up/Down": "Up/Down Prediction" }[record.text] ?? record.text;
+ record.text = record.text
+ .replace(/\bnet PnL\b/gi, "net profit and loss")
+ .replace(/\bquoted odds\b/gi, "offered payout multiplier")
+ .replace(/\brecorded odds\b/gi, "recorded payout multiplier");
+ }
+ }
const translated = await translateRecords(
document.records,
locale.sourceLanguage,
@@ -655,8 +693,8 @@ const activePages = [
),
];
-if (activePages.length !== 87) {
- throw new Error(`Expected 87 active pages, found ${activePages.length}`);
+if (activePages.length !== 125) {
+ throw new Error(`Expected 125 active pages, found ${activePages.length}`);
}
const manifest = await loadManifest();
diff --git a/scripts/polish-core-translations.mjs b/scripts/polish-core-translations.mjs
index 1639b2e3..4f707b6d 100644
--- a/scripts/polish-core-translations.mjs
+++ b/scripts/polish-core-translations.mjs
@@ -1,11 +1,12 @@
+import { fileURLToPath } from "node:url";
import { readFile, readdir, writeFile } from "node:fs/promises";
import path from "node:path";
import { locales } from "./locale-config.mjs";
-const projectRoot = path.resolve(path.dirname(new URL(import.meta.url).pathname), "..");
+const projectRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
const isMain =
Boolean(process.argv[1]) &&
- path.resolve(process.argv[1]) === new URL(import.meta.url).pathname;
+ path.resolve(process.argv[1]) === fileURLToPath(import.meta.url);
const tradingApiPaths =
/^(?:docs\.yml|docs\/pages\/(?:trading|getting-started|developer-api|sdk|solutions\/(?:matching-engine|operations-console))\/?)/;
@@ -632,10 +633,6 @@ const coreTextReplacementsByLocale = {
},
ru: {
"docs/pages/home.mdx": [
- [
- "Выбирайте встроенную торговлю, белую биржу, институциональную ликвидность или поддержку комплаенса и лицензирования.",
- "Выберите встроенную торговлю, биржу под собственной маркой, институциональную ликвидность или поддержку по вопросам комплаенса и лицензирования.",
- ],
[
"Интегрируйте аутентификацию, подписывание запросов, REST конечных точек, WebSocket потоков и обработку ошибок в производстве.",
"Интегрируйте аутентификацию, подписание запросов, конечные точки REST, потоки WebSocket и обработку ошибок в рабочей среде.",
@@ -672,7 +669,6 @@ const coreTextReplacementsByLocale = {
},
fr: {
"docs/pages/home.mdx": [
- ['title="Trading Solutions"', 'title="Solutions de trading"'],
[
"Intégrez l’authentification, la signature de requêtes, les terminaux REST , les flux WebSocket et la gestion des erreurs de production.",
"Intégrez l’authentification, la signature des requêtes, les points de terminaison REST, les flux WebSocket et la gestion des erreurs en production.",
@@ -873,6 +869,51 @@ function applyApprovedCoreCopy(content, locale, relativePath) {
return output;
}
+function polishPredictionCopy(content, locale, relativePath) {
+ if (!relativePath.startsWith("docs/pages/prediction/")) return content;
+ let output = content.replace(/^(#{1,6})(?=[^#\s])/gm, "$1 ")
+ .replace(/^(\d+\.)(?=\S)/gm, "$1 ");
+ const glossary = {
+ ja: {
+ "精度と沈み込み": "精度と決済", "細胞成分": "セルの構成", "返品": "払戻金",
+ "永久アカウント": "無期限契約アカウント", "永久取引": "無期限契約取引",
+ "勝ちグリッドの順序": "予測グリッドの勝ち注文", "カスタムオーダーを獲得": "カスタム予測の勝ち注文",
+ "支払いなしで注文を失った場合": "負け注文（払戻額なし）", "実際に動作した例": "計算例",
+ "予選ヒットなし": "有効なタッチなし", "料金は窓口中は横切らずに外に留まります": "有効時間内に価格が区間外にとどまり、区間を横切らない",
+ "100 件の勝利注文 USDT": "賭け金 100 USDT の勝ち注文",
+ },
+ ru: { "Пользовательская сеть PnL": "Чистый результат пользователя", "Ничья и расчет": "Определение результата и расчёт" },
+ fr: { "Les chances sont un multiplicateur de rendement": "Les cotes sont un multiplicateur de paiement", "les guillemets au-dessus du maximum": "les cotes supérieures au maximum" },
+ de: { "Eine qualifizierende Note reicht aus": "Eine gültige Preisberührung reicht aus" },
+ ar: {
+ "دفعات التنبؤ والخسارة والخسارة": "مدفوعات التنبؤ والأرباح والخسائر",
+ "دفعات التنبؤ والخسارة والخسائر": "مدفوعات التنبؤ والأرباح والخسائر",
+ "آليات احتمالات التنبؤ": "آليات مضاعفات العائد في التنبؤ",
+ "الاحتمالات هي مضاعف العائد": "نسبة العائد هي مضاعف المبلغ المدفوع",
+ "احتمالات ثابتة": "مضاعفات عائد ثابتة", "الاحتمالات الثابتة": "مضاعفات العائد الثابتة",
+ "حمام السباحة": "مجمع السيولة", "المسبحين": "مجمعي السيولة",
+ "علامات الاقتباس": "عروض الأسعار", "اقتباس ديناميكي": "عرض أسعار متغير",
+ "الحصة الصحيحة": "مبلغ الرهان المؤهل للاحتساب",
+ "الفوز بترتيب الشبكة": "أمر شبكة رابح", "فقدان النظام مع عدم وجود دفع تعويضات": "أمر خاسر دون عائد",
+ "الفراغات": "الأوامر الملغاة", "الصعاب والخلايا غير المتاحة": "مضاعفات العائد والخلايا غير المتاحة",
+ },
+
+ ko: {
+ "확률 메커니즘": "배당률 체계", "확률은 수익 승수입니다": "배당률은 지급 배수입니다",
+ "고정 확률": "고정 배당률", "따옴표": "배당률", "목표 반품": "목표 환급률",
+ "승률 경계": "배당률 한도", "말뚝": "베팅 금액", "시장평균가": "마크 가격",
+ "구성에서는 Up 견적을 1에 목표 수익률 계수를 Down 풀에 곱하고 Up 풀에 제안된 스테이크로 나눈 값으로 설명합니다. Down의 경우 두 개의 풀을 교환합니다. 구성된 하한 및 상한은 결과를 제한합니다.": "상승(Up) 배당률은 1 + 목표 환급 계수 × 하락 풀 ÷ (상승 풀 + 신규 베팅 금액)으로 계산합니다. 하락(Down)은 두 풀을 서로 바꿉니다. 계산 결과에는 설정된 최솟값과 최댓값이 적용됩니다.",
+ },
+
+
+
+ }[locale] ?? {};
+ return mapOutsideProtectedMdx(output, text => {
+ for (const [from, to] of Object.entries(glossary)) text = text.split(from).join(to);
+ return text;
+ });
+}
+
export function polishMachineTranslation(content, locale, relativePath) {
let output = content;
output = polishUnexpectedUrlJoins(output, locale, relativePath);
@@ -899,6 +940,7 @@ export function polishMachineTranslation(content, locale, relativePath) {
);
}
output = applyApprovedCoreCopy(output, locale, relativePath);
+ output = polishPredictionCopy(output, locale, relativePath);
return output;
}
diff --git a/scripts/preview-prediction.mjs b/scripts/preview-prediction.mjs
new file mode 100755
index 00000000..c96fbcd8
--- /dev/null
+++ b/scripts/preview-prediction.mjs
@@ -0,0 +1,25 @@
+import { spawn } from "node:child_process";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const args = process.argv.slice(2);
+function portArgument(name, fallback) {
+ const arg = args.find((value) => value.startsWith(`--${name}=`));
+ const value = arg ? Number(arg.split("=")[1]) : fallback;
+ if (!Number.isInteger(value) || value < 1024 || value > 65535) throw new Error(`Invalid ${name}`);
+ return value;
+}
+const port = portArgument("port", 3010);
+const backendPort = portArgument("backend-port", 3011);
+if (port === backendPort) throw new Error("Preview and backend ports must differ");
+console.log(`Local prediction review: http://127.0.0.1:${port}/zh-CN/prediction/overview`);
+console.log("Uses all configured languages and Fern's normal renderer. This command does not publish.");
+const executable = path.join(root, "node_modules/.bin", process.platform === "win32" ? "fern.cmd" : "fern");
+const child = spawn(executable, ["docs", "dev", "--port", String(port), "--backend-port", String(backendPort)], {
+ cwd: root,
+ stdio: "inherit",
+ shell: process.platform === "win32",
+});
+for (const signal of ["SIGINT", "SIGTERM"]) process.on(signal, () => child.kill(signal));
+child.on("error", (error) => { console.error(error.message); process.exitCode = 1; });
+child.on("exit", (code) => { process.exitCode = code ?? 0; });
diff --git a/scripts/repair-translation-links.mjs b/scripts/repair-translation-links.mjs
index 89e45079..6839fdd7 100644
--- a/scripts/repair-translation-links.mjs
+++ b/scripts/repair-translation-links.mjs
@@ -1,9 +1,11 @@
-import { execFileSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { readFileSync } from "node:fs";
+import { parse as parseYaml } from "yaml";
import { readFile, writeFile } from "node:fs/promises";
import path from "node:path";
import { generatedLocaleSpecs } from "./locale-config.mjs";
-const projectRoot = path.resolve(path.dirname(new URL(import.meta.url).pathname), "..");
+const projectRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
const fernRoot = path.join(projectRoot, "fern");
const translationsRoot = path.join(fernRoot, "translations");
const generatedLocales = generatedLocaleSpecs.map((locale) => locale.code);
@@ -32,12 +34,7 @@ function localeRoot(locale) {
}
function loadYamlAsJson(filePath) {
- const ruby = [
- "require 'yaml'",
- "require 'json'",
- "puts JSON.generate(YAML.load_file(ARGV.fetch(0)))",
- ].join("; ");
- return JSON.parse(execFileSync("ruby", ["-e", ruby, filePath], { encoding: "utf8" }));
+ return parseYaml(readFileSync(filePath, "utf8"));
}
function metadata(content) {