react-cosmos 6.0.0-alpha.9 → 6.0.0-beta.1

package/bin/cosmos-export.js

@@ -3,9 +3,7 @@
 // Set the env before any code reads it
 process.env.NODE_ENV = process.env.NODE_ENV || 'production';
 
-const { generateExport } = await import(
-  '../dist/server/export/generateExport.js'
-);
+const { generateExport } = await import('../dist/export/generateExport.js');
 
 generateExport().catch(err => {
   console.log('[Cosmos] Export failed...');

package/bin/cosmos-native.js

@@ -3,9 +3,7 @@
 // Set the env before any code reads it
 process.env.NODE_ENV = process.env.NODE_ENV || 'development';
 
-const { startDevServer } = await import(
-  '../dist/server/devServer/startDevServer.js'
-);
+const { startDevServer } = await import('../dist/devServer/startDevServer.js');
 
 startDevServer('native').catch(err => {
   console.log('[Cosmos] Server crashed...');

package/bin/cosmos.js

@@ -3,13 +3,7 @@
 // Set the env before any code reads it
 process.env.NODE_ENV = process.env.NODE_ENV || 'development';
 
-const { startDevServer } = await import(
-  '../dist/server/devServer/startDevServer.js'
-);
-
-// Auto disable Fast Refresh in CRA 4 until integration is implemented
-// https://github.com/react-cosmos/react-cosmos/issues/1272
-process.env.FAST_REFRESH = process.env.FAST_REFRESH || false;
+const { startDevServer } = await import('../dist/devServer/startDevServer.js');
 
 startDevServer('web').catch(err => {
   console.log('[Cosmos] Server crashed...');

package/client.d.ts

@@ -0,0 +1 @@
+export * from './dist/client.js';

package/client.js

@@ -0,0 +1 @@
+export * from './dist/client.js';

package/config.schema.json

@@ -1,7 +1,5 @@
 {
-  "$schema": "http://json-schema.org/draft-04/schema",
-  "title": "JSON schema for React Cosmos configs",
-  "type": "object",
+  "$schema": "http://json-schema.org/draft-04/schema#",
   "additionalProperties": false,
   "properties": {
     "$schema": {
@@ -22,7 +20,7 @@
       "type": "boolean"
     },
     "disablePlugins": {
-      "description": "Disable all plugins 3rd party plugins",
+      "description": "Disable plugins",
       "type": "boolean"
     },
     "staticPath": {
@@ -37,7 +35,7 @@
       "uniqueItems": true
     },
     "publicUrl": {
-      "description": "Base URL for static assets. [default: \"/\"]",
+      "description": "Base URL for static assets. [default: \"\"]",
       "type": "string"
     },
     "fixturesDir": {
@@ -65,10 +63,13 @@
       },
       "uniqueItems": true
     },
-    "userDepsFilePath": {
-      "description": "Where to generate a file that contains a map to all fixtures and other Cosmos-related user modules. Only used in setups where Cosmos can't piggyback on the user's build (eg. React Native setups). [default: \"cosmos.userdeps.js\"]",
-      "type": "string",
-      "minLength": 1
+    "lazy": {
+      "description": "Dynamically import fixture and decorator modules as they are loaded. When false all fixture and decorator modules are imported statically and bundled together. [default: false]",
+      "type": "boolean"
+    },
+    "exposeImports": {
+      "description": "Expose user imports and config required for the Cosmos renderer. Used with React Native and in custom integrations. When a path is specified it requires a file extension (eg. \"src/cosmos.imports.ts\"). [default: false]",
+      "anyOf": [{ "type": "string", "minLength": 1 }, { "type": "boolean" }]
     },
     "hostname": {
       "description": "Dev server hostname. Set to null to accept connections with any hostname. [default: null]",
@@ -78,12 +79,16 @@
       "description": "Dev server port. [default: 5000]",
       "type": "number"
     },
+    "portRetries": {
+      "description": "Max number of port retries. [default: 10]",
+      "type": "number"
+    },
     "https": {
-      "description": "Server will be served over HTTPS",
+      "description": "Server will be served over HTTPS.",
       "type": "boolean"
     },
     "httpsOptions": {
-      "description": "Additional options for HTTPS server",
+      "description": "Additional options for HTTPS server.",
       "type": "object",
       "additionalProperties": false,
       "properties": {
@@ -135,7 +140,19 @@
     },
     "rendererUrl": {
       "description": "Required when renderer doesn't run on the same port (or host) as the Playground. Useful for integrations with build tools. [default: null]",
-      "anyOf": [{ "type": "string", "minLength": 1 }, { "type": "null" }]
+      "anyOf": [
+        { "type": "string", "minLength": 1 },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["dev", "export"],
+          "properties": {
+            "dev": { "type": "string", "minLength": 1 },
+            "export": { "type": "string", "minLength": 1 }
+          }
+        },
+        { "type": "null" }
+      ]
     },
     "dom": {
       "description": "DOM-related options",
@@ -148,17 +165,36 @@
         }
       }
     },
+    "vite": {
+      "description": "Vite-related options",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "configPath": {
+          "description": "Path to Vite config. Set to false to disable reading it from the default path. [default: \"vite.config.js\"]",
+          "anyOf": [{ "type": "string", "minLength": 1 }, { "enum": [false] }]
+        },
+        "indexPath": {
+          "description": "Path to index module (eg. \"src/my-index.tsx\"). [default: matches common index/main module paths]",
+          "anyOf": [{ "type": "string", "minLength": 1 }, { "type": "null" }]
+        },
+        "port": {
+          "description": "Vite renderer port. [default: 5050]",
+          "type": "number"
+        }
+      }
+    },
     "webpack": {
       "description": "Webpack-related options",
       "type": "object",
       "additionalProperties": false,
       "properties": {
         "configPath": {
-          "description": "Path to an existing webpack config, which Cosmos will reuse to build your code. Set to null to disable this behavior. [default \"webpack.config.js\"]",
+          "description": "Path to an existing webpack config, which Cosmos will reuse to build your code. Set to null to disable this behavior. [default: \"webpack.config.js\"]",
           "anyOf": [{ "type": "string", "minLength": 1 }, { "type": "null" }]
         },
         "overridePath": {
-          "description": "Path to a user module that customizes the webpack config used by Cosmos. Set to null to disable this behavior. [default \"webpack.override.js\"]",
+          "description": "Path to a user module that customizes the webpack config used by Cosmos. Set to null to disable this behavior. [default: \"webpack.override.js\"]",
           "anyOf": [{ "type": "string", "minLength": 1 }, { "type": "null" }]
         },
         "includeHashInOutputFilename": {
@@ -202,5 +238,7 @@
         }
       }
     }
-  }
+  },
+  "title": "JSON schema for React Cosmos configs",
+  "type": "object"
 }

package/dist/cjsMocks/requireModule.js

@@ -0,0 +1,7 @@
+// CJS mock for packages/react-cosmos/src/utils/requireModule.ts
+export function requireModule(moduleId) {
+    return require(moduleId);
+}
+export function requireFrom(fromDirectory, moduleId) {
+    return require(require.resolve(moduleId, { paths: [fromDirectory] }));
+}

package/dist/cjsMocks/resolve.js

@@ -0,0 +1,7 @@
+// CJS mock for packages/react-cosmos/src/utils/resolve.ts
+export function resolve(moduleId) {
+    return require.resolve(moduleId);
+}
+export function resolveFrom(fromDirectory, moduleId) {
+    return require.resolve(moduleId, { paths: [fromDirectory] });
+}

package/dist/cjsMocks/staticPath.js

@@ -0,0 +1,4 @@
+// CJS mock for packages/react-cosmos/src/shared/staticPath.ts
+export function getStaticPath(relPath) {
+    return require.resolve(`../static/${relPath}`);
+}

package/dist/client.d.ts

@@ -0,0 +1 @@
+export { Viewport, useSelect, useValue } from 'react-cosmos-renderer/client';

package/dist/client.js

@@ -0,0 +1 @@
+export { Viewport, useSelect, useValue } from 'react-cosmos-renderer/client';

package/dist/corePlugins/exposeImports.d.ts

@@ -0,0 +1,2 @@
+import { CosmosServerPlugin } from '../cosmosPlugin/types.js';
+export declare const exposeImportsServerPlugin: CosmosServerPlugin;

package/dist/corePlugins/exposeImports.js

@@ -0,0 +1,53 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { pickRendererUrl, } from 'react-cosmos-core';
+import { getPlaygroundUrl } from '../shared/playgroundUrl.js';
+import { startFixtureWatcher } from '../userModules/fixtureWatcher.js';
+import { generateUserImports } from '../userModules/generateUserImports.js';
+import { moduleExists } from '../utils/fs.js';
+export const exposeImportsServerPlugin = {
+    name: 'exposeImports',
+    async devServer({ cosmosConfig, platform }) {
+        if (!shouldExposeImports(platform, cosmosConfig))
+            return;
+        await generateImportsFile(cosmosConfig, 'dev');
+        const watcher = await startFixtureWatcher(cosmosConfig, 'all', () => {
+            generateImportsFile(cosmosConfig, 'dev');
+        });
+        return () => {
+            watcher.close();
+        };
+    },
+    async export({ cosmosConfig }) {
+        if (shouldExposeImports('web', cosmosConfig)) {
+            await generateImportsFile(cosmosConfig, 'export');
+        }
+    },
+};
+function shouldExposeImports(platform, cosmosConfig) {
+    return platform === 'native' || Boolean(cosmosConfig.exposeImports);
+}
+async function generateImportsFile(cosmosConfig, command) {
+    const { exposeImports } = cosmosConfig;
+    const filePath = typeof exposeImports === 'string'
+        ? exposeImports
+        : getDefaultFilePath(cosmosConfig.rootDir);
+    const typeScript = /\.tsx?$/.test(filePath);
+    const rendererConfig = {
+        playgroundUrl: getPlaygroundUrl(cosmosConfig),
+        rendererUrl: pickRendererUrl(cosmosConfig.rendererUrl, command),
+    };
+    const fileSource = generateUserImports({
+        cosmosConfig,
+        rendererConfig,
+        relativeToDir: path.dirname(filePath),
+        typeScript,
+    });
+    await fs.writeFile(filePath, fileSource, 'utf8');
+    const relModulesPath = path.relative(process.cwd(), filePath);
+    console.log(`[Cosmos] Generated ${relModulesPath}`);
+}
+function getDefaultFilePath(rootDir) {
+    const ext = moduleExists('typescript') ? 'ts' : 'js';
+    return path.join(rootDir, `cosmos.imports.${ext}`);
+}

package/dist/corePlugins/httpProxy.d.ts

@@ -0,0 +1,2 @@
+import { CosmosServerPlugin } from '../cosmosPlugin/types.js';
+export declare const httpProxyServerPlugin: CosmosServerPlugin;

package/dist/corePlugins/httpProxy.js

@@ -0,0 +1,21 @@
+import { createProxyMiddleware } from 'http-proxy-middleware';
+export const httpProxyServerPlugin = {
+    name: 'httpProxy',
+    devServer({ cosmosConfig, platform, expressApp }) {
+        if (platform !== 'web')
+            return;
+        const httpProxyConfig = getHttpProxyCosmosConfig(cosmosConfig);
+        Object.keys(httpProxyConfig).forEach(context => {
+            const config = httpProxyConfig[context];
+            if (typeof config === 'string') {
+                expressApp.use(context, createProxyMiddleware(context, { target: config }));
+            }
+            else if (typeof config === 'object') {
+                expressApp.use(context, createProxyMiddleware(context, config));
+            }
+        });
+    },
+};
+function getHttpProxyCosmosConfig(cosmosConfig) {
+    return (cosmosConfig.httpProxy || {});
+}

package/dist/corePlugins/index.d.ts

@@ -0,0 +1,2 @@
+import { CosmosServerPlugin } from '../cosmosPlugin/types.js';
+export declare const coreServerPlugins: CosmosServerPlugin[];

package/dist/corePlugins/index.js

@@ -0,0 +1,12 @@
+import { exposeImportsServerPlugin } from './exposeImports.js';
+import { httpProxyServerPlugin } from './httpProxy.js';
+import { openFileServerPlugin } from './openFile.js';
+import { pluginEndpointServerPlugin } from './pluginEndpoint.js';
+import { portRetryServerPlugin } from './portRetry.js';
+export const coreServerPlugins = [
+    portRetryServerPlugin,
+    exposeImportsServerPlugin,
+    httpProxyServerPlugin,
+    openFileServerPlugin,
+    pluginEndpointServerPlugin,
+];

package/dist/corePlugins/openFile.d.ts

@@ -0,0 +1,2 @@
+import { CosmosServerPlugin } from '../cosmosPlugin/types.js';
+export declare const openFileServerPlugin: CosmosServerPlugin;

package/dist/corePlugins/openFile.js

@@ -0,0 +1,59 @@
+import launchEditor from '@skidding/launch-editor';
+import fs from 'fs';
+import open from 'open';
+import path from 'path';
+export const openFileServerPlugin = {
+    name: 'openFile',
+    devServer({ cosmosConfig, expressApp }) {
+        expressApp.get('/_open', (req, res) => {
+            const { filePath, line, column } = getReqQuery(req);
+            if (!filePath) {
+                res.status(400).send(`File path missing`);
+                return;
+            }
+            const absFilePath = resolveFilePath(cosmosConfig.rootDir, filePath);
+            if (!fs.existsSync(absFilePath)) {
+                res.status(404).send(`File not found at path: ${absFilePath}`);
+                return;
+            }
+            new Promise((resolve, reject) => {
+                const file = `${absFilePath}:${line}:${column}`;
+                launchEditor(file, (fileName, errorMsg) => reject(errorMsg));
+                // If launchEditor doesn't report error within 500ms we assume it worked
+                setTimeout(resolve, 500);
+            })
+                // Fall back to open in case launchEditor fails. launchEditor only works
+                // when the editor app is already open, but is favorable because it can
+                // open a code file on a specific line & column.
+                .catch(err => open(absFilePath))
+                .catch(err => {
+                console.log(err);
+                res.status(500).send('Failed to open file');
+            })
+                .then(() => res.send());
+        });
+    },
+};
+function getReqQuery(req) {
+    const { filePath, line, column } = req.query;
+    if (typeof filePath !== 'string')
+        throw new Error('filePath missing');
+    return {
+        filePath,
+        line: typeof line === 'string' ? parseInt(line, 10) : 1,
+        column: typeof column === 'string' ? parseInt(column, 10) : 1,
+    };
+}
+function resolveFilePath(rootDir, filePath) {
+    // This heuristic is needed because the open file endpoint is used for
+    // multiple applications, which provide different file path types:
+    // 1. Edit fixture button: Sends path relative to Cosmos rootDir
+    // 2. react-error-overlay runtime error: Sends absolute path
+    // 3. react-error-overlay compile error: Sends path relative to CWD
+    if (path.isAbsolute(filePath)) {
+        return filePath;
+    }
+    const cosmosRelPath = path.join(rootDir, filePath);
+    const cwdRelPath = path.join(process.cwd(), filePath);
+    return fs.existsSync(cosmosRelPath) ? cosmosRelPath : cwdRelPath;
+}

package/dist/corePlugins/pluginEndpoint.d.ts

@@ -0,0 +1,2 @@
+import { CosmosServerPlugin } from '../cosmosPlugin/types.js';
+export declare const pluginEndpointServerPlugin: CosmosServerPlugin;

package/dist/corePlugins/pluginEndpoint.js

@@ -0,0 +1,22 @@
+import path from 'node:path';
+import { resolveSilent } from '../utils/resolveSilent.js';
+export const pluginEndpointServerPlugin = {
+    name: 'pluginEndpoint',
+    devServer({ expressApp }) {
+        expressApp.get('/_plugin/*.js', (req, res) => {
+            const modulePath = req.params['0'];
+            if (!modulePath) {
+                res.sendStatus(404);
+                return;
+            }
+            // The module path is always absolute, but Windows paths don't start
+            // with a slash (e.g. C:\foo\bar.js)
+            const resolvedPath = resolveSilent(path.isAbsolute(modulePath) ? modulePath : `/${modulePath}`);
+            if (!resolvedPath) {
+                res.sendStatus(404);
+                return;
+            }
+            res.sendFile(resolvedPath);
+        });
+    },
+};

package/dist/corePlugins/portRetry.d.ts

@@ -0,0 +1,2 @@
+import { CosmosServerPlugin } from '../cosmosPlugin/types.js';
+export declare const portRetryServerPlugin: CosmosServerPlugin;

package/dist/corePlugins/portRetry.js

@@ -0,0 +1,14 @@
+import { findNextAvailablePort } from '../shared/findNextAvailablePort.js';
+export const portRetryServerPlugin = {
+    name: 'portRetry',
+    async config({ cosmosConfig, command }) {
+        if (command === 'export') {
+            return cosmosConfig;
+        }
+        const { port, portRetries } = cosmosConfig;
+        return {
+            ...cosmosConfig,
+            port: portRetries ? await findNextAvailablePort(port, portRetries) : port,
+        };
+    },
+};

package/dist/{server/cosmosConfig → cosmosConfig}/createCosmosConfig.js

@@ -5,9 +5,10 @@ export function createCosmosConfig(rootDir, cosmosConfigInput = {}) {
     return {
         ...cosmosConfigInput,
         rootDir,
-        exportPath: getExportPath(cosmosConfigInput, rootDir),
         detectLocalPlugins: cosmosConfigInput.detectLocalPlugins ?? true,
         disablePlugins: cosmosConfigInput.disablePlugins ?? false,
+        exposeImports: getExposeImports(cosmosConfigInput, rootDir),
+        exportPath: getExportPath(cosmosConfigInput, rootDir),
         fixtureFileSuffix: getFixtureFileSuffix(cosmosConfigInput),
         fixturesDir: getFixturesDir(cosmosConfigInput),
         globalImports: getGlobalImports(cosmosConfigInput, rootDir),
@@ -15,13 +16,15 @@ export function createCosmosConfig(rootDir, cosmosConfigInput = {}) {
         https: getHttps(cosmosConfigInput),
         httpsOptions: getHttpsOptions(cosmosConfigInput, rootDir),
         ignore: getIgnore(cosmosConfigInput),
-        port: getPort(cosmosConfigInput),
+        lazy: getLazy(cosmosConfigInput),
         plugins: getPlugins(cosmosConfigInput, rootDir),
-        publicUrl: getPublicUrl(cosmosConfigInput),
+        port: getPort(cosmosConfigInput),
+        portRetries: getPortRetries(cosmosConfigInput),
+        publicUrl: cosmosConfigInput.publicUrl ?? '',
+        rendererUrl: cosmosConfigInput.rendererUrl ?? null,
         staticPath: getStaticPath(cosmosConfigInput, rootDir),
-        userDepsFilePath: getUserDepsFilePath(cosmosConfigInput, rootDir),
         watchDirs: getWatchDirs(cosmosConfigInput, rootDir),
-        rendererUrl: cosmosConfigInput.rendererUrl ?? null,
+        dom: getDomConfig(cosmosConfigInput.dom || {}),
         ui: cosmosConfigInput.ui || {},
     };
 }
@@ -50,9 +53,6 @@ function getHttpsOptions(cosmosConfigInput, rootDir) {
 function getIgnore({ ignore = [] }) {
     return ['**/node_modules/**', ...ignore];
 }
-function getPublicUrl({ publicUrl = '/' }) {
-    return publicUrl;
-}
 function getFixturesDir({ fixturesDir = '__fixtures__' }) {
     return fixturesDir;
 }
@@ -63,9 +63,18 @@ function getWatchDirs(cosmosConfigInput, rootDir) {
     const { watchDirs = ['.'] } = cosmosConfigInput;
     return watchDirs.map(watchDir => path.resolve(rootDir, watchDir));
 }
-function getUserDepsFilePath(cosmosConfigInput, rootDir) {
-    const { userDepsFilePath = 'cosmos.userdeps.js' } = cosmosConfigInput;
-    return path.resolve(rootDir, userDepsFilePath);
+function getExposeImports(cosmosConfigInput, rootDir) {
+    const cliArgs = getCliArgs();
+    if (typeof cliArgs.exposeImports === 'boolean') {
+        return cliArgs.exposeImports;
+    }
+    else if (typeof cliArgs.exposeImports === 'string') {
+        return path.resolve(rootDir, cliArgs.exposeImports);
+    }
+    const { exposeImports = false } = cosmosConfigInput;
+    return typeof exposeImports === 'string'
+        ? path.resolve(rootDir, exposeImports)
+        : exposeImports;
 }
 function getHostname({ hostname = null }) {
     return hostname;
@@ -78,6 +87,9 @@ function getPort(cosmosConfigInput) {
     const { port = 5000 } = cosmosConfigInput;
     return port;
 }
+function getPortRetries({ portRetries = 10 }) {
+    return portRetries;
+}
 function getGlobalImports(cosmosConfigInput, rootDir) {
     const { globalImports = [] } = cosmosConfigInput;
     return globalImports.map(globalImport => resolveLoose(rootDir, globalImport));
@@ -86,3 +98,17 @@ function getPlugins(cosmosConfigInput, rootDir) {
     const { plugins = [] } = cosmosConfigInput;
     return plugins.map(plugin => resolveLoose(rootDir, plugin));
 }
+function getDomConfig(cosmosConfigInput) {
+    const { containerQuerySelector = null } = cosmosConfigInput;
+    return {
+        containerQuerySelector,
+    };
+}
+function getLazy(cosmosConfigInput) {
+    const cliArgs = getCliArgs();
+    if (typeof cliArgs.lazy === 'boolean') {
+        return cliArgs.lazy;
+    }
+    const { lazy = false } = cosmosConfigInput;
+    return lazy;
+}

package/dist/{server/cosmosConfig → cosmosConfig}/shared.js

@@ -1,7 +1,7 @@
-import { importModule } from '../utils/fs.js';
+import { importJson } from '../utils/fs.js';
 export function getCurrentDir() {
     return process.cwd();
 }
 export async function importConfigFile(cosmosConfigPath) {
-    return importModule(cosmosConfigPath);
+    return importJson(cosmosConfigPath);
 }

package/dist/{server/cosmosConfig → cosmosConfig}/types.d.ts

@@ -2,10 +2,15 @@ interface HttpsOptions {
     keyPath: string;
     certPath: string;
 }
+export type CosmosDomConfig = {
+    containerQuerySelector: null | string;
+};
 export type CosmosConfig = {
     exportPath: string;
     detectLocalPlugins: boolean;
     disablePlugins: boolean;
+    dom: CosmosDomConfig;
+    exposeImports: boolean | string;
     fixtureFileSuffix: string;
     fixturesDir: string;
     globalImports: string[];
@@ -13,18 +18,23 @@ export type CosmosConfig = {
     https: boolean;
     httpsOptions: null | HttpsOptions;
     ignore: string[];
+    lazy: boolean;
     port: number;
+    portRetries: number;
     plugins: string[];
     publicUrl: string;
-    rendererUrl: string | null;
+    rendererUrl: null | string | {
+        dev: string;
+        export: string;
+    };
     rootDir: string;
     staticPath: null | string;
-    userDepsFilePath: string;
     watchDirs: string[];
     [option: string]: unknown;
     ui: {
         [pluginName: string]: {};
     };
 };
+export type CosmosDomConfigInput = Partial<CosmosDomConfig>;
 export type CosmosConfigInput = Partial<CosmosConfig>;
 export {};

package/dist/{server/cosmosPlugin → cosmosPlugin}/findCosmosPluginConfigs.js

@@ -1,4 +1,4 @@
-import glob from 'glob';
+import { globSync } from 'glob';
 import { readCosmosPluginConfig } from './readCosmosPluginConfig.js';
 export async function findCosmosPluginConfigs({ rootDir, relativePaths, ignore, }) {
     const configPaths = findCosmosPluginConfigPaths(rootDir, ignore);
@@ -6,7 +6,7 @@ export async function findCosmosPluginConfigs({ rootDir, relativePaths, ignore,
 }
 const defaultIgnore = ['**/node_modules/**'];
 function findCosmosPluginConfigPaths(rootDir, ignore = defaultIgnore) {
-    return glob.sync('**/cosmos.plugin.json', {
+    return globSync('**/cosmos.plugin.json', {
         cwd: rootDir,
         absolute: true,
         ignore,

package/dist/{server/cosmosPlugin → cosmosPlugin}/readCosmosPluginConfig.js

@@ -1,8 +1,8 @@
 import path from 'path';
-import { importModule } from '../utils/fs.js';
+import { importJson } from '../utils/fs.js';
 import { resolveSilent } from '../utils/resolveSilent.js';
 export async function readCosmosPluginConfig({ rootDir, configPath, relativePaths, }) {
-    const rawConfig = await importModule(configPath);
+    const rawConfig = await importJson(configPath);
     const pluginRootDir = path.dirname(configPath);
     const config = {
         name: rawConfig.name,
@@ -13,11 +13,8 @@ export async function readCosmosPluginConfig({ rootDir, configPath, relativePath
     if (rawConfig.ui) {
         config.ui = resolvePluginPath(config.name, rootDir, pluginRootDir, rawConfig.ui, relativePaths);
     }
-    if (rawConfig.devServer) {
-        config.devServer = resolvePluginPath(config.name, rootDir, pluginRootDir, rawConfig.devServer, relativePaths);
-    }
-    if (rawConfig.export) {
-        config.export = resolvePluginPath(config.name, rootDir, pluginRootDir, rawConfig.export, relativePaths);
+    if (rawConfig.server) {
+        config.server = resolvePluginPath(config.name, rootDir, pluginRootDir, rawConfig.server, relativePaths);
     }
     return config;
 }

package/dist/{server/cosmosPlugin → cosmosPlugin}/types.d.ts

@@ -1,12 +1,18 @@
 /// <reference types="node" />
 import express from 'express';
 import http from 'http';
-import { MessageType } from 'react-cosmos-core';
+import { CosmosCommand, MessageType } from 'react-cosmos-core';
 import { CosmosConfig } from '../cosmosConfig/types.js';
-export type PlatformType = 'web' | 'native';
+export type CosmosPlatform = 'web' | 'native';
+export type CosmosConfigPluginArgs = {
+    cosmosConfig: CosmosConfig;
+    command: CosmosCommand;
+    platform: CosmosPlatform;
+};
+export type CosmosConfigPlugin = (args: CosmosConfigPluginArgs) => Promise<CosmosConfig> | CosmosConfig;
 export type DevServerPluginArgs = {
     cosmosConfig: CosmosConfig;
-    platformType: PlatformType;
+    platform: CosmosPlatform;
     httpServer: http.Server;
     expressApp: express.Express;
     sendMessage(msg: MessageType): unknown;
@@ -19,3 +25,9 @@ export type ExportPluginArgs = {
     cosmosConfig: CosmosConfig;
 };
 export type ExportPlugin = (args: ExportPluginArgs) => unknown;
+export type CosmosServerPlugin = {
+    name: string;
+    config?: CosmosConfigPlugin;
+    devServer?: DevServerPlugin;
+    export?: ExportPlugin;
+};

package/dist/devServer/expressApp.d.ts

@@ -0,0 +1,5 @@
+import express from 'express';
+import { CosmosPluginConfig } from 'react-cosmos-core';
+import { CosmosConfig } from '../cosmosConfig/types.js';
+import { CosmosPlatform } from '../cosmosPlugin/types.js';
+export declare function createExpressApp(platform: CosmosPlatform, cosmosConfig: CosmosConfig, pluginConfigs: CosmosPluginConfig[]): Promise<express.Express>;