feat(website): check all supported locales in doc check script

Instead of hard-coding the list of locales, use quick-lint-js' C++ code
as the source of truth for what locales should be checked. This means
that check-diagnostic-messages.mjs will check new locales as they are
added.

Author: strager

src/c-api.cpp

@@ -111,6 +111,28 @@ const qljs_web_demo_diagnostic* qljs_web_demo_lint_as_config_file(
   return p->lint_as_config_file();
 }
 
+const char* const* qljs_list_locales() {
+  static const char* const* locale_list = [] {
+    std::size_t locale_count =
+        quick_lint_js::translation_table_locale_count + 1;
+    const char** locales = new const char*[locale_count + 1];
+
+    std::size_t i = 0;
+    const char* l;
+    for (l = quick_lint_js::translation_data.locale_table; *l != '\0';
+         l += std::strlen(l) + 1, ++i) {
+      locales[i] = l;
+    }
+    locales[i] = l;  // Default locale (empty string).
+    ++i;
+    QLJS_ASSERT(i == locale_count);
+    locales[i] = nullptr;  // Terminator.
+
+    return locales;
+  }();
+  return locale_list;
+}
+
 // quick-lint-js finds bugs in JavaScript programs.
 // Copyright (C) 2020  Matthew "strager" Glazar
 //

src/quick-lint-js/c-api.h

@@ -36,6 +36,9 @@ const qljs_web_demo_diagnostic* qljs_web_demo_lint(qljs_web_demo_document*);
 const qljs_web_demo_diagnostic* qljs_web_demo_lint_as_config_file(
     qljs_web_demo_document*);
 
+// Returns a null-terminated array of null-terminated strings.
+const char* const* qljs_list_locales();
+
 #if defined(__cplusplus)
 }
 #endif

test/test-c-api.cpp

@@ -4,6 +4,7 @@
 #include <gtest/gtest.h>
 #include <quick-lint-js/c-api.h>
 #include <quick-lint-js/char8.h>
+#include <quick-lint-js/translation-table.h>
 
 namespace quick_lint_js {
 namespace {
@@ -88,6 +89,25 @@ TEST(test_c_api_web_demo, linting_uses_config) {
 
   qljs_web_demo_destroy_document(p);
 }
+
+TEST(test_c_api, locale_list) {
+  std::vector<std::string> locale_strings;
+  const char* const* locales = qljs_list_locales();
+  for (const char* const* l = locales; *l; ++l) {
+    locale_strings.push_back(*l);
+  }
+  std::sort(locale_strings.begin(), locale_strings.end());
+
+  std::vector<std::string> expected_locale_strings;
+  for (const char* l = translation_data.locale_table; *l != '\0';
+       l += std::strlen(l) + 1) {
+    expected_locale_strings.push_back(l);
+  }
+  expected_locale_strings.push_back("");
+  std::sort(expected_locale_strings.begin(), expected_locale_strings.end());
+
+  EXPECT_EQ(locale_strings, expected_locale_strings);
+}
 }
 }
 

website/check-diagnostic-messages.mjs

@@ -7,6 +7,7 @@ import {
   ProblemsError,
   documentationDirectoryPath,
   loadErrorDocumentationFilesAsync,
+  qljsProcessPromise,
 } from "./src/error-documentation.mjs";
 
 async function mainAsync() {
@@ -24,7 +25,8 @@ async function mainAsync() {
     );
   }
 
-  let locales = ["", "de", "en@loud", "en_US@snarky", "fr_FR", "sv_SE"];
+  let locales = (await qljsProcessPromise).listLocales();
+  console.log(locales); // @@@
   let maxLocaleLength = Math.max(...locales.map((l) => l.length));
 
   let cwd = process.cwd();

website/src/error-documentation.mjs

@@ -30,7 +30,7 @@ async function makeQLJSProcessAsync() {
   let process = await factory.createProcessAsync();
   return process;
 }
-let qljsProcessPromise = makeQLJSProcessAsync();
+export let qljsProcessPromise = makeQLJSProcessAsync();
 
 markdownParser.renderer.rules = {
   ...markdownParser.renderer.rules,

website/wasm/CMakeLists.txt

@@ -15,7 +15,7 @@ if (EMSCRIPTEN)
     quick-lint-js-vscode
     PRIVATE
     quick-lint-js-lib
-    "-sEXPORTED_FUNCTIONS=[\"_qljs_web_demo_create_document\",\"_qljs_web_demo_destroy_document\",\"_qljs_web_demo_set_locale\",\"_qljs_web_demo_set_text\",\"_qljs_web_demo_set_config_text\",\"_qljs_web_demo_lint\",\"_qljs_web_demo_lint_as_config_file\",\"_malloc\",\"_free\"]"
+    "-sEXPORTED_FUNCTIONS=[\"_qljs_list_locales\",\"_qljs_web_demo_create_document\",\"_qljs_web_demo_destroy_document\",\"_qljs_web_demo_set_locale\",\"_qljs_web_demo_set_text\",\"_qljs_web_demo_set_config_text\",\"_qljs_web_demo_lint\",\"_qljs_web_demo_lint_as_config_file\",\"_malloc\",\"_free\"]"
     -sASSERTIONS=0
     -sSTANDALONE_WASM=1
     -sSUPPORT_LONGJMP=1

website/wasm/quick-lint-js.js

@@ -202,6 +202,7 @@ class Process {
 
     this._malloc = wrap("malloc");
     this._free = wrap("free");
+    this._listLocales = wrap("qljs_list_locales");
     this._webDemoCreateDocument = wrap("qljs_web_demo_create_document");
     this._webDemoDestroyDocument = wrap("qljs_web_demo_destroy_document");
     this._webDemoLint = wrap("qljs_web_demo_lint");
@@ -229,6 +230,7 @@ class Process {
     // Make future calls crash and also reduce memory usage.
     this._malloc = tainted;
     this._free = tainted;
+    this._listLocales = tainted;
     this._webDemoCreateDocument = tainted;
     this._webDemoDestroyDocument = tainted;
     this._webDemoLint = tainted;
@@ -243,6 +245,17 @@ class Process {
   async createDocumentForWebDemoAsync() {
     return new DocumentForWebDemo(this);
   }
+
+  listLocales() {
+    let localePointerList = new Uint32Array(this._heap, this._listLocales());
+    let locales = [];
+    for (let i = 0; localePointerList[i] != 0; ++i) {
+      locales.push(
+        decodeUTF8CString(new Uint8Array(this._heap, localePointerList[i]))
+      );
+    }
+    return locales;
+  }
 }
 
 class DocumentForWebDemo {