@quilted/create 0.3.2 → 0.3.4

package/CHANGELOG.md

@@ -1,5 +1,116 @@
 # @quilted/create
 
+## 0.3.4
+
+### Patch Changes
+
+- [`e6fa47e`](https://github.com/lemonmade/quilt/commit/e6fa47e93981ce0eaebbe1546659aaa08cc22689) Thanks [@lemonmade](https://github.com/lemonmade)! - Update Preact and Signal dependencies
+
+## 0.3.3
+
+### Patch Changes
+
+- [#890](https://github.com/lemonmade/quilt/pull/890) [`b0f2334`](https://github.com/lemonmade/quilt/commit/b0f23340945280c951998bf77b3be8b8df13338c) Thanks [@lemonmade](https://github.com/lemonmade)! - Redesign asset loading APIs for better performance and clearer structure.
+
+  ## Breaking changes
+
+  ### `@quilted/assets`: `BrowserAssetsEntry` redesigned
+
+  The `BrowserAssetsEntry` type has been completely restructured. The previous flat `scripts` and `styles` arrays have been replaced with structured `script` and `style` objects that separate the entry asset from its dependencies:
+
+  ```ts
+  // Before
+  interface BrowserAssetsEntry {
+    scripts: Asset[];
+    styles: Asset[];
+  }
+
+  // After
+  interface BrowserAssetsEntry {
+    script?: {
+      asset: Asset;
+      syncDependencies: readonly Asset[];
+      asyncDependencies: readonly Asset[];
+    };
+    style?: {
+      asset: Asset;
+      syncDependencies: readonly Asset[];
+      asyncDependencies: readonly Asset[];
+    };
+  }
+  ```
+
+  This separation enables the renderer to treat the entry script, its preloadable sync dependencies, and its async dependencies differently in the HTML output.
+
+  ### `@quilted/assets`: `BrowserAssets.modules()` return type changed
+
+  `modules()` now returns `readonly BrowserAssetsEntry[]` (one entry per module ID) instead of a single merged `BrowserAssetsEntry`:
+
+  ```ts
+  // Before
+  modules(modules: Iterable<...>, options?): BrowserAssetsEntry;
+
+  // After
+  modules(modules: Iterable<string>, options?): readonly BrowserAssetsEntry[];
+  ```
+
+  ### `@quilted/assets`: `BrowserAssetModuleSelector` removed
+
+  The `BrowserAssetModuleSelector` interface and the `modules` field on `BrowserAssetSelector` have been removed. If you want to get the asset details for modules in addition to the entrypoints, use `BrowserAssets.modules()` instead.
+
+  ### `@quilted/assets`: `AssetBuildManifest` module entry format changed
+
+  `AssetBuildManifest.modules` values changed from `number[]` to the new `AssetBuildModuleEntry` tuple type. The tuple uses positional slots for each asset category and is serialized in JSON as an object with numeric string keys (omitting empty positions):
+
+  ```ts
+  type AssetBuildModuleEntry = [
+    script?: number, // [0] entry JS chunk
+    style?: number, // [1] entry CSS file
+    scriptSync?: number[], // [2] sync JS dependency indices
+    styleSync?: number[], // [3] CSS from sync JS dependencies
+    scriptAsync?: number[], // [4] dynamic JS dependency indices
+    styleAsync?: number[], // [5] CSS from dynamic JS dependencies
+  ];
+  ```
+
+  ### `@quilted/browser`: `BrowserResponseAssets.get()` return type changed
+
+  `get()` now returns `string[]` (module IDs) instead of `BrowserAssetModuleSelector[]`.
+
+  ## New features
+
+  ### `@quilted/preact-browser`: `BrowserApp` class
+
+  A new `BrowserApp` class simplifies constructing and running a browser app. It handles waiting for the `#app` DOM element via `MutationObserver`, which is necessary now that the entry script runs with the `async` attribute:
+
+  ```ts
+  import {BrowserApp} from '@quilted/quilt/browser';
+  import {BrowserAppContext} from '~/context/browser.ts';
+  import {App} from './App.tsx';
+
+  const context = new BrowserAppContext();
+  const app = new BrowserApp(<App context={context} />, {context});
+  await app.hydrate();
+  ```
+
+  ## Render behavior changes
+
+  ### Entry script rendered as `async` module
+
+  The browser entry script is now rendered as `<script type="module" async>` instead of a blocking `<script type="module">`. This means the script no longer blocks HTML parsing, and does not wait for DOMContentLoaded. This change is meant to allow streaming HTML responses to begin executing JavaScript earlier.
+
+  ### Sync dependencies rendered as `modulepreload` links
+
+  Sync JS dependencies (previously rendered as additional `<script type="module">` tags) are now rendered as `<link rel="modulepreload">` hints. This tells the browser to fetch them eagerly without executing them, since the entry script will import them when it runs.
+
+  ### Stylesheets rendered after all script references
+
+  Entry and async stylesheets are now emitted from the `<HTMLTemplate.Assets async />` placeholder, after all script and modulepreload tags. This ensures the stylesheet `<link>` elements appear after all JS references in the HTML.
+
+  ### Asset deduplication across streamed chunks
+
+  Asset deduplication (preventing the same `src`/`href` from appearing more than once) now works across all streamed HTML chunks within a single response, not just within a single placeholder.
+
 ## 0.3.2
 
 ### Patch Changes

package/build/esnext/_virtual/index7.esnext

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

package/build/esnext/_virtual/index8.esnext

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

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

@@ -1,4 +1,4 @@
-import { __module as dirGlob } from '../../../../../_virtual/index8.esnext';
+import { __module as dirGlob } from '../../../../../_virtual/index7.esnext';
 import path__default from 'node:path';
 import { __require as requirePathType } from '../../../path-type@4.0.0/node_modules/path-type/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/stream3.esnext';
+import { __exports as stream } from '../../../../../../../_virtual/stream2.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/index.esnext

@@ -1,4 +1,4 @@
-import { __exports as utils } from '../../../../../../../_virtual/index7.esnext';
+import { __exports as utils } from '../../../../../../../_virtual/index8.esnext';
 import { __require as requireArray } from './array.esnext';
 import { __require as requireErrno } from './errno.esnext';
 import { __require as requireFs } from './fs.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/stream2.esnext';
+import { __exports as stream } from '../../../../../../../_virtual/stream3.esnext';
 import { __require as requireMerge2 } from '../../../../../merge2@1.4.1/node_modules/merge2/index.esnext';
 
 var hasRequiredStream;

package/package.json

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

package/templates/app-basic/App.tsx

@@ -1,6 +1,6 @@
 import {NotFound} from '@quilted/quilt/server';
-import {Navigation} from '@quilted/quilt/navigation';
-import {Localization} from '@quilted/quilt/localize';
+import {Routes} from '@quilted/quilt/navigation';
+import {QuiltFrameworkContext} from '@quilted/quilt/context';
 
 import {Head} from './foundation/html.ts';
 import {Frame} from './foundation/frame.ts';
@@ -15,8 +15,6 @@ export interface AppProps {
   context: AppContext;
 }
 
-// Define the routes for your application. If you have a lot of routes, you
-// might want to split this into a separate file.
 const routes = [
   routeWithAppContext('*', {
     render: (children) => <Frame>{children}</Frame>,
@@ -32,19 +30,16 @@ const routes = [
   }),
 ];
 
-// The root component for your application. You will typically render any
-// app-wide context in this component.
 export function App({context}: AppProps) {
   return (
     <AppContextPreact.Provider value={context}>
-      <Localization>
+      <QuiltFrameworkContext
+        navigation={context.navigation}
+        localization={context.localization}
+      >
         <Head />
-        <Navigation
-          router={context.navigation.router}
-          routes={routes}
-          context={context}
-        />
-      </Localization>
+        <Routes list={routes} context={context} />
+      </QuiltFrameworkContext>
     </AppContextPreact.Provider>
   );
 }

package/templates/app-basic/browser.tsx

@@ -1,45 +1,26 @@
 import './browser.css';
 
-import type {ComponentChild} from 'preact';
-import {hydrate} from '@quilted/quilt/browser';
+import {BrowserApp} from '@quilted/quilt/browser';
 
 import {BrowserAppContext} from '~/context/browser.ts';
 import {App} from './App.tsx';
 
-class BrowserApp {
-  /**
-   * The app’s globally-available context.
-   */
-  readonly context: BrowserAppContext;
-
-  /**
-   * The app’s root JSX element, seeded with the necessary app context.
-   */
-  readonly rendered: ComponentChild;
-
-  constructor() {
-    this.context = new BrowserAppContext();
-    this.rendered = <App context={this.context} />;
-
-    // Makes key parts of the app available in the browser console.
-    //
-    // @example
-    // ```js
-    // // Log the current URL
-    // console.log(globalThis.app.context.router.currentRequest.url);
-    // ```
-    Object.defineProperty(globalThis, 'app', {
-      value: this,
-      enumerable: false,
-      configurable: true,
-      writable: true,
-    });
-  }
-
-  hydrate() {
-    hydrate(this.rendered);
-  }
-}
-
-const app = new BrowserApp();
-app.hydrate();
+const context = new BrowserAppContext();
+
+const app = new BrowserApp(<App context={context} />, {context});
+
+// Makes key parts of the app available in the browser console.
+//
+// @example
+// ```js
+// // Log the current URL
+// console.log(globalThis.app.context.navigation.currentRequest.url);
+// ```
+Object.defineProperty(globalThis, 'app', {
+  value: app,
+  enumerable: false,
+  configurable: true,
+  writable: true,
+});
+
+await app.hydrate();

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

@@ -1,10 +1,14 @@
+import {Navigation} from '@quilted/quilt/navigation';
+import {Localization} from '@quilted/quilt/localize';
+
 import type {AppContext} from './types.ts';
-import {NavigationForApp} from './navigation.ts';
 
 export class BrowserAppContext implements AppContext {
-  readonly navigation: NavigationForApp;
+  readonly navigation: Navigation;
+  readonly localization: Localization;
 
   constructor() {
-    this.navigation = new NavigationForApp();
+    this.navigation = new Navigation();
+    this.localization = new Localization(navigator.language);
   }
 }

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

@@ -1,17 +1,10 @@
-import {createContextRouteFunction, Router} from '@quilted/quilt/navigation';
+import {
+  createContextRouteFunction,
+  Navigation,
+} 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>();
+
+export {Navigation};

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

@@ -2,5 +2,14 @@ import {createOptionalContext} from '@quilted/quilt/context';
 
 import type {AppContext} from './types.ts';
 
+/**
+ * The Preact context object for this application's shared context.
+ * Provide it in `App.tsx` via `<AppContextPreact.Provider value={context}>`.
+ */
 export const AppContextPreact = createOptionalContext<AppContext>();
+
+/**
+ * Returns the app's shared context. All fields in `AppContext` are required
+ * and will be available anywhere inside `<AppContextPreact.Provider>`.
+ */
 export const useAppContext = AppContextPreact.use;

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

@@ -1,10 +1,17 @@
+import {Navigation} from '@quilted/quilt/navigation';
+import {Localization, parseAcceptLanguageHeader} from '@quilted/quilt/localize';
+
 import type {AppContext} from './types.ts';
-import {NavigationForApp} from './navigation.ts';
 
 export class ServerAppContext implements AppContext {
-  readonly navigation: NavigationForApp;
+  readonly navigation: Navigation;
+  readonly localization: Localization;
 
   constructor(request: Request) {
-    this.navigation = new NavigationForApp(request.url);
+    this.navigation = new Navigation(request.url);
+    this.localization = new Localization(
+      parseAcceptLanguageHeader(request.headers.get('Accept-Language') ?? '') ??
+        'en',
+    );
   }
 }

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

@@ -1,5 +1,24 @@
-import type {Navigation} from './navigation.ts';
+import type {Navigation} from '@quilted/quilt/navigation';
+import type {Localization} from '@quilted/quilt/localize';
 
+/**
+ * The shared context for this application. Values in this object are
+ * available to all components in the app via `useQuiltContext()` hooks
+ * or the `useAppContext()` convenience hook.
+ *
+ * This interface extends a subset of `QuiltContext`, providing the
+ * navigation and localization fields as required (non-optional) values.
+ */
 export interface AppContext {
+  /**
+   * The navigation instance for this application. Manages the current URL,
+   * browser history, and programmatic navigation.
+   */
   readonly navigation: Navigation;
+
+  /**
+   * The localization instance for this application. Contains the active
+   * locale and formatting utilities for numbers, dates, currencies, and more.
+   */
+  readonly localization: Localization;
 }

package/templates/app-basic/package.json

@@ -18,7 +18,7 @@
     "@quilted/quilt": "^0.9.0",
     "hono": "^4.8.0",
     "jsdom": "^26.0.0",
-    "preact": "^10.26.0",
+    "preact": "^10.29.0",
     "react": "npm:@quilted/react@^19.0.0",
     "react-dom": "npm:@quilted/react-dom@^19.0.0"
   },

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

@@ -1,12 +1,8 @@
 import {createRender} from '@quilted/quilt/testing';
-import {
-  BrowserDetailsContext,
-  BrowserTestMock,
-} from '@quilted/quilt/browser/testing';
-import {Navigation, TestRouter} from '@quilted/quilt/navigation/testing';
+import {TestBrowser} from '@quilted/quilt/browser/testing';
+import {TestNavigation} from '@quilted/quilt/navigation/testing';
 import {Localization} from '@quilted/quilt/localize';
-
-import {AppContextPreact} from '~/context/preact.ts';
+import {QuiltFrameworkTestContext} from '@quilted/quilt/context/testing';
 
 import {RenderOptions, RenderContext, RenderActions} from './types.ts';
 
@@ -23,24 +19,23 @@ export const renderApp = createRender<
   // Create context that can be used by the `render` function, and referenced by test
   // 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 {navigation: {router}, browser};
+  context({
+    navigation = new TestNavigation(),
+    browser = new TestBrowser(),
+    localization = new Localization('en'),
+  }) {
+    return {navigation, browser, localization};
   },
   // Render all of our app-wide context providers around each component under test.
-  render(element, context, {locale = 'en'}) {
-    const {
-      navigation: {router},
-      browser,
-    } = context;
-
+  render(element, {navigation, browser, localization}) {
     return (
-      <AppContextPreact.Provider value={context}>
-        <BrowserDetailsContext.Provider value={browser}>
-          <Localization locale={locale}>
-            <Navigation router={router}>{element}</Navigation>
-          </Localization>
-        </BrowserDetailsContext.Provider>
-      </AppContextPreact.Provider>
+      <QuiltFrameworkTestContext
+        navigation={navigation}
+        browser={browser}
+        localization={localization}
+      >
+        {element}
+      </QuiltFrameworkTestContext>
     );
   },
   async afterRender() {

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

@@ -1,38 +1,42 @@
-import type {TestRouter} from '@quilted/quilt/navigation/testing';
-import type {BrowserTestMock} from '@quilted/quilt/browser/testing';
-
-import type {AppContext} from '~/context/types.ts';
+import type {TestNavigation} from '@quilted/quilt/navigation/testing';
+import type {TestBrowser} from '@quilted/quilt/browser/testing';
+import type {Localization} from '@quilted/quilt/localize';
 
 export interface RenderOptions {
   /**
-   * A custom router to use for this component test. You can use a
+   * A custom navigation to use for this component test. You can use a
    * custom router to simulate a particular URL, and you can spy on
    * its navigation method to check that components navigate as
    * you expect.
    */
-  readonly router?: TestRouter;
+  readonly navigation?: TestNavigation;
 
   /**
    * A custom environment for this component test.
    */
-  readonly browser?: BrowserTestMock;
+  readonly browser?: TestBrowser;
 
   /**
-   * A custom locale to use for this component test.
+   * A custom localization instance to use for this component test.
    */
-  readonly locale?: string;
+  readonly localization?: Localization;
 }
 
-export interface RenderContext extends AppContext {
+export interface RenderContext {
   /**
-   * The router used for this component test.
+   * The navigation used for this component test.
    */
-  readonly navigation: {router: TestRouter};
+  readonly navigation: TestNavigation;
 
   /**
    * The browser environment for this component test.
    */
-  readonly browser: BrowserTestMock;
+  readonly browser: TestBrowser;
+
+  /**
+   * The localization used for this component test.
+   */
+  readonly localization: Localization;
 }
 
 export interface RenderActions extends Record<string, never> {}

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

@@ -1,6 +1,6 @@
 import '@quilted/quilt/testing';
 
-export {TestRouter} from '@quilted/quilt/navigation/testing';
+export {TestNavigation} from '@quilted/quilt/navigation/testing';
 
 export * from './render/types.ts';
 export {renderApp} from './render/render.tsx';

package/templates/app-empty/package.json

@@ -17,7 +17,7 @@
   "devDependencies": {
     "@quilted/quilt": "^0.9.0",
     "hono": "^4.8.0",
-    "preact": "^10.26.0",
+    "preact": "^10.29.0",
     "react": "npm:@quilted/react@^19.0.0",
     "react-dom": "npm:@quilted/react-dom@^19.0.0"
   },

package/templates/app-graphql/App.tsx

@@ -1,7 +1,6 @@
 import {NotFound} from '@quilted/quilt/server';
-import {GraphQLContext} from '@quilted/quilt/graphql';
-import {Navigation} from '@quilted/quilt/navigation';
-import {Localization} from '@quilted/quilt/localize';
+import {Routes} from '@quilted/quilt/navigation';
+import {QuiltFrameworkContext} from '@quilted/quilt/context';
 
 import {Head} from './foundation/html.ts';
 import {Frame} from './foundation/frame.ts';
@@ -24,7 +23,7 @@ const routes = [
     children: [
       routeWithAppContext('/', {
         async load({context: {graphql}}) {
-          await Promise.all([Home.load(), graphql.cache.query(homeQuery)]);
+          await Promise.all([Home.load(), graphql.cache?.query(homeQuery)]);
         },
         render: <Home />,
       }),
@@ -38,19 +37,14 @@ const routes = [
 export function App({context}: AppProps) {
   return (
     <AppContextPreact.Provider value={context}>
-      <GraphQLContext
-        fetch={context.graphql.fetch}
-        cache={context.graphql.cache}
+      <QuiltFrameworkContext
+        navigation={context.navigation}
+        localization={context.localization}
+        graphql={context.graphql}
       >
-        <Localization>
-          <Head />
-          <Navigation
-            router={context.navigation.router}
-            routes={routes}
-            context={context}
-          />
-        </Localization>
-      </GraphQLContext>
+        <Head />
+        <Routes list={routes} context={context} />
+      </QuiltFrameworkContext>
     </AppContextPreact.Provider>
   );
 }

package/templates/app-graphql/browser.tsx

@@ -1,46 +1,27 @@
 import './browser.css';
 
-import type {ComponentChild} from 'preact';
-import {hydrate} from '@quilted/quilt/browser';
+import {BrowserApp} from '@quilted/quilt/browser';
 
 import {BrowserAppContext} from '~/context/browser.ts';
 
 import {App} from './App.tsx';
 
-class BrowserApp {
-  /**
-   * The app's globally-available context.
-   */
-  readonly context: BrowserAppContext;
-
-  /**
-   * The app's root JSX element, seeded with the necessary app context.
-   */
-  readonly rendered: ComponentChild;
-
-  constructor() {
-    this.context = new BrowserAppContext();
-    this.rendered = <App context={this.context} />;
-
-    // Makes key parts of the app available in the browser console.
-    //
-    // @example
-    // ```js
-    // // Log the current URL
-    // console.log(globalThis.app.context.navigation.router.currentRequest.url);
-    // ```
-    Object.defineProperty(globalThis, 'app', {
-      value: this,
-      enumerable: false,
-      configurable: true,
-      writable: true,
-    });
-  }
-
-  hydrate() {
-    hydrate(this.rendered);
-  }
-}
-
-const app = new BrowserApp();
-app.hydrate();
+const context = new BrowserAppContext();
+
+const app = new BrowserApp(<App context={context} />, {context});
+
+// Makes key parts of the app available in the browser console.
+//
+// @example
+// ```js
+// // Log the current URL
+// console.log(globalThis.app.context.navigation.currentRequest.url);
+// ```
+Object.defineProperty(globalThis, 'app', {
+  value: app,
+  enumerable: false,
+  configurable: true,
+  writable: true,
+});
+
+await app.hydrate();