feat: support loading config from explicit path

packages/rstack/src/config.ts

@@ -24,6 +24,15 @@ type LoadedRstackConfig = {
   dependencies: string[];
 };
 
+type LoadRstackConfigOptions = {
+  /**
+   * The path to the Rstack config file, can be a relative or absolute path.
+   * If `configFilePath` is not provided, the config path set by the CLI is used.
+   * If neither path is provided, the function will search for the config file in the current working directory.
+   */
+  configFilePath?: string;
+};
+
 type ConfigState = {
   configs: Configs;
   configPath?: string;
@@ -108,17 +117,20 @@ export const define: Define = {
   staged: (config) => setConfig('staged', config),
 };
 
-export const loadRstackConfig = async (): Promise<LoadedRstackConfig> => {
+export const loadRstackConfig = async ({
+  configFilePath,
+}: LoadRstackConfigOptions = {}): Promise<LoadedRstackConfig> => {
   const state = getConfigState();
+  const configPath = configFilePath ?? state.configPath;
   state.configs = {};
 
   try {
     const { filePath, dependencies } = await loadConfig({
       loader: 'native',
       exportName: false,
       fresh: true,
-      ...(state.configPath !== undefined
-        ? { path: state.configPath }
+      ...(configPath !== undefined
+        ? { path: configPath }
         : {
             configFileNames: [
               'rstack.config.ts',

packages/rstack/tests/config/load-config/explicit.config.ts

@@ -0,0 +1,3 @@
+import { define } from 'rstack';
+
+define.app({});

packages/rstack/tests/config/load-config/index.test.ts

@@ -0,0 +1,28 @@
+import path from 'node:path';
+import { afterEach, expect, test } from 'rstack/test';
+import { getConfigState, loadRstackConfig } from '../../../src/config.ts';
+
+const state = getConfigState();
+
+afterEach(() => {
+  state.configs = {};
+  delete state.configPath;
+});
+
+test('should reset config state before and after loading', async () => {
+  state.configs = { app: {} };
+  state.configPath = path.join(import.meta.dirname, 'rstack.config.ts');
+
+  await expect(loadRstackConfig()).rejects.toThrow('test config error');
+  expect(state.configs).toEqual({});
+});
+
+test('should prefer an explicit config path over the state config path', async () => {
+  const configFilePath = path.join(import.meta.dirname, 'explicit.config.ts');
+  state.configPath = path.join(import.meta.dirname, 'rstack.config.ts');
+
+  const { configs, filePath } = await loadRstackConfig({ configFilePath });
+
+  expect(configs.app).toEqual({});
+  expect(filePath).toBe(configFilePath);
+});