chore: update

Author: Timeless0911

package.json

@@ -20,8 +20,8 @@
     "test:benchmark": "cd ./tests && pnpm run test:benchmark",
     "test:e2e": "pnpm run build:examples && cd tests && pnpm run test:e2e",
     "test:ecosystem-ci": "pnpm run test:unit && cross-env ECO_CI=1 pnpm run test:integration && pnpm run test:e2e",
-    "test:integration": "rstest run --project integration --exclude tests/integration/exe/**",
-    "test:integration:exe": "rstest run --project integration tests/integration/exe/**",
+    "test:integration": "rstest run --project integration",
+    "test:integration:exe": "rstest run --project integration-exe",
     "test:unit": "rstest run --project unit*",
     "testu": "pnpm run test:unit -u && pnpm run test:integration -u",
     "type-check": "pnpm -r run type-check",

packages/core/src/exe/download.ts

@@ -1,5 +1,8 @@
 import fs from 'node:fs';
 import path from 'node:path';
+import { Readable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+import type { ReadableStream as WebReadableStream } from 'node:stream/web';
 import type { ExeArch, ExePlatform } from '../types';
 import type { NormalizedExeTarget, ResolvedExeTarget } from './types';
 import { readBinaryVersion, runCommand } from './utils';
@@ -56,9 +59,23 @@ const downloadArchive = async (url: string, archivePath: string) => {
     );
   }
 
-  const arrayBuffer = await response.arrayBuffer();
+  if (!response.body) {
+    throw new Error(
+      `Failed to download "${url}" for "experiments.exe": response body is empty.`,
+    );
+  }
+
   await fs.promises.mkdir(path.dirname(archivePath), { recursive: true });
-  await fs.promises.writeFile(archivePath, Buffer.from(arrayBuffer));
+
+  try {
+    await pipeline(
+      Readable.fromWeb(response.body as WebReadableStream<Uint8Array>),
+      fs.createWriteStream(archivePath),
+    );
+  } catch (error) {
+    await fs.promises.rm(archivePath, { force: true });
+    throw error;
+  }
 };
 
 const extractArchive = async ({

packages/core/src/exe/index.ts

@@ -15,11 +15,9 @@ import {
   normalizeNodeVersion,
 } from './version';
 
-const normalizeTargetsInput = (exe?: ExeOptions): ExeTargetInput[] => {
-  if (!exe) {
-    return [];
-  }
+type EnabledExeOptions = Exclude<ExeOptions, false | undefined>;
 
+const normalizeTargetsInput = (exe: EnabledExeOptions): ExeTargetInput[] => {
   if (exe === true) {
     return [{}];
   }
@@ -28,7 +26,7 @@ const normalizeTargetsInput = (exe?: ExeOptions): ExeTargetInput[] => {
 };
 
 export const resolveExeTargets = (
-  exe?: ExeOptions,
+  exe: EnabledExeOptions,
   root: string = process.cwd(),
 ): NormalizedExeTarget[] => {
   const currentPlatform = getCurrentExePlatform();
@@ -156,14 +154,14 @@ export const composeExeConfig = ({
   sourceEntry,
   target,
 }: ComposeExeConfigOptions): ComposedExeConfig => {
-  const normalizedTargets = resolveExeTargets(exe, root);
-
-  if (normalizedTargets.length === 0) {
+  if (!exe) {
     return {
       config: {},
     };
   }
 
+  const normalizedTargets = resolveExeTargets(exe, root);
+
   validateExeTargets({
     bundle,
     targets: normalizedTargets,

packages/core/tests/exe.test.ts

@@ -45,6 +45,33 @@ const withSupportedNodeRuntime = async <T>(fn: () => Promise<T>) => {
   }
 };
 
+const withUnsupportedExeHost = async <T>(fn: () => Promise<T>) => {
+  const originalPlatform = process.platform;
+  const originalArch = process.arch;
+
+  Object.defineProperty(process, 'platform', {
+    value: 'freebsd',
+    configurable: true,
+  });
+  Object.defineProperty(process, 'arch', {
+    value: 'riscv64',
+    configurable: true,
+  });
+
+  try {
+    return await fn();
+  } finally {
+    Object.defineProperty(process, 'platform', {
+      value: originalPlatform,
+      configurable: true,
+    });
+    Object.defineProperty(process, 'arch', {
+      value: originalArch,
+      configurable: true,
+    });
+  }
+};
+
 describe('experiments.exe', () => {
   test('should detect supported Node.js versions', () => {
     expect(isExeSupportedNodeVersion('25.7.0')).toBe(true);
@@ -125,6 +152,16 @@ describe('experiments.exe', () => {
     );
   });
 
+  test('should not validate host exe capabilities when exe is disabled', async () => {
+    await expect(
+      withUnsupportedExeHost(() =>
+        composeTestRslibConfig({
+          format: 'esm',
+        }),
+      ),
+    ).resolves.toBeTruthy();
+  });
+
   test('should resolve outputPath separately from fileName', () => {
     const resolved = resolveExecutableOutputPath({
       environment: {

rstest.config.ts

@@ -33,7 +33,13 @@ export const shared: RstestConfig = {
 };
 
 export default defineConfig({
-  projects: ['packages/*', 'tests'],
+  projects: [
+    'packages/*',
+    'tests/rstest.config.ts',
+    // Keep exe tests in a separate project so eco CI can skip these slower SEA
+    // cases, while the workflow can still run them in parallel as a dedicated job.
+    'tests/rstest.exe.config.ts',
+  ],
   pool: {
     // Leave some workers available for DTS tests to spawn sub processes
     maxWorkers: '80%',

scripts/dictionary.txt

@@ -103,6 +103,7 @@ pxtorem
 quxx
 rebranded
 reduxjs
+riscv
 rolldown
 rootdir
 rsbuild

tests/package.json

@@ -6,6 +6,7 @@
     "test": "rstest",
     "test:benchmark": "rstest bench",
     "test:e2e": "playwright test --pass-with-no-tests",
+    "test:exe": "rstest -c rstest.exe.config.ts",
     "type-check": "tsc --noEmit"
   },
   "dependencies": {

tests/rstest.config.ts

@@ -7,7 +7,7 @@ export default defineConfig({
   name: 'integration',
   setupFiles: ['./setupRstestTests.ts'],
   include: ['./integration/**/*.test.ts'],
-  exclude: ['**/node_modules/**'],
+  exclude: ['**/node_modules/**', './integration/exe/*.test.ts'],
   // TODO: Support benchmark in Rstest.
   // benchmark: {
   //   include: ['./benchmark/**/*.bench.ts'],

tests/rstest.exe.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from '@rstest/core';
+import { shared } from '../rstest.config';
+
+export default defineConfig({
+  ...shared,
+  name: 'integration-exe',
+  setupFiles: ['./setupRstestTests.ts'],
+  include: ['./integration/exe/*.test.ts'],
+});

website/docs/en/config/lib/experiments.mdx

@@ -175,6 +175,14 @@ For string targets, Rslib treats the value as a custom Node.js executable path.
 
 This also means that when multiple targets are enabled, the version resolved from a custom binary path affects the suffix of the final output file name.
 
+:::info macOS target signing
+
+`darwin` targets are only signed automatically when the build itself runs on macOS.
+
+If you generate a macOS executable on Linux or Windows, the output remains unsigned. In most cases, you need to sign it on macOS before it can run normally.
+
+:::
+
 Here is an example that generates executables for multiple platforms in a single build:
 
 ```ts title="rslib.config.ts"