@quilted/create 0.3.1 → 0.3.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @quilted/create
 
+## 0.3.2
+
+### Patch Changes
+
+- [`be4e753`](https://github.com/lemonmade/quilt/commit/be4e7532de2bdda83302c2eb8bc2a0a09aeae07e) Thanks [@lemonmade](https://github.com/lemonmade)! - Refactor app template context structure: replace `shared/` directory with `context/` directory
+
+  The `shared/` directory, which used TypeScript declaration merging to build up the `AppContext` interface across multiple files, has been replaced with a `context/` directory that defines the full interface explicitly in a single `types.ts` file. This makes the shape of the application context immediately visible without needing to trace module augmentations.
+
+  The new structure separates each concern into its own file: `types.ts` owns the interface, `navigation.ts` provides the router and route helpers, `preact.ts` holds the Preact context binding, `browser.ts` exports `BrowserAppContext`, and `server.ts` exports `ServerAppContext`. The context classes have been extracted from `browser.tsx` and `server.tsx` into these dedicated files, keeping the entry points lean.
+
+  Navigation is now accessed as `context.navigation.router` instead of `context.router`, grouping router state under a `navigation` namespace. A `browser.css` file has also been added to each app template for global CSS resets.
+
 ## 0.3.1
 
 ### Patch Changes

package/build/esm/_virtual/index7.mjs

@@ -1,3 +1,3 @@
-var utils = {};
+var dirGlob = {exports: {}};
 
-export { utils as __exports };
+export { dirGlob as __module };

package/build/esm/_virtual/index8.mjs

@@ -1,3 +1,3 @@
-var dirGlob = {exports: {}};
+var utils = {};
 
-export { dirGlob as __module };
+export { utils as __exports };

package/build/esm/node_modules/.pnpm/dir-glob@3.0.1/node_modules/dir-glob/index.mjs

@@ -1,4 +1,4 @@
-import { __module as dirGlob } from '../../../../../_virtual/index8.mjs';
+import { __module as dirGlob } from '../../../../../_virtual/index7.mjs';
 import path__default from 'node:path';
 import { __require as requirePathType } from '../../../path-type@4.0.0/node_modules/path-type/index.mjs';
 

package/build/esm/node_modules/.pnpm/fast-glob@3.3.3/node_modules/fast-glob/out/utils/index.mjs

@@ -1,4 +1,4 @@
-import { __exports as utils } from '../../../../../../../_virtual/index7.mjs';
+import { __exports as utils } from '../../../../../../../_virtual/index8.mjs';
 import { __require as requireArray } from './array.mjs';
 import { __require as requireErrno } from './errno.mjs';
 import { __require as requireFs } from './fs.mjs';

package/build/esm/node_modules/.pnpm/prompts@2.4.2/node_modules/prompts/dist/prompts.mjs

@@ -1,4 +1,4 @@
-import { __exports as prompts } from '../../../../../../_virtual/prompts2.mjs';
+import { __exports as prompts } from '../../../../../../_virtual/prompts.mjs';
 import { __require as requireElements } from './elements/index.mjs';
 
 var hasRequiredPrompts;

package/build/esm/node_modules/.pnpm/prompts@2.4.2/node_modules/prompts/lib/prompts.mjs

@@ -1,4 +1,4 @@
-import { __exports as prompts } from '../../../../../../_virtual/prompts.mjs';
+import { __exports as prompts } from '../../../../../../_virtual/prompts2.mjs';
 import { __require as requireElements } from './elements/index.mjs';
 
 var hasRequiredPrompts;

package/build/esnext/node_modules/.pnpm/@nodelib_fs.stat@2.0.5/node_modules/@nodelib/fs.stat/out/index.esnext

@@ -1,4 +1,4 @@
-import { __exports as out } from '../../../../../../../_virtual/index11.esnext';
+import { __exports as out } from '../../../../../../../_virtual/index10.esnext';
 import { __require as requireAsync } from './providers/async.esnext';
 import { __require as requireSync } from './providers/sync.esnext';
 import { __require as requireSettings } from './settings.esnext';

package/build/esnext/node_modules/.pnpm/@nodelib_fs.stat@2.0.5/node_modules/@nodelib/fs.stat/out/providers/async.esnext

@@ -1,4 +1,4 @@
-import { __exports as async } from '../../../../../../../../_virtual/async4.esnext';
+import { __exports as async } from '../../../../../../../../_virtual/async3.esnext';
 
 var hasRequiredAsync;
 function requireAsync() {

package/build/esnext/node_modules/.pnpm/@nodelib_fs.stat@2.0.5/node_modules/@nodelib/fs.stat/out/providers/sync.esnext

@@ -1,4 +1,4 @@
-import { __exports as sync } from '../../../../../../../../_virtual/sync4.esnext';
+import { __exports as sync } from '../../../../../../../../_virtual/sync3.esnext';
 
 var hasRequiredSync;
 function requireSync() {

package/build/esnext/node_modules/.pnpm/@nodelib_fs.stat@2.0.5/node_modules/@nodelib/fs.stat/out/settings.esnext

@@ -1,4 +1,4 @@
-import { __exports as settings } from '../../../../../../../_virtual/settings3.esnext';
+import { __exports as settings } from '../../../../../../../_virtual/settings2.esnext';
 import { __require as requireFs } from './adapters/fs.esnext';
 
 var hasRequiredSettings;

package/build/esnext/node_modules/.pnpm/@nodelib_fs.walk@1.2.8/node_modules/@nodelib/fs.walk/out/index.esnext

@@ -1,4 +1,4 @@
-import { __exports as out } from '../../../../../../../_virtual/index10.esnext';
+import { __exports as out } from '../../../../../../../_virtual/index11.esnext';
 import { __require as requireAsync } from './providers/async.esnext';
 import { __require as requireStream } from './providers/stream.esnext';
 import { __require as requireSync } from './providers/sync.esnext';

package/build/esnext/node_modules/.pnpm/@nodelib_fs.walk@1.2.8/node_modules/@nodelib/fs.walk/out/providers/async.esnext

@@ -1,4 +1,4 @@
-import { __exports as async } from '../../../../../../../../_virtual/async3.esnext';
+import { __exports as async } from '../../../../../../../../_virtual/async4.esnext';
 import { __require as requireAsync$1 } from '../readers/async.esnext';
 
 var hasRequiredAsync;

package/build/esnext/node_modules/.pnpm/@nodelib_fs.walk@1.2.8/node_modules/@nodelib/fs.walk/out/providers/sync.esnext

@@ -1,4 +1,4 @@
-import { __exports as sync } from '../../../../../../../../_virtual/sync3.esnext';
+import { __exports as sync } from '../../../../../../../../_virtual/sync4.esnext';
 import { __require as requireSync$1 } from '../readers/sync.esnext';
 
 var hasRequiredSync;

package/build/esnext/node_modules/.pnpm/@nodelib_fs.walk@1.2.8/node_modules/@nodelib/fs.walk/out/settings.esnext

@@ -1,4 +1,4 @@
-import { __exports as settings } from '../../../../../../../_virtual/settings2.esnext';
+import { __exports as settings } from '../../../../../../../_virtual/settings3.esnext';
 import path__default from 'node:path';
 import { __require as requireOut } from '../../../../../@nodelib_fs.scandir@2.1.5/node_modules/@nodelib/fs.scandir/out/index.esnext';
 

package/build/esnext/node_modules/.pnpm/fast-glob@3.3.3/node_modules/fast-glob/out/readers/stream.esnext

@@ -1,4 +1,4 @@
-import { __exports as stream } from '../../../../../../../_virtual/stream2.esnext';
+import { __exports as stream } from '../../../../../../../_virtual/stream3.esnext';
 import require$$0 from 'node:stream';
 import { __require as requireOut } from '../../../../../@nodelib_fs.stat@2.0.5/node_modules/@nodelib/fs.stat/out/index.esnext';
 import { __require as requireOut$1 } from '../../../../../@nodelib_fs.walk@1.2.8/node_modules/@nodelib/fs.walk/out/index.esnext';

package/build/esnext/node_modules/.pnpm/fast-glob@3.3.3/node_modules/fast-glob/out/utils/stream.esnext

@@ -1,4 +1,4 @@
-import { __exports as stream } from '../../../../../../../_virtual/stream3.esnext';
+import { __exports as stream } from '../../../../../../../_virtual/stream2.esnext';
 import { __require as requireMerge2 } from '../../../../../merge2@1.4.1/node_modules/merge2/index.esnext';
 
 var hasRequiredStream;

package/build/esnext/node_modules/.pnpm/prompts@2.4.2/node_modules/prompts/dist/prompts.esnext

@@ -1,4 +1,4 @@
-import { __exports as prompts } from '../../../../../../_virtual/prompts2.esnext';
+import { __exports as prompts } from '../../../../../../_virtual/prompts.esnext';
 import { __require as requireElements } from './elements/index.esnext';
 
 var hasRequiredPrompts;

package/build/esnext/node_modules/.pnpm/prompts@2.4.2/node_modules/prompts/lib/prompts.esnext

@@ -1,4 +1,4 @@
-import { __exports as prompts } from '../../../../../../_virtual/prompts.esnext';
+import { __exports as prompts } from '../../../../../../_virtual/prompts2.esnext';
 import { __require as requireElements } from './elements/index.esnext';
 
 var hasRequiredPrompts;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@quilted/create",
   "type": "module",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "license": "MIT",
   "repository": {
     "type": "git",

package/templates/app-basic/App.tsx

@@ -7,8 +7,9 @@ import {Frame} from './foundation/frame.ts';
 
 import {Home} from './features/home.ts';
 
-import {AppContextPreact, type AppContext} from './shared/context.ts';
-import {routeWithAppContext} from './shared/navigation.ts';
+import type {AppContext} from './context/types.ts';
+import {AppContextPreact} from './context/preact.ts';
+import {routeWithAppContext} from './context/navigation.ts';
 
 export interface AppProps {
   context: AppContext;
@@ -38,7 +39,11 @@ export function App({context}: AppProps) {
     <AppContextPreact.Provider value={context}>
       <Localization>
         <Head />
-        <Navigation router={context.router} routes={routes} context={context} />
+        <Navigation
+          router={context.navigation.router}
+          routes={routes}
+          context={context}
+        />
       </Localization>
     </AppContextPreact.Provider>
   );

package/templates/app-basic/browser.css

@@ -0,0 +1,10 @@
+*,
+*::before,
+*::after {
+  box-sizing: border-box;
+}
+
+html,
+body {
+  margin: 0;
+}

package/templates/app-basic/browser.tsx

@@ -1,18 +1,11 @@
+import './browser.css';
+
 import type {ComponentChild} from 'preact';
 import {hydrate} from '@quilted/quilt/browser';
-import {Router} from '@quilted/quilt/navigation';
 
-import type {AppContext} from '~/shared/context.ts';
+import {BrowserAppContext} from '~/context/browser.ts';
 import {App} from './App.tsx';
 
-class BrowserAppContext implements AppContext {
-  readonly router: Router;
-
-  constructor() {
-    this.router = new Router();
-  }
-}
-
 class BrowserApp {
   /**
    * The app’s globally-available context.
@@ -42,8 +35,11 @@ class BrowserApp {
       writable: true,
     });
   }
+
+  hydrate() {
+    hydrate(this.rendered);
+  }
 }
 
 const app = new BrowserApp();
-
-hydrate(app.rendered);
+app.hydrate();

package/templates/app-basic/context/browser.ts

@@ -0,0 +1,10 @@
+import type {AppContext} from './types.ts';
+import {NavigationForApp} from './navigation.ts';
+
+export class BrowserAppContext implements AppContext {
+  readonly navigation: NavigationForApp;
+
+  constructor() {
+    this.navigation = new NavigationForApp();
+  }
+}

package/templates/app-basic/context/navigation.ts

@@ -0,0 +1,17 @@
+import {createContextRouteFunction, Router} from '@quilted/quilt/navigation';
+
+import type {AppContext} from './types.ts';
+
+export interface Navigation {
+  readonly router: Router;
+}
+
+export class NavigationForApp implements Navigation {
+  readonly router: Router;
+
+  constructor(url?: string | URL) {
+    this.router = new Router(url);
+  }
+}
+
+export const routeWithAppContext = createContextRouteFunction<AppContext>();

package/templates/app-basic/{shared/context.ts → context/preact.ts}

@@ -1,6 +1,6 @@
 import {createOptionalContext} from '@quilted/quilt/context';
 
-export interface AppContext {}
+import type {AppContext} from './types.ts';
 
 export const AppContextPreact = createOptionalContext<AppContext>();
 export const useAppContext = AppContextPreact.use;

package/templates/app-basic/context/server.ts

@@ -0,0 +1,10 @@
+import type {AppContext} from './types.ts';
+import {NavigationForApp} from './navigation.ts';
+
+export class ServerAppContext implements AppContext {
+  readonly navigation: NavigationForApp;
+
+  constructor(request: Request) {
+    this.navigation = new NavigationForApp(request.url);
+  }
+}

package/templates/app-basic/context/types.ts

@@ -0,0 +1,5 @@
+import type {Navigation} from './navigation.ts';
+
+export interface AppContext {
+  readonly navigation: Navigation;
+}

package/templates/app-basic/foundation/frame/Frame.module.css

@@ -1,14 +1,3 @@
-*,
-*::before,
-*::after {
-  box-sizing: border-box;
-}
-
-html,
-body {
-  margin: 0;
-}
-
 .Frame {
   padding: 1rem;
 }

package/templates/app-basic/server.tsx

@@ -6,30 +6,21 @@ import {
   PermissionsPolicyHeader,
   StrictTransportSecurityHeader,
 } from '@quilted/quilt/server';
-import {Router} from '@quilted/quilt/navigation';
-
 import Env from 'quilt:module/env';
 import {BrowserAssets} from 'quilt:module/assets';
 
-import type {AppContext} from '~/shared/context.ts';
-
-import {App} from './App.tsx';
-
 const app = new Hono();
 const assets = new BrowserAssets();
 
-class ServerAppContext implements AppContext {
-  readonly router: Router;
-
-  constructor(request: Request) {
-    this.router = new Router(request.url);
-  }
-}
-
 // For all GET requests, render our Preact application.
 app.get('*', async (c) => {
   const request = c.req.raw;
 
+  const [{App}, {ServerAppContext}] = await Promise.all([
+    import('./App.tsx'),
+    import('./context/server.ts'),
+  ]);
+
   const context = new ServerAppContext(request);
 
   const isHttps = request.url.startsWith('https://');

package/templates/app-basic/tests/render/render.tsx

@@ -6,7 +6,7 @@ import {
 import {Navigation, TestRouter} from '@quilted/quilt/navigation/testing';
 import {Localization} from '@quilted/quilt/localize';
 
-import {AppContextPreact} from '~/shared/context.ts';
+import {AppContextPreact} from '~/context/preact.ts';
 
 import {RenderOptions, RenderContext, RenderActions} from './types.ts';
 
@@ -24,11 +24,14 @@ export const renderApp = createRender<
   // authors on the `root.context` property. Context is used to share data between your
   // React tree and your test code, and is ideal for mocking out global context providers.
   context({router = new TestRouter(), browser = new BrowserTestMock()}) {
-    return {router, browser};
+    return {navigation: {router}, browser};
   },
   // Render all of our app-wide context providers around each component under test.
   render(element, context, {locale = 'en'}) {
-    const {router, browser} = context;
+    const {
+      navigation: {router},
+      browser,
+    } = context;
 
     return (
       <AppContextPreact.Provider value={context}>

package/templates/app-basic/tests/render/types.ts

@@ -1,7 +1,7 @@
 import type {TestRouter} from '@quilted/quilt/navigation/testing';
 import type {BrowserTestMock} from '@quilted/quilt/browser/testing';
 
-import type {AppContext} from '~/shared/context.ts';
+import type {AppContext} from '~/context/types.ts';
 
 export interface RenderOptions {
   /**
@@ -27,7 +27,7 @@ export interface RenderContext extends AppContext {
   /**
    * The router used for this component test.
    */
-  readonly router: TestRouter;
+  readonly navigation: {router: TestRouter};
 
   /**
    * The browser environment for this component test.

package/templates/app-basic/tsconfig.json

@@ -3,10 +3,8 @@
   "compilerOptions": {
     "jsxImportSource": "preact",
     "paths": {
-      "~/shared/*": ["./shared/*"],
-      "~/tests/*": ["./tests/*"],
-      "react": ["./node_modules/preact/compat"],
-      "react-dom": ["./node_modules/preact/compat"]
+      "~/context/*": ["./context/*"],
+      "~/tests/*": ["./tests/*"]
     }
   },
   "include": ["**/*"],

package/templates/app-graphql/App.tsx

@@ -8,8 +8,9 @@ import {Frame} from './foundation/frame.ts';
 
 import {Home, homeQuery} from './features/home.ts';
 
-import {AppContextPreact, type AppContext} from './shared/context.ts';
-import {routeWithAppContext} from './shared/navigation.ts';
+import type {AppContext} from './context/types.ts';
+import {AppContextPreact} from './context/preact.ts';
+import {routeWithAppContext} from './context/navigation.ts';
 
 export interface AppProps {
   context: AppContext;
@@ -44,7 +45,7 @@ export function App({context}: AppProps) {
         <Localization>
           <Head />
           <Navigation
-            router={context.router}
+            router={context.navigation.router}
             routes={routes}
             context={context}
           />

package/templates/app-graphql/browser.css

@@ -0,0 +1,10 @@
+*,
+*::before,
+*::after {
+  box-sizing: border-box;
+}
+
+html,
+body {
+  margin: 0;
+}

package/templates/app-graphql/browser.tsx

@@ -1,29 +1,12 @@
+import './browser.css';
+
 import type {ComponentChild} from 'preact';
 import {hydrate} from '@quilted/quilt/browser';
-import {Router} from '@quilted/quilt/navigation';
-import {createGraphQLFetch, GraphQLCache} from '@quilted/quilt/graphql';
 
-import type {AppContext} from '~/shared/context.ts';
+import {BrowserAppContext} from '~/context/browser.ts';
 
 import {App} from './App.tsx';
 
-class BrowserAppContext implements AppContext {
-  readonly router: Router;
-  readonly graphql: AppContext['graphql'];
-
-  constructor() {
-    this.router = new Router();
-
-    const graphQLFetch = createGraphQLFetch({url: '/api/graphql'});
-    const graphQLCache = new GraphQLCache({fetch: graphQLFetch});
-
-    this.graphql = {
-      fetch: graphQLFetch,
-      cache: graphQLCache,
-    };
-  }
-}
-
 class BrowserApp {
   /**
    * The app's globally-available context.
@@ -44,7 +27,7 @@ class BrowserApp {
     // @example
     // ```js
     // // Log the current URL
-    // console.log(globalThis.app.context.router.currentRequest.url);
+    // console.log(globalThis.app.context.navigation.router.currentRequest.url);
     // ```
     Object.defineProperty(globalThis, 'app', {
       value: this,
@@ -53,8 +36,11 @@ class BrowserApp {
       writable: true,
     });
   }
+
+  hydrate() {
+    hydrate(this.rendered);
+  }
 }
 
 const app = new BrowserApp();
-
-hydrate(app.rendered);
+app.hydrate();

package/templates/app-graphql/context/browser.ts

@@ -0,0 +1,21 @@
+import {createGraphQLFetch, GraphQLCache} from '@quilted/quilt/graphql';
+
+import type {AppContext} from './types.ts';
+import {NavigationForApp} from './navigation.ts';
+
+export class BrowserAppContext implements AppContext {
+  readonly navigation: NavigationForApp;
+  readonly graphql: AppContext['graphql'];
+
+  constructor() {
+    this.navigation = new NavigationForApp();
+
+    const graphQLFetch = createGraphQLFetch({url: '/api/graphql'});
+    const graphQLCache = new GraphQLCache({fetch: graphQLFetch});
+
+    this.graphql = {
+      fetch: graphQLFetch,
+      cache: graphQLCache,
+    };
+  }
+}

package/templates/app-graphql/context/navigation.ts

@@ -0,0 +1,17 @@
+import {createContextRouteFunction, Router} from '@quilted/quilt/navigation';
+
+import type {AppContext} from './types.ts';
+
+export interface Navigation {
+  readonly router: Router;
+}
+
+export class NavigationForApp implements Navigation {
+  readonly router: Router;
+
+  constructor(url?: string | URL) {
+    this.router = new Router(url);
+  }
+}
+
+export const routeWithAppContext = createContextRouteFunction<AppContext>();

package/templates/{app-trpc/shared/context.ts → app-graphql/context/preact.ts}

@@ -1,6 +1,6 @@
 import {createOptionalContext} from '@quilted/quilt/context';
 
-export interface AppContext {}
+import type {AppContext} from './types.ts';
 
 export const AppContextPreact = createOptionalContext<AppContext>();
 export const useAppContext = AppContextPreact.use;

package/templates/app-graphql/context/server.ts

@@ -0,0 +1,23 @@
+import {GraphQLCache} from '@quilted/quilt/graphql';
+
+import type {AppContext} from './types.ts';
+import {NavigationForApp} from './navigation.ts';
+
+export class ServerAppContext implements AppContext {
+  readonly navigation: NavigationForApp;
+  readonly graphql: AppContext['graphql'];
+
+  constructor(request: Request) {
+    this.navigation = new NavigationForApp(request.url);
+
+    const graphQLFetch: AppContext['graphql']['fetch'] = async (...args) => {
+      const {performGraphQLOperation} = await import('../server/graphql.ts');
+      return performGraphQLOperation(...args);
+    };
+
+    this.graphql = {
+      fetch: graphQLFetch,
+      cache: new GraphQLCache({fetch: graphQLFetch}),
+    };
+  }
+}

package/templates/app-graphql/context/types.ts

@@ -0,0 +1,10 @@
+import type {Navigation} from './navigation.ts';
+import type {GraphQLFetch, GraphQLCache} from '@quilted/quilt/graphql';
+
+export interface AppContext {
+  readonly navigation: Navigation;
+  readonly graphql: {
+    readonly fetch: GraphQLFetch;
+    readonly cache: GraphQLCache;
+  };
+}

package/templates/app-graphql/server.tsx

@@ -1,5 +1,4 @@
 import {Hono} from 'hono';
-import {Router} from '@quilted/quilt/navigation';
 import {
   renderAppToHTMLResponse,
   CacheControlHeader,
@@ -7,35 +6,13 @@ import {
   PermissionsPolicyHeader,
   StrictTransportSecurityHeader,
 } from '@quilted/quilt/server';
-import {GraphQLCache} from '@quilted/quilt/graphql';
 
 import Env from 'quilt:module/env';
 import {BrowserAssets} from 'quilt:module/assets';
 
-import type {AppContext} from '~/shared/context.ts';
-
 const app = new Hono();
 const assets = new BrowserAssets();
 
-class ServerAppContext implements AppContext {
-  readonly router: Router;
-  readonly graphql: AppContext['graphql'];
-
-  constructor(request: Request) {
-    this.router = new Router(request.url);
-
-    const graphQLFetch: AppContext['graphql']['fetch'] = async (...args) => {
-      const {performGraphQLOperation} = await import('./server/graphql.ts');
-      return performGraphQLOperation(...args);
-    };
-
-    this.graphql = {
-      fetch: graphQLFetch,
-      cache: new GraphQLCache({fetch: graphQLFetch}),
-    };
-  }
-}
-
 // GraphQL API, called from the client
 app.post('/api/graphql', async (c) => {
   const request = c.req.raw;
@@ -55,7 +32,10 @@ app.post('/api/graphql', async (c) => {
 app.get('*', async (c) => {
   const request = c.req.raw;
 
-  const [{App}] = await Promise.all([import('./App.tsx')]);
+  const [{App}, {ServerAppContext}] = await Promise.all([
+    import('./App.tsx'),
+    import('./context/server.ts'),
+  ]);
 
   const context = new ServerAppContext(request);
 

package/templates/app-graphql/tests/render/render.tsx

@@ -9,7 +9,7 @@ import {Navigation, TestRouter} from '@quilted/quilt/navigation/testing';
 import {Localization} from '@quilted/quilt/localize';
 import {GraphQLCache} from '@quilted/quilt/graphql';
 
-import {AppContextPreact} from '~/shared/context.ts';
+import {AppContextPreact} from '~/context/preact.ts';
 
 import {GraphQLTesting, GraphQLController} from '../graphql.ts';
 
@@ -32,18 +32,21 @@ export const renderApp = createRender<
     router = new TestRouter(),
     browser = new BrowserTestMock(),
     graphql = new GraphQLController(),
-    graphQLCache = new GraphQLCache(),
+    graphQLCache = new GraphQLCache({fetch: graphql.fetch}),
   }) {
     return {
-      router,
+      navigation: {router},
       browser,
-      graphql: {fetch: graphql.fetch, cache: graphQLCache},
-      graphQLController: graphql,
+      graphql: {fetch: graphql.fetch, cache: graphQLCache, controller: graphql},
     };
   },
   // Render all of our app-wide context providers around each component under test.
   render(element, context, {locale = 'en'}) {
-    const {router, browser, graphql, graphQLController} = context;
+    const {
+      navigation: {router},
+      browser,
+      graphql,
+    } = context;
 
     return (
       <AppContextPreact.Provider value={context}>
@@ -51,7 +54,7 @@ export const renderApp = createRender<
           <Localization locale={locale}>
             <Navigation router={router}>
               <GraphQLTesting
-                controller={graphQLController}
+                controller={graphql.controller}
                 cache={graphql.cache}
               >
                 <Suspense fallback={null}>{element}</Suspense>
@@ -69,7 +72,7 @@ export const renderApp = createRender<
     // once the data is ready.
 
     await wrapper.act(async () => {
-      await wrapper.context.graphQLController.resolveAll();
+      await wrapper.context.graphql.controller.resolveAll();
     });
   },
 });

package/templates/app-graphql/tests/render/types.ts

@@ -2,7 +2,7 @@ import type {TestRouter} from '@quilted/quilt/navigation/testing';
 import type {BrowserTestMock} from '@quilted/quilt/browser/testing';
 import type {GraphQLCache} from '@quilted/quilt/graphql';
 
-import type {AppContext} from '~/shared/context.ts';
+import type {AppContext} from '~/context/types.ts';
 
 import type {GraphQLController} from '../graphql.ts';
 
@@ -58,7 +58,7 @@ export interface RenderContext extends AppContext {
   /**
    * The router used for this component test.
    */
-  readonly router: TestRouter;
+  readonly navigation: {router: TestRouter};
 
   /**
    * The browser environment for this component test.
@@ -66,9 +66,14 @@ export interface RenderContext extends AppContext {
   readonly browser: BrowserTestMock;
 
   /**
-   * The GraphQL controller used for this component test.
+   * The GraphQL context used for this component test.
    */
-  readonly graphQLController: GraphQLController;
+  readonly graphql: AppContext['graphql'] & {
+    /**
+     * The GraphQL controller used for this component test.
+     */
+    readonly controller: GraphQLController;
+  };
 }
 
 export interface RenderActions extends Record<string, never> {}

package/templates/app-graphql/tsconfig.json

@@ -3,7 +3,7 @@
   "compilerOptions": {
     "jsxImportSource": "preact",
     "paths": {
-      "~/shared/*": ["./shared/*"],
+      "~/context/*": ["./context/*"],
       "~/tests/*": ["./tests/*"],
       "react": ["./node_modules/preact/compat"],
       "react-dom": ["./node_modules/preact/compat"]

package/templates/app-trpc/App.tsx

@@ -9,12 +9,10 @@ import {Frame} from './foundation/frame.ts';
 
 import {Home} from './features/home.ts';
 
-import {trpc} from './shared/trpc.ts';
-import {
-  AppContextPreact,
-  type AppContext as AppContextType,
-} from './shared/context.ts';
-import {routeWithAppContext} from './shared/navigation.ts';
+import {trpc} from './context/trpc.ts';
+import type {AppContext as AppContextType} from './context/types.ts';
+import {AppContextPreact} from './context/preact.ts';
+import {routeWithAppContext} from './context/navigation.ts';
 
 export interface AppProps {
   context: AppContextType;
@@ -47,7 +45,7 @@ export function App({context}: AppProps) {
           <Localization>
             <Head />
             <Navigation
-              router={context.router}
+              router={context.navigation.router}
               routes={routes}
               context={context}
             />

package/templates/app-trpc/browser.css

@@ -0,0 +1,10 @@
+*,
+*::before,
+*::after {
+  box-sizing: border-box;
+}
+
+html,
+body {
+  margin: 0;
+}

package/templates/app-trpc/browser.tsx

@@ -1,29 +1,12 @@
+import './browser.css';
+
 import type {ComponentChild} from 'preact';
 import {hydrate} from '@quilted/quilt/browser';
-import {Router} from '@quilted/quilt/navigation';
-
-import {httpBatchLink} from '@trpc/client';
-import {QueryClient} from '@tanstack/react-query';
 
-import type {AppContext} from '~/shared/context.ts';
-import {trpc} from '~/shared/trpc.ts';
+import {BrowserAppContext} from '~/context/browser.ts';
 
 import {App} from './App.tsx';
 
-class BrowserAppContext implements AppContext {
-  readonly router: Router;
-  readonly trpc: AppContext['trpc'];
-  readonly queryClient: QueryClient;
-
-  constructor() {
-    this.router = new Router();
-    this.queryClient = new QueryClient();
-    this.trpc = trpc.createClient({
-      links: [httpBatchLink({url: new URL('/api', window.location.href).href})],
-    });
-  }
-}
-
 class BrowserApp {
   /**
    * The app's globally-available context.
@@ -44,7 +27,7 @@ class BrowserApp {
     // @example
     // ```js
     // // Log the current URL
-    // console.log(globalThis.app.context.router.currentRequest.url);
+    // console.log(globalThis.app.context.navigation.router.currentRequest.url);
     // ```
     Object.defineProperty(globalThis, 'app', {
       value: this,
@@ -53,8 +36,11 @@ class BrowserApp {
       writable: true,
     });
   }
+
+  hydrate() {
+    hydrate(this.rendered);
+  }
 }
 
 const app = new BrowserApp();
-
-hydrate(app.rendered);
+app.hydrate();

package/templates/app-trpc/context/browser.ts

@@ -0,0 +1,20 @@
+import {httpBatchLink} from '@trpc/client';
+import {QueryClient} from '@tanstack/react-query';
+
+import type {AppContext} from './types.ts';
+import {NavigationForApp} from './navigation.ts';
+import {trpc} from './trpc.ts';
+
+export class BrowserAppContext implements AppContext {
+  readonly navigation: NavigationForApp;
+  readonly trpc: AppContext['trpc'];
+  readonly queryClient: QueryClient;
+
+  constructor() {
+    this.navigation = new NavigationForApp();
+    this.queryClient = new QueryClient();
+    this.trpc = trpc.createClient({
+      links: [httpBatchLink({url: new URL('/api', window.location.href).href})],
+    });
+  }
+}

package/templates/app-trpc/context/navigation.ts

@@ -0,0 +1,17 @@
+import {createContextRouteFunction, Router} from '@quilted/quilt/navigation';
+
+import type {AppContext} from './types.ts';
+
+export interface Navigation {
+  readonly router: Router;
+}
+
+export class NavigationForApp implements Navigation {
+  readonly router: Router;
+
+  constructor(url?: string | URL) {
+    this.router = new Router(url);
+  }
+}
+
+export const routeWithAppContext = createContextRouteFunction<AppContext>();

package/templates/{app-graphql/shared/context.ts → app-trpc/context/preact.ts}

@@ -1,6 +1,6 @@
 import {createOptionalContext} from '@quilted/quilt/context';
 
-export interface AppContext {}
+import type {AppContext} from './types.ts';
 
 export const AppContextPreact = createOptionalContext<AppContext>();
 export const useAppContext = AppContextPreact.use;

package/templates/app-trpc/context/server.ts

@@ -0,0 +1,18 @@
+import {createDirectClient} from '@quilted/trpc/server';
+import {QueryClient} from '@tanstack/react-query';
+
+import type {AppContext} from './types.ts';
+import {NavigationForApp} from './navigation.ts';
+import {appRouter} from '../trpc.ts';
+
+export class ServerAppContext implements AppContext {
+  readonly navigation: NavigationForApp;
+  readonly trpc: AppContext['trpc'];
+  readonly queryClient: QueryClient;
+
+  constructor(request: Request) {
+    this.navigation = new NavigationForApp(request.url);
+    this.trpc = createDirectClient(appRouter);
+    this.queryClient = new QueryClient();
+  }
+}

package/templates/app-trpc/context/trpc.ts

@@ -0,0 +1,6 @@
+import {createTRPCReact, type CreateTRPCReact} from '@trpc/react-query';
+
+import type {AppRouter} from '../trpc.ts';
+
+export const trpc: CreateTRPCReact<AppRouter, {}> =
+  createTRPCReact<AppRouter>();

package/templates/app-trpc/context/types.ts

@@ -0,0 +1,11 @@
+import type {Navigation} from './navigation.ts';
+import type {TRPCUntypedClient} from '@trpc/client';
+import type {QueryClient} from '@tanstack/react-query';
+
+import type {AppRouter} from '../trpc.ts';
+
+export interface AppContext {
+  readonly navigation: Navigation;
+  readonly trpc: TRPCUntypedClient<AppRouter>;
+  readonly queryClient: QueryClient;
+}

package/templates/app-trpc/features/home/Home.tsx

@@ -1,4 +1,4 @@
-import {trpc} from '~/shared/trpc.ts';
+import {trpc} from '~/context/trpc.ts';
 
 import styles from './Home.module.css';
 

package/templates/app-trpc/server.tsx

@@ -6,34 +6,16 @@ import {
   PermissionsPolicyHeader,
   StrictTransportSecurityHeader,
 } from '@quilted/quilt/server';
-import {Router} from '@quilted/quilt/navigation';
-
 import Env from 'quilt:module/env';
 import {BrowserAssets} from 'quilt:module/assets';
 
-import {createDirectClient} from '@quilted/trpc/server';
 import {fetchRequestHandler} from '@trpc/server/adapters/fetch';
-import {QueryClient} from '@tanstack/react-query';
-
-import type {AppContext} from '~/shared/context.ts';
 
 import {appRouter} from './trpc.ts';
 
 const app = new Hono();
 const assets = new BrowserAssets();
 
-class ServerAppContext implements AppContext {
-  readonly router: Router;
-  readonly trpc: AppContext['trpc'];
-  readonly queryClient: QueryClient;
-
-  constructor(request: Request) {
-    this.router = new Router(request.url);
-    this.trpc = createDirectClient(appRouter);
-    this.queryClient = new QueryClient();
-  }
-}
-
 // TRPC API
 app.all('/api/*', async (c) => {
   const request = c.req.raw;
@@ -49,7 +31,10 @@ app.all('/api/*', async (c) => {
 app.get('*', async (c) => {
   const request = c.req.raw;
 
-  const [{App}] = await Promise.all([import('./App.tsx')]);
+  const [{App}, {ServerAppContext}] = await Promise.all([
+    import('./App.tsx'),
+    import('./context/server.ts'),
+  ]);
 
   const context = new ServerAppContext(request);
 

package/templates/app-trpc/tests/render/render.tsx

@@ -8,8 +8,8 @@ import {Localization} from '@quilted/quilt/localize';
 
 import {QueryClient, QueryClientProvider} from '@tanstack/react-query';
 
-import {trpc} from '~/shared/trpc.ts';
-import {AppContextPreact} from '~/shared/context.ts';
+import {trpc} from '~/context/trpc.ts';
+import {AppContextPreact} from '~/context/preact.ts';
 
 import {RenderOptions, RenderContext, RenderActions} from './types.ts';
 
@@ -28,7 +28,7 @@ export const renderApp = createRender<
   // React tree and your test code, and is ideal for mocking out global context providers.
   context({router = new TestRouter(), browser = new BrowserTestMock()}) {
     return {
-      router,
+      navigation: {router},
       browser,
       trpc: trpc.createClient(),
       queryClient: new QueryClient(),
@@ -36,7 +36,12 @@ export const renderApp = createRender<
   },
   // Render all of our app-wide context providers around each component under test.
   render(element, context, {locale = 'en'}) {
-    const {router, browser, trpc: trpcClient, queryClient} = context;
+    const {
+      navigation: {router},
+      browser,
+      trpc: trpcClient,
+      queryClient,
+    } = context;
 
     return (
       <AppContextPreact.Provider value={context}>

package/templates/app-trpc/tests/render/types.ts

@@ -2,7 +2,7 @@ import type {TestRouter} from '@quilted/quilt/navigation/testing';
 import type {BrowserTestMock} from '@quilted/quilt/browser/testing';
 import type {QueryClient} from '@tanstack/react-query';
 
-import type {AppContext} from '~/shared/context.ts';
+import type {AppContext} from '~/context/types.ts';
 
 export interface RenderOptions {
   /**
@@ -28,7 +28,7 @@ export interface RenderContext extends AppContext {
   /**
    * The router used for this component test.
    */
-  readonly router: TestRouter;
+  readonly navigation: {router: TestRouter};
 
   /**
    * The browser environment for this component test.

package/templates/app-trpc/tsconfig.json

@@ -3,7 +3,7 @@
   "compilerOptions": {
     "jsxImportSource": "preact",
     "paths": {
-      "~/shared/*": ["./shared/*"],
+      "~/context/*": ["./context/*"],
       "~/tests/*": ["./tests/*"],
       "react": ["./node_modules/preact/compat"],
       "react-dom": ["./node_modules/preact/compat"]

package/templates/app-basic/shared/navigation.ts

@@ -1,15 +0,0 @@
-import type {Router} from '@quilted/quilt/navigation';
-import {createContextRouteFunction} from '@quilted/quilt/navigation';
-
-import type {AppContext} from '~/shared/context.ts';
-
-declare module '~/shared/context.ts' {
-  interface AppContext {
-    /**
-     * The router used to control navigation throughout the application.
-     */
-    readonly router: Router;
-  }
-}
-
-export const routeWithAppContext = createContextRouteFunction<AppContext>();

package/templates/app-graphql/shared/graphql.ts

@@ -1,22 +0,0 @@
-import type {GraphQLFetch, GraphQLCache} from '@quilted/quilt/graphql';
-
-declare module '~/shared/context.ts' {
-  interface AppContext {
-    /**
-     * The app’s GraphQL client.
-     */
-    readonly graphql: {
-      /**
-       * A function to perform GraphQL operations.
-       */
-      readonly fetch: GraphQLFetch;
-
-      /**
-       * The app’s GraphQL cache.
-       */
-      readonly cache: GraphQLCache;
-    };
-  }
-}
-
-export {};

package/templates/app-graphql/shared/navigation.ts

@@ -1,15 +0,0 @@
-import type {Router} from '@quilted/quilt/navigation';
-import {createContextRouteFunction} from '@quilted/quilt/navigation';
-
-import type {AppContext} from '~/shared/context.ts';
-
-declare module '~/shared/context.ts' {
-  interface AppContext {
-    /**
-     * The router used to control navigation throughout the application.
-     */
-    readonly router: Router;
-  }
-}
-
-export const routeWithAppContext = createContextRouteFunction<AppContext>();

package/templates/app-trpc/shared/navigation.ts

@@ -1,15 +0,0 @@
-import type {Router} from '@quilted/quilt/navigation';
-import {createContextRouteFunction} from '@quilted/quilt/navigation';
-
-import type {AppContext} from '~/shared/context.ts';
-
-declare module '~/shared/context.ts' {
-  interface AppContext {
-    /**
-     * The router used to control navigation throughout the application.
-     */
-    readonly router: Router;
-  }
-}
-
-export const routeWithAppContext = createContextRouteFunction<AppContext>();

package/templates/app-trpc/shared/trpc.ts

@@ -1,18 +0,0 @@
-import type {TRPCUntypedClient} from '@trpc/client';
-import {createTRPCReact, type CreateTRPCReact} from '@trpc/react-query';
-import type {QueryClient} from '@tanstack/react-query';
-
-// Get access to our app’s router type signature, which will
-// provide strong typing on the queries and mutations we can
-// perform.
-import type {AppRouter} from '../trpc.ts';
-
-export const trpc: CreateTRPCReact<AppRouter, {}> =
-  createTRPCReact<AppRouter>();
-
-declare module '~/shared/context.ts' {
-  interface AppContext {
-    trpc: TRPCUntypedClient<AppRouter>;
-    queryClient: QueryClient;
-  }
-}