@ecopages/core 0.2.0-beta.8 → 0.2.0-rc.0

package/src/build/browser-runtime-plugin.js

@@ -1,173 +0,0 @@
-import path from "node:path";
-import { existsSync, readFileSync } from "node:fs";
-import { cachedParseSync } from "../cache/module-parse-cache.js";
-import { getBrowserRuntimeSpecifierMap } from "./browser-runtime-manifest.js";
-import { buildSpecifierFilter } from "./browser-runtime-plugin-helpers.js";
-const BROWSER_RUNTIME_IMPORT_REWRITE_MAP = /* @__PURE__ */ Symbol.for("ecopages.browserRuntimeImportRewriteMap");
-const DEFAULT_BROWSER_RUNTIME_PLUGIN_NAME = "browser-runtime-plugin";
-function isRecord(value) {
-  return Boolean(value) && typeof value === "object";
-}
-function inferLoaderFromPath(filePath) {
-  const extension = path.extname(filePath).toLowerCase();
-  switch (extension) {
-    case ".mts":
-    case ".cts":
-    case ".ts":
-      return "ts";
-    case ".tsx":
-      return "tsx";
-    case ".jsx":
-      return "jsx";
-    default:
-      return "js";
-  }
-}
-function queueReplacement(options) {
-  if (!isRecord(options.source) || typeof options.source.value !== "string") {
-    return;
-  }
-  const mappedPath = options.specifierMap.get(options.source.value);
-  if (!mappedPath || typeof options.source.start !== "number" || typeof options.source.end !== "number") {
-    return;
-  }
-  const quote = options.code[options.source.start] === "'" ? "'" : '"';
-  options.edits.push({
-    start: options.source.start,
-    end: options.source.end,
-    replacement: `${quote}${mappedPath}${quote}`
-  });
-}
-function rewriteBrowserRuntimeImports(code, specifierMap, filePath = "browser-runtime-imports.js") {
-  if (specifierMap.size === 0) {
-    return code;
-  }
-  const edits = [];
-  try {
-    const result = cachedParseSync(filePath, code, {
-      sourceType: "module",
-      lang: path.extname(filePath).endsWith("x") ? "tsx" : "ts"
-    });
-    const walk = (node) => {
-      if (!isRecord(node)) {
-        return;
-      }
-      if (node.type === "ImportDeclaration" || node.type === "ExportNamedDeclaration" || node.type === "ExportAllDeclaration") {
-        queueReplacement({ code, source: node.source, specifierMap, edits });
-      }
-      if (node.type === "ImportExpression" && isRecord(node.source)) {
-        if (node.source.type === "StringLiteral" || node.source.type === "Literal") {
-          queueReplacement({ code, source: node.source, specifierMap, edits });
-        }
-      }
-      for (const value of Object.values(node)) {
-        if (Array.isArray(value)) {
-          for (const child of value) {
-            walk(child);
-          }
-        } else {
-          walk(value);
-        }
-      }
-    };
-    walk(result.program);
-  } catch {
-    return code;
-  }
-  if (edits.length === 0) {
-    return code;
-  }
-  edits.sort((left, right) => right.start - left.start);
-  let rewritten = code;
-  for (const edit of edits) {
-    rewritten = rewritten.slice(0, edit.start) + edit.replacement + rewritten.slice(edit.end);
-  }
-  return rewritten;
-}
-function getBrowserRuntimeImportRewriteMap(plugin) {
-  return plugin[BROWSER_RUNTIME_IMPORT_REWRITE_MAP];
-}
-function collectBrowserRuntimeImportRewriteMap(plugins) {
-  const merged = /* @__PURE__ */ new Map();
-  for (const plugin of plugins ?? []) {
-    const specifierMap = getBrowserRuntimeImportRewriteMap(plugin);
-    if (!specifierMap) {
-      continue;
-    }
-    for (const [specifier, publicPath] of specifierMap.entries()) {
-      if (!merged.has(specifier)) {
-        merged.set(specifier, publicPath);
-      }
-    }
-  }
-  return merged;
-}
-function createBrowserRuntimePlugin(options) {
-  const { manifest } = options;
-  const specifierMap = getBrowserRuntimeSpecifierMap(manifest);
-  const specifierFilter = buildSpecifierFilter(specifierMap);
-  if (!specifierFilter) {
-    return null;
-  }
-  const external = options.external ?? true;
-  const rewriteImports = options.rewriteImports ?? true;
-  const matchPublicPaths = options.matchPublicPaths ?? true;
-  const publicPathSet = new Set(specifierMap.values());
-  const specifierKeys = Array.from(specifierMap.keys());
-  const plugin = {
-    name: options.name ?? DEFAULT_BROWSER_RUNTIME_PLUGIN_NAME,
-    setup(build) {
-      build.onResolve({ filter: specifierFilter }, (args) => {
-        const mappedPath = specifierMap.get(args.path);
-        if (!mappedPath) {
-          return void 0;
-        }
-        return {
-          path: mappedPath,
-          external
-        };
-      });
-      if (matchPublicPaths) {
-        build.onResolve({ filter: /^\// }, (args) => {
-          if (!publicPathSet.has(args.path)) {
-            return void 0;
-          }
-          return {
-            path: args.path,
-            external: true
-          };
-        });
-      }
-      if (rewriteImports) {
-        build.onLoad({ filter: /\.[cm]?[jt]sx?$/ }, (args) => {
-          if (!path.isAbsolute(args.path) || !existsSync(args.path)) {
-            return void 0;
-          }
-          const code = readFileSync(args.path, "utf-8");
-          if (!specifierKeys.some((specifier) => code.includes(specifier))) {
-            return void 0;
-          }
-          const rewritten = rewriteBrowserRuntimeImports(code, specifierMap, args.path);
-          if (rewritten === code) {
-            return void 0;
-          }
-          return {
-            contents: rewritten,
-            loader: inferLoaderFromPath(args.path),
-            resolveDir: path.dirname(args.path)
-          };
-        });
-      }
-    }
-  };
-  plugin[BROWSER_RUNTIME_IMPORT_REWRITE_MAP] = specifierMap;
-  return plugin;
-}
-export {
-  BROWSER_RUNTIME_IMPORT_REWRITE_MAP,
-  DEFAULT_BROWSER_RUNTIME_PLUGIN_NAME,
-  collectBrowserRuntimeImportRewriteMap,
-  createBrowserRuntimePlugin,
-  getBrowserRuntimeImportRewriteMap,
-  rewriteBrowserRuntimeImports
-};

package/src/build/build-input-fingerprint.js

@@ -1,31 +0,0 @@
-import { fileSystem } from "@ecopages/file-system";
-function didBuildInputContributorChange(contributor) {
-  return contributor.didChange?.() === true;
-}
-function hashAppConfigFile(appConfig) {
-  const configPath = appConfig.absolutePaths?.config;
-  if (!configPath || !fileSystem.exists(configPath)) {
-    return "missing";
-  }
-  return fileSystem.hash(configPath);
-}
-function createBuildInputsFingerprint(appConfig) {
-  const changedContributors = [
-    ...Array.from(appConfig.processors?.values() ?? []).filter((processor) => didBuildInputContributorChange(processor)).map((processor) => `processor:${processor.getName()}`),
-    ...(appConfig.integrations ?? []).filter((integration) => didBuildInputContributorChange(integration)).map((integration) => `integration:${integration.name}`)
-  ];
-  return changedContributors.length > 0 ? changedContributors.sort().join("|") : "stable";
-}
-function haveBuildInputsChanged(appConfig) {
-  return createBuildInputsFingerprint(appConfig) !== "stable";
-}
-function collectBuildInputContributors(appConfig) {
-  return [...Array.from(appConfig.processors?.values() ?? []), ...appConfig.integrations ?? []];
-}
-export {
-  collectBuildInputContributors,
-  createBuildInputsFingerprint,
-  didBuildInputContributorChange,
-  hashAppConfigFile,
-  haveBuildInputsChanged
-};

package/src/build/build-manifest.d.ts

@@ -1,33 +0,0 @@
-import type { EcoBuildPlugin } from './build-types.js';
-import { type BrowserRuntimeManifest } from './browser-runtime-manifest.js';
-export interface AppBuildManifest {
-    loaderPlugins: EcoBuildPlugin[];
-    runtimePlugins: EcoBuildPlugin[];
-    browserBundlePlugins: EcoBuildPlugin[];
-    browserRuntimeManifest: BrowserRuntimeManifest;
-}
-/**
- * Merges plugin lists while preserving first-registration precedence by name.
- *
- * @remarks
- * Build manifests treat plugin names as stable identities. The first plugin
- * with a given name wins so config-time assembly stays deterministic across
- * loader, runtime, and browser buckets.
- */
-export declare function mergeEcoBuildPlugins(...pluginLists: Array<EcoBuildPlugin[] | undefined>): EcoBuildPlugin[];
-/**
- * Creates one app-owned build manifest from the supplied plugin buckets.
- */
-export declare function createAppBuildManifest(input?: Partial<AppBuildManifest>): AppBuildManifest;
-/**
- * Returns the shared browser runtime asset manifest sealed into the app build manifest.
- */
-export declare function getBrowserRuntimeManifest(manifest: AppBuildManifest): BrowserRuntimeManifest;
-/**
- * Returns the plugin list used for server-oriented builds.
- */
-export declare function getServerBuildPlugins(manifest: AppBuildManifest): EcoBuildPlugin[];
-/**
- * Returns the plugin list used for browser-oriented builds.
- */
-export declare function getBrowserBuildPlugins(manifest: AppBuildManifest): EcoBuildPlugin[];

package/src/build/build-manifest.js

@@ -1,49 +0,0 @@
-import { createBrowserRuntimePlugin, DEFAULT_BROWSER_RUNTIME_PLUGIN_NAME } from "./browser-runtime-plugin.js";
-import {
-  createBrowserRuntimeManifest,
-  mergeBrowserRuntimeManifests
-} from "./browser-runtime-manifest.js";
-function mergeEcoBuildPlugins(...pluginLists) {
-  const byName = /* @__PURE__ */ new Map();
-  for (const plugins of pluginLists) {
-    for (const plugin of plugins ?? []) {
-      if (!byName.has(plugin.name)) {
-        byName.set(plugin.name, plugin);
-      }
-    }
-  }
-  return Array.from(byName.values());
-}
-function createAppBuildManifest(input) {
-  return {
-    loaderPlugins: mergeEcoBuildPlugins(input?.loaderPlugins),
-    runtimePlugins: mergeEcoBuildPlugins(input?.runtimePlugins),
-    browserBundlePlugins: mergeEcoBuildPlugins(input?.browserBundlePlugins),
-    browserRuntimeManifest: mergeBrowserRuntimeManifests(input?.browserRuntimeManifest)
-  };
-}
-function getBrowserRuntimeManifest(manifest) {
-  return manifest.browserRuntimeManifest ?? createBrowserRuntimeManifest();
-}
-function getServerBuildPlugins(manifest) {
-  return mergeEcoBuildPlugins(manifest.loaderPlugins, manifest.runtimePlugins);
-}
-function getBrowserBuildPlugins(manifest) {
-  const runtimeRewritePlugin = createBrowserRuntimePlugin({
-    name: DEFAULT_BROWSER_RUNTIME_PLUGIN_NAME,
-    manifest: getBrowserRuntimeManifest(manifest)
-  });
-  return mergeEcoBuildPlugins(
-    manifest.loaderPlugins,
-    manifest.runtimePlugins,
-    runtimeRewritePlugin ? [runtimeRewritePlugin] : [],
-    manifest.browserBundlePlugins
-  );
-}
-export {
-  createAppBuildManifest,
-  getBrowserBuildPlugins,
-  getBrowserRuntimeManifest,
-  getServerBuildPlugins,
-  mergeEcoBuildPlugins
-};

package/src/build/jsx-ownership-plugins.d.ts

@@ -1,10 +0,0 @@
-import type { EcoBuildPlugin } from './build-types.js';
-import type { EcoPagesAppConfig } from '../types/internal-types.js';
-/**
- * Foreign JSX override plugins for mixed-integration apps (Kita + React, etc.).
- *
- * Each plugin rewrites files for one `(integration, extension)` pair with a
- * `@jsxImportSource` pragma so the bundler compiles against the owning runtime.
- * Extensions are sorted longest-first so `.page.react.tsx` wins over `.tsx`.
- */
-export declare function getJsxOwnershipPlugins(appConfig: EcoPagesAppConfig): EcoBuildPlugin[];

package/src/build/jsx-ownership-plugins.js

@@ -1,17 +0,0 @@
-import { createForeignJsxOverridePlugin } from "../plugins/foreign-jsx-override-plugin.js";
-function getJsxOwnershipPlugins(appConfig) {
-  const jsxExtensions = (appConfig.integrations ?? []).filter((integration) => integration.jsxImportSource).flatMap(
-    (integration) => integration.extensions.filter((extension) => extension.endsWith(".tsx") || extension.endsWith(".jsx")).map((extension) => ({ integration, extension }))
-  ).sort((left, right) => right.extension.length - left.extension.length);
-  return jsxExtensions.map(
-    ({ integration, extension }) => createForeignJsxOverridePlugin({
-      hostJsxImportSource: integration.jsxImportSource,
-      foreignExtensions: [extension],
-      excludeExtensions: jsxExtensions.filter((candidate) => candidate.extension.length > extension.length).filter((candidate) => candidate.extension.endsWith(extension)).map((candidate) => candidate.extension),
-      name: `ecopages-jsx-ownership-${integration.name}-${extension.replace(/[^a-zA-Z0-9]+/g, "-")}`
-    })
-  );
-}
-export {
-  getJsxOwnershipPlugins
-};

package/src/build/pages-unified-graph-build.js

@@ -1,208 +0,0 @@
-import path from "node:path";
-import { pathToFileURL } from "node:url";
-import { fileSystem } from "@ecopages/file-system";
-import { appLogger } from "../global/app-logger.js";
-import { build, getAppRouteModuleBuildExecutor, getAppServerBuildPlugins } from "./build-adapter.js";
-import { createBuildInputsFingerprint, hashAppConfigFile } from "./build-input-fingerprint.js";
-import { getCorePackageVersion } from "../services/module-loading/route-module-build-manifest.js";
-import { resolveInternalExecutionDir } from "../utils/resolve-work-dir.js";
-import { getSharedRouteModuleBuildCache } from "../services/module-loading/route-module-build-cache-registry.js";
-import { normalizeNodeRuntimeBuildOutputFile } from "./runtime-build-output-normalizer.js";
-import { resolveRouteModuleDependencyPaths } from "../services/module-loading/route-module-dependency-hasher.js";
-import { getJsxOwnershipPlugins } from "./jsx-ownership-plugins.js";
-const PAGES_UNIFIED_GRAPH_CACHE_DIR = ".server-pages-graph";
-const PAGES_UNIFIED_GRAPH_CACHE_FILENAME = ".build-cache.json";
-function isPagesUnifiedGraphEnabled() {
-  if (process.env.ECOPAGES_UNIFIED_PAGES_GRAPH === "0") {
-    return false;
-  }
-  if (process.env.ECOPAGES_UNIFIED_PAGES_GRAPH === "1") {
-    return true;
-  }
-  return process.env.NODE_ENV === "production";
-}
-function shouldBuildPagesUnifiedGraph() {
-  return isPagesUnifiedGraphEnabled() && process.env.NODE_ENV === "production";
-}
-function isPagesUnifiedGraphPage(filePath, appConfig) {
-  const normalizedPath = path.normalize(filePath);
-  return appConfig.templatesExt.some((extension) => normalizedPath.endsWith(extension));
-}
-function getPagesUnifiedGraphCachePath(appConfig) {
-  return path.join(
-    resolveInternalExecutionDir(appConfig),
-    PAGES_UNIFIED_GRAPH_CACHE_DIR,
-    PAGES_UNIFIED_GRAPH_CACHE_FILENAME
-  );
-}
-function createPagesUnifiedGraphBuildKey(appConfig, outdir) {
-  const plugins = appConfig.runtime?.buildManifest ? getAppServerBuildPlugins(appConfig) : [];
-  const pluginNames = [...plugins, ...getJsxOwnershipPlugins(appConfig)].map((plugin) => plugin.name).sort().join("|");
-  const templateExtensions = [...appConfig.templatesExt].sort().join("|");
-  return [
-    path.resolve(outdir),
-    hashAppConfigFile(appConfig),
-    templateExtensions,
-    pluginNames,
-    "es2022",
-    "esm",
-    "external-packages"
-  ].join("::");
-}
-function readPagesUnifiedGraphManifest(appConfig) {
-  const manifestPath = getPagesUnifiedGraphCachePath(appConfig);
-  if (!fileSystem.exists(manifestPath)) {
-    return void 0;
-  }
-  try {
-    const parsed = JSON.parse(fileSystem.readFileSync(manifestPath));
-    if (!parsed?.outputs) {
-      return void 0;
-    }
-    return parsed;
-  } catch {
-    return void 0;
-  }
-}
-function writePagesUnifiedGraphManifest(appConfig, manifest) {
-  const manifestPath = getPagesUnifiedGraphCachePath(appConfig);
-  fileSystem.ensureDir(path.dirname(manifestPath));
-  fileSystem.write(manifestPath, `${JSON.stringify(manifest, null, "	")}
-`);
-}
-function createSafeGraphEntryKey(entryPath, rootDir) {
-  const relativePath = path.relative(rootDir, entryPath).replace(/\.[^.]+$/u, "");
-  const safeKey = relativePath.replace(/[^a-zA-Z0-9]+/gu, "-").replace(/^-+|-+$/gu, "");
-  return safeKey.length > 0 ? safeKey : "page";
-}
-function resolveOutputForEntrypoint(entryKey, buildResult) {
-  const outputs = buildResult.outputs.map((output) => output.path);
-  for (const outputPath of outputs) {
-    const outputBaseName = path.basename(outputPath);
-    if (outputBaseName.startsWith(`${entryKey}-`) && /\.(?:m?js)$/u.test(outputBaseName)) {
-      return outputPath;
-    }
-    if (outputBaseName === `${entryKey}.js` || outputBaseName === `${entryKey}.mjs`) {
-      return outputPath;
-    }
-  }
-  return void 0;
-}
-function isManifestValidForEntries(manifest, appConfig, outdir, entryPaths) {
-  if (manifest.invalidationVersion !== getCorePackageVersion()) {
-    return false;
-  }
-  if (manifest.buildInputsFingerprint !== createBuildInputsFingerprint(appConfig)) {
-    return false;
-  }
-  if (manifest.buildKey !== createPagesUnifiedGraphBuildKey(appConfig, outdir)) {
-    return false;
-  }
-  return entryPaths.every((entryPath) => {
-    const resolvedEntryPath = path.resolve(entryPath);
-    const outputPath = manifest.outputs[resolvedEntryPath];
-    return outputPath ? fileSystem.exists(outputPath) : false;
-  });
-}
-async function ensurePagesUnifiedGraphBuilt(options) {
-  if (!shouldBuildPagesUnifiedGraph()) {
-    return void 0;
-  }
-  const eligibleEntryPaths = options.entryPaths.map((entryPath) => path.resolve(entryPath)).filter((entryPath) => isPagesUnifiedGraphPage(entryPath, options.appConfig));
-  if (eligibleEntryPaths.length === 0) {
-    return void 0;
-  }
-  const outdir = path.resolve(options.outdir);
-  const existingManifest = options.force ? void 0 : readPagesUnifiedGraphManifest(options.appConfig);
-  if (existingManifest && isManifestValidForEntries(existingManifest, options.appConfig, outdir, eligibleEntryPaths)) {
-    appLogger.debug("Reusing pages unified graph cache");
-    return existingManifest;
-  }
-  const plugins = options.appConfig.runtime?.buildManifest ? getAppServerBuildPlugins(options.appConfig) : [];
-  const mergedPlugins = [...plugins, ...getJsxOwnershipPlugins(options.appConfig)];
-  const routeModuleBuildCache = getSharedRouteModuleBuildCache(outdir, options.appConfig);
-  const entryRecord = {};
-  const entryKeysByPath = /* @__PURE__ */ new Map();
-  for (const entryPath of eligibleEntryPaths) {
-    const entryKey = createSafeGraphEntryKey(entryPath, options.appConfig.rootDir);
-    entryRecord[entryKey] = entryPath;
-    entryKeysByPath.set(entryPath, entryKey);
-  }
-  appLogger.debugTime("pagesUnifiedGraphBuild");
-  const buildResult = await build(
-    {
-      entrypoints: entryRecord,
-      root: options.appConfig.rootDir,
-      outdir,
-      target: "es2022",
-      format: "esm",
-      sourcemap: "none",
-      splitting: true,
-      minify: false,
-      naming: "[name]-[hash].[ext]",
-      externalPackages: true,
-      plugins: mergedPlugins.length > 0 ? mergedPlugins : void 0
-    },
-    getAppRouteModuleBuildExecutor(options.appConfig)
-  );
-  appLogger.debugTimeEnd("pagesUnifiedGraphBuild");
-  if (!buildResult.success) {
-    const details = buildResult.logs.map((log) => log.message).join(" | ");
-    throw new Error(`Pages unified graph build failed: ${details}`);
-  }
-  const outputs = {};
-  for (const entryPath of eligibleEntryPaths) {
-    const fileHash = fileSystem.hash(entryPath);
-    const entryKey = entryKeysByPath.get(entryPath);
-    const compiledOutput = entryKey ? resolveOutputForEntrypoint(entryKey, buildResult) : void 0;
-    if (!compiledOutput) {
-      throw new Error(`Pages unified graph build produced no output for ${entryPath}`);
-    }
-    normalizeNodeRuntimeBuildOutputFile(compiledOutput, options.appConfig.rootDir);
-    outputs[entryPath] = compiledOutput;
-    routeModuleBuildCache.recordBuild({
-      filePath: entryPath,
-      rootDir: options.appConfig.rootDir,
-      outdir,
-      fileHash,
-      outputPath: compiledOutput,
-      dependencyModulePaths: resolveRouteModuleDependencyPaths(buildResult, entryPath, options.appConfig.rootDir),
-      externalPackages: true,
-      plugins: mergedPlugins
-    });
-  }
-  const manifest = {
-    invalidationVersion: getCorePackageVersion(),
-    buildInputsFingerprint: createBuildInputsFingerprint(options.appConfig),
-    buildKey: createPagesUnifiedGraphBuildKey(options.appConfig, outdir),
-    builtAt: Date.now(),
-    outputs
-  };
-  writePagesUnifiedGraphManifest(options.appConfig, manifest);
-  appLogger.debug(`Built pages unified graph for ${eligibleEntryPaths.length} entries`);
-  return manifest;
-}
-async function importPagesUnifiedGraphModule(appConfig, filePath) {
-  const manifest = readPagesUnifiedGraphManifest(appConfig);
-  if (!manifest) {
-    return void 0;
-  }
-  const resolvedFilePath = path.resolve(filePath);
-  const outputPath = manifest.outputs[resolvedFilePath];
-  if (!outputPath || !fileSystem.exists(outputPath)) {
-    return void 0;
-  }
-  return await import(
-    /* @vite-ignore */
-    pathToFileURL(outputPath).href
-  );
-}
-export {
-  PAGES_UNIFIED_GRAPH_CACHE_DIR,
-  PAGES_UNIFIED_GRAPH_CACHE_FILENAME,
-  ensurePagesUnifiedGraphBuilt,
-  importPagesUnifiedGraphModule,
-  isPagesUnifiedGraphEnabled,
-  isPagesUnifiedGraphPage,
-  shouldBuildPagesUnifiedGraph
-};

package/src/build/parallel-build-executor.js

@@ -1,52 +0,0 @@
-class ParallelBuildExecutor {
-  inner;
-  limit;
-  activeCount = 0;
-  queue = [];
-  constructor(inner, limit) {
-    this.inner = inner;
-    this.limit = Math.max(1, limit);
-  }
-  build(options) {
-    return new Promise((resolve, reject) => {
-      this.queue.push({
-        operation: () => this.inner.build(options),
-        resolve,
-        reject
-      });
-      this.drainQueue();
-    });
-  }
-  drainQueue() {
-    while (this.activeCount < this.limit && this.queue.length > 0) {
-      const next = this.queue.shift();
-      if (!next) {
-        return;
-      }
-      this.activeCount += 1;
-      void next.operation().then((result) => {
-        next.resolve(result);
-      }).catch((error) => {
-        next.reject(error);
-      }).finally(() => {
-        this.activeCount -= 1;
-        this.drainQueue();
-      });
-    }
-  }
-  unwrap() {
-    return this.inner;
-  }
-  getConcurrencyLimitForTests() {
-    return this.limit;
-  }
-  getActiveCountForTests() {
-    return this.activeCount;
-  }
-  getQueuedCountForTests() {
-    return this.queue.length;
-  }
-}
-export {
-  ParallelBuildExecutor
-};