perf(engine): fuse the particle sweep, bound the spatial grid, and fill the pub-API test gaps

.github/workflows/mirror.yml

@@ -36,7 +36,7 @@ jobs:
             echo "::error::GITEE_TOKEN secret is missing"; exit 1
           fi
           git remote remove gitee 2>/dev/null || true
-          git remote add gitee "https://eastspire:${GITEE_TOKEN}@gitee.com/eastspire/${REPO_NAME}.git"
+          git remote add gitee "https://vshengbro:${GITEE_TOKEN}@gitee.com/vshengbro/${REPO_NAME}.git"
           attempt=0
           max_retries=8
           while [ $attempt -le $max_retries ]; do
@@ -65,7 +65,7 @@ jobs:
             echo "::error::GITCODE_TOKEN secret is missing"; exit 1
           fi
           git remote remove gitcode 2>/dev/null || true
-          git remote add gitcode "https://oauth2:${GITCODE_TOKEN}@gitcode.com/eastspire/${REPO_NAME}.git"
+          git remote add gitcode "https://oauth2:${GITCODE_TOKEN}@gitcode.com/vshengbro/${REPO_NAME}.git"
           attempt=0
           max_retries=8
           while [ $attempt -le $max_retries ]; do

.github/workflows/rust.yml

@@ -159,7 +159,7 @@ jobs:
       - name: Configure git
         if: steps.check_branch.outputs.skip == 'false'
         run: |
-          git config user.name "eastspire"
+          git config user.name "vshengbro"
           git config user.email "root@ltpp.vip"
       - name: Sync workspace versions
         if: steps.check_branch.outputs.skip == 'false'

Cargo.toml

@@ -12,7 +12,7 @@ categories = ["network-programming", "web-programming"]
 exclude.workspace = true
 
 [workspace.package]
-version = "0.28.9"
+version = "0.28.12"
 readme = "README.md"
 edition = "2024"
 authors = ["root@ltpp.vip"]
@@ -38,13 +38,13 @@ resolver = "3"
 crate-type = ["rlib"]
 
 [workspace.dependencies]
-euv = { path = ".", version = "0.28.9" }
-euv-ui = { path = "ui", version = "0.28.9" }
-euv-cli = { path = "cli", version = "0.28.9" }
-euv-core = { path = "core", version = "0.28.9" }
-euv-engine = { path = "engine", version = "0.28.9" }
-euv-macros = { path = "macros", version = "0.28.9" }
-euv-example = { path = "example", version = "0.28.9" }
+euv = { path = ".", version = "0.28.10" }
+euv-ui = { path = "ui", version = "0.28.10" }
+euv-cli = { path = "cli", version = "0.28.10" }
+euv-core = { path = "core", version = "0.28.10" }
+euv-engine = { path = "engine", version = "0.28.10" }
+euv-macros = { path = "macros", version = "0.28.10" }
+euv-example = { path = "example", version = "0.28.10" }
 
 log = "0.4.33"
 toml = "0.9.12"
@@ -53,15 +53,15 @@ chrono = "0.4.45"
 ignore = "0.4.31"
 js-sys = "0.3.103"
 if-addrs = "0.15.0"
-hyperlane = "21.9.1"
 serde_json = "1.0.151"
 color-output = "10.2.2"
 proc-macro2 = "1.0.107"
-hyperlane-cli = "21.9.1"
+hyperlane-cli = "21.9.0"
 lombok-macros = "10.2.2"
 wasm-bindgen = "0.2.126"
 alloc-no-stdlib = "3.0.0"
 compare_version = "10.2.2"
+hyperlane-core = "=21.9.0"
 bin-encode-decode = "1.2.6"
 serde-wasm-bindgen = "0.6.5"
 wasm-bindgen-test = "0.3.76"
@@ -82,6 +82,9 @@ tokio = { version = "1.53.1", features = [
     "process",
     "rt-multi-thread",
 ] }
+hyperlane = "21.9.0"
+# hyperlane-core 21.11.0 changed Server::route to take two generic
+# arguments; pin the transitive dependency until euv-cli migrates.
 web-sys = { version = "0.3.103", features = [
     "Gpu",
     "Blob",

cli/Cargo.toml

@@ -31,3 +31,8 @@ proc-macro2 = { workspace = true }
 color-output = { workspace = true }
 hyperlane-cli = { workspace = true }
 lombok-macros = { workspace = true }
+hyperlane-core = { workspace = true }
+
+[dev-dependencies]
+clap = { workspace = true }
+tokio = { workspace = true }

cli/src/build/const.rs

@@ -1,12 +1,22 @@
+/// The default output subdirectory name for wasm-pack artifacts.
+pub(crate) const PKG_DIR_NAME: &str = "pkg";
+
+/// The index HTML file name.
+pub(crate) const INDEX_HTML_FILE_NAME: &str = "index.html";
+
+/// The hyphen character used when normalizing crate names to wasm-pack's
+/// underscore output convention.
+pub(crate) const STR_HYPHEN: &str = "-";
+
 /// Placeholder token used in HTML templates for the JS import path.
 ///
 /// Replaced at runtime with the resolved import path relative to the www directory.
-pub const IMPORT_PATH_PLACEHOLDER: &str = "__IMPORT_PATH__";
+pub(crate) const IMPORT_PATH_PLACEHOLDER: &str = "__IMPORT_PATH__";
 
 /// Placeholder token used in HTML templates for the reload endpoint URL.
 ///
 /// Replaced at runtime with the actual reload route path.
-pub const RELOAD_ROUTE_PLACEHOLDER: &str = "__RELOAD_ROUTE__";
+pub(crate) const RELOAD_ROUTE_PLACEHOLDER: &str = "__RELOAD_ROUTE__";
 
 /// Placeholder token used in HTML templates for the inlined wasm-bindgen JS bridge.
 ///
@@ -15,7 +25,7 @@ pub const RELOAD_ROUTE_PLACEHOLDER: &str = "__RELOAD_ROUTE__";
 /// wrapped in a synchronous IIFE that fetches the wasm module and calls
 /// `main()`. This eliminates the separate HTTP request for the JS bridge file
 /// and skips ES module graph parsing on the critical path.
-pub const INLINE_JS_PLACEHOLDER: &str = "__EUV_INLINE_JS__";
+pub(crate) const INLINE_JS_PLACEHOLDER: &str = "__EUV_INLINE_JS__";
 
 /// Placeholder token used in HTML templates for the `<base href="..."/>` tag.
 ///
@@ -25,104 +35,91 @@ pub const INLINE_JS_PLACEHOLDER: &str = "__EUV_INLINE_JS__";
 /// resource the HTML references — against the euv serving root rather
 /// than the page URL. This makes the dev server robust to users landing
 /// on `http://host:port/` instead of `http://host:port/www/`.
-pub const BASE_HREF_PLACEHOLDER: &str = "__EUV_BASE_HREF_TAG__";
+pub(crate) const BASE_HREF_PLACEHOLDER: &str = "__EUV_BASE_HREF_TAG__";
 
 /// Environment variable to disable JS bridge inlining and fall back to the
 /// classic `<script type="module">import init, { main } from '__IMPORT_PATH__'`
 /// bootstrap. Set to any non-empty value to opt out (e.g. when the wasm-pack
 /// output structure changes and the inline pipeline can't recover).
-pub const EUV_NO_INLINE_BRIDGE_ENV: &str = "EUV_NO_INLINE_BRIDGE";
+pub(crate) const EUV_NO_INLINE_BRIDGE_ENV: &str = "EUV_NO_INLINE_BRIDGE";
 
 /// The URL path for the reload endpoint.
 ///
 /// Used by the live-reload script in the HTML template and the server route registration.
-pub const RELOAD_ROUTE: &str = "/__euv_reload";
+pub(crate) const RELOAD_ROUTE: &str = "/__euv_reload";
 
 /// The wasm-pack flag indicating a release build.
-pub const RELEASE_FLAG: &str = "--release";
+pub(crate) const RELEASE_FLAG: &str = "--release";
 
 /// The CLI command name for wasm-pack.
-pub const WASM_PACK_COMMAND: &str = "wasm-pack";
+pub(crate) const WASM_PACK_COMMAND: &str = "wasm-pack";
 
 /// The wasm-pack subcommand for building.
-pub const WASM_PACK_BUILD_SUBCOMMAND: &str = "build";
+pub(crate) const WASM_PACK_BUILD_SUBCOMMAND: &str = "build";
 
 /// The wasm-pack argument for specifying the output directory.
-pub const OUT_DIR_ARG: &str = "--out-dir";
+pub(crate) const OUT_DIR_ARG: &str = "--out-dir";
 
 /// The wasm-pack argument for specifying the output name.
-pub const OUT_NAME_ARG: &str = "--out-name";
+pub(crate) const OUT_NAME_ARG: &str = "--out-name";
 
 /// The wasm-pack argument for specifying the target.
-pub const TARGET_ARG: &str = "--target";
+pub(crate) const TARGET_ARG: &str = "--target";
 
 /// The default wasm-pack target for browser usage.
-pub const TARGET_WEB: &str = "web";
-
-/// The default output subdirectory name for wasm-pack artifacts.
-pub const PKG_DIR_NAME: &str = "pkg";
+pub(crate) const TARGET_WEB: &str = "web";
 
 /// The JavaScript file extension.
-pub const JS_EXTENSION: &str = ".js";
+pub(crate) const JS_EXTENSION: &str = ".js";
 
 /// The source directory name within a Cargo project.
-pub const SRC_DIR_NAME: &str = "src";
+pub(crate) const SRC_DIR_NAME: &str = "src";
 
 /// The name of the gitignore file.
-pub const GITIGNORE_FILE_NAME: &str = ".gitignore";
+pub(crate) const GITIGNORE_FILE_NAME: &str = ".gitignore";
 
 /// The name of the Cargo manifest file.
-pub const CARGO_TOML_FILE_NAME: &str = "Cargo.toml";
-
-/// The index HTML file name.
-pub const INDEX_HTML_FILE_NAME: &str = "index.html";
+pub(crate) const CARGO_TOML_FILE_NAME: &str = "Cargo.toml";
 
 /// The relative path prefix used for import path construction.
-pub const RELATIVE_PATH_PREFIX: &str = "./";
+pub(crate) const RELATIVE_PATH_PREFIX: &str = "./";
 
 /// The path separator used for joining path components.
-pub const PATH_SEPARATOR: &str = "/";
+pub(crate) const PATH_SEPARATOR: &str = "/";
 
 /// The parent directory indicator used in relative path computation.
-pub const PARENT_DIR: &str = "..";
-
-/// The hyphen character used when normalizing crate names to wasm-pack's
-/// underscore output convention.
-pub const STR_HYPHEN: &str = "-";
+pub(crate) const PARENT_DIR: &str = "..";
 
 /// The underscore character used when normalizing crate names to wasm-pack's
 /// output convention.
-pub const STR_UNDERSCORE: &str = "_";
+pub(crate) const STR_UNDERSCORE: &str = "_";
 
 /// The wasm-pack flag for development builds.
-pub const DEV_FLAG: &str = "--dev";
+pub(crate) const DEV_FLAG: &str = "--dev";
 
 /// The wasm-pack flag for profiling builds.
-pub const PROFILING_FLAG: &str = "--profiling";
+pub(crate) const PROFILING_FLAG: &str = "--profiling";
 
 /// The euv-specific argument for specifying the crate path.
-pub const CRATE_PATH_ARG: &str = "--crate-path";
+pub(crate) const CRATE_PATH_ARG: &str = "--crate-path";
 
 /// The short form of the crate-path argument.
-pub const CRATE_PATH_ARG_SHORT: &str = "-c";
-
-/// The euv-specific argument for specifying the server port.
-pub const PORT_ARG: &str = "--port";
+pub(crate) const CRATE_PATH_ARG_SHORT: &str = "-c";
 
 /// The short form of the port argument.
-pub const PORT_ARG_SHORT: &str = "-p";
+pub(crate) const PORT_ARG_SHORT: &str = "-p";
 
 /// The euv-specific argument for specifying the www directory.
-pub const WWW_DIR_ARG: &str = "--www-dir";
+pub(crate) const WWW_DIR_ARG: &str = "--www-dir";
 
 /// The euv-specific argument for specifying a custom index.html template.
-pub const INDEX_HTML_ARG: &str = "--index-html";
+pub(crate) const INDEX_HTML_ARG: &str = "--index-html";
 
 /// The euv-specific argument for removing the .gitignore file from the output directory.
-pub const NO_GITIGNORE_ARG: &str = "--no-gitignore";
+pub(crate) const NO_GITIGNORE_ARG: &str = "--no-gitignore";
 
 /// The euv-specific argument names that should not be forwarded to wasm-pack.
-pub const EUV_ARGS: &[&str] = &[
+pub(crate) const EUV_ARGS: &[&str] = &[
     CRATE_PATH_ARG,
     CRATE_PATH_ARG_SHORT,
     PORT_ARG,
@@ -133,19 +130,19 @@ pub const EUV_ARGS: &[&str] = &[
 ];
 
 /// The double-dash separator used to distinguish euv args from wasm-pack args.
-pub const DOUBLE_DASH: &str = "--";
+pub(crate) const DOUBLE_DASH: &str = "--";
 
 /// The `run` action name used in banner display.
-pub const ACTION_RUN: &str = "run";
+pub(crate) const ACTION_RUN: &str = "run";
 
 /// The `build` action name used in banner display.
-pub const ACTION_BUILD: &str = "build";
+pub(crate) const ACTION_BUILD: &str = "build";
 
 /// The environment variable name for setting the minimum stack size of rustc threads.
-pub const RUST_MIN_STACK_ENV: &str = "RUST_MIN_STACK";
+pub(crate) const RUST_MIN_STACK_ENV: &str = "RUST_MIN_STACK";
 
 /// The minimum stack size in bytes for rustc threads (16 MiB).
-pub const RUST_MIN_STACK_VALUE: &str = "16777216";
+pub(crate) const RUST_MIN_STACK_VALUE: &str = "16777216";
 
 /// The `index.html` template for the development profile.
 ///
@@ -156,7 +153,7 @@ pub const RUST_MIN_STACK_VALUE: &str = "16777216";
 /// - `{"type":"Error","message":"..."}` — a build error occurred.
 ///
 /// The `__IMPORT_PATH__` placeholder is replaced with the resolved JS import path at runtime.
-pub const INDEX_HTML_DEV: &str = r#"<!doctype html>
+pub(crate) const INDEX_HTML_DEV: &str = r#"<!doctype html>
 <html lang="en">
   <head>
     <meta charset="utf-8" />
@@ -228,7 +225,7 @@ __EUV_INLINE_JS__
 /// A minimal `index.html` without any live-reload instrumentation.
 /// Used when building for release to produce a clean, static entry point.
 /// The `__IMPORT_PATH__` placeholder is replaced with the resolved JS import path at runtime.
-pub const INDEX_HTML_RELEASE: &str = r#"<!doctype html>
+pub(crate) const INDEX_HTML_RELEASE: &str = r#"<!doctype html>
 <html lang="en">
   <head>
     <meta charset="utf-8" />
@@ -273,3 +270,6 @@ __EUV_INLINE_JS__
   </script>
 </html>
 "#;
+
+/// The euv-specific argument for specifying the server port.
+pub(crate) const PORT_ARG: &str = "--port";

cli/src/build/fn.rs

@@ -48,8 +48,17 @@ pub fn filter_euv_args(wasm_pack_args: &[String]) -> Vec<String> {
             skip_next = false;
             continue;
         }
-        if EUV_ARGS.contains(&arg.as_str()) {
-            if arg.contains('=') {
+        // Compare the flag NAME, not the whole argument: clap accepts both
+        // `--port 3000` and `--port=3000`, and only the first form ever
+        // matched `EUV_ARGS` exactly. Without the split, `--port=3000` was
+        // forwarded to wasm-pack even though `reconcile_args` had already
+        // consumed its value — the same string both used and leaked.
+        let name: &str = arg.split('=').next().unwrap_or(arg.as_str());
+        if EUV_ARGS.contains(&name) {
+            if arg.contains('=') || name == NO_GITIGNORE_ARG {
+                // `--no-gitignore` is a bare boolean: there is no value to
+                // skip, so treating it like `--port 3000` ate whatever
+                // argument followed it.
                 continue;
             }
             skip_next = true;
@@ -341,7 +350,7 @@ pub fn resolve_out_name(args: &ModeArgs) -> String {
 ///
 /// - `Option<String>` - The crate name if found.
 fn read_crate_name_from_toml(path: &Path) -> Option<String> {
-    let content: String = std::fs::read_to_string(path).ok()?;
+    let content: String = sync_read_to_string(path).ok()?;
     let mut in_package: bool = false;
     for line in content.lines() {
         let trimmed: &str = line.trim();
@@ -740,7 +749,7 @@ pub async fn build_wasm(args: &ModeArgs) -> Result<(), EuvError> {
     let display_args: Vec<String> = (if has_existing_build_mode {
         filtered_args.to_vec()
     } else {
-        std::iter::once(build_mode_flag.to_string())
+        once(build_mode_flag.to_string())
             .chain(filtered_args.iter().cloned())
             .collect::<Vec<String>>()
     })
@@ -901,7 +910,7 @@ pub(crate) async fn build_inline_bridge(
     js_name: &str,
     wasm_url: &str,
 ) -> Result<String, EuvError> {
-    let js_path: std::path::PathBuf = pkg_dir.join(js_name);
+    let js_path: PathBuf = pkg_dir.join(js_name);
     let bridge_source: String =
         read_to_string(&js_path)
             .await
@@ -958,7 +967,7 @@ pub(crate) fn build_module_fallback_bridge(import_path: &str) -> String {
 ///
 /// - `bool` - `true` if the env var is set to a non-empty value.
 pub(crate) fn inline_bridge_disabled() -> bool {
-    matches!(std::env::var(EUV_NO_INLINE_BRIDGE_ENV), Ok(value) if !value.is_empty())
+    matches!(var(EUV_NO_INLINE_BRIDGE_ENV), Ok(value) if !value.is_empty())
 }
 
 /// Collects the source of every module the bridge imports, inlined in
@@ -1008,7 +1017,7 @@ async fn collect_snippet_bodies(bridge_source: &str, pkg_dir: &Path) -> Result<S
         }
     }
     for ns in &namespace_imports {
-        let snippet_path: std::path::PathBuf = resolve_snippet_path(pkg_dir, &ns.spec)?;
+        let snippet_path: PathBuf = resolve_snippet_path(pkg_dir, &ns.spec)?;
         let exports: Vec<String> = if snippet_path.exists() {
             let raw: String = read_to_string(&snippet_path)
                 .await
@@ -1153,7 +1162,7 @@ pub fn extract_import_spec(rest: &str) -> Option<&str> {
 /// - `Result<Option<String>, EuvError>` - The stripped body, `None` if the
 ///   file does not exist, or an error if it cannot be read or decoded.
 async fn read_snippet_module(pkg_dir: &Path, spec: &str) -> Result<Option<String>, EuvError> {
-    let snippet_path: std::path::PathBuf = resolve_snippet_path(pkg_dir, spec)?;
+    let snippet_path: PathBuf = resolve_snippet_path(pkg_dir, spec)?;
     if !snippet_path.exists() {
         return Ok(None);
     }
@@ -1181,11 +1190,11 @@ async fn read_snippet_module(pkg_dir: &Path, spec: &str) -> Result<Option<String
 ///
 /// # Returns
 ///
-/// - `Result<std::path::PathBuf, EuvError>` - The resolved path, or an error if the
+/// - `Result<PathBuf, EuvError>` - The resolved path, or an error if the
 ///   specifier climbs above `pkg_dir`.
-fn resolve_snippet_path(pkg_dir: &Path, spec: &str) -> Result<std::path::PathBuf, EuvError> {
+fn resolve_snippet_path(pkg_dir: &Path, spec: &str) -> Result<PathBuf, EuvError> {
     let base: &str = spec.trim_start_matches('.').trim_start_matches('/');
-    let mut path: std::path::PathBuf = pkg_dir.to_path_buf();
+    let mut path: PathBuf = pkg_dir.to_path_buf();
     for segment in base.split('/') {
         if segment.is_empty() || segment == "." {
             continue;