@openlaboratory/open-doc 0.1.2 → 0.1.3

package/app/src/integrations/open-doc-config.mjs

@@ -1,16 +1,64 @@
 import { fileURLToPath } from 'node:url'
+import { createRequire } from 'node:module'
 
 // The bundled Astro app this integration ships inside, e.g.
 // `…/node_modules/@openlaboratory/open-doc/app`. Its `src/` holds the React
 // island components Vite must be allowed to serve in dev.
 const APP_ROOT = fileURLToPath(new URL('../../', import.meta.url))
 
+// Resolve specifiers from open-doc's own install (not the consumer's).
+const require = createRequire(import.meta.url)
+
+/**
+ * Astro's static build emits an SSR server bundle into the consumer's `dist/`
+ * and then runs it with Node to prerender the pages. That bundle keeps open-doc's
+ * runtime deps (Astro, the React renderer, and their transitive deps like
+ * `clsx`/`piccolore`) as bare `import` specifiers — but those live in open-doc's
+ * own `node_modules`, not the consumer's, so under a strict (non-hoisted) install
+ * Node can't resolve them from `dist/` and prerendering fails.
+ *
+ * This plugin rewrites those bare specifiers to absolute paths resolved from
+ * open-doc's install, making the build self-contained under any package manager
+ * or workspace layout — without consumer-side hoisting. It runs in `renderChunk`
+ * (after Astro's module graph is fully resolved) so Astro's own resolution and
+ * virtual modules (`astro:*`) are left untouched. Client chunks bundle their
+ * deps, so they have nothing bare to rewrite.
+ *
+ * @returns {import('vite').Plugin}
+ */
+function absolutizeSsrExternals() {
+  const rewrite = (_match, pre, quote, spec) => {
+    if (/^[./]/.test(spec) || spec.startsWith('\0') || spec.includes(':')) return _match
+    try {
+      return pre + quote + require.resolve(spec) + quote
+    } catch {
+      return _match
+    }
+  }
+  return {
+    name: 'open-doc:absolutize-ssr-externals',
+    renderChunk(code) {
+      // Only the SSR build emits bare external imports; skip the client build.
+      if (this.environment && this.environment.name !== 'ssr') return null
+      const out = code
+        // `import … from '<spec>'` / `export … from '<spec>'`
+        .replace(/^(\s*(?:import|export)\b[^\n'"]*?\bfrom\s*)(['"])([^'"]+)\2/gm, rewrite)
+        // bare side-effect `import '<spec>'`
+        .replace(/^(\s*import\s+)(['"])([^'"]+)\2/gm, rewrite)
+        // dynamic `import('<spec>')`
+        .replace(/(\bimport\s*\(\s*)(['"])([^'"]+)\2/g, rewrite)
+      return out === code ? null : { code: out }
+    },
+  }
+}
+
 /**
  * Internal Astro integration that wires the consumer's project into the bundled
  * app:
  *   • exposes the resolved config as the `virtual:open-doc-config` module
  *   • aliases `@docs` to the consumer's content directory
- *   • allows Vite to read files from the (external) content + public dirs
+ *   • allows Vite to read the app's island sources + the consumer's content/public dirs
+ *   • makes the production build self-contained (see absolutizeSsrExternals)
  *
  * The resolved config is passed from the CLI via OPEN_DOC_CONFIG_JSON.
  *
@@ -28,24 +76,15 @@ export function openDocConfig({ contentDir, publicDir } = {}) {
     name: 'open-doc:config',
     hooks: {
       'astro:config:setup': ({ command, updateConfig }) => {
-        // For `build`, bundle the runtime deps our chunks reference into the SSR
-        // output so the build is self-contained under every package manager
-        // (they live in open-doc's node_modules, not the consumer's). Bundling
-        // *everything* (`noExternal: true`) breaks `astro sync` on a CommonJS
-        // dep, so we target the specific packages. In `dev` they must stay
-        // external — bundling CommonJS React breaks the dev SSR runtime.
-        const noExternal =
-          command === 'build' ? ['fuse.js', 'react', 'react-dom', '@astrojs/react'] : []
-
+        const buildPlugins = command === 'build' ? [absolutizeSsrExternals()] : []
         updateConfig({
           vite: {
-            plugins: [virtualConfigPlugin(configJson)],
+            plugins: [virtualConfigPlugin(configJson), ...buildPlugins],
             resolve: {
               alias: contentDir ? { '@docs': contentDir } : {},
               // One React instance, even if a consumer installs their own for MDX.
               dedupe: ['react', 'react-dom'],
             },
-            ssr: { noExternal },
             server: { fs: { allow } },
           },
         })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openlaboratory/open-doc",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "A polished, GitBook-style documentation-site framework. Write Markdown, run one command, get a beautiful static site.",
   "keywords": [
     "documentation",