feat(web): add root app composition workspace

Split async-web into router, web, and webruntime packages, add root app composition helpers, and wire remote app connections plus AsyncDB contract context.

Author: PatrickJS

.github/workflows/ci.yml

@@ -21,19 +21,22 @@ jobs:
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
           node-version: 24
-          cache: npm
+          cache: pnpm
+
+      - name: Enable pnpm
+        run: corepack enable
 
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
 
       - name: Typecheck
-        run: npm run typecheck
+        run: pnpm typecheck
 
       - name: Test
-        run: npm test
+        run: pnpm test
 
       - name: Build
-        run: npm run build
+        run: pnpm build
 
       - name: Check package contents
-        run: npm pack --dry-run
+        run: pnpm -r pack:check

.github/workflows/release.yml

@@ -31,38 +31,52 @@ jobs:
         uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6
         with:
           node-version: 24
-          cache: npm
+          cache: pnpm
           registry-url: "https://registry.npmjs.org"
 
-      - name: Validate package version matches tag
+      - name: Enable pnpm
+        run: corepack enable
+
+      - name: Validate package versions match tag
         run: |
-          PACKAGE_VERSION="$(node -p "require('./package.json').version")"
-          if [ "v${PACKAGE_VERSION}" != "${RELEASE_TAG}" ]; then
-            echo "package.json version ${PACKAGE_VERSION} does not match tag ${RELEASE_TAG}" >&2
-            exit 1
-          fi
+          node --input-type=module <<'NODE'
+          import { readFileSync } from 'node:fs';
+
+          const releaseTag = process.env.RELEASE_TAG;
+          const packages = [
+            'packages/web/package.json'
+          ];
+
+          for (const packagePath of packages) {
+            const manifest = JSON.parse(readFileSync(packagePath, 'utf8'));
+            if (`v${manifest.version}` !== releaseTag) {
+              console.error(`${packagePath} version ${manifest.version} does not match ${releaseTag}`);
+              process.exitCode = 1;
+            }
+          }
+          NODE
 
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
 
       - name: Typecheck
-        run: npm run typecheck
+        run: pnpm typecheck
 
       - name: Test
-        run: npm test
+        run: pnpm test
 
       - name: Build
-        run: npm run build
+        run: pnpm build
 
-      - name: Pack
-        id: pack
+      - name: Pack packages
+        id: packs
         run: |
-          npm pack --json > pack.json
-          TARBALL="$(node -e "console.log(JSON.parse(require('node:fs').readFileSync('pack.json', 'utf8'))[0].filename)")"
-          echo "tarball=${TARBALL}" >> "$GITHUB_OUTPUT"
+          pnpm --dir packages/web pack --pack-destination "$PWD"
+          echo "web_tarball=$(ls async-web-*.tgz)" >> "$GITHUB_OUTPUT"
 
       - name: Publish to npm
-        run: npm publish "${{ steps.pack.outputs.tarball }}" --access public
+        run: |
+          npm publish "${{ steps.packs.outputs.web_tarball }}" --access public
 
       - name: Ensure GitHub Release exists
         env:
@@ -75,4 +89,5 @@ jobs:
       - name: Attach package tarball to GitHub Release
         env:
           GH_TOKEN: ${{ github.token }}
-        run: gh release upload "${RELEASE_TAG}" "${{ steps.pack.outputs.tarball }}" --clobber
+        run: |
+          gh release upload "${RELEASE_TAG}" "${{ steps.packs.outputs.web_tarball }}" --clobber

.gitignore

@@ -2,3 +2,7 @@
 /node_modules
 /dist
 /node_modules
+/packages/*/node_modules
+/packages/*/dist
+/packages/*/*.tsbuildinfo
+/*.tgz

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.1.0"
+  "packages/web": "0.1.0"
 }

CHANGELOG.md

@@ -1,22 +1,22 @@
 # Changelog
 
-## [0.1.0](https://github.com/async-framework/async-miniweb/releases/tag/v0.1.0) - 2026-05-28
+## [0.1.0](https://github.com/async-framework/async-web/releases/tag/v0.1.0) - 2026-05-28
 
-Initial public release of MiniWeb as `@async/miniweb`.
+Initial public release of Async Web as `@async/web`.
 
 ### Features
 
-- Added the MiniWeb `Request -> Response` simulator with fake frontend, service worker, network, edge/CDN, backend, tracing, delay, streaming, and virtual filesystem support.
+- Added the WebRuntime `Request -> Response` simulator with fake frontend, service worker, network, edge/CDN, backend, tracing, delay, streaming, and virtual filesystem support.
 - Added promise-based route middleware with mounted apps, mock/origin routes, cache helpers, redirects, rewrites, static file serving, and backend app dispatch.
 - Added scoped platform APIs for per-runtime `fetch`, storage, cookies, cache storage, timers, crypto, encoding, messaging, navigator state, and fake locations.
 - Added same-realm and iframe runtime configuration for registered frontend and backend apps.
-- Added MiniWeb-to-MiniWeb routing and streaming through the virtual network.
+- Added WebRuntime-to-WebRuntime routing and streaming through the virtual network.
 - Added browser shell examples for full-stack demos, service-worker-style cache, edge cache, streaming, multi-app routing, request bodies, platform fetch chains, and stateful session/cache behavior.
-- Added the `@async/miniweb/platform` authoring facade and `@async/miniweb/vite` plugin for dev-time MiniWeb APIs and build-time native globals.
+- Added the `@async/web/runtime/platform` authoring facade and `@async/web/runtime/vite` plugin for dev-time WebRuntime APIs and build-time native globals.
 
 ### Tests
 
-- Added coverage for memory filesystem, fake location/history/navigation, service worker routing, pipeline tracing, delay, edge cache/transforms, request bodies, streaming responses, MiniWeb network streaming, platform state, iframe runtime config, browser shell routing, and Vite platform import behavior.
+- Added coverage for memory filesystem, fake location/history/navigation, service worker routing, pipeline tracing, delay, edge cache/transforms, request bodies, streaming responses, WebRuntime network streaming, platform state, iframe runtime config, browser shell routing, and Vite platform import behavior.
 
 ### Documentation