@quilted/rollup 0.0.0-preview-20231014022518

package/build/typescript/app.d.ts

@@ -0,0 +1,163 @@
+import type { MagicModuleEnvOptions } from './env.ts';
+export interface AppOptions {
+    /**
+     * The entry module for this app. This should be an absolute path, or relative
+     * path from the root directory containing your project. This entry should just be
+     * for the main `App` component in your project, which Quilt will automatically use
+     * to create browser and server-side entries for your project.
+     *
+     * If you only want to use a custom entry module for the browser build, use the
+     * `browser.entry` option instead. If you only want to use a custom entry module
+     * for the server-side build, use the `server.entry` option instead.
+     *
+     * @example './App.tsx'
+     */
+    entry?: string;
+    /**
+     * Whether to include GraphQL-related code transformations.
+     *
+     * @default true
+     */
+    graphql?: boolean;
+    /**
+     * Customizes the behavior of environment variables for your application. You
+     * can further customize the environment variables provided during server-side
+     * rendering by passing `server.env`.
+     */
+    env?: MagicModuleEnvOptions;
+}
+export declare function quiltApp({ env, entry }?: AppOptions): {
+    name: string;
+    options(this: import("rollup").MinimalPluginContext, originalOptions: import("rollup").InputOptions): Promise<{
+        plugins: import("rollup").InputPluginOption[];
+        cache?: boolean | import("rollup").RollupCache | undefined;
+        context?: string | undefined;
+        experimentalCacheExpiry?: number | undefined;
+        experimentalLogSideEffects?: boolean | undefined;
+        external?: import("rollup").ExternalOption | undefined;
+        input?: import("rollup").InputOption | undefined;
+        logLevel?: import("rollup").LogLevelOption | undefined;
+        makeAbsoluteExternalsRelative?: boolean | "ifRelativeSource" | undefined;
+        maxParallelFileOps?: number | undefined;
+        moduleContext?: ((id: string) => string | import("rollup").NullValue) | {
+            [id: string]: string;
+        } | undefined;
+        onLog?: import("rollup").LogHandlerWithDefault | undefined;
+        onwarn?: import("rollup").WarningHandlerWithDefault | undefined;
+        perf?: boolean | undefined;
+        preserveEntrySignatures?: import("rollup").PreserveEntrySignaturesOption | undefined;
+        preserveSymlinks?: boolean | undefined;
+        shimMissingExports?: boolean | undefined;
+        strictDeprecations?: boolean | undefined;
+        treeshake?: boolean | import("rollup").TreeshakingPreset | import("rollup").TreeshakingOptions | undefined;
+        watch?: false | import("rollup").WatcherOptions | undefined;
+    }>;
+};
+export interface AppBrowserOptions {
+    /**
+     * Whether the app should use hydration or client-side rendering.
+     */
+    hydrate?: boolean;
+    /**
+     * The CSS selector to render or hydrate the application into.
+     */
+    selector?: string;
+}
+export declare function quiltAppBrowser(options?: AppBrowserOptions): {
+    name: string;
+    options(this: import("rollup").MinimalPluginContext, originalOptions: import("rollup").InputOptions): {
+        plugins: import("rollup").InputPluginOption[];
+        cache?: boolean | import("rollup").RollupCache | undefined;
+        context?: string | undefined;
+        experimentalCacheExpiry?: number | undefined;
+        experimentalLogSideEffects?: boolean | undefined;
+        external?: import("rollup").ExternalOption | undefined;
+        input?: import("rollup").InputOption | undefined;
+        logLevel?: import("rollup").LogLevelOption | undefined;
+        makeAbsoluteExternalsRelative?: boolean | "ifRelativeSource" | undefined;
+        maxParallelFileOps?: number | undefined;
+        moduleContext?: ((id: string) => string | import("rollup").NullValue) | {
+            [id: string]: string;
+        } | undefined;
+        onLog?: import("rollup").LogHandlerWithDefault | undefined;
+        onwarn?: import("rollup").WarningHandlerWithDefault | undefined;
+        perf?: boolean | undefined;
+        preserveEntrySignatures?: import("rollup").PreserveEntrySignaturesOption | undefined;
+        preserveSymlinks?: boolean | undefined;
+        shimMissingExports?: boolean | undefined;
+        strictDeprecations?: boolean | undefined;
+        treeshake?: boolean | import("rollup").TreeshakingPreset | import("rollup").TreeshakingOptions | undefined;
+        watch?: false | import("rollup").WatcherOptions | undefined;
+    };
+};
+export interface AppServerOptions {
+    /**
+     * The entry module for the server of this app. This module must export a
+     * `RequestRouter` object as its default export, which will be wrapped in
+     * the specific server runtime you configure.
+     */
+    entry?: string;
+}
+export declare function quiltAppServer(options?: AppServerOptions): {
+    name: string;
+    options(this: import("rollup").MinimalPluginContext, originalOptions: import("rollup").InputOptions): Promise<{
+        plugins: import("rollup").InputPluginOption[];
+        cache?: boolean | import("rollup").RollupCache | undefined;
+        context?: string | undefined;
+        experimentalCacheExpiry?: number | undefined;
+        experimentalLogSideEffects?: boolean | undefined;
+        external?: import("rollup").ExternalOption | undefined;
+        input?: import("rollup").InputOption | undefined;
+        logLevel?: import("rollup").LogLevelOption | undefined;
+        makeAbsoluteExternalsRelative?: boolean | "ifRelativeSource" | undefined;
+        maxParallelFileOps?: number | undefined;
+        moduleContext?: ((id: string) => string | import("rollup").NullValue) | {
+            [id: string]: string;
+        } | undefined;
+        onLog?: import("rollup").LogHandlerWithDefault | undefined;
+        onwarn?: import("rollup").WarningHandlerWithDefault | undefined;
+        perf?: boolean | undefined;
+        preserveEntrySignatures?: import("rollup").PreserveEntrySignaturesOption | undefined;
+        preserveSymlinks?: boolean | undefined;
+        shimMissingExports?: boolean | undefined;
+        strictDeprecations?: boolean | undefined;
+        treeshake?: boolean | import("rollup").TreeshakingPreset | import("rollup").TreeshakingOptions | undefined;
+        watch?: false | import("rollup").WatcherOptions | undefined;
+    }>;
+};
+export declare function magicModuleAppComponent({ entry }: {
+    entry: string;
+}): {
+    name: string;
+    resolveId(this: import("rollup").PluginContext, id: string): {
+        id: string;
+        moduleSideEffects: "no-treeshake" | undefined;
+    } | null;
+    load: ((this: import("rollup").PluginContext, source: string) => Promise<{
+        code: string;
+        moduleSideEffects: "no-treeshake" | undefined;
+    } | null>) | undefined;
+};
+export declare function magicModuleAppRequestRouter({ entry, }?: Pick<AppServerOptions, 'entry'>): {
+    name: string;
+    resolveId(this: import("rollup").PluginContext, id: string): {
+        id: string;
+        moduleSideEffects: "no-treeshake" | undefined;
+    } | null;
+    load: ((this: import("rollup").PluginContext, source: string) => Promise<{
+        code: string;
+        moduleSideEffects: "no-treeshake" | undefined;
+    } | null>) | undefined;
+};
+export declare function magicModuleAppBrowserEntry({ hydrate, selector, }?: AppBrowserOptions): {
+    name: string;
+    resolveId(this: import("rollup").PluginContext, id: string): {
+        id: string;
+        moduleSideEffects: "no-treeshake" | undefined;
+    } | null;
+    load: ((this: import("rollup").PluginContext, source: string) => Promise<{
+        code: string;
+        moduleSideEffects: "no-treeshake" | undefined;
+    } | null>) | undefined;
+};
+//# sourceMappingURL=app.d.ts.map

package/build/typescript/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../source/app.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,UAAU,CAAC;AAKpD,MAAM,WAAW,UAAU;IACzB;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,GAAG,CAAC,EAAE,qBAAqB,CAAC;CAC7B;AAED,wBAAgB,QAAQ,CAAC,EAAC,GAAG,EAAE,KAAK,EAAC,GAAE,UAAe;;;;;;;;;;;;;;;;;;;;;;;;;;EAiCrD;AAED,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE,iBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;EAmB9D;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,cAAc,CAAC,OAAO,GAAE,gBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;EAwB5D;AAED,wBAAgB,uBAAuB,CAAC,EAAC,KAAK,EAAC,EAAE;IAAC,KAAK,EAAE,MAAM,CAAA;CAAC;;;;;;;;;;EAM/D;AAED,wBAAgB,2BAA2B,CAAC,EAC1C,KAAK,GACN,GAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAM;;;;;;;;;;EAqCtC;AAED,wBAAgB,0BAA0B,CAAC,EACzC,OAAc,EACd,QAAiB,GAClB,GAAE,iBAAsB;;;;;;;;;;EA0BxB"}

package/build/typescript/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const MAGIC_MODULE_ENV = "quilt:module/env";
+export declare const MAGIC_MODULE_ENTRY = "quilt:module/entry";
+export declare const MAGIC_MODULE_APP_COMPONENT = "quilt:module/app";
+export declare const MAGIC_MODULE_BROWSER_ASSETS = "quilt:module/assets";
+export declare const MAGIC_MODULE_REQUEST_ROUTER = "quilt:module/request-router";
+//# sourceMappingURL=constants.d.ts.map

package/build/typescript/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../source/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AACnD,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AACvD,eAAO,MAAM,0BAA0B,qBAAqB,CAAC;AAC7D,eAAO,MAAM,2BAA2B,wBAAwB,CAAC;AACjE,eAAO,MAAM,2BAA2B,gCAAgC,CAAC"}

package/build/typescript/env.d.ts

@@ -0,0 +1,55 @@
+import type { PluginContext } from 'rollup';
+export declare function replaceProcessEnv({ mode, preserve, }: {
+    mode: string;
+    preserve?: boolean;
+}): import("rollup").Plugin<any>;
+export interface MagicModuleEnvOptions {
+    /**
+     * The runtime mode for your target environment.
+     */
+    mode?: 'production' | 'development';
+    /**
+     * Environment variables from the build environment to inline into the magic
+     * module. Be careful when using this option! Inlining environment variables
+     * into your application always comes with the risk of exposing sensitive information
+     * to your users. Only use this option for environment variables that are safe
+     * for a human to see if they open their browser developer tools.
+     */
+    inline?: string[];
+    /**
+     * A string that will be inlined directly as code to reference a runtime variable
+     * that contains environment variables.
+     */
+    runtime?: string;
+    /**
+     * Whether to load environment variables from a `.env` file. The option can
+     * be one of the following types:
+     *
+     * - `false`, which disables loading environment variables from a `.env` file.
+     * - An object containing a `roots` field, specifying the directories to search
+     * for `.env` files in.
+     * - An object containing a `files` field, specifying the directories to search
+     * for `.env` files in.
+     *
+     * @default {roots: ['.', 'configuration']}
+     */
+    dotenv?: false | {
+        roots?: string[];
+        files?: never;
+    } | {
+        roots?: never;
+        files?: string[];
+    };
+}
+export declare function magicModuleEnv({ mode, dotenv, inline, runtime, }?: MagicModuleEnvOptions): {
+    name: string;
+    resolveId(this: PluginContext, id: string): {
+        id: string;
+        moduleSideEffects: "no-treeshake" | undefined;
+    } | null;
+    load: ((this: PluginContext, source: string) => Promise<{
+        code: string;
+        moduleSideEffects: "no-treeshake" | undefined;
+    } | null>) | undefined;
+};
+//# sourceMappingURL=env.d.ts.map

package/build/typescript/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../source/env.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,QAAQ,CAAC;AAa1C,wBAAgB,iBAAiB,CAAC,EAChC,IAAI,EACJ,QAAe,GAChB,EAAE;IACD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,gCAQA;AAED,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,IAAI,CAAC,EAAE,YAAY,GAAG,aAAa,CAAC;IAEpC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAElB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EACH,KAAK,GACL;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAC,GACjC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;KAAC,CAAC;CACvC;AAED,wBAAgB,cAAc,CAAC,EAC7B,IAAI,EACJ,MAAwC,EACxC,MAAW,EACX,OAAc,GACf,GAAE,qBAA0B;;;;;;;;;;EA0C5B"}

package/build/typescript/index.d.ts

@@ -0,0 +1,4 @@
+export { magicModuleEnv, type MagicModuleEnvOptions } from './env.ts';
+export { quiltApp, quiltAppBrowser, quiltAppServer, magicModuleAppComponent, magicModuleAppBrowserEntry, magicModuleAppRequestRouter, type AppOptions, type AppBrowserOptions, type AppServerOptions, } from './app.ts';
+export { magicModuleRequestRouterEntry } from './request-router.ts';
+//# sourceMappingURL=index.d.ts.map

package/build/typescript/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../source/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,EAAE,KAAK,qBAAqB,EAAC,MAAM,UAAU,CAAC;AACpE,OAAO,EACL,QAAQ,EACR,eAAe,EACf,cAAc,EACd,uBAAuB,EACvB,0BAA0B,EAC1B,2BAA2B,EAC3B,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAC,6BAA6B,EAAC,MAAM,qBAAqB,CAAC"}

package/build/typescript/request-router.d.ts

@@ -0,0 +1,15 @@
+export declare function magicModuleRequestRouterEntry({ host, port, }?: {
+    host?: string;
+    port?: number;
+}): {
+    name: string;
+    resolveId(this: import("rollup").PluginContext, id: string): {
+        id: string;
+        moduleSideEffects: "no-treeshake" | undefined;
+    } | null;
+    load: ((this: import("rollup").PluginContext, source: string) => Promise<{
+        code: string;
+        moduleSideEffects: "no-treeshake" | undefined;
+    } | null>) | undefined;
+};
+//# sourceMappingURL=request-router.d.ts.map

package/build/typescript/request-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-router.d.ts","sourceRoot":"","sources":["../../source/request-router.ts"],"names":[],"mappings":"AAKA,wBAAgB,6BAA6B,CAAC,EAC5C,IAAI,EACJ,IAAI,GACL,GAAE;IACD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACV;;;;;;;;;;EAsBL"}

package/build/typescript/shared/magic-module.d.ts

@@ -0,0 +1,19 @@
+import type { PluginContext } from 'rollup';
+export declare function createMagicModulePlugin({ name, module, alias, source: getSource, sideEffects, }: {
+    readonly name: string;
+    readonly alias?: string;
+    readonly module: string;
+    readonly sideEffects?: boolean;
+    source?(this: PluginContext): string | Promise<string>;
+}): {
+    name: string;
+    resolveId(this: PluginContext, id: string): {
+        id: string;
+        moduleSideEffects: "no-treeshake" | undefined;
+    } | null;
+    load: ((this: PluginContext, source: string) => Promise<{
+        code: string;
+        moduleSideEffects: "no-treeshake" | undefined;
+    } | null>) | undefined;
+};
+//# sourceMappingURL=magic-module.d.ts.map

package/build/typescript/shared/magic-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"magic-module.d.ts","sourceRoot":"","sources":["../../../source/shared/magic-module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,aAAa,EAAC,MAAM,QAAQ,CAAC;AAKlD,wBAAgB,uBAAuB,CAAC,EACtC,IAAI,EACJ,MAAM,EACN,KAAoE,EACpE,MAAM,EAAE,SAAS,EACjB,WAAmB,GACpB,EAAE;IACD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,MAAM,CAAC,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACxD;;;;;;;;;;EAwBA"}

package/build/typescript/shared/rollup.d.ts

@@ -0,0 +1,5 @@
+import type { InputOptions } from 'rollup';
+import { type RollupReplaceOptions } from '@rollup/plugin-replace';
+export declare function smartReplace(values: NonNullable<RollupReplaceOptions['values']>, options?: Omit<RollupReplaceOptions, 'values'>): import("rollup").Plugin<any>;
+export declare function addRollupOnWarn(options: InputOptions, warn: NonNullable<InputOptions['onwarn']>): InputOptions;
+//# sourceMappingURL=rollup.d.ts.map

package/build/typescript/shared/rollup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollup.d.ts","sourceRoot":"","sources":["../../../source/shared/rollup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,QAAQ,CAAC;AACzC,OAAgB,EAAC,KAAK,oBAAoB,EAAC,MAAM,wBAAwB,CAAC;AAE1E,wBAAgB,YAAY,CAC1B,MAAM,EAAE,WAAW,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,EACnD,OAAO,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,CAAC,gCAY/C;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,WAAW,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,GACxC,YAAY,CAed"}

package/build/typescript/shared/strings.d.ts

@@ -0,0 +1,2 @@
+export declare function multiline(strings: TemplateStringsArray, ...values: any[]): string;
+//# sourceMappingURL=strings.d.ts.map

package/build/typescript/shared/strings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../../../source/shared/strings.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,UAgBxE"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@quilted/rollup",
+  "type": "module",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "@quilted/registry": "https://registry.npmjs.org"
+  },
+  "version": "0.0.0-preview-20231014022518",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lemonmade/quilt.git",
+    "directory": "packages/rollup"
+  },
+  "exports": {
+    ".": {
+      "types": "./build/typescript/index.d.ts",
+      "quilt:source": "./source/index.ts",
+      "quilt:esnext": "./build/esnext/index.esnext",
+      "import": "./build/esm/index.mjs",
+      "require": "./build/cjs/index.cjs"
+    }
+  },
+  "types": "./build/typescript/index.d.ts",
+  "sideEffects": false,
+  "dependencies": {
+    "@rollup/plugin-replace": "^5.0.0",
+    "dotenv": "^16.0.0"
+  },
+  "peerDependencies": {
+    "rollup": "^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "rollup": {
+      "optional": false
+    }
+  },
+  "devDependencies": {
+    "@quilted/testing": "^0.1.0",
+    "rollup": "^4.0.0"
+  },
+  "eslintConfig": {
+    "extends": [
+      "@quilted/eslint-config/project"
+    ]
+  },
+  "browserslist": [
+    "extends @quilted/browserslist-config/defaults"
+  ]
+}

package/quilt.project.ts

@@ -0,0 +1,5 @@
+import {createProject, quiltPackage} from '@quilted/craft';
+
+export default createProject((project) => {
+  project.use(quiltPackage({react: false}));
+});

package/source/app.ts

@@ -0,0 +1,225 @@
+import type {Plugin} from 'rollup';
+
+import {
+  MAGIC_MODULE_ENTRY,
+  MAGIC_MODULE_APP_COMPONENT,
+  MAGIC_MODULE_BROWSER_ASSETS,
+  MAGIC_MODULE_REQUEST_ROUTER,
+} from './constants.ts';
+import type {MagicModuleEnvOptions} from './env.ts';
+
+import {multiline} from './shared/strings.ts';
+import {createMagicModulePlugin} from './shared/magic-module.ts';
+
+export interface AppOptions {
+  /**
+   * The entry module for this app. This should be an absolute path, or relative
+   * path from the root directory containing your project. This entry should just be
+   * for the main `App` component in your project, which Quilt will automatically use
+   * to create browser and server-side entries for your project.
+   *
+   * If you only want to use a custom entry module for the browser build, use the
+   * `browser.entry` option instead. If you only want to use a custom entry module
+   * for the server-side build, use the `server.entry` option instead.
+   *
+   * @example './App.tsx'
+   */
+  entry?: string;
+
+  /**
+   * Whether to include GraphQL-related code transformations.
+   *
+   * @default true
+   */
+  graphql?: boolean;
+
+  /**
+   * Customizes the behavior of environment variables for your application. You
+   * can further customize the environment variables provided during server-side
+   * rendering by passing `server.env`.
+   */
+  env?: MagicModuleEnvOptions;
+}
+
+export function quiltApp({env, entry}: AppOptions = {}) {
+  return {
+    name: '@quilted/app',
+    async options(originalOptions) {
+      const newPlugins = [
+        ...(Array.isArray(originalOptions.plugins)
+          ? originalOptions.plugins
+          : originalOptions.plugins
+          ? [originalOptions.plugins]
+          : []),
+      ];
+
+      const newOptions = {...originalOptions, plugins: newPlugins};
+
+      if (env) {
+        const {magicModuleEnv, replaceProcessEnv} = await import('./env.ts');
+
+        if (typeof env === 'boolean') {
+          newPlugins.push(replaceProcessEnv({mode: 'production'}));
+          newPlugins.push(magicModuleEnv({mode: 'production'}));
+        } else {
+          newPlugins.push(replaceProcessEnv({mode: env.mode ?? 'production'}));
+          newPlugins.push(magicModuleEnv({mode: 'production', ...env}));
+        }
+      }
+
+      if (entry) {
+        newPlugins.push(magicModuleAppComponent({entry}));
+      }
+
+      return newOptions;
+    },
+  } satisfies Plugin;
+}
+
+export interface AppBrowserOptions {
+  /**
+   * Whether the app should use hydration or client-side rendering.
+   */
+  hydrate?: boolean;
+
+  /**
+   * The CSS selector to render or hydrate the application into.
+   */
+  selector?: string;
+}
+
+export function quiltAppBrowser(options: AppBrowserOptions = {}) {
+  return {
+    name: '@quilted/app/browser',
+    options(originalOptions) {
+      const newPlugins = [
+        ...(Array.isArray(originalOptions.plugins)
+          ? originalOptions.plugins
+          : originalOptions.plugins
+          ? [originalOptions.plugins]
+          : []),
+      ];
+
+      const newOptions = {...originalOptions, plugins: newPlugins};
+
+      newPlugins.push(magicModuleAppBrowserEntry(options));
+
+      return newOptions;
+    },
+  } satisfies Plugin;
+}
+
+export interface AppServerOptions {
+  /**
+   * The entry module for the server of this app. This module must export a
+   * `RequestRouter` object as its default export, which will be wrapped in
+   * the specific server runtime you configure.
+   */
+  entry?: string;
+}
+
+export function quiltAppServer(options: AppServerOptions = {}) {
+  return {
+    name: '@quilted/app/server',
+    async options(originalOptions) {
+      const newPlugins = [
+        ...(Array.isArray(originalOptions.plugins)
+          ? originalOptions.plugins
+          : originalOptions.plugins
+          ? [originalOptions.plugins]
+          : []),
+      ];
+
+      const [{magicModuleRequestRouterEntry}] = await Promise.all([
+        import('./request-router.ts'),
+      ]);
+
+      const newOptions = {...originalOptions, plugins: newPlugins};
+
+      newPlugins.push(magicModuleRequestRouterEntry());
+      newPlugins.push(magicModuleAppRequestRouter(options));
+
+      return newOptions;
+    },
+  } satisfies Plugin;
+}
+
+export function magicModuleAppComponent({entry}: {entry: string}) {
+  return createMagicModulePlugin({
+    name: '@quilted/magic-module/app',
+    module: MAGIC_MODULE_APP_COMPONENT,
+    alias: entry,
+  });
+}
+
+export function magicModuleAppRequestRouter({
+  entry,
+}: Pick<AppServerOptions, 'entry'> = {}) {
+  return createMagicModulePlugin({
+    name: '@quilted/magic-module/app-request-router',
+    module: MAGIC_MODULE_REQUEST_ROUTER,
+    alias: entry,
+    source: entry
+      ? undefined
+      : async function source() {
+          return multiline`
+            import '@quilted/quilt/globals';
+
+            import {jsx} from 'react/jsx-runtime';
+            import {RequestRouter} from '@quilted/quilt/request-router';
+            import {renderToResponse} from '@quilted/quilt/server';
+
+            import App from ${JSON.stringify(MAGIC_MODULE_APP_COMPONENT)};
+            import {BrowserAssets} from ${JSON.stringify(
+              MAGIC_MODULE_BROWSER_ASSETS,
+            )};
+
+            const router = new RequestRouter();
+            const assets = new BrowserAssets();
+
+            // For all GET requests, render our React application.
+            router.get(async (request) => {
+              const response = await renderToResponse(jsx(App), {
+                request,
+                assets,
+              });
+
+              return response;
+            });
+
+            export default router;
+          `;
+        },
+  });
+}
+
+export function magicModuleAppBrowserEntry({
+  hydrate = true,
+  selector = '#app',
+}: AppBrowserOptions = {}) {
+  return createMagicModulePlugin({
+    name: '@quilted/magic-module/app-browser-entry',
+    module: MAGIC_MODULE_ENTRY,
+    sideEffects: true,
+    async source() {
+      const reactRootFunction = hydrate ? 'hydrateRoot' : 'createRoot';
+
+      return multiline`
+        import '@quilted/quilt/globals';
+
+        import {jsx} from 'react/jsx-runtime';
+        import {${reactRootFunction}} from 'react-dom/client';
+
+        import App from ${JSON.stringify(MAGIC_MODULE_APP_COMPONENT)};
+
+        const element = document.querySelector(${JSON.stringify(selector)});
+
+        ${
+          hydrate
+            ? `${reactRootFunction}(element, jsx(App));`
+            : `${reactRootFunction}(element).render(jsx(App));`
+        }
+      `;
+    },
+  });
+}

package/source/constants.ts

@@ -0,0 +1,5 @@
+export const MAGIC_MODULE_ENV = 'quilt:module/env';
+export const MAGIC_MODULE_ENTRY = 'quilt:module/entry';
+export const MAGIC_MODULE_APP_COMPONENT = 'quilt:module/app';
+export const MAGIC_MODULE_BROWSER_ASSETS = 'quilt:module/assets';
+export const MAGIC_MODULE_REQUEST_ROUTER = 'quilt:module/request-router';