refactor(platform): resolve via #platform import map and unify type contract

Replace the template-literal `await import()` pattern in next.config.mjs,
mdx/plugins.mjs, and playwright.config.ts with a static
`import from '#platform/...'` resolved by Node's subpath imports. Each
platform's build command sets `NODE_OPTIONS=--conditions=<target>` so
the imports map selects the matching @node-core/platform-* package;
without the flag, the site's local no-op file is used.

Consolidate the duplicated PlatformConfig / PlatformPlaywrightConfig
types into apps/site, the contract owner. Platform .mjs files JSDoc
the site types via relative path; platform-side .d.ts duplicates are
removed.

Also: arrow-function instrumentation hooks; prune the redundant
PLAYWRIGHT_BASE_URL env from the Cloudflare Playwright workflow and
config (kept in the Vercel workflow where it carries the dynamic
preview URL).

Author: ovflowd

.github/workflows/playwright-cloudflare-open-next.yml

@@ -55,7 +55,7 @@ jobs:
         run: node --run playwright
         env:
           NEXT_PUBLIC_DEPLOY_TARGET: cloudflare
-          PLAYWRIGHT_BASE_URL: http://127.0.0.1:8787
+          NODE_OPTIONS: --conditions=cloudflare
 
       - name: Upload Playwright test results
         if: always()

apps/cloudflare/next.platform.config.mjs

@@ -12,7 +12,7 @@ const require = createRequire(import.meta.url);
  * Must export a default `{ nextConfig, aliases, images }` shape — any of
  * which may be omitted when the platform has nothing to contribute.
  *
- * @type {import('@node-core/platform-cloudflare/next.platform.config').PlatformConfig}
+ * @type {import('../site/next.platform.config').PlatformConfig}
  */
 export default {
   nextConfig: {

apps/cloudflare/open-next.config.ts

@@ -21,7 +21,7 @@ const cloudflareConfig = defineCloudflareConfig({
 const openNextConfig: OpenNextConfig = {
   ...cloudflareConfig,
   buildCommand:
-    'cross-env NEXT_PUBLIC_DEPLOY_TARGET=cloudflare pnpm build --webpack',
+    'cross-env NEXT_PUBLIC_DEPLOY_TARGET=cloudflare NODE_OPTIONS=--conditions=cloudflare pnpm build --webpack',
   cloudflare: {
     skewProtection: { enabled: true },
   },

apps/cloudflare/playwright.platform.config.mjs

@@ -5,15 +5,15 @@
  * loader. Spins up the wrangler preview so E2E runs against the
  * OpenNext worker artifact rather than `next dev`.
  *
- * @type {import('./playwright.platform.config').PlatformPlaywrightConfig}
+ * @type {import('../site/playwright.platform.config').PlatformPlaywrightConfig}
  */
 export default {
   baseURL: 'http://127.0.0.1:8787',
   webServer: {
     stdout: 'pipe',
     command:
       '../../node_modules/.bin/turbo cloudflare:preview --filter=@node-core/platform-cloudflare',
-    url: process.env.PLAYWRIGHT_BASE_URL || 'http://127.0.0.1:8787',
+    url: 'http://127.0.0.1:8787',
     timeout: 60_000 * 3,
   },
 };

apps/cloudflare/src/instrumentation.ts

@@ -1 +1 @@
-export function register() {}
+export const register = () => {};

apps/cloudflare/tsconfig.json

@@ -16,8 +16,7 @@
   "include": [
     "src",
     "next.platform.config.mjs",
-    "playwright.platform.config.mjs",
-    "playwright.platform.config.d.ts"
+    "playwright.platform.config.mjs"
   ],
   "exclude": ["src/worker-entrypoint.ts"]
 }

apps/site/mdx/plugins.mjs

@@ -7,16 +7,13 @@ import rehypeSlug from 'rehype-slug';
 import remarkGfm from 'remark-gfm';
 import readingTime from 'remark-reading-time';
 
-import { DEPLOY_TARGET } from '../next.constants.mjs';
-import remarkTableTitles from '../util/table';
+// MDX overrides contributed by the active deployment target. Resolved via
+// the `#platform/next.platform.config` import map in `package.json`; each
+// platform owns its own `{ wasm, twoslash }` defaults and the in-repo
+// default file acts as the standalone fallback.
+import platform from '#platform/next.platform.config';
 
-// Load MDX overrides contributed by the active deployment target. Keeps
-// this module free of platform-specific branches — each platform owns
-// its own `{ wasm, twoslash }` defaults via `next.platform.config.mjs`,
-// with the in-repo default config serving as the standalone fallback.
-const { default: platform } = DEPLOY_TARGET
-  ? await import(`@node-core/platform-${DEPLOY_TARGET}/next.platform.config`)
-  : await import('../next.platform.config.mjs');
+import remarkTableTitles from '../util/table';
 
 // Shiki is created out here to avoid an async rehype plugin
 const singletonShiki = await rehypeShikiji(platform.mdx);

apps/site/next.config.mjs

@@ -2,25 +2,12 @@
 
 import createNextIntlPlugin from 'next-intl/plugin';
 
-import {
-  BASE_PATH,
-  DEPLOY_TARGET,
-  ENABLE_STATIC_EXPORT,
-} from './next.constants.mjs';
+import platform from '#platform/next.platform.config';
+
+import { BASE_PATH, ENABLE_STATIC_EXPORT } from './next.constants.mjs';
 import { getImagesConfig } from './next.image.config.mjs';
 import { redirects, rewrites } from './next.rewrites.mjs';
 
-/**
- * Loads the deployment platform's `next.platform.config.mjs` — falling back
- * to the local no-op when no platform is active. Each platform package
- * (`@node-core/platform-<target>`) owns its own file and contributes
- * `{ nextConfig, aliases, images }`. Adding a new platform only means
- * creating a new `@node-core/platform-<target>` package.
- */
-const { default: platform } = DEPLOY_TARGET
-  ? await import(`@node-core/platform-${DEPLOY_TARGET}/next.platform.config`)
-  : await import('./next.platform.config.mjs');
-
 /** @type {import('next').NextConfig} */
 const nextConfig = {
   // Full Support of React 18 SSR and Streaming

apps/cloudflare/next.platform.config.d.ts apps/site/next.platform.config.d.tsapps/cloudflare/next.platform.config.d.ts renamed to apps/site/next.platform.config.d.ts

@@ -1,11 +1,13 @@
+import type { HighlighterOptions } from '@node-core/rehype-shiki';
 import type { NextConfig } from 'next';
 
-type PlatformMdxConfig = Pick<
-  import('@node-core/rehype-shiki').HighlighterOptions,
-  'wasm' | 'twoslash'
->;
+type PlatformMdxConfig = Pick<HighlighterOptions, 'wasm' | 'twoslash'>;
 type PlatformNextConfig = Pick<NextConfig, 'deploymentId' | 'env'>;
 
+/**
+ * Shared platform-config contract consumed by `apps/site/next.config.mjs`
+ * and implemented by each `@node-core/platform-<target>` package.
+ */
 export type PlatformConfig = {
   aliases?: Record<string, string>;
   images?: NextConfig['images'];

apps/site/next.platform.config.mjs

@@ -9,6 +9,8 @@
  * Alias values are project-relative strings (not absolute paths) so
  * Turbopack resolves them correctly — Turbopack treats absolute paths
  * as server-relative and rejects them.
+ *
+ * @type {import('./next.platform.config').PlatformConfig}
  */
 export default {
   aliases: {