react-cosmos 6.0.0-canary.fe0c7d1.0 → 6.0.0

package/README.md

@@ -1,7 +1,41 @@
 <p align="center">
-  <a href="https://reactcosmos.org"><img alt="Cosmos" width="150" height="150" src="https://raw.githubusercontent.com/react-cosmos/react-cosmos/main/cosmos.png"></a>
+  <a href="https://reactcosmos.org"><img alt="Cosmos" width="150" height="150" src="cosmos.png"></a>
+  <h1 align="center">React Cosmos</h1>
 </p>
 
-# React Cosmos
+<p align="center">
+  <a aria-label="npm version" href="https://www.npmjs.com/package/react-cosmos"><img src="https://img.shields.io/npm/v/react-cosmos/next.svg?style=flat&colorA=000000&colorB=000000" alt="" /></a>
+  <a aria-label="CI Status" href="https://github.com/react-cosmos/react-cosmos/actions/workflows/test.yml"><img src="https://img.shields.io/github/actions/workflow/status/react-cosmos/react-cosmos/test.yml?branch=main&style=flat&colorA=000000&colorB=000000" alt="" /></a>
+  <a aria-label="Codecov" href="https://app.codecov.io/gh/react-cosmos/react-cosmos"><img src="https://img.shields.io/codecov/c/github/react-cosmos/react-cosmos?colorA=000000&colorB=000000" alt="" /></a>
+  <a aria-label="Twitter" href="https://twitter.com/ReactCosmos"><img src="https://img.shields.io/badge/twitter-follow-%2300acee?colorA=000000&colorB=000000" alt="" /></a>
+  <a aria-label="Discord" href="https://discord.gg/3X95VgfnW5"><img src="https://img.shields.io/discord/620737684859781150?label=discord&logo=discord&logoColor=ffffff&colorA=000000&colorB=000000" alt="" /></a>
+  <a aria-label="PRs Welcome" href="https://github.com/react-cosmos/react-cosmos/blob/main/CONTRIBUTING.md#how-to-contribute"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg?colorA=000000&colorB=000000" alt="" /></a>
+</p>
+
+## Getting Started
+
+Choose one of the [Getting Started](https://reactcosmos.org/docs/getting-started) guides to dive into React Cosmos.
+
+> Check out the [Next.js integration](https://reactcosmos.org/docs/getting-started/next) to get started with React Server Components.
+
+Visit [reactcosmos.org/docs](https://reactcosmos.org/docs) to view the full documentation.
+
+## Community
+
+To chat with other community members you can join the [React Cosmos Discord](https://discord.gg/3X95VgfnW5).
+
+You can also ask questions, voice ideas, and share your projects on [GitHub Discussions](https://github.com/react-cosmos/react-cosmos/discussions).
+
+Our [Code of Conduct](/CODE_OF_CONDUCT.md) applies to all React Cosmos community channels.
+
+## Contributing
+
+Please see our [CONTRIBUTING.md](/CONTRIBUTING.md).
+
+[Become a Sponsor](https://github.com/users/skidding/sponsorship) to support the ongoing development of React Cosmos.
+
+## Live Demo
+
+Visit [reactcosmos.org/demo/](https://reactcosmos.org/demo/) for a live demo of React Cosmos.
 
-Sandbox for developing and testing UI components in isolation.
+[![React Cosmos](/docs/public/demo.png)](https://reactcosmos.org/demo/)

package/bin/cosmos.js

@@ -5,10 +5,6 @@ process.env.NODE_ENV = process.env.NODE_ENV || 'development';
 
 const { startDevServer } = await import('../dist/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;
-
 startDevServer('web').catch(err => {
   console.log('[Cosmos] Server crashed...');
   console.log(`\n  (╯°□°)╯︵ ┻━┻\n`);

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": {
@@ -13,16 +11,16 @@
       "minLength": 1
     },
     "exportPath": {
-      "description": "Where to generate static exports on disk. [default: \"cosmos-export\"]",
+      "description": "Output directory for static exports. [default: \"cosmos-export\"]",
       "type": "string",
       "minLength": 1
     },
     "detectLocalPlugins": {
-      "description": "Automatically detect and load local plugins",
+      "description": "Automatically detect and load local plugins. [default: true]",
       "type": "boolean"
     },
     "disablePlugins": {
-      "description": "Disable all plugins 3rd party plugins",
+      "description": "Disable plugins. [default: false]",
       "type": "boolean"
     },
     "staticPath": {
@@ -37,11 +35,11 @@
       "uniqueItems": true
     },
     "publicUrl": {
-      "description": "Base URL for static assets. [default: \"/\"]",
+      "description": "Base URL for static assets. [default: \"\"]",
       "type": "string"
     },
     "fixturesDir": {
-      "description": "Name for directories that contain fixtures (eg. __fixtures__/example.jsx). [default: \"__fixtures__\"]",
+      "description": "Name for directories that contain fixture files (eg. __fixtures__/example.jsx). [default: \"__fixtures__\"]",
       "type": "string",
       "minLength": 1
     },
@@ -51,7 +49,7 @@
       "minLength": 1
     },
     "ignore": {
-      "description": "Patterns for ignoring fixture and decorator files (eg. [\"**/dist/**\"]]).",
+      "description": "Patterns for ignoring fixture and decorator files (eg. [\"**/dist/**\"]).",
       "type": "array",
       "items": { "type": "string", "minLength": 1 },
       "uniqueItems": true
@@ -69,10 +67,9 @@
       "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"
     },
-    "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
+    "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]",
@@ -96,17 +93,17 @@
       "additionalProperties": false,
       "properties": {
         "certPath": {
-          "description": "Path of a certificate file",
+          "description": "Path of a certificate file.",
           "type": "string"
         },
         "keyPath": {
-          "description": "Path of a certificate's key file",
+          "description": "Path of a certificate's key file.",
           "type": "string"
         }
       }
     },
     "httpProxy": {
-      "description": "Proxy some URLs to a different HTTP server (eg. an API backend dev server). Similar to devServer.proxy in webpack config.",
+      "description": "Proxy some URLs to a different HTTP server (eg. an API backend dev server).",
       "type": "object",
       "additionalProperties": true,
       "patternProperties": {
@@ -143,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",
@@ -162,11 +171,11 @@
       "additionalProperties": false,
       "properties": {
         "configPath": {
-          "description": "Path to Vite config. Set to false to disable reading it from the default path. [default: \"vite.config.js\"]",
+          "description": "Path to Vite config. Set to false to disable reading it from the default path. [default: \"vite.config.js\" or \"vite.config.ts\"]",
           "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]",
+          "description": "Path to index module (eg. \"src/my-index.tsx\"). [default: detects common index/main module paths]",
           "anyOf": [{ "type": "string", "minLength": 1 }, { "type": "null" }]
         },
         "port": {
@@ -229,5 +238,7 @@
         }
       }
     }
-  }
+  },
+  "title": "JSON schema for React Cosmos configs",
+  "type": "object"
 }

package/dist/cjsMocks/requireModule.d.ts

@@ -0,0 +1,2 @@
+export declare function requireModule(moduleId: string): any;
+export declare function requireFrom(fromDirectory: string, moduleId: string): any;

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.d.ts

@@ -0,0 +1,2 @@
+export declare function resolve(moduleId: string): string;
+export declare function resolveFrom(fromDirectory: string, moduleId: string): string;

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.d.ts

@@ -0,0 +1 @@
+export declare function getStaticPath(relPath: string): string;

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 { FixtureContext, Viewport, useFixtureState, useSelect, useValue, } from 'react-cosmos-renderer/client';

package/dist/client.js

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

package/dist/corePlugins/{openFile.d.ts → fixtureWatcherPlugin.d.ts}

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

package/dist/corePlugins/fixtureWatcherPlugin.js

@@ -0,0 +1,63 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { pickRendererUrl, } from 'react-cosmos-core';
+import { getPlaygroundUrl } from '../shared/playgroundUrl.js';
+import { updateFixtureListCache } from '../shared/serverFixtureList.js';
+import { findUserModulePaths } from '../userModules/findUserModulePaths.js';
+import { startFixtureWatcher } from '../userModules/fixtureWatcher.js';
+import { generateUserImports } from '../userModules/generateUserImports.js';
+import { moduleExists } from '../utils/fs.js';
+export const fixtureWatcherPlugin = {
+    name: 'fixtureWatcher',
+    async devServer({ cosmosConfig, platform }) {
+        const exposeImports = shouldExposeImports(platform, cosmosConfig);
+        if (exposeImports) {
+            const modulePaths = findUserModulePaths(cosmosConfig);
+            await generateImportsFile(cosmosConfig, 'dev', modulePaths);
+        }
+        const watcher = await startFixtureWatcher(cosmosConfig, 'all', () => {
+            const modulePaths = findUserModulePaths(cosmosConfig);
+            updateFixtureListCache(cosmosConfig.rootDir, modulePaths.fixturePaths);
+            if (exposeImports) {
+                generateImportsFile(cosmosConfig, 'dev', modulePaths);
+            }
+        });
+        return async () => {
+            await watcher.close();
+        };
+    },
+    async export({ cosmosConfig }) {
+        if (shouldExposeImports('web', cosmosConfig)) {
+            const modulePaths = findUserModulePaths(cosmosConfig);
+            await generateImportsFile(cosmosConfig, 'export', modulePaths);
+        }
+    },
+};
+function shouldExposeImports(platform, cosmosConfig) {
+    return platform === 'native' || Boolean(cosmosConfig.exposeImports);
+}
+async function generateImportsFile(cosmosConfig, command, modulePaths) {
+    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,
+        modulePaths,
+        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/httpProxyPlugin.d.ts

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

package/dist/corePlugins/{httpProxy.js → httpProxyPlugin.js}

@@ -1,8 +1,8 @@
 import { createProxyMiddleware } from 'http-proxy-middleware';
-export const httpProxyServerPlugin = {
+export const httpProxyPlugin = {
     name: 'httpProxy',
-    devServer({ platformType, cosmosConfig, expressApp }) {
-        if (platformType !== 'web')
+    devServer({ cosmosConfig, platform, expressApp }) {
+        if (platform !== 'web')
             return;
         const httpProxyConfig = getHttpProxyCosmosConfig(cosmosConfig);
         Object.keys(httpProxyConfig).forEach(context => {

package/dist/corePlugins/index.js

@@ -1,12 +1,15 @@
-import { httpProxyServerPlugin } from './httpProxy.js';
-import { openFileServerPlugin } from './openFile.js';
-import { pluginEndpointServerPlugin } from './pluginEndpoint.js';
-import { portRetryServerPlugin } from './portRetry.js';
-import { userDepsFileServerPlugin } from './userDepsFile.js';
+import { fixtureWatcherPlugin } from './fixtureWatcherPlugin.js';
+import { httpProxyPlugin } from './httpProxyPlugin.js';
+import { openFilePlugin } from './openFilePlugin.js';
+import { pluginEndpointPlugin } from './pluginEndpointPlugin.js';
+import { portRetryPlugin } from './portRetryPlugin.js';
 export const coreServerPlugins = [
-    portRetryServerPlugin,
-    userDepsFileServerPlugin,
-    httpProxyServerPlugin,
-    openFileServerPlugin,
-    pluginEndpointServerPlugin,
+    portRetryPlugin,
+    httpProxyPlugin,
+    openFilePlugin,
+    pluginEndpointPlugin,
 ];
+// Omit starting chokidar in Jest tests for performance reasons
+if (process.env.JEST_WORKER_ID === undefined) {
+    coreServerPlugins.push(fixtureWatcherPlugin);
+}

package/dist/corePlugins/openFilePlugin.d.ts

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

package/dist/corePlugins/{openFile.js → openFilePlugin.js}

@@ -2,7 +2,7 @@ import launchEditor from '@skidding/launch-editor';
 import fs from 'fs';
 import open from 'open';
 import path from 'path';
-export const openFileServerPlugin = {
+export const openFilePlugin = {
     name: 'openFile',
     devServer({ cosmosConfig, expressApp }) {
         expressApp.get('/_open', (req, res) => {

package/dist/corePlugins/pluginEndpointPlugin.d.ts

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

package/dist/corePlugins/{pluginEndpoint.js → pluginEndpointPlugin.js}

@@ -1,6 +1,6 @@
 import path from 'node:path';
 import { resolveSilent } from '../utils/resolveSilent.js';
-export const pluginEndpointServerPlugin = {
+export const pluginEndpointPlugin = {
     name: 'pluginEndpoint',
     devServer({ expressApp }) {
         expressApp.get('/_plugin/*.js', (req, res) => {

package/dist/corePlugins/portRetryPlugin.d.ts

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

package/dist/corePlugins/{portRetry.js → portRetryPlugin.js}

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

package/dist/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),
@@ -16,14 +17,13 @@ export function createCosmosConfig(rootDir, cosmosConfigInput = {}) {
         httpsOptions: getHttpsOptions(cosmosConfigInput, rootDir),
         ignore: getIgnore(cosmosConfigInput),
         lazy: getLazy(cosmosConfigInput),
+        plugins: getPlugins(cosmosConfigInput, rootDir),
         port: getPort(cosmosConfigInput),
         portRetries: getPortRetries(cosmosConfigInput),
-        plugins: getPlugins(cosmosConfigInput, rootDir),
-        publicUrl: getPublicUrl(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 || {},
     };
@@ -53,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;
 }
@@ -66,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;

package/dist/cosmosConfig/types.d.ts

@@ -10,6 +10,7 @@ export type CosmosConfig = {
     detectLocalPlugins: boolean;
     disablePlugins: boolean;
     dom: CosmosDomConfig;
+    exposeImports: boolean | string;
     fixtureFileSuffix: string;
     fixturesDir: string;
     globalImports: string[];
@@ -22,10 +23,12 @@ export type CosmosConfig = {
     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: {

package/dist/cosmosPlugin/types.d.ts

@@ -1,17 +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;
-    platformType: PlatformType;
+    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;

package/dist/devServer/expressApp.d.ts

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

package/dist/devServer/expressApp.js

@@ -2,11 +2,10 @@ import express from 'express';
 import { getDevPlaygroundHtml } from '../shared/playgroundHtml.js';
 import { getStaticPath } from '../shared/staticPath.js';
 import { resolve } from '../utils/resolve.js';
-export async function createExpressApp(platformType, cosmosConfig, pluginConfigs) {
+export async function createExpressApp(platform, cosmosConfig, pluginConfigs) {
     const app = express();
-    const playgroundHtml = await getDevPlaygroundHtml(platformType, cosmosConfig, pluginConfigs);
-    app.get('/', (req, res) => {
-        res.send(playgroundHtml);
+    app.get('/', async (req, res) => {
+        res.send(await getDevPlaygroundHtml(platform, cosmosConfig, pluginConfigs));
     });
     app.get('/playground.bundle.js', (req, res) => {
         res.sendFile(resolve('react-cosmos-ui/dist/playground.bundle.js'));

package/dist/devServer/startDevServer.d.ts

@@ -1,2 +1,2 @@
-import { PlatformType } from '../cosmosPlugin/types.js';
-export declare function startDevServer(platformType: PlatformType): Promise<() => Promise<void>>;
+import { CosmosPlatform } from '../cosmosPlugin/types.js';
+export declare function startDevServer(platform: CosmosPlatform): Promise<() => Promise<void>>;

package/dist/devServer/startDevServer.js

@@ -1,14 +1,14 @@
 import path from 'path';
-import { coreServerPlugins } from '../corePlugins/index.js';
 import { detectCosmosConfig, detectCosmosConfigPath, } from '../cosmosConfig/detectCosmosConfig.js';
 import { getPluginConfigs } from '../cosmosPlugin/pluginConfigs.js';
-import { importServerPlugins } from '../shared/importServerPlugins.js';
+import { applyServerConfigPlugins } from '../shared/applyServerConfigPlugins.js';
+import { getServerPlugins } from '../shared/getServerPlugins.js';
 import { logPluginInfo } from '../shared/logPluginInfo.js';
 import { serveStaticDir } from '../shared/staticServer.js';
 import { createExpressApp } from './expressApp.js';
 import { createHttpServer } from './httpServer.js';
 import { createMessageHandler } from './messageHandler.js';
-export async function startDevServer(platformType) {
+export async function startDevServer(platform) {
     let cosmosConfig = await detectCosmosConfig();
     logCosmosConfigInfo();
     const pluginConfigs = await getPluginConfigs({
@@ -19,20 +19,14 @@ export async function startDevServer(platformType) {
         relativePaths: false,
     });
     logPluginInfo(pluginConfigs);
-    const userPlugins = await importServerPlugins(pluginConfigs, cosmosConfig.rootDir);
-    const plugins = [...coreServerPlugins, ...userPlugins];
-    for (const plugin of plugins) {
-        if (plugin.config) {
-            try {
-                cosmosConfig = await plugin.config({ cosmosConfig, platformType });
-            }
-            catch (err) {
-                console.log(`[Cosmos][plugin:${plugin.name}] Config hook failed`);
-                throw err;
-            }
-        }
-    }
-    const app = await createExpressApp(platformType, cosmosConfig, pluginConfigs);
+    const serverPlugins = await getServerPlugins(pluginConfigs, cosmosConfig.rootDir);
+    cosmosConfig = await applyServerConfigPlugins({
+        cosmosConfig,
+        serverPlugins,
+        command: 'dev',
+        platform,
+    });
+    const app = await createExpressApp(platform, cosmosConfig, pluginConfigs);
     const httpServer = await createHttpServer(cosmosConfig, app);
     const msgHandler = createMessageHandler(httpServer.server);
     if (cosmosConfig.staticPath) {
@@ -47,21 +41,21 @@ export async function startDevServer(platformType) {
         msgHandler.close();
         await httpServer.stop();
     }
-    for (const plugin of plugins) {
+    for (const plugin of serverPlugins) {
         try {
             if (!plugin.devServer)
                 continue;
             const pluginReturn = await plugin.devServer({
                 cosmosConfig,
-                platformType,
+                platform,
                 httpServer: httpServer.server,
                 expressApp: app,
                 sendMessage: msgHandler.sendMessage,
             });
             if (typeof pluginReturn === 'function') {
-                pluginCleanupCallbacks.push(() => {
+                pluginCleanupCallbacks.push(async () => {
                     try {
-                        pluginReturn();
+                        await pluginReturn();
                     }
                     catch (err) {
                         // Log when a plugin fails to clean up, but continue to attempt