@ecopages/core 0.2.0-beta.3 → 0.2.0-beta.31

package/README.md

@@ -186,31 +186,60 @@ Dependency ownership affects final asset packaging:
 
 ### 5. API Handlers
 
-Add server-side routes using `defineApiHandler`. Register them on your `app` instance before starting:
+Add server-side routes using `defineApiHandler` or the method helpers (`defineGet`, `definePost`, …). Register them on your `app` instance before starting:
 
 ```typescript
-import { defineApiHandler } from '@ecopages/core';
+import { defineApiHandler, defineGet, json } from '@ecopages/core';
 
-export const helloWorld = defineApiHandler({
+export const helloWorld = defineGet({
 	path: '/api/hello',
-	method: 'GET',
 	handler: async ({ response }) => {
 		return response.json({ message: 'Hello World' });
 	},
 });
+
+// Equivalent with an explicit method:
+export const helloWorldAlt = defineApiHandler({
+	path: '/api/hello',
+	method: 'GET',
+	handler: async () => json({ message: 'Hello World' }),
+});
+```
+
+Group related routes with `defineGroupHandler`. Prefer `api.get` / `api.post` helpers inside the `routes` callback:
+
+```typescript
+import { defineGroupHandler } from '@ecopages/core';
+
+export const adminGroup = defineGroupHandler({
+	prefix: '/admin',
+	routes: (api) => [
+		api.get({
+			path: '/',
+			handler: async ({ response }) => response.json({ ok: true }),
+		}),
+		api.post({
+			path: '/items',
+			handler: async ({ response }) => response.status(201).json({ created: true }),
+		}),
+	],
+});
 ```
 
+Standalone response helpers (`json`, `html`, `redirect`) share the same body emission path as `context.response.json()` / `context.response.html()`.
+
+Register a prebuilt handler with `app.add()`. Use `app.get(path, handler)` only when defining the route inline in `app.ts`.
+
 Attach the handler in your `app.ts` entry:
 
 ```typescript
-// app.ts
 import { createApp } from '@ecopages/core/create-app';
 import { helloWorld } from './handlers/hello';
 import appConfig from './eco.config';
 
 const app = await createApp({ appConfig });
 
-app.get(helloWorld); // Register the API handler
+app.add(helloWorld);
 
 await app.start();
 ```
@@ -223,11 +252,11 @@ Use the `create-app` subpath for runtime startup and the root package for standa
 
 ```ts
 import { createApp } from '@ecopages/core/create-app';
-import { defineApiHandler, defineGroupHandler, eco } from '@ecopages/core';
+import { defineApiHandler, defineGet, defineGroupHandler, eco } from '@ecopages/core';
 ```
 
 > [!NOTE]
-> `createApp` is the recommended entrypoint over `EcopagesApp`.
+> Use `createApp()` from `@ecopages/core/create-app` as the application entrypoint.
 
 ### Runtime Escape Hatches
 
@@ -267,7 +296,7 @@ Use these entrypoints when implementing integrations, processors, or source tran
 - `@ecopages/core/plugins/integration-plugin`
 - `@ecopages/core/plugins/processor`
 - `@ecopages/core/plugins/source-transform`
-- `@ecopages/core/route-renderer/integration-renderer`
+- `@ecopages/core/route-renderer/orchestration/integration-renderer`
 - `@ecopages/core/services/asset-processing-service`
 - `@ecopages/core/hmr/hmr-strategy`
 - `@ecopages/core/integrations/ghtml`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecopages/core",
-  "version": "0.2.0-beta.3",
+  "version": "0.2.0-beta.31",
   "description": "Core package for Ecopages",
   "keywords": [
     "ecopages",
@@ -13,11 +13,11 @@
   "sideEffects": false,
   "repository": {
     "type": "git",
-    "url": "https://github.com/ecopages/ecopages.git",
+    "url": "git+https://github.com/ecopages/ecopages.git",
     "directory": "packages/core"
   },
   "dependencies": {
-    "@ecopages/file-system": "0.2.0-beta.3",
+    "@ecopages/file-system": "0.2.0-beta.31",
     "@ecopages/logger": "^0.2.3",
     "@ecopages/scripts-injector": "^0.1.5",
     "@oxc-project/runtime": "0.134.0",
@@ -26,8 +26,11 @@
     "esbuild": "^0.28.0",
     "ghtml": "^4.0.2",
     "oxc-parser": "^0.124.0",
+    "oxc-resolver": "^11.24.2",
     "rolldown": "^1.1.0",
-    "ws": "^8.20.1"
+    "ws": "^8.20.1",
+    "@standard-schema/spec": "^1.1.0",
+    "@standard-schema/utils": "^0.3.0"
   },
   "exports": {
     ".": {
@@ -41,14 +44,38 @@
       "types": "./src/adapters/create-app.d.ts",
       "default": "./src/adapters/create-app.js"
     },
-    "./route-renderer/integration-renderer": {
+    "./route-renderer/orchestration/integration-renderer": {
       "types": "./src/route-renderer/orchestration/integration-renderer.d.ts",
       "default": "./src/route-renderer/orchestration/integration-renderer.js"
     },
-    "./route-renderer/component-render-context": {
-      "import": "./src/route-renderer/orchestration/component-render-context.js",
-      "types": "./src/route-renderer/orchestration/component-render-context.d.ts",
-      "default": "./src/route-renderer/orchestration/component-render-context.js"
+    "./route-renderer/orchestration/string-markup-renderer": {
+      "types": "./src/route-renderer/orchestration/string-markup-renderer.d.ts",
+      "default": "./src/route-renderer/orchestration/string-markup-renderer.js"
+    },
+    "./route-renderer/route-renderer": {
+      "types": "./src/route-renderer/route-renderer.d.ts",
+      "default": "./src/route-renderer/route-renderer.js"
+    },
+    "./route-renderer/orchestration/foreign-child/component-render-context": {
+      "import": "./src/route-renderer/orchestration/foreign-child/component-render-context.js",
+      "types": "./src/route-renderer/orchestration/foreign-child/component-render-context.d.ts",
+      "default": "./src/route-renderer/orchestration/foreign-child/component-render-context.js"
+    },
+    "./route-renderer/orchestration/foreign-child/foreign-subtree-execution.service": {
+      "types": "./src/route-renderer/orchestration/foreign-child/foreign-subtree-execution.service.d.ts",
+      "default": "./src/route-renderer/orchestration/foreign-child/foreign-subtree-execution.service.js"
+    },
+    "./route-renderer/orchestration/document-shell/document-shell-render.service": {
+      "types": "./src/route-renderer/orchestration/document-shell/document-shell-render.service.d.ts",
+      "default": "./src/route-renderer/orchestration/document-shell/document-shell-render.service.js"
+    },
+    "./route-renderer/orchestration/page-browser-graph/page-browser-graph-merge.utils": {
+      "types": "./src/route-renderer/orchestration/page-browser-graph/page-browser-graph-merge.utils.d.ts",
+      "default": "./src/route-renderer/orchestration/page-browser-graph/page-browser-graph-merge.utils.js"
+    },
+    "./route-renderer/orchestration/foreign-child/owning-renderer-resolution": {
+      "types": "./src/route-renderer/orchestration/foreign-child/owning-renderer-resolution.d.ts",
+      "default": "./src/route-renderer/orchestration/foreign-child/owning-renderer-resolution.js"
     },
     "./router/navigation-coordinator": {
       "types": "./src/router/client/navigation-coordinator.d.ts",
@@ -58,11 +85,31 @@
       "types": "./src/router/client/link-intent.d.ts",
       "default": "./src/router/client/link-intent.js"
     },
+    "./router/link-navigation-policy": {
+      "types": "./src/router/client/link-navigation-policy.d.ts",
+      "default": "./src/router/client/link-navigation-policy.js"
+    },
+    "./client/scroll": {
+      "types": "./src/client/scroll.d.ts",
+      "default": "./src/client/scroll.js"
+    },
+    "./client/view-transitions": {
+      "types": "./src/client/view-transitions.d.ts",
+      "default": "./src/client/view-transitions.js"
+    },
+    "./client/navigation-scripts": {
+      "types": "./src/client/navigation-scripts/index.d.ts",
+      "default": "./src/client/navigation-scripts/index.js"
+    },
     "./eco": {
       "browser": "./src/eco/eco.browser.js",
       "types": "./src/eco/eco.d.ts",
       "default": "./src/eco/eco.js"
     },
+    "./eco/page-layout-normalization": {
+      "types": "./src/eco/page-layout-normalization.d.ts",
+      "default": "./src/eco/page-layout-normalization.js"
+    },
     "./declarations": {
       "types": "./src/declarations.d.ts"
     },
@@ -77,6 +124,10 @@
       "types": "./src/config/constants.d.ts",
       "default": "./src/config/constants.js"
     },
+    "./diagnostics/startup-trace": {
+      "types": "./src/diagnostics/startup-trace.d.ts",
+      "default": "./src/diagnostics/startup-trace.js"
+    },
     "./bun": {
       "types": "./src/adapters/bun/index.d.ts",
       "default": "./src/adapters/bun/index.js"
@@ -85,6 +136,10 @@
       "types": "./src/hmr/hmr-strategy.d.ts",
       "default": "./src/hmr/hmr-strategy.js"
     },
+    "./hmr/hmr-file-change-prep": {
+      "types": "./src/hmr/hmr-file-change-prep.d.ts",
+      "default": "./src/hmr/hmr-file-change-prep.js"
+    },
     "./hmr/client/hmr-runtime": {
       "types": "./src/hmr/client/hmr-runtime.d.ts",
       "default": "./src/hmr/client/hmr-runtime.js"
@@ -93,6 +148,18 @@
       "types": "./src/dev/host-runtime.d.ts",
       "default": "./src/dev/host-runtime.js"
     },
+    "./dev/client-bridge-registry": {
+      "types": "./src/dev/client-bridge-registry.d.ts",
+      "default": "./src/dev/client-bridge-registry.js"
+    },
+    "./dev/hmr-manager-registry": {
+      "types": "./src/dev/hmr-manager-registry.d.ts",
+      "default": "./src/dev/hmr-manager-registry.js"
+    },
+    "./dev/dev-client-ownership": {
+      "types": "./src/dev/dev-client-ownership.d.ts",
+      "default": "./src/dev/dev-client-ownership.js"
+    },
     "./services/asset-processing-service": {
       "types": "./src/services/assets/asset-processing-service/index.d.ts",
       "default": "./src/services/assets/asset-processing-service/index.js"
@@ -105,29 +172,57 @@
       "types": "./src/plugins/integration-plugin.d.ts",
       "default": "./src/plugins/integration-plugin.js"
     },
+    "./plugins/define-integration": {
+      "types": "./src/plugins/define-integration.d.ts",
+      "default": "./src/plugins/define-integration.js"
+    },
     "./plugins/source-transform": {
       "types": "./src/plugins/source-transform.d.ts",
       "default": "./src/plugins/source-transform.js"
     },
     "./build/build-types": {
-      "types": "./src/build/build-types.d.ts",
-      "default": "./src/build/build-types.js"
+      "types": "./src/build/contracts/build-types.d.ts",
+      "default": "./src/build/contracts/build-types.js"
     },
     "./build/build-adapter": {
       "types": "./src/build/build-adapter.d.ts",
       "default": "./src/build/build-adapter.js"
     },
+    "./build/build-runtime": {
+      "types": "./src/build/runtime/build-runtime.d.ts",
+      "default": "./src/build/runtime/build-runtime.js"
+    },
+    "./build/build-contracts": {
+      "types": "./src/build/contracts/build-contracts.d.ts",
+      "default": "./src/build/contracts/build-contracts.js"
+    },
+    "./build/production-build-cache": {
+      "types": "./src/build/cache/production-build-cache.d.ts",
+      "default": "./src/build/cache/production-build-cache.js"
+    },
+    "./build/server-entry-build-cache": {
+      "types": "./src/build/cache/server-entry-build-cache.d.ts",
+      "default": "./src/build/cache/server-entry-build-cache.js"
+    },
     "./build/runtime-build-output-normalizer": {
-      "types": "./src/build/runtime-build-output-normalizer.d.ts",
-      "default": "./src/build/runtime-build-output-normalizer.js"
+      "types": "./src/build/rolldown/runtime-build-output-normalizer.d.ts",
+      "default": "./src/build/rolldown/runtime-build-output-normalizer.js"
     },
     "./build/browser-runtime-manifest": {
-      "types": "./src/build/browser-runtime-manifest.d.ts",
-      "default": "./src/build/browser-runtime-manifest.js"
+      "types": "./src/build/browser/browser-runtime-manifest.d.ts",
+      "default": "./src/build/browser/browser-runtime-manifest.js"
     },
     "./build/browser-runtime-plugin": {
-      "types": "./src/build/browser-runtime-plugin.d.ts",
-      "default": "./src/build/browser-runtime-plugin.js"
+      "types": "./src/build/browser/browser-runtime-plugin.d.ts",
+      "default": "./src/build/browser/browser-runtime-plugin.js"
+    },
+    "./build/jsx-ownership-plugins": {
+      "types": "./src/build/browser/jsx-ownership-plugins.d.ts",
+      "default": "./src/build/browser/jsx-ownership-plugins.js"
+    },
+    "./build/lit-static-render-worker-context": {
+      "types": "./src/build/browser/lit-static-render-worker-context.d.ts",
+      "default": "./src/build/browser/lit-static-render-worker-context.js"
     },
     "./cache": {
       "types": "./src/cache/index.d.ts",
@@ -137,6 +232,18 @@
       "types": "./src/plugins/foreign-jsx-override-plugin.d.ts",
       "default": "./src/plugins/foreign-jsx-override-plugin.js"
     },
+    "./plugins/alias-resolver-plugin": {
+      "types": "./src/plugins/alias-resolver-plugin.d.ts",
+      "default": "./src/plugins/alias-resolver-plugin.js"
+    },
+    "./plugins/tsconfig-import-resolver": {
+      "types": "./src/plugins/tsconfig-import-resolver.d.ts",
+      "default": "./src/plugins/tsconfig-import-resolver.js"
+    },
+    "./plugins/jsx-import-source.utils": {
+      "types": "./src/plugins/jsx-import-source.utils.d.ts",
+      "default": "./src/plugins/jsx-import-source.utils.js"
+    },
     "./html": {
       "import": "./src/utils/html.js",
       "default": "./src/utils/html.js",
@@ -170,14 +277,38 @@
       "types": "./src/adapters/create-app.d.ts",
       "default": "./src/adapters/create-app.js"
     },
-    "./route-renderer/integration-renderer.ts": {
+    "./route-renderer/orchestration/integration-renderer.ts": {
       "types": "./src/route-renderer/orchestration/integration-renderer.d.ts",
       "default": "./src/route-renderer/orchestration/integration-renderer.js"
     },
-    "./route-renderer/component-render-context.ts": {
-      "import": "./src/route-renderer/orchestration/component-render-context.js",
-      "types": "./src/route-renderer/orchestration/component-render-context.d.ts",
-      "default": "./src/route-renderer/orchestration/component-render-context.js"
+    "./route-renderer/orchestration/string-markup-renderer.ts": {
+      "types": "./src/route-renderer/orchestration/string-markup-renderer.d.ts",
+      "default": "./src/route-renderer/orchestration/string-markup-renderer.js"
+    },
+    "./route-renderer/route-renderer.ts": {
+      "types": "./src/route-renderer/route-renderer.d.ts",
+      "default": "./src/route-renderer/route-renderer.js"
+    },
+    "./route-renderer/orchestration/foreign-child/component-render-context.ts": {
+      "import": "./src/route-renderer/orchestration/foreign-child/component-render-context.js",
+      "types": "./src/route-renderer/orchestration/foreign-child/component-render-context.d.ts",
+      "default": "./src/route-renderer/orchestration/foreign-child/component-render-context.js"
+    },
+    "./route-renderer/orchestration/foreign-child/foreign-subtree-execution.service.ts": {
+      "types": "./src/route-renderer/orchestration/foreign-child/foreign-subtree-execution.service.d.ts",
+      "default": "./src/route-renderer/orchestration/foreign-child/foreign-subtree-execution.service.js"
+    },
+    "./route-renderer/orchestration/document-shell/document-shell-render.service.ts": {
+      "types": "./src/route-renderer/orchestration/document-shell/document-shell-render.service.d.ts",
+      "default": "./src/route-renderer/orchestration/document-shell/document-shell-render.service.js"
+    },
+    "./route-renderer/orchestration/page-browser-graph/page-browser-graph-merge.utils.ts": {
+      "types": "./src/route-renderer/orchestration/page-browser-graph/page-browser-graph-merge.utils.d.ts",
+      "default": "./src/route-renderer/orchestration/page-browser-graph/page-browser-graph-merge.utils.js"
+    },
+    "./route-renderer/orchestration/foreign-child/owning-renderer-resolution.ts": {
+      "types": "./src/route-renderer/orchestration/foreign-child/owning-renderer-resolution.d.ts",
+      "default": "./src/route-renderer/orchestration/foreign-child/owning-renderer-resolution.js"
     },
     "./router/navigation-coordinator.ts": {
       "types": "./src/router/client/navigation-coordinator.d.ts",
@@ -187,11 +318,31 @@
       "types": "./src/router/client/link-intent.d.ts",
       "default": "./src/router/client/link-intent.js"
     },
+    "./router/link-navigation-policy.ts": {
+      "types": "./src/router/client/link-navigation-policy.d.ts",
+      "default": "./src/router/client/link-navigation-policy.js"
+    },
+    "./client/scroll.ts": {
+      "types": "./src/client/scroll.d.ts",
+      "default": "./src/client/scroll.js"
+    },
+    "./client/view-transitions.ts": {
+      "types": "./src/client/view-transitions.d.ts",
+      "default": "./src/client/view-transitions.js"
+    },
+    "./client/navigation-scripts.ts": {
+      "types": "./src/client/navigation-scripts/index.d.ts",
+      "default": "./src/client/navigation-scripts/index.js"
+    },
     "./eco.ts": {
       "browser": "./src/eco/eco.browser.js",
       "types": "./src/eco/eco.d.ts",
       "default": "./src/eco/eco.js"
     },
+    "./eco/page-layout-normalization.ts": {
+      "types": "./src/eco/page-layout-normalization.d.ts",
+      "default": "./src/eco/page-layout-normalization.js"
+    },
     "./declarations.ts": {
       "types": "./src/declarations.d.ts"
     },
@@ -206,6 +357,10 @@
       "types": "./src/config/constants.d.ts",
       "default": "./src/config/constants.js"
     },
+    "./diagnostics/startup-trace.ts": {
+      "types": "./src/diagnostics/startup-trace.d.ts",
+      "default": "./src/diagnostics/startup-trace.js"
+    },
     "./bun.ts": {
       "types": "./src/adapters/bun/index.d.ts",
       "default": "./src/adapters/bun/index.js"
@@ -214,6 +369,10 @@
       "types": "./src/hmr/hmr-strategy.d.ts",
       "default": "./src/hmr/hmr-strategy.js"
     },
+    "./hmr/hmr-file-change-prep.ts": {
+      "types": "./src/hmr/hmr-file-change-prep.d.ts",
+      "default": "./src/hmr/hmr-file-change-prep.js"
+    },
     "./hmr/client/hmr-runtime.ts": {
       "types": "./src/hmr/client/hmr-runtime.d.ts",
       "default": "./src/hmr/client/hmr-runtime.js"
@@ -222,6 +381,18 @@
       "types": "./src/dev/host-runtime.d.ts",
       "default": "./src/dev/host-runtime.js"
     },
+    "./dev/client-bridge-registry.ts": {
+      "types": "./src/dev/client-bridge-registry.d.ts",
+      "default": "./src/dev/client-bridge-registry.js"
+    },
+    "./dev/hmr-manager-registry.ts": {
+      "types": "./src/dev/hmr-manager-registry.d.ts",
+      "default": "./src/dev/hmr-manager-registry.js"
+    },
+    "./dev/dev-client-ownership.ts": {
+      "types": "./src/dev/dev-client-ownership.d.ts",
+      "default": "./src/dev/dev-client-ownership.js"
+    },
     "./services/asset-processing-service.ts": {
       "types": "./src/services/assets/asset-processing-service/index.d.ts",
       "default": "./src/services/assets/asset-processing-service/index.js"
@@ -234,29 +405,57 @@
       "types": "./src/plugins/integration-plugin.d.ts",
       "default": "./src/plugins/integration-plugin.js"
     },
+    "./plugins/define-integration.ts": {
+      "types": "./src/plugins/define-integration.d.ts",
+      "default": "./src/plugins/define-integration.js"
+    },
     "./plugins/source-transform.ts": {
       "types": "./src/plugins/source-transform.d.ts",
       "default": "./src/plugins/source-transform.js"
     },
     "./build/build-types.ts": {
-      "types": "./src/build/build-types.d.ts",
-      "default": "./src/build/build-types.js"
+      "types": "./src/build/contracts/build-types.d.ts",
+      "default": "./src/build/contracts/build-types.js"
     },
     "./build/build-adapter.ts": {
       "types": "./src/build/build-adapter.d.ts",
       "default": "./src/build/build-adapter.js"
     },
+    "./build/build-runtime.ts": {
+      "types": "./src/build/runtime/build-runtime.d.ts",
+      "default": "./src/build/runtime/build-runtime.js"
+    },
+    "./build/build-contracts.ts": {
+      "types": "./src/build/contracts/build-contracts.d.ts",
+      "default": "./src/build/contracts/build-contracts.js"
+    },
+    "./build/production-build-cache.ts": {
+      "types": "./src/build/cache/production-build-cache.d.ts",
+      "default": "./src/build/cache/production-build-cache.js"
+    },
+    "./build/server-entry-build-cache.ts": {
+      "types": "./src/build/cache/server-entry-build-cache.d.ts",
+      "default": "./src/build/cache/server-entry-build-cache.js"
+    },
     "./build/runtime-build-output-normalizer.ts": {
-      "types": "./src/build/runtime-build-output-normalizer.d.ts",
-      "default": "./src/build/runtime-build-output-normalizer.js"
+      "types": "./src/build/rolldown/runtime-build-output-normalizer.d.ts",
+      "default": "./src/build/rolldown/runtime-build-output-normalizer.js"
     },
     "./build/browser-runtime-manifest.ts": {
-      "types": "./src/build/browser-runtime-manifest.d.ts",
-      "default": "./src/build/browser-runtime-manifest.js"
+      "types": "./src/build/browser/browser-runtime-manifest.d.ts",
+      "default": "./src/build/browser/browser-runtime-manifest.js"
     },
     "./build/browser-runtime-plugin.ts": {
-      "types": "./src/build/browser-runtime-plugin.d.ts",
-      "default": "./src/build/browser-runtime-plugin.js"
+      "types": "./src/build/browser/browser-runtime-plugin.d.ts",
+      "default": "./src/build/browser/browser-runtime-plugin.js"
+    },
+    "./build/jsx-ownership-plugins.ts": {
+      "types": "./src/build/browser/jsx-ownership-plugins.d.ts",
+      "default": "./src/build/browser/jsx-ownership-plugins.js"
+    },
+    "./build/lit-static-render-worker-context.ts": {
+      "types": "./src/build/browser/lit-static-render-worker-context.d.ts",
+      "default": "./src/build/browser/lit-static-render-worker-context.js"
     },
     "./cache.ts": {
       "types": "./src/cache/index.d.ts",
@@ -266,6 +465,18 @@
       "types": "./src/plugins/foreign-jsx-override-plugin.d.ts",
       "default": "./src/plugins/foreign-jsx-override-plugin.js"
     },
+    "./plugins/alias-resolver-plugin.ts": {
+      "types": "./src/plugins/alias-resolver-plugin.d.ts",
+      "default": "./src/plugins/alias-resolver-plugin.js"
+    },
+    "./plugins/tsconfig-import-resolver.ts": {
+      "types": "./src/plugins/tsconfig-import-resolver.d.ts",
+      "default": "./src/plugins/tsconfig-import-resolver.js"
+    },
+    "./plugins/jsx-import-source.utils.ts": {
+      "types": "./src/plugins/jsx-import-source.utils.d.ts",
+      "default": "./src/plugins/jsx-import-source.utils.js"
+    },
     "./html.ts": {
       "import": "./src/utils/html.js",
       "default": "./src/utils/html.js",

package/src/adapters/README.md

@@ -22,9 +22,13 @@ They are not responsible for:
 
 ## Main Areas
 
-- `bun/`: Bun server adapter, lifecycle coordination, bridge, and HMR transport
+- `bun/`: Bun server adapter, lifecycle coordination, bridge, HMR transport, and Bun user WebSocket lifecycle
 - `node/`: internal Node compatibility adapter pieces used by the CLI thin-host path
-- `shared/`: runtime-neutral adapter helpers used by both hosts
+- `shared/`: runtime-neutral adapter helpers used by both hosts, clustered by concern:
+    - `shared/http/` — API response builders, request pipeline, middleware runner, define-api helpers, explicit-static and filesystem matchers
+    - `shared/hmr/` — HMR HTML inject helpers, shared HMR manager, entrypoint registrar
+    - `shared/runtime/` — shared server adapter, route handler, application adapter, static builder, port/bootstrap utilities
+    - `shared/ws/` — WinterCG WebSocket lifecycle helpers and Node HTTP upgrade bridge (Bun-specific user WS lifecycle lives under `bun/`)
 
 ## Ownership Boundary