WIP - test: Add Vitest test suite.

.github/workflows/tests.yaml

@@ -0,0 +1,50 @@
+name: "tests"
+
+on:
+  pull_request:
+    paths: &monitored_paths
+      - ".github/workflows/tests.yaml"
+      - "CMakeLists.txt"
+      - "package.json"
+      - "package-lock.json"
+      - "src/**"
+      - "taskfiles/**"
+      - "Taskfile.yml"
+      - "test/**"
+      - "tsconfig.json"
+      - "vitest.config.ts"
+  push:
+    paths: *monitored_paths
+  schedule:
+    # Run daily at 00:15 UTC (the 15 is to avoid periods of high load)
+    - cron: "15 0 * * *"
+  workflow_dispatch:
+
+permissions: {}
+
+concurrency:
+  group: "${{github.workflow}}-${{github.ref}}"
+
+  # Cancel in-progress jobs for efficiency
+  cancel-in-progress: true
+
+jobs:
+  tests:
+    runs-on: "ubuntu-24.04"
+    steps:
+      - uses: "actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8"  # v6.0.1
+        with:
+          submodules: "recursive"
+
+      - name: "Install task"
+        run: "npm install -g @go-task/cli@3.44.0"
+
+      - name: "Log tool versions"
+        run: |-
+          cmake --version
+          md5sum --version
+          node --version
+          npm --version
+          task --version
+
+      - run: "task test:js"

.gitignore

@@ -1,3 +1,6 @@
+# Dependencies
+node_modules
+
 # Build
 .task
 build
@@ -11,3 +14,6 @@ dist
 # IDEs
 .idea
 .vscode
+
+# Test data
+/test/data

CMakeLists.txt

@@ -1,8 +1,5 @@
 cmake_minimum_required(VERSION 3.16)
 
-include(FetchContent)
-set(FETCHCONTENT_QUIET OFF)
-
 if(NOT CMAKE_TOOLCHAIN_FILE)
     set(CMAKE_TOOLCHAIN_FILE
         "${CMAKE_CURRENT_SOURCE_DIR}/build/emsdk/upstream/emscripten/cmake/Modules/Platform/\
@@ -111,6 +108,7 @@ set(CLP_FFI_JS_SRC_MAIN
 )
 
 set(CLP_FFI_JS_SRC_CLP_CORE
+    ${CLP_FFI_JS_CLP_SOURCE_DIRECTORY}/components/core/src/clp/ffi/EncodedTextAstError.cpp
     ${CLP_FFI_JS_CLP_SOURCE_DIRECTORY}/components/core/src/clp/ffi/ir_stream/decoding_methods.cpp
     ${CLP_FFI_JS_CLP_SOURCE_DIRECTORY}/components/core/src/clp/ffi/ir_stream/ir_unit_deserialization_methods.cpp
     ${CLP_FFI_JS_CLP_SOURCE_DIRECTORY}/components/core/src/clp/ffi/ir_stream/search/ErrorCode.cpp
@@ -126,8 +124,6 @@ set(CLP_FFI_JS_SRC_CLP_CORE
     ${CLP_FFI_JS_CLP_SOURCE_DIRECTORY}/components/core/src/clp/streaming_compression/zstd/Decompressor.cpp
 )
 
-set(CLP_FFI_JS_SRC_FMT ${CLP_FFI_JS_FMT_SOURCE_DIRECTORY}/src/format.cc)
-
 set(CLP_FFI_JS_SRC_ZSTD
     ${CLP_FFI_JS_ZSTD_SOURCE_DIRECTORY}/lib/common/entropy_common.c
     ${CLP_FFI_JS_ZSTD_SOURCE_DIRECTORY}/lib/common/error_private.c
@@ -150,6 +146,30 @@ set(CLP_FFI_JS_SUPPORTED_ENVIRONMENTS
 set(CLP_BUILD_CLP_STRING_UTILS ON)
 add_subdirectory(${CLP_FFI_JS_CLP_SOURCE_DIRECTORY}/components/core/src/clp/string_utils)
 
+# Set up `Boost::headers` as a header-only interface target so that downstream dependencies
+# (e.g., ystdlib) can link against it without requiring a full Boost installation.
+if(NOT TARGET Boost::headers)
+    add_library(Boost_headers INTERFACE)
+    target_include_directories(Boost_headers INTERFACE ${CLP_FFI_JS_BOOST_SOURCE_DIRECTORY})
+    add_library(Boost::headers ALIAS Boost_headers)
+endif()
+
+# Set up ystdlib as a subproject to provide the `ystdlib::error_handling` target required by the CLP
+# core's `EncodedTextAstError` and `clp_s`'s `timestamp_parser`.
+set(Boost_INCLUDE_DIR "${CLP_FFI_JS_BOOST_SOURCE_DIRECTORY}")
+set(YSTDLIB_CPP_BUILD_TESTING OFF)
+add_subdirectory(${CLP_FFI_JS_YSTDLIB_SOURCE_DIRECTORY} ystdlib)
+
+set(ANTLR_BUILD_SHARED OFF)
+set(ANTLR_BUILD_STATIC ON)
+add_subdirectory(${CLP_FFI_JS_ANTLR_RUNTIME_SOURCE_DIRECTORY})
+
+add_subdirectory(${CLP_FFI_JS_DATE_SOURCE_DIRECTORY})
+set(FMT_INSTALL OFF)
+add_subdirectory(${CLP_FFI_JS_FMT_SOURCE_DIRECTORY} fmt)
+add_subdirectory(${CLP_FFI_JS_SIMDJSON_SOURCE_DIRECTORY})
+add_subdirectory(${CLP_FFI_JS_SPDLOG_SOURCE_DIRECTORY})
+
 # The `clp_s` component is linked because the IR search feature uses the same KQL syntax as `clp_s`,
 # by reusing `clp_s`'s AST and KQL libraries.
 #
@@ -166,17 +186,10 @@ set(CLP_BUILD_CLP_S_REDUCER_DEPENDENCIES OFF)
 set(CLP_BUILD_CLP_S_SEARCH OFF)
 set(CLP_BUILD_CLP_S_SEARCH_AST ON)
 set(CLP_BUILD_CLP_S_SEARCH_KQL ON)
+set(CLP_BUILD_CLP_S_TIMESTAMP_PARSER ON)
 set(CLP_BUILD_CLP_S_TIMESTAMPPATTERN ON)
 add_subdirectory(${CLP_FFI_JS_CLP_SOURCE_DIRECTORY}/components/core/src/clp_s)
 
-set(ANTLR_BUILD_SHARED OFF)
-set(ANTLR_BUILD_STATIC ON)
-add_subdirectory(${CLP_FFI_JS_ANTLR_RUNTIME_SOURCE_DIRECTORY})
-
-add_subdirectory(${CLP_FFI_JS_DATE_SOURCE_DIRECTORY})
-add_subdirectory(${CLP_FFI_JS_SIMDJSON_SOURCE_DIRECTORY})
-add_subdirectory(${CLP_FFI_JS_SPDLOG_SOURCE_DIRECTORY})
-
 foreach(env ${CLP_FFI_JS_SUPPORTED_ENVIRONMENTS})
     set(CLP_FFI_JS_BIN_NAME "ClpFfiJs-${env}")
     add_executable(${CLP_FFI_JS_BIN_NAME})
@@ -192,6 +205,7 @@ foreach(env ${CLP_FFI_JS_SUPPORTED_ENVIRONMENTS})
         clp_s::search::ast
         clp_s::search::kql
         embind
+        fmt::fmt
         spdlog::spdlog
     )
     set(CLP_FFI_JS_LINK_OPTIONS
@@ -221,7 +235,6 @@ Link options: ${CLP_FFI_JS_LINK_OPTIONS}."
         ${CLP_FFI_JS_BOOST_SOURCE_DIRECTORY}
         ${CLP_FFI_JS_CLP_SOURCE_DIRECTORY}/components/core/src
         ${CLP_FFI_JS_CLP_SOURCE_DIRECTORY}/components/core/src/clp
-        ${CLP_FFI_JS_FMT_SOURCE_DIRECTORY}/include
         ${CLP_FFI_JS_NLOHMANN_JSON_SOURCE_DIRECTORY}/include
         ${CLP_FFI_JS_YSTDLIB_SOURCE_DIRECTORY}/src
         ${CLP_FFI_JS_ZSTD_SOURCE_DIRECTORY}/lib
@@ -234,7 +247,6 @@ Link options: ${CLP_FFI_JS_LINK_OPTIONS}."
         PRIVATE
         ${CLP_FFI_JS_SRC_MAIN}
         ${CLP_FFI_JS_SRC_CLP_CORE}
-        ${CLP_FFI_JS_SRC_FMT}
         ${CLP_FFI_JS_SRC_ZSTD}
     )
 endforeach()

Taskfile.yml

@@ -3,6 +3,7 @@ version: "3"
 includes:
   deps: "taskfiles/deps.yaml"
   lint: "lint-tasks.yml"
+  test: "taskfiles/test.yaml"
   utils: "tools/yscope-dev-utils/exports/taskfiles/utils/utils.yaml"
 
 vars:

eslint.config.mjs

@@ -0,0 +1,20 @@
+import CommonConfig from "eslint-config-yscope/CommonConfig.mjs";
+import StylisticConfigArray from "eslint-config-yscope/StylisticConfigArray.mjs";
+import TsConfigArray from "eslint-config-yscope/TsConfigArray.mjs";
+
+
+const EslintConfig = [
+    {
+        ignores: [
+            "build/",
+            "dist/",
+            "node_modules/",
+        ],
+    },
+    CommonConfig,
+    ...TsConfigArray,
+    ...StylisticConfigArray,
+];
+
+
+export default EslintConfig;

lint-tasks.yml

@@ -10,6 +10,7 @@ tasks:
   check:
     cmds:
       - task: "check-cpp-full"
+      - task: "check-js"
       - task: "check-yaml"
 
   check-cpp-diff:
@@ -22,13 +23,20 @@ tasks:
       - task: "check-cpp-format"
       - task: "check-cpp-static-full"
 
+  check-js:
+    deps: [":deps:node-modules", ":package"]
+    cmds:
+      - "npm run lint:check:js"
+
   check-no-cpp:
     cmds:
+      - task: "check-js"
       - task: "check-yaml"
 
   fix:
     cmds:
       - task: "fix-cpp-full"
+      - task: "fix-js"
       - task: "fix-yaml"
 
   fix-cpp-diff:
@@ -41,8 +49,14 @@ tasks:
       - task: "fix-cpp-format"
       - task: "fix-cpp-static-full"
 
+  fix-js:
+    deps: [":deps:node-modules", ":package"]
+    cmds:
+      - "npm run lint:fix:js"
+
   fix-no-cpp:
     cmds:
+      - task: "fix-js"
       - task: "fix-yaml"
 
   check-cpp-format:
@@ -120,6 +134,7 @@ tasks:
           --strict \
           .github \
           lint-tasks.yml \
+          taskfiles \
           Taskfile.yml
 
   cpp-lint-configs: