@terra-symposium/docs 0.1.78 → 0.1.80

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@terra-symposium/docs",
-  "version": "0.1.78",
+  "version": "0.1.80",
   "description": "Terra Docs workspace and Markdown site generator.",
   "repository": {
     "type": "git",
@@ -69,7 +69,7 @@
     "@changesets/cli": "^3.0.3",
     "@eslint/js": "10.0.1",
     "@playwright/test": "^1.64.1",
-    "@terra-symposium/standards-quality": "2.1.0",
+    "@terra-symposium/standards-quality": "2.1.3",
     "@terra-symposium/standards-reporting": "0.6.2",
     "@types/katex": "^0.16.8",
     "@types/node": "^24.19.2",

package/site/astro.config.mjs

@@ -15,6 +15,9 @@ const packageRoot = fileURLToPath(new URL('../', import.meta.url));
 const requireFromPackage = createRequire(import.meta.url);
 const stylingEntry = requireFromPackage.resolve('@terra-symposium/styling');
 const requireFromStyling = createRequire(stylingEntry);
+const astroManifest = JSON.parse(
+  readFileSync(requireFromPackage.resolve('astro/package.json'), 'utf8'),
+);
 const docsManifest = JSON.parse(readFileSync(resolve(packageRoot, 'package.json'), 'utf8'));
 const projectRoot = process.env.TERRA_DOCS_ROOT ?? process.cwd();
 const publicDir = resolve(projectRoot, '.terra-docs/public');
@@ -28,6 +31,7 @@ const projectManifest = (() => {
     return {};
   }
 })();
+const requireFromProject = createRequire(resolve(projectRoot, 'package.json'));
 
 function packageExportAliases() {
   if (!projectManifest.name || !projectManifest.exports) return [];
@@ -46,6 +50,72 @@ function packageExportAliases() {
   });
 }
 
+function astroPackageExportAliases() {
+  return Object.keys(astroManifest.exports)
+    .filter((key) => key.startsWith('./') && !key.includes('*'))
+    .map((key) => {
+      const specifier = `astro${key.slice(1)}`;
+      try {
+        requireFromProject.resolve(specifier);
+        return null;
+      } catch {
+        // Package-owned Astro installation is the fallback for content-only repos.
+      }
+      return {
+        find: new RegExp(`^${specifier.replace(/[|\\{}()[\]^$+?.]/g, '\\$&')}$`),
+        replacement: requireFromPackage.resolve(specifier),
+      };
+    })
+    .filter(Boolean);
+}
+
+function packageDependencyAliases() {
+  return Object.keys(docsManifest.dependencies ?? {})
+    .filter((name) => name !== 'astro')
+    .flatMap((name) => {
+      const manifestPath = resolve(packageRoot, 'node_modules', name, 'package.json');
+      let dependencyManifest;
+      try {
+        dependencyManifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
+      } catch {
+        return [];
+      }
+      const subpaths = Object.keys(dependencyManifest.exports ?? {}).filter(
+        (key) => key.startsWith('./') && !key.includes('*'),
+      );
+      return [name, ...subpaths.map((key) => `${name}${key.slice(1)}`)].flatMap((specifier) => {
+        try {
+          return [
+            {
+              find: new RegExp(`^${specifier.replace(/[|\\{}()[\]^$+?.]/g, '\\$&')}$`),
+              replacement: requireFromPackage.resolve(specifier),
+            },
+          ];
+        } catch {
+          return [];
+        }
+      });
+    });
+}
+
+function sharedReactAliases() {
+  const specifiers = [
+    'react',
+    'react/compiler-runtime',
+    'react/jsx-dev-runtime',
+    'react/jsx-runtime',
+    'react-dom',
+    'react-dom/client',
+    'react-dom/server',
+  ];
+  return specifiers.map((specifier) => {
+    return {
+      find: new RegExp(`^${specifier.replace(/[|\\{}()[\]^$+?.]/g, '\\$&')}$`),
+      replacement: requireFromPackage.resolve(specifier),
+    };
+  });
+}
+
 export default defineConfig({
   root: projectRoot,
   srcDir: resolve(packageRoot, 'site/src'),
@@ -61,9 +131,22 @@ export default defineConfig({
     plugins: [docsContentPlugin({ root: projectRoot, base })],
     optimizeDeps: { include: [...DOCS_VITE_OPTIMIZE_DEPS] },
     resolve: {
-      alias: packageExportAliases(),
+      // Astro's virtual build entries are resolved from the consumer project
+      // root. Consumers only need the Docs package, so map Astro's exported
+      // subpaths to the installation shipped with Docs.
+      alias: [
+        ...packageExportAliases(),
+        ...sharedReactAliases(),
+        ...astroPackageExportAliases(),
+        ...packageDependencyAliases(),
+      ],
       dedupe: ['react', 'react-dom'],
     },
+    ssr: {
+      // Bundle React peer consumers with the package-owned React runtime so
+      // static rendering does not load two copies across pnpm virtual stores.
+      noExternal: ['@terra-symposium/styling', '@terra-symposium/standards-error-boundaries'],
+    },
     server: { fs: { allow: [projectRoot, packageRoot] } },
   },
 });