@uniweb/unipress 0.4.27 → 0.4.29

package/src/runtime-externals.js

@@ -0,0 +1,138 @@
+// Single-instance linkage for dynamically imported foundations.
+//
+// A built foundation externalizes its peer deps — react, react-dom,
+// react-dom/server, react/jsx-runtime, react/jsx-dev-runtime, @uniweb/core
+// (the set in @uniweb/build's foundation/config.js DEFAULT_EXTERNALS). When
+// unipress fetches a foundation to its cache and dynamically imports the built
+// entry.js, those bare imports must resolve to unipress's OWN copies so the
+// foundation shares one React instance with @uniweb/runtime/ssr and one
+// @uniweb/core with the Website graph the orchestrator builds.
+//
+// The old approach symlinked unipress's node_modules copies beside the cached
+// entry. That relies on those copies existing on disk and being locatable via
+// require.resolve — which fails in the `bun --compile` standalone binary: the
+// deps are bundled INTO the binary, and require.resolve does CWD-relative
+// resolution, so it finds nothing when unipress runs from a project (like a
+// loose book folder) that has no react up its directory tree. The symlink step
+// then produced an empty node_modules and the foundation import failed with
+// "Cannot find module 'react/jsx-runtime'".
+//
+// Instead we mirror @uniweb/runtime's worker-isolate shims (its
+// build-worker.js): publish each package on a globalThis bridge here, and write
+// tiny shim modules into the cache's co-located node_modules (see
+// writeExternalShims in foundation-fetch.js) that re-export from the bridge.
+// Bun/Node resolve the foundation's bare imports to the shims (nearest
+// node_modules wins); each shim reads the bridge and yields unipress's exact
+// instance — no on-disk package needed, works identically in the compiled
+// binary and in source/npm mode.
+//
+// Why globalThis rather than a direct import inside the shim: the shim lives on
+// disk beside the foundation; an `import 'react'` from it would re-enter
+// resolution (and in the binary resolve to nothing). Reading a global sidesteps
+// module resolution entirely — the same reason the isolate uses it.
+//
+// Importing this module has the SIDE EFFECT of setting the globalThis bridges,
+// so it must be imported before any foundation is dynamically imported. Both
+// foundation-fetch.js (which writes the shims) and orchestrator.js (which does
+// the import) import it; ESM evaluates it once.
+
+import * as React from 'react'
+import * as ReactJsxRuntime from 'react/jsx-runtime'
+import * as ReactJsxDevRuntime from 'react/jsx-dev-runtime'
+import * as ReactDom from 'react-dom'
+import * as ReactDomServer from 'react-dom/server'
+import * as UniwebCore from '@uniweb/core'
+
+// globalThis bridge keys. Namespaced to unipress so they never collide with
+// @uniweb/runtime's worker isolate (__PLATFORM_*), which a foundation could
+// conceivably bundle into the same realm.
+const REACT_KEY = '__UNIPRESS_REACT'
+const JSX_RUNTIME_KEY = '__UNIPRESS_JSX_RUNTIME'
+const JSX_DEV_RUNTIME_KEY = '__UNIPRESS_JSX_DEV_RUNTIME'
+const REACT_DOM_KEY = '__UNIPRESS_REACT_DOM'
+const REACT_DOM_SERVER_KEY = '__UNIPRESS_REACT_DOM_SERVER'
+const UNIWEB_CORE_KEY = '__UNIPRESS_UNIWEB_CORE'
+
+globalThis[REACT_KEY] = React
+globalThis[JSX_RUNTIME_KEY] = ReactJsxRuntime
+globalThis[JSX_DEV_RUNTIME_KEY] = ReactJsxDevRuntime
+globalThis[REACT_DOM_KEY] = ReactDom
+globalThis[REACT_DOM_SERVER_KEY] = ReactDomServer
+globalThis[UNIWEB_CORE_KEY] = UniwebCore
+
+const VALID_IDENTIFIER = /^[A-Za-z_$][A-Za-z0-9_$]*$/
+
+// Generate an ESM shim module that re-exports every named export of `ns` from
+// the globalThis bridge. Names are enumerated from the live namespace (as
+// build-worker.js does) so the shim tracks the actual React / core surface
+// without a hardcoded list. Non-identifier keys (e.g. "module.exports" from CJS
+// interop) are skipped; `default` is re-exported explicitly.
+function shimSource(globalKey, ns) {
+  const names = Object.keys(ns).filter(
+    (name) => name !== 'default' && VALID_IDENTIFIER.test(name)
+  )
+  return [
+    `// AUTO-GENERATED by unipress — re-exports from globalThis.${globalKey}.`,
+    `// unipress publishes its own bundled instance there (see runtime-externals.js),`,
+    `// giving this dynamically-imported foundation the SAME instance unipress uses.`,
+    `const __ns = globalThis.${globalKey}`,
+    `export default __ns?.default ?? __ns`,
+    ...names.map((name) => `export const ${name} = __ns.${name}`),
+    ''
+  ].join('\n')
+}
+
+function modulePackageJson(name, exportsMap) {
+  return JSON.stringify(
+    {
+      name,
+      type: 'module',
+      exports: { ...exportsMap, './package.json': './package.json' }
+    },
+    null,
+    2
+  )
+}
+
+// The shim packages to lay into a fetched foundation's co-located node_modules.
+// Each entry: the package directory (relative to node_modules, POSIX-style),
+// its package.json text, and the shim files keyed by relative path. Subpath
+// specifiers (react/jsx-runtime, react-dom/server) are served through the
+// package's `exports` map so Node/Bun resolve them to the right shim file.
+export function externalShimPackages() {
+  return [
+    {
+      dir: 'react',
+      packageJson: modulePackageJson('react', {
+        '.': './index.js',
+        './jsx-runtime': './jsx-runtime.js',
+        './jsx-dev-runtime': './jsx-dev-runtime.js'
+      }),
+      files: {
+        'index.js': shimSource(REACT_KEY, React),
+        'jsx-runtime.js': shimSource(JSX_RUNTIME_KEY, ReactJsxRuntime),
+        'jsx-dev-runtime.js': shimSource(JSX_DEV_RUNTIME_KEY, ReactJsxDevRuntime)
+      }
+    },
+    {
+      dir: 'react-dom',
+      packageJson: modulePackageJson('react-dom', {
+        '.': './index.js',
+        './server': './server.js'
+      }),
+      files: {
+        'index.js': shimSource(REACT_DOM_KEY, ReactDom),
+        'server.js': shimSource(REACT_DOM_SERVER_KEY, ReactDomServer)
+      }
+    },
+    {
+      dir: '@uniweb/core',
+      packageJson: modulePackageJson('@uniweb/core', {
+        '.': './index.js'
+      }),
+      files: {
+        'index.js': shimSource(UNIWEB_CORE_KEY, UniwebCore)
+      }
+    }
+  ]
+}